Affiliate Link Injector WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Automatically appends affiliate tracking parameters to links targeting specific domains across all WordPress content contexts.

Features

• Rule-based injection - Define rules by target domain with query params (?ref=123) or path format (/ref/123)
• Universal content support - Works with Gutenberg blocks, Bricks Builder, Classic Editor, widgets, comments, excerpts, and REST API responses
• Smart duplicate detection - Prevents double-appending of affiliate parameters
• Subdomain matching - Optionally match subdomains (e.g., docs.example.com)
• Path exclusions - Skip specific paths from injection
• Modern admin UI - React-based rule management with inline editing

Requirements

• WordPress 6.2+
• PHP 8.0+

Installation

Via GitHub Release

1. Download the latest release zip from Releases
2. Upload to WordPress via Plugins → Add New → Upload Plugin
3. Activate the plugin

Via Git Updater

This plugin supports Git Updater for automatic updates.

Configuration

Navigate to Settings → Affiliate Links to manage rules.

Rule Options

Example Rules

Query format:

• Domain: example.com
• Format: query
• Params: ref=123
• Result: https://example.com/page → https://example.com/page?ref=123

Path format:

• Domain: example.com
• Format: path
• Path: ref/456
• Result: https://example.com/page → https://example.com/ref/456/page

REST API

The plugin exposes a REST API at /wp-json/affiliate-link-injector/v1/:

Hooks

Skip Processing

add_filter( 'affiliate_link_injector/skip_processing', function( $skip ) {
    // Skip on specific pages
    if ( is_page( 'no-affiliate' ) ) {
        return true;
    }
    return $skip;
});

Exclude Links by Class

Add the class no-affiliate to any link to exclude it from processing:

<a href="https://example.com" class="no-affiliate">Not tracked</a>

Development

Run Tests

# PHP Unit Tests
composer install
TEST_TYPE=unit ./vendor/bin/phpunit

# JavaScript Tests
npm install
npm test

# PHPCS
./vendor/bin/phpcs

Build Admin UI

npm install
npm run build

Changelog

See CHANGELOG.md for version history.

License

GPL-2.0-or-later