Server-side conversion attribution for LnkFlow tracked links, as a native WordPress/WooCommerce plugin.
When a visitor arrives through a LnkFlow tracked link (?lnk_id=<uuid>), the plugin captures the click reference, attaches it to the WooCommerce order, and reports the authoritative order lifecycle to the LnkFlow v1 API from the server:
Multi-touch journey capture is automatic for the selected Website: the bundled, consent-aware script preserves a pseudonymous visitor id plus first and last LnkFlow clicks and records each touchpoint without requiring hosted JavaScript.
| Event | Trigger | LnkFlow endpoint |
|---|---|---|
| Sale | WooCommerce confirms payment | POST /api/v1/track/sale |
| Refund | Full/partial refund created | POST /api/v1/track/refund |
| Lead (optional) | Customer account created | POST /api/v1/track/lead |
This replaces LnkFlow's browser-captured thank-you-page bridge with payment-status truth: paid vs pending, refunds, cancellations, and subscription renewals.
1.1.2 — released. The current release is v1.1.2: multi-touch journey capture is automatic for the selected Website, using the same visitor/first/last-touch identity as LnkFlow's hosted script. Every sale remains server-authoritative. See CHANGELOG.md.
The plugin is not yet listed on WordPress.org — submission is pending review — so install it from the release ZIP via Plugins → Add New → Upload Plugin. The development plan lives in docs/DEVELOPMENT-PLAN.md; the vendored integration context in docs/CONTEXT-LNKFLOW.md and docs/CONTEXT-WORDPRESS-WOOCOMMERCE.md.
| Audience | Document |
|---|---|
| Merchants — setup, settings, filters | docs/USAGE.md |
| Merchants — when something is missing | docs/TROUBLESHOOTING.md |
| Merchants — updates, deactivation, rollback, uninstall | docs/UPGRADING.md |
| WordPress.org listing, including the exhaustive external-services disclosure | readme.txt |
- WordPress 6.5+
- WooCommerce 8.5+
- PHP 8.1+
- A LnkFlow API token with the
conversionsability
composer install
composer lint # PHPCS (WordPress-Extra)
composer analyse # PHPStan
composer test # PHPUnitThis plugin lives in its own git repository (integrations/lnkflow-for-woocommerce is ignored by the LnkFlow SaaS monorepo, like every public integration). Releases follow SemVer and document the compatible LnkFlow API range (v1). The repository is public and 1.0.0 is tagged and released; store submission remains an owner-approved action.
GPL-2.0-or-later.