自定义WordPress插件settings_fields仅管理员可用，其他角色无法保存设置求助

这个问题的核心原因很明确：当你调用settings_fields('custom_options')时，WordPress默认会校验用户是否拥有manage_options权限——而这个权限只有管理员（admin）角色才默认具备，所以编辑（editor）或其他角色点击保存时会被系统拦截，出现你看到的权限提示。

下面是具体的解决方案，一步步来调整：

1. 注册设置时指定对应角色的权限 #

在你注册插件设置的register_setting()函数里，一定要添加capability参数，把默认的manage_options替换成目标角色已有的权限。比如编辑角色默认拥有edit_pages权限，你可以这样修改：

register_setting(
    'custom_options', // 要和你settings_fields里的设置组名称对应
    'custom_plugin_options', // 你的选项存储名称
    array(
        'type' => 'array',
        'sanitize_callback' => 'your_custom_sanitize_function', // 你的数据清洗函数
        'capability' => 'edit_pages', // 替换成目标角色具备的权限
        'default' => array()
    )
);

如果想更灵活，也可以自定义一个专属权限，再给目标角色添加这个权限：

// 插件激活时给编辑角色添加自定义权限
function custom_plugin_add_cap() {
    $editor_role = get_role('editor');
    $editor_role->add_cap('manage_custom_plugin_settings');
}
register_activation_hook(__FILE__, 'custom_plugin_add_cap');

// 注册设置时使用自定义权限
register_setting(
    'custom_options',
    'custom_plugin_options',
    array(
        'type' => 'array',
        'sanitize_callback' => 'your_custom_sanitize_function',
        'capability' => 'manage_custom_plugin_settings',
        'default' => array()
    )
);

2. 确保设置页面的访问权限匹配 #

如果你是通过add_options_page()或类似函数添加插件设置页面的，也要把页面的权限参数改成和上面一致的内容，不然用户连设置页面都打不开：

add_options_page(
    '自定义插件设置', // 页面标题
    '我的插件设置', // 后台菜单显示名称
    'edit_pages', // 这里的权限要和注册设置时的capability一致
    'custom-plugin-settings', // 菜单唯一标识slug
    'your_settings_page_render_function' // 渲染页面的回调函数
);

3. 手动校验权限（可选兜底） #

如果还是遇到问题，可以在保存逻辑前手动添加权限检查，确保流程万无一失：

function custom_plugin_save_check() {
    if (!current_user_can('edit_pages')) {
        wp_die('Sorry, you are not allowed to manage these options.');
    }
    // 这里写你的自定义保存逻辑（如果有的话）
}
add_action('admin_init', 'custom_plugin_save_check');

按照上面的步骤调整后，编辑角色（或其他你指定的角色）就能正常访问并保存插件设置了。

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