WordPress插件设置页表单提交后执行操作的正确方法

问题背景 #

我正在开发一款WordPress插件，已经在插件设置页面添加了表单，希望点击「保存更改」按钮提交表单后执行特定操作。尝试过用isset()函数检测POST参数，但没有效果。以下是我的表单代码：

<div class="wrap">
    <div id="icon-themes" class="icon32"></div>
    <h2>My Settings</h2>
    <?php settings_errors();
    if (isset($_POST['form_submitted'])) {
        echo '<script>alert("Hello World")</script>';
    } ?>
    <form method="POST" action="options.php">
        <?php
        settings_fields('my_general_settings');
        do_settings_sections('my_general_settings');
        ?>
        <?php submit_button(); ?>
        <input type="hidden" name="form_submitted" value="1">
    </form>
</div>

为什么原方法无效 #

你的代码不生效的核心原因是：表单提交到options.php后，WordPress处理完设置保存逻辑，会通过重定向跳回原设置页面。重定向后是GET请求，原POST请求的所有参数（包括form_submitted）都会丢失，所以isset($_POST['form_submitted'])永远不会触发。

正确实现方式 #

方法1：使用WordPress内置钩子（推荐） #

WordPress提供了多个与设置保存相关的钩子，能精准捕获设置提交事件，避免依赖URL参数。

方式A：监听特定设置组的提交

通过admin_init钩子检查是否是你的设置表单提交，然后执行操作：

add_action('admin_init', 'my_handle_settings_submit');
function my_handle_settings_submit() {
    // 验证是否是目标设置表单的提交请求
    if (isset($_POST['option_page'], $_POST['action']) 
        && $_POST['option_page'] === 'my_general_settings' 
        && $_POST['action'] === 'update') {
        
        // 这里执行你的自定义操作，比如：
        // 1. 添加后台通知
        add_action('admin_notices', function() {
            echo '<div class="notice notice-success is-dismissible"><p>设置已保存，自定义操作执行完成！</p></div>';
        });
        
        // 2. 调用API、更新其他选项、执行数据库操作等
        // my_custom_function();
    }
}

方式B：监听单个选项的更新

如果只需针对某个特定选项的变更执行操作，可以用update_option_{option_name}钩子：

// 替换my_specific_option为你实际的选项名
add_action('update_option_my_specific_option', 'my_after_option_update', 10, 3);
function my_after_option_update($old_value, $new_value, $option) {
    // 当my_specific_option被更新时执行逻辑
    // 比如对比新旧值，执行对应操作
    if ($old_value !== $new_value) {
        // do something
    }
}

方法2：检查settings-updated GET参数 #

设置保存成功后，WordPress会重定向回设置页面，并在URL中添加?settings-updated=true参数，你可以直接检测这个参数来执行操作：

<div class="wrap">
    <div id="icon-themes" class="icon32"></div>
    <h2>My Settings</h2>
    <?php settings_errors(); ?>
    
    <?php
    // 检测设置更新后的重定向参数
    if (isset($_GET['settings-updated']) && $_GET['settings-updated'] === 'true') {
        // 执行自定义操作，比如弹出提示
        echo '<script>alert("设置已保存，执行自定义操作！");</script>';
        // 或者添加后台通知
        echo '<div class="notice notice-success is-dismissible"><p>设置已保存，完成自定义操作！</p></div>';
    }
    ?>
    
    <form method="POST" action="options.php">
        <?php
        settings_fields('my_general_settings');
        do_settings_sections('my_general_settings');
        ?>
        <?php submit_button(); ?>
    </form>
</div>

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