Skip to content

Latest commit

 

History

384 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClickTrail

ClickTrail

Attribution usually breaks somewhere between the ad click and the conversion. ClickTrail keeps campaign context alive through cached pages, dynamic forms, cross-domain journeys, repeat visits, and configured consent rules.

ClickTrail keeps the source of the visit, not a profile of the visitor — first-party capture with consent controls. It is a WordPress capture-and-controlled-delivery layer, not an attribution dashboard, hosting platform, lead manager, or ad optimizer. The current security-status blockers and verification boundary are documented in Security and Privacy.

GitHub release License PHP WordPress GitHub stars

Vizuh logo

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

Integration evidence: Source presence alone does not prove production provider support. Current form, WooCommerce, GTM, and delivery status lives in the integration reference and machine-readable ledger.

What ClickTrail Solves

  • Keeps campaign context available for WooCommerce orders when the configured path captures it.
  • Persists UTMs and click IDs across the configured attribution journey.
  • Provides client-side fallback paths for cached or dynamic forms.
  • Provides approved cross-domain continuity paths with documented limitations.
  • Consent controls and optional server-side delivery live in one plugin; queued retries now recheck current consent before delivery.

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, post-purchase milestones, and allowlisted privacy export/erase/purge/uninstall handling.
  • 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-gated dispatch with a current-consent check before queued delivery.

Releases

ClickTrail 1.10.0 adds consent-safe queued delivery, cross-tab consent authority, WooCommerce privacy lifecycle handling, and evidence-labelled form coverage. The WordPress.org package is prepared at the same version; live WordPress, browser, and provider verification remains a separate release gate. See changelog.txt for the full history and readme.txt for the WordPress.org release notes.

Documentation By Audience

Repository Map

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.

Releases

Packages

Contributors

Languages