本文详解如何在 woocommerce 外部产品链接中，根据目标域名自动追加对应联盟 id（如 sitea.com → ?affiliateid-1，siteb.com → ?affiliateid-2），通过 woocommerce_product_add_to_cart_url 钩子实现精准、可扩展的多联盟路由逻辑。
本文详解如何在 woocommerce 外部产品链接中，根据目标域名自动追加对应联盟 id（如 sitea.com → ?affiliateid-1，siteb.com → ?affiliateid-2），通过 woocommerce_product_add_to_cart_url 钩子实现精准、可扩展的多联盟路由逻辑。
在 WooCommerce 中，外部产品（External/Affiliate Product）的「加入购物车」按钮实际跳转至第三方联盟网站。为追踪推广效果，需为不同合作平台动态拼接专属联盟参数（如 ?affiliateID-1）。原方案仅支持单一域名硬编码，而真实业务常需对接多个联盟渠道（例如 Facebook、Microsoft、Amazon 等），此时需基于 URL 域名智能匹配并注入对应参数。
核心思路是：在 woocommerce_product_add_to_cart_url 过滤器中，先判断产品类型是否为 external，再使用字符串匹配（推荐 parse_url() + str_ends_with() 或 str_starts_with()）精准识别目标域名，避免误判子路径或协议差异。以下为生产就绪的优化代码：
add_filter( 'woocommerce_product_add_to_cart_url', 'custom_product_add_to_cart_url', 20, 2 );
function custom_product_add_to_cart_url( $add_to_cart_url, $product ) {
// 仅处理外部产品
if ( ! $product->is_type( 'external' ) ) {
return $add_to_cart_url;
}
// 解析 URL 主机名（兼容 http/https/www/non-www）
$parsed = parse_url( $add_to_cart_url );
if ( ! $parsed || ! isset( $parsed['host'] ) ) {
return $add_to_cart_url;
}
$host = strtolower( $parsed['host'] );
// 定义联盟规则：域名 → 参数后缀
$affiliate_rules = [
'facebook.com' => '?affiliateID-1',
'microsoft.com' => '?affiliateID-2',
'amazon.com' => '?ref=yourstore-20',
'example-affiliate.net' => '?utm_source=wc&utm_medium=affiliate',
];
// 匹配并追加参数（支持精确主机名匹配）
foreach ( $affiliate_rules as $domain => $param ) {
if ( $host === $domain || $host === 'www.' . $domain ) {
// 若原 URL 已含查询参数，用 & 连接；否则用 ? 开头
$separator = ( false !== strpos( $add_to_cart_url, '?' ) ) ? '&' : '?';
return $add_to_cart_url . $separator . ltrim( $param, '?' );
}
}
// 未匹配时保持原始链接（不添加任何参数）
return $add_to_cart_url;
}✅ 关键优势说明：
- 域名精准匹配：使用 parse_url() 提取 host，规避路径干扰（如 siteA.com/product/123 仍能正确识别）；
- 大小写与 www 兼容：统一转为小写，并支持 www. 前缀变体；
- 参数安全拼接：自动检测 URL 是否已含 ?，避免重复问号导致参数失效；
- 高可维护性：联盟规则集中定义在 $affiliate_rules 数组中，增删改无需修改逻辑；
- 健壮性保障：对无效 URL 提前返回，防止解析异常中断流程。
⚠️ 注意事项：
- 请将代码添加至当前主题的 functions.php 文件末尾，或更推荐的方式是封装为独立插件（避免主题更新丢失）；
- 若联盟参数需包含特殊字符（如 /, #），务必使用 urlencode() 编码值部分；
- 测试时建议在无缓存环境（如隐身模式）下验证生成链接，排除浏览器或 CDN 缓存影响；
- 对于需要 HTTPS 强制跳转的联盟站，请确保原始产品链接已配置为 https://，否则可能触发混合内容警告。
通过该方案，您可轻松管理数十个联盟渠道，且后续新增只需在数组中追加一行配置，真正实现「一次开发、长期复用、灵活扩展」的电商联盟运营自动化。
