Title: FirstPromoter Author: FirstPromoter Published: 19, Payares de 2025 Last modified: 12, Marzu de 2026 --- Guetar plugins ![](https://ps.w.org/firstpromoter/assets/banner-772x250.png?rev=3402380) ![](https://ps.w.org/firstpromoter/assets/icon-256x256.png?rev=3402380) # FirstPromoter By [FirstPromoter](https://profiles.wordpress.org/maxwellfp/) [Download](https://downloads.wordpress.org/plugin/firstpromoter.0.3.6.zip) * [Details](https://ast.wordpress.org/plugins/firstpromoter/#description) * [Reviews](https://ast.wordpress.org/plugins/firstpromoter/#reviews) * [Installation](https://ast.wordpress.org/plugins/firstpromoter/#installation) * [Development](https://ast.wordpress.org/plugins/firstpromoter/#developers) [Support](https://wordpress.org/support/plugin/firstpromoter/) ## Description FirstPromoter for WordPress allows you to easily integrate FirstPromoter’s affiliate tracking scripts with your WordPress website. With this plugin, you can track referrals, registrations, and sales across your website, with special integrations for popular platforms. #### Features * Add FirstPromoter tracking to your WordPress site * WooCommerce integration – track new account registrations and checkouts * OptimizePress integration – track form submissions * Contact Form 7 integration – track form submissions with email capture * MemberPress integration – track member signups, transactions, and recurring payments * Custom Form Tracking – track email submissions from any form using CSS selectors * URL Email Capture – capture referrals from thank you pages where the email is in the URL * Payment Links – automatically append the FirstPromoter tracking ID to payment links on your pages * Cross-domain tracking support * Automatically send sales data to FirstPromoter (WooCommerce, MemberPress) * Automatic refund and cancellation tracking (WooCommerce) * Track recurring subscription payments (MemberPress) * Force tracking bypass for privacy browsers and ad-blockers #### WooCommerce Integration When enabled, the WooCommerce integration allows you to: * Capture emails when users create new accounts * Capture emails at checkout * Automatically send sale information to FirstPromoter * Track refunds and generate negative commissions * Track order cancellations and update customer status #### OptimizePress Integration The OptimizePress integration tracks form submissions and captures emails for referral tracking. #### Contact Form 7 Integration When enabled, the Contact Form 7 integration allows you to: * Track form submissions automatically (all forms tracked) * Capture email addresses from any field containing “email” in its name * Attribute form leads to the correct referral source * **Requires API key** – uses server-side tracking #### MemberPress Integration When enabled, the MemberPress integration allows you to: * Track new member signups and registrations (always enabled) * Automatically send transaction data to FirstPromoter (requires API key) * Track recurring subscription payments (requires API key) * Associate members with their referral source * API sale tracking uses prefixed user IDs (“mepr-“) to prevent conflicts **Important**: If you’re using FirstPromoter’s Stripe integration, only enable signup tracking. Leave sale tracking OFF to avoid duplicate sales. #### Custom Form Tracking When enabled, the Custom Form Tracking integration allows you to: * Track email submissions from any form on your site — no plugin dependency required * Works with any form builder, custom HTML forms, or dynamically loaded popups * Configure CSS selector pairs: one for the email input, one for the submit button or form element * Supports multiple forms with separate selector pairs * Uses MutationObserver to handle dynamically loaded forms (popups, AJAX-injected content) * AJAX fallback for ad-blocker bypass when force tracking is enabled #### URL Email Capture When enabled, the URL Email Capture integration allows you to: * Track referrals from thank you pages where the email is passed as a URL query parameter * Useful when your checkout, funnel, or external platform redirects to a confirmation page with the customer’s email in the URL (e.g. `/thank-you?email=user@example. com`) * Configure the URL parameter key for the email (e.g. `email`) * Optionally configure a second parameter key for the user ID (e.g. `uid`) * No plugin dependency required — works on any WordPress page #### Payment Links When enabled, the Payment Links integration allows you to: * Automatically append the FirstPromoter tracking ID to payment links on your pages as the `client_reference_id` parameter * Works with Stripe `buy.stripe.com` links, custom Stripe checkout domains, or any direct payment URL * Configure the URL prefix to match — defaults to `https://buy.stripe.com/`, supports comma-separated multiple prefixes * Uses MutationObserver to handle dynamically added links (popups, AJAX-injected content) * No plugin dependency required — works on any WordPress page ### Configuration After activation, you’ll find a new menu item in your WordPress admin dashboard labeled “FirstPromoter”. #### Base Configuration 1. Navigate to the FirstPromoter settings page in your WordPress admin 2. Enter your FirstPromoter Account ID (required) 3. Enter your API key (required for most integrations – see below) 4. If you want to track across multiple domains, enter them in the Cross Domain field, separated by commas 5. Click “Save” to store your settings #### API Key Requirements The FirstPromoter API key is **required** for the following features: * Contact Form 7 integration (all tracking) * WooCommerce sale tracking * MemberPress sale tracking * MemberPress recurring payment tracking The following features work **without** an API key: * WooCommerce signup tracking * WooCommerce checkout email capture * OptimizePress integration * MemberPress signup tracking (without sales) You can find your API key in your FirstPromoter dashboard: Settings > Integrations > Manage API keys #### Integration Settings The plugin supports multiple types of integrations: 1. **WooCommerce Integration**: Track new account registrations and checkouts 2. **OptimizePress Integration**: Track form submissions 3. **Contact Form 7 Integration**: Track contact form submissions with email capture 4. **MemberPress Integration**: Track member signups, transactions, and recurring payments 5. **Custom Form Tracking**: Track email submissions from any form using CSS selectors 6. **URL Email Capture**: Capture referrals from thank you pages where the email is in the URL 7. **Payment Links**: Automatically append the tracking ID to payment links on your pages Enable the integrations that apply to your website and configure their specific settings. ### External Services This plugin connects to FirstPromoter’s external services to provide affiliate and referral tracking functionality. It’s essential for the plugin’s operation to track referrals, registrations, and sales. #### FirstPromoter Tracking Service **What it is:** FirstPromoter’s affiliate tracking platform that monitors referral activity and conversions. **What data is sent:** – Email addresses (for referral tracking) – User IDs (when available) – Order information including amount, order ID, and coupon codes (when WooCommerce sales tracking is enabled) – Page visit information for referral attribution **When data is sent:** – Every time a page loads (for referral attribution via JavaScript tracking) – When users register or create accounts (if integration is enabled) – When purchases are completed (if WooCommerce integration is enabled) – When custom tracking events are triggered **Service provider:** FirstPromoter (https://firstpromoter.com) – Terms of Service: https://firstpromoter.com/terms – Privacy Policy: https://firstpromoter.com/privacy– API Documentation: https://docs.firstpromoter.com/api-reference-v2/ #### FirstPromoter CDN Service **What it is:** Content delivery network that serves the FirstPromoter tracking JavaScript library. **What data is sent:** Standard web request data (IP address, user agent, referrer) **When data is sent:** On every page load where tracking is active **Service details:** – CDN URL: https://cdn.firstpromoter.com/fpr.js – v2 API Endpoints: https://api.firstpromoter.com/api/v2/track/* – This is required for the tracking functionality to work ### Technical Details This plugin works by adding the FirstPromoter tracking script to your website and handling various trigger points for tracking registrations, checkouts, and custom events. The plugin: 1. Adds the base FirstPromoter tracking script to all pages 2. Captures and tracks user emails at registration and checkout (when enabled) 3. Supports cross-domain tracking 4. Can send WooCommerce sales data directly to FirstPromoter’s API ## Screenshots * [[ * FirstPromoter settings page ## Installation 1. Upload the plugin files to the `/wp-content/plugins/firstpromoter` directory, or install the plugin through the WordPress plugins screen 2. Activate the plugin through the ‘Plugins’ screen in WordPress 3. Use the FirstPromoter menu item in your admin sidebar to configure the plugin ## FAQ ### Where do I find my FirstPromoter Account ID? You can find your Account ID in your FirstPromoter dashboard under Settings > Integrations. ### Where do I find my FirstPromoter API key? You can find your API key in your FirstPromoter dashboard under Settings > Integrations > Manage API keys. You can use an existing key or create a new one for this WordPress integration. ### Which features require an API key? API key is required for: Contact Form 7 (all tracking), WooCommerce sale tracking, MemberPress sales and recurring payments. Basic signup/email tracking for WooCommerce, OptimizePress, and MemberPress works without an API key. ### Does this work with other plugins? The plugin has specific integrations for WooCommerce, OptimizePress, Contact Form 7, and MemberPress. The Custom Form Tracking and URL Email Capture integrations work with any platform — no additional plugin required. ### How do I use Payment Links? Enable the “Payment Links” integration. By default it targets all `https://buy.stripe. com/` links on your pages. If you use a custom Stripe domain or a different payment provider, enter your URL prefix in the Payment Link URL Prefix field. You can enter multiple prefixes separated by commas. The plugin will automatically append `?client_reference_id ={tid}` to every matching link as soon as the link appears in the DOM and the FirstPromoter tracking ID is available. ### How do I use URL Email Capture? Enable the “URL Email Capture” integration and enter the URL parameter name that contains the email on your thank you page. For example, if your thank you page URL looks like `/thank-you?email=user@example.com`, enter `email` in the Email URL Parameter Key field. Optionally enter a second parameter name for the user ID. ### What information is sent to FirstPromoter? When tracking is enabled, the plugin sends: – Email addresses (for referral tracking)– User IDs (when available) – Order information (when WooCommerce sales tracking is enabled) ### Is cross-domain tracking supported? Yes, you can enable cross-domain tracking in the Base Configuration settings. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “FirstPromoter” is open source software. The following people have contributed to this plugin. Contributors * [ FirstPromoter ](https://profiles.wordpress.org/maxwellfp/) [Translate “FirstPromoter” into your language.](https://translate.wordpress.org/projects/wp-plugins/firstpromoter) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/firstpromoter/), check out the [SVN repository](https://plugins.svn.wordpress.org/firstpromoter/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/firstpromoter/) by [RSS](https://plugins.trac.wordpress.org/log/firstpromoter/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.3.6 * Fixed: OptimizePress integration now always appears in settings regardless of plugin detection — resolves issue where OptimizePress 3.x users could not see the option #### 0.3.5 * Improved: Custom Form Tracking admin UI now shows labels (“Email Input” / “Submit Button”) on selector fields for clarity * Fixed: Removed spurious console.warn when no custom forms are configured (script is never loaded in that case anyway) #### 0.3.4 * New: Payment Links integration — automatically append FirstPromoter tracking ID to payment links as `client_reference_id` * Supports Stripe buy.stripe.com links, custom checkout domains, or any direct payment URL prefix * Configurable URL prefix field with comma-separated support for multiple prefixes * Uses MutationObserver to handle dynamically added links (popups, AJAX content) with no fixed timeouts #### 0.3.3 * Fixed: URL capture now uses filter_input( INPUT_SERVER ) instead of direct $_SERVER access, resolving WordPress coding standards warnings without suppression comments * Fixed: Inline script for URL param capture refactored to use wp_json_encode() and pure JS conditionals, eliminating unescaped output warnings #### 0.3.2 * Improved: URL capture JS now uses decodeURI + new URL() for robust param parsing, window.fpr guard, and setInterval readyState check to ensure the FP library is loaded before calling fpr(“referral”, …) #### 0.3.1 * New: URL Email Capture integration — capture referrals from thank you pages where the email (and optionally a user ID) is passed as a URL query parameter * Configurable parameter key names for both email and UID #### 0.3.0 * New: Custom Form Tracking integration — track email submissions from any form using CSS selectors * Supports multiple form selector pairs (email input + submit element) * MutationObserver support for dynamically loaded forms (popups, AJAX content) * Server-side AJAX fallback for ad-blocker bypass when force tracking is enabled * Admin repeater UI for managing form selectors * Removed Guzzle dependency – replaced with WordPress native wp_remote_post() for all API calls * Lowered PHP requirement from 7.2 to 5.6 for broader hosting compatibility * Fixed: AJAX fallback handler now registers once instead of per-integration * Fixed: WooCommerce double-tracking on checkout (track_checkout and order_payment_successful both calling track_referral) * Fixed: OptimizePress JS crash when button element not found in form * Fixed: Removed IE-only window.attachEvent from OptimizePress integration * Fixed: setcookie now includes SameSite attribute for modern browser compatibility * Improved: Centralized API request handling via api_post() helper method * Improved: Consolidated debug logging via log() helper to reduce boilerplate * Improved: All API methods now return false on failure instead of exception objects * Removed dead track_registration() method from WooCommerce integration * Removed redundant cross-domain setting check #### 0.2.1 * Fixed: Comprehensive error handling to prevent API failures from breaking payments * Fixed: All FirstPromoter API calls now fail gracefully when API credentials are missing or invalid * Improved: Enhanced error logging for debugging API issues without affecting store functionality #### 0.2.0 * New: Contact Form 7 integration – track form submissions with automatic email capture * New: MemberPress integration – track member signups, transactions, and recurring payments * Improved: Plugin now supports tracking across multiple membership and form plugins * Enhanced: Admin settings page now dynamically shows available integrations based on installed plugins #### 0.1.1 * Fixed: WooCommerce integration checkbox settings not saving properly * Fixed: Email capture not working during WooCommerce checkout * Fixed: Sale tracking API calls not being made when only sale tracking was enabled( without email capture) * Fixed: Sale tracking now works with both ‘processing’ and ‘completed’ order statuses * Fixed: Server-side API tracking now properly uses fallback cookies when ad blockers are active * Improved: Referral tracking script injection to work with late-stage WordPress hooks * Improved: Added duplicate sale prevention to avoid tracking the same order multiple times * Improved: Comprehensive debug logging for troubleshooting API calls and tracking issues #### 0.1 * Initial release * FirstPromoter v2 API integration with Bearer token authentication * WooCommerce integration – track registrations, checkouts, refunds, and cancellations * OptimizePress integration – track form submissions * Cross-domain tracking support * Enhanced security with proper nonce verification * Automatic refund and cancellation tracking ## Meta * Version **0.3.6** * Last updated **1 mes ago** * Active installations **10+** * WordPress version ** 5.0 or higher ** * Tested up to **6.9.4** * PHP version ** 5.6 or higher ** * Language * [English (US)](https://wordpress.org/plugins/firstpromoter/) * Tags * [affiliate](https://ast.wordpress.org/plugins/tags/affiliate/)[marketing](https://ast.wordpress.org/plugins/tags/marketing/) [memberpress](https://ast.wordpress.org/plugins/tags/memberpress/)[referral tracking](https://ast.wordpress.org/plugins/tags/referral-tracking/) [woocommerce](https://ast.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://ast.wordpress.org/plugins/firstpromoter/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/firstpromoter/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/firstpromoter/reviews/) ## Contributors * [ FirstPromoter ](https://profiles.wordpress.org/maxwellfp/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/firstpromoter/)