提交Contact Form 7表单后如何修改WordPress已登录用户的角色

核心排查点 #

• 确认表单ID匹配：你当前代码判断的表单ID是2368，请进入WordPress后台→Contact→Contact Forms，查看对应表单短代码中的id参数值，确认是否为2368，不要误填表单所在页面的ID
• 确认paid角色存在：WordPress默认无paid用户角色，若未提前注册该角色，角色赋值会静默失败。可临时在主题functions.php中添加代码print_r(wp_roles()->get_names());查看所有已注册角色的slug，确认paid存在且拼写完全正确
• 检查权限拦截：若站点安装了角色管理、权限控制类插件（如Members、User Role Editor），需确认当前执行的操作有权限修改用户角色
• 排除缓存干扰：站点如果开启了对象缓存、用户信息缓存，修改后前端可能不会立刻同步状态，可直接在后台用户列表确认角色是否更新

优化后代码 #

function wpcf7_before_send_mail_function( $contact_form, $abort, $submission ) {
    // 提前过滤非目标表单，减少无效逻辑执行
    if ( $contact_form->id() !== 2368 ) {
        return $contact_form;
    }

    if ( !is_user_logged_in() ) {
        return $contact_form;
    }

    $user = wp_get_current_user();
    // 避免重复修改已符合要求的用户角色
    if ( in_array( 'paid', $user->roles ) ) {
        return $contact_form;
    }

    // 使用WP_User原生set_role方法修改角色，兼容性和稳定性优于wp_update_user传role参数
    $user->set_role( 'paid' );

    return $contact_form;
}
add_action( 'wpcf7_before_send_mail', 'wpcf7_before_send_mail_function', 10, 3 );

若需调试可在set_role代码后加日志输出error_log( '用户' . $user->ID . '已修改角色为paid' );，后续可通过查看站点PHP错误日志确认代码是否正常触发执行。

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