WordPress Contact Form 7复选框未匹配指定值时的自定义邮箱验证问题

原有逻辑存在3个核心问题导致无法实现预期效果：

• 数据类型错误：Contact Form 7 的复选框字段无论是否加exclusive参数，提交时$_POST['checkbox-999']默认返回数组类型，原代码直接对数组执行trim()、字符串全等判断，逻辑完全失效。
• 缺少钩子挂载：校验函数没有挂载到CF7官方的wpcf7_validate校验钩子上，代码不会在表单提交时被触发执行。
• 兼容性与依赖问题：对$tag重复实例化WPCF7_Shortcode不符合CF7高版本的开发规范，同时如果is_business_email函数未提前实现，会直接触发PHP致命错误。

以下代码可直接放到主题functions.php文件或自定义代码片段中生效：

// 挂载校验函数到CF7校验钩子，优先级10，接收2个参数
add_filter('wpcf7_validate', 'custom_email_validation_filter', 10, 2);
function custom_email_validation_filter($result, $tag) {
    $target_email_field = 'email-799';
    $target_checkbox_field = 'checkbox-999';
    $freelancer_option_value = "I'm a freelancer";

    // 仅处理目标邮箱字段的校验，其他字段直接返回原有校验结果
    if ($target_email_field !== $tag->name) {
        return $result;
    }

    // 读取复选框选中值，因加了exclusive参数只能选一个，直接判断值是否在数组内即可
    $selected_checkbox = isset($_POST[$target_checkbox_field]) ? $_POST[$target_checkbox_field] : [];
    $is_freelancer = in_array($freelancer_option_value, $selected_checkbox);

    // 未选中自由职业者选项时，触发企业邮箱校验
    if (!$is_freelancer) {
        $email_value = isset($_POST[$target_email_field]) ? trim($_POST[$target_email_field]) : '';
        // 若is_business_email未实现，可替换为下方的示例校验逻辑
        if (!is_business_email($email_value)) {
            $result->invalidate($tag, "Please enter a valid business email");
        }
    }

    return $result;
}

如果还未实现is_business_email业务邮箱校验逻辑，可参考以下简易实现（排除公共邮箱后缀，可按需调整黑名单）：

function is_business_email($email) {
    // 公共邮箱后缀黑名单，可自行补充
    $public_domains = [
        'gmail.com', 'yahoo.com', 'hotmail.com', 'outlook.com', 'qq.com', '163.com'
    ];
    // 先校验邮箱格式合法性
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        return false;
    }
    $email_domain = strtolower(explode('@', $email)[1]);
    return !in_array($email_domain, $public_domains);
}

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