WordPress站点捕获gclid等URL参数并传递至外部链接的技术问询

方案1：前端JavaScript实现（适配自定义HTML区块场景） #

直接在文章的自定义HTML区块或主题footer模板中添加以下代码，自动捕获URL中的gclid、utm_campaign、utm_content、utm_source等参数，并追加到页面所有外部链接上：

document.addEventListener('DOMContentLoaded', function() {
    // 定义需要传递的追踪参数列表
    const trackParams = ['gclid', 'utm_campaign', 'utm_content', 'utm_source', 'utm_medium', 'utm_term'];
    const currentHost = window.location.hostname;
    const urlParams = new URLSearchParams(window.location.search);
    const paramsToAppend = {};

    // 筛选URL中存在的目标参数
    trackParams.forEach(param => {
        if (urlParams.has(param)) {
            paramsToAppend[param] = urlParams.get(param);
        }
    });

    // 无参数则直接退出
    if (Object.keys(paramsToAppend).length === 0) return;

    // 遍历所有外部链接并追加参数
    document.querySelectorAll('a').forEach(link => {
        const linkUrl = new URL(link.href);
        if (linkUrl.hostname !== currentHost) {
            Object.keys(paramsToAppend).forEach(param => {
                if (!linkUrl.searchParams.has(param)) {
                    linkUrl.searchParams.append(param, paramsToAppend[param]);
                }
            });
            link.href = linkUrl.toString();
        }
    });
});

此方案无需PHP权限，完美解决自定义HTML区块无法执行PHP的问题。

方案2：后端WordPress过滤器实现 #

如果希望在内容输出时直接修改链接（无需前端JS处理），可在主题的functions.php中添加以下代码，通过the_content过滤器自动为内容中的外部链接追加追踪参数：

function append_tracking_params_to_external_links($content) {
    // 定义需要传递的追踪参数
    $track_params = ['gclid', 'utm_campaign', 'utm_content', 'utm_source', 'utm_medium', 'utm_term'];
    $current_host = $_SERVER['HTTP_HOST'];
    $params_to_append = [];

    // 收集当前URL中存在的目标参数
    foreach ($track_params as $param) {
        if (isset($_GET[$param])) {
            $params_to_append[$param] = sanitize_text_field($_GET[$param]);
        }
    }

    if (empty($params_to_append)) return $content;

    // 生成编码后的查询字符串
    $query_string = http_build_query($params_to_append);

    // 正则匹配并替换外部链接
    $content = preg_replace_callback('/<a\s+[^>]*href=["\']([^"\']+)["\'][^>]*>/i', function($matches) use ($current_host, $query_string) {
        $link_url = $matches[1];
        // 跳过相对链接和内部链接
        if (strpos($link_url, 'http') !== 0) return $matches[0];
        
        $parsed_url = parse_url($link_url);
        if (!isset($parsed_url['host']) || $parsed_url['host'] === $current_host) return $matches[0];

        // 追加参数（避免重复）
        $separator = strpos($link_url, '?') !== false ? '&' : '?';
        $new_link_url = $link_url . $separator . $query_string;

        return str_replace($link_url, $new_link_url, $matches[0]);
    }, $content);

    return $content;
}
add_filter('the_content', 'append_tracking_params_to_external_links');

该方案在内容输出阶段直接处理链接，无需前端干预，适合全站统一配置的场景。

自定义重写规则方案（备选） #

你提到的重写规则思路需要通过中间跳转页传递参数，操作成本较高，仅作为备选：

1. 在functions.php添加重写规则：

function add_external_redirect_rewrite_rule() {
    add_rewrite_rule('^external/(.*)$', 'index.php?external_url=$matches[1]', 'top');
}
add_action('init', 'add_external_redirect_rewrite_rule');

// 注册查询变量
function add_external_redirect_query_var($vars) {
    $vars[] = 'external_url';
    return $vars;
}
add_filter('query_vars', 'add_external_redirect_query_var');

2. 创建模板文件external-redirect.php，解码并跳转外部链接：

<?php
/**
 * Template Name: External Redirect
 */
$external_url = base64_decode(get_query_var('external_url'));
if (!empty($external_url)) {
    $track_params = ['gclid', 'utm_campaign', 'utm_content', 'utm_source', 'utm_medium', 'utm_term'];
    $params_to_append = [];
    foreach ($track_params as $param) {
        if (isset($_GET[$param])) {
            $params_to_append[$param] = sanitize_text_field($_GET[$param]);
        }
    }
    if (!empty($params_to_append)) {
        $separator = strpos($external_url, '?') !== false ? '&' : '?';
        $external_url .= $separator . http_build_query($params_to_append);
    }
    wp_redirect($external_url);
    exit;
}

3. 将文章中的外部链接替换为/external/[base64编码的外部URL]（例如/external/aHR0cHM6Ly93d3cuZXhhbXBsZS5jb20=对应https://www.example.com）。

内容的提问来源于stack exchange，提问作者Glen