如何让AffiliateWP中WPForms生成的推荐状态强制为pending？

问题分析 #

你之前使用的affiliate_wp_referral_status钩子可能存在时机或判断逻辑的问题：要么是钩子触发时WPForms的推荐状态已经被固定，要么是WPForms对应的context值并非wp-forms（实际可能是wpforms），导致条件判断不生效。另外，WPForms与AffiliateWP的集成有专属钩子，用它来修改状态会更精准。

正确代码实现 #

替换你之前的代码，使用WPForms专属钩子直接设置推荐状态：

<?php
// 针对WPForms生成的推荐，强制设置状态为pending
add_filter( 'affwp_wpforms_referral_args', 'custom_set_wpforms_referral_pending', 10, 3 );
function custom_set_wpforms_referral_pending( $args, $entry, $form ) {
    // 修改推荐状态为pending
    $args['status'] = 'pending';
    return $args;
}

代码说明 #

• 钩子affwp_wpforms_referral_args是WPForms集成AffiliateWP时的专属过滤钩子，只会在WPForms生成推荐时触发，不会影响WooCommerce等其他集成的推荐逻辑。
• 直接修改推荐创建时的参数，能确保状态在推荐生成之初就被设为pending，避免后续钩子覆盖。

验证步骤 #

1. 将代码添加到主题的functions.php文件，或使用代码片段插件（如Code Snippets）导入。
2. 通过WPForms提交表单触发推荐，查看AffiliateWP的推荐列表，确认状态为「pending」。
3. 测试WooCommerce订单，确认其推荐状态仍保持默认的「unpaid」。

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