ClickTrail

Keep campaign context attached to WooCommerce orders, WordPress forms, and event flows across cached pages, dynamic forms, cross-domain journeys, repeat visits, and consent-aware sites.

Read in English
Leia em Portugues (Brasil)
Contributor Guide
Guia de Contribuicao
Technical Docs
WordPress Readme

What ClickTrail Solves

• WooCommerce orders lose campaign context before revenue is reported.
• UTMs and click IDs disappear after the landing page.
• Cached or dynamic forms submit without attribution.
• Cross-domain flows reset the source trail.
• Teams need consent-aware capture and optional server-side delivery in one plugin.

ClickTrail is designed to keep first-touch and last-touch context alive until the point where WordPress actually needs it: WooCommerce orders, form submissions, browser events, and optional downstream delivery.

Core Capabilities

• Capture: first-touch and last-touch attribution, referrers, classic and extended UTMs, click IDs, browser identifiers, retention, and cross-domain continuity.
• WooCommerce: order attribution, enriched purchase payloads, thank-you page purchase pushes, optional list-view and cart storefront events, richer Woo dataLayer support, and post-purchase milestones.
• Forms: automatic hidden-field enrichment for Contact Form 7 and Fluent Forms, compatible hidden-field population for Gravity Forms and WPForms, cached-page fallback, dynamic-content support, and WhatsApp continuity.
• Events: browser collection, dataLayer pushes, sGTM compatibility mode, webhook intake, lifecycle updates, and optional Woo storefront signals.
• Delivery: optional server-side transport, retries, diagnostics, conflict scanning, backup/restore, and consent-aware dispatch.

Latest Release: 1.7.0

• GF helper classes committed (Gf_Channel_Resolver, Gf_Form_Settings_Tab, Gf_Merge_Tags, Gf_Minification_Protector)
• Admin QA cookie priority fix; wp_logout now clears it immediately
• lt_channel server-side fallback added alongside ft_channel
• Channel classifier extended: dclid → Display & Video 360, epik → Pinterest Ads, sccid → Snapchat Ads
• visitor_id + session_id persisted to GF entry meta and WooCommerce order meta
• Legacy code removed: dead v1 API controller, URL alias remapping, enable_consent_banner, log_whatsapp_clicks() stub
• Full release notes: changelog.txt

Documentation By Audience

• GitHub visitors: start with README.en.md or README.pt-BR.md.
• Contributors and reviewers: use CONTRIBUTING.md or CONTRIBUTING.pt-BR.md.
• Engineers and agents: use docs/README.md and AGENTS.md.

Repository Map

• docs/README.md: engineering index by task and subsystem
• docs/guides/IMPLEMENTATION-PLAYBOOK.md: practical rollout guide for lead-gen, WooCommerce, cross-domain, consent-aware, and server-side setups
• docs/architecture/PLUGIN-OVERVIEW.md: runtime architecture and module map
• docs/reference/INTEGRATIONS.md: forms, commerce, consent, webhook, and delivery integrations
• docs/guides/SETTINGS-AND-ADMIN.md: current admin IA and option mapping
• changelog.txt: full plain-English release history aligned with the WordPress readme
• .github/PULL_REQUEST_TEMPLATE.md: PR checklist for repo changes

Contributor Quick Start

1. Read CONTRIBUTING.md.
2. Use docs/README.md to find the canonical doc for the area you will change.
3. Keep product docs, technical docs, and changelog entries aligned with the implementation.

Requirements

• WordPress 6.5+
• PHP 8.1+

License

GPL-2.0-or-later. See LICENSE.