如何处理WordPress插件的用户保存设置并解决'test_plugin_options不在允许选项列表'的报错

咱做WordPress插件开发的时候，经常会碰到这个报错，本质就是WordPress的安全拦截机制在起作用——它为了防止恶意提交未授权的选项，只允许通过官方设置API注册过的选项被保存。你的test_plugin_options没被正确加入允许列表，自然就触发这个提示了。

别慌，按下面的步骤一步步排查修复就行：

1. 必须用register_setting()注册你的选项 #

这是最核心的一步，你得在admin_init钩子里调用这个函数，把test_plugin_options正式注册到WordPress的允许列表里，同时还要指定一个输入验证的回调函数（安全要求，不能省）。

给你个示例代码，直接套用到你的插件里就行：

// 绑定admin_init钩子，在后台初始化时注册设置
add_action('admin_init', 'test_plugin_register_settings');

function test_plugin_register_settings() {
    // 三个关键参数：选项组名、要保存的选项名、输入清理回调
    register_setting(
        'test_plugin_options_group', // 这个组名要和后面表单里的settings_fields对应
        'test_plugin_options',       // 就是你报错里的那个选项名
        'test_plugin_sanitize_user_input' // 用来验证、清理用户输入的函数
    );
}

// 示例：输入清理函数，一定要做验证，避免恶意输入
function test_plugin_sanitize_user_input($input) {
    $cleaned_data = array();
    // 假设你有一个叫'custom_title'的设置项，这里做文本清理
    if (isset($input['custom_title'])) {
        $cleaned_data['custom_title'] = sanitize_text_field($input['custom_title']);
    }
    // 如果有其他设置项，照着上面的格式加就行
    return $cleaned_data;
}

2. 确保设置页面的表单用对了函数 #

在你输出插件设置页面的表单时，必须用WordPress提供的settings_fields()函数，不能自己瞎写表单字段，不然安全验证通不过。

示例表单代码：

// 这是你的设置页面输出函数
function test_plugin_render_settings_page() {
    ?>
    <div class="wrap">
        <h1>我的插件设置</h1>
        <form method="post" action="options.php">
            <?php
            // 输出WordPress的安全验证字段，参数是你注册时用的选项组名
            settings_fields('test_plugin_options_group');
            // 输出你之前添加的设置节和字段（如果有的话）
            do_settings_sections('test_plugin_settings_page');
            // 提交按钮
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

这里要注意：settings_fields()的参数必须和你register_setting()里的第一个参数（选项组名）完全一致，差一个字符都不行！

3. 排查常见的小坑 #

• 别漏加admin_init钩子：很多新手写完注册函数，忘了绑定到admin_init上，导致注册代码根本没执行，自然选项没被加入允许列表。
• 不要绕过设置API：别图省事直接用update_option()在表单提交时保存数据，这种方式既不安全，也会触发WordPress的安全拦截。
• 检查选项名拼写：确保你在所有地方用的都是test_plugin_options，别一会儿写成test_plugin_option（少个s），拼写错误是最容易犯的低级错误。

按照上面的步骤改完，再去点击保存按钮，这个报错应该就消失了。

内容来源于stack exchange