WordPress文章发布框添加自定义复选框出现PHP警告如何修复

• 核心报错是因为你在add_action中传入回调函数名时没有加引号，PHP会将未加引号的字符识别为常量，找不到对应常量就会抛出你收到的警告
• 另外代码还存在一个隐藏bug：保存逻辑中判断的POST字段名和表单实际提交的字段名不一致，会导致勾选状态无法正常存储

///////////// ADD WATERMARK CHECK BOX TO TOOLS POST ////////////////
// 函数声明提前，避免调用时未定义
function createCheckBoxField()
{
    $post_id = get_the_ID();

    if (get_post_type($post_id) != 'tools' ) {
        return;
    }

    $value = get_post_meta($post_id, 'watermark_chk-box', true);
    wp_nonce_field('my_custom_nonce_'.$post_id, 'my_custom_nonce');
    ?>
    <div class="misc-pub-section misc-pub-section-last">
        <label><input type="checkbox" value="1" <?php checked($value, true, true); ?> name="watermark_chk-box" /><?php _e('Watermark Images', 'pmg'); ?></label>
    </div>
    <?php
}

function saveCustomField($post_id)
{
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }

    if (
        !isset($_POST['my_custom_nonce']) ||
        !wp_verify_nonce($_POST['my_custom_nonce'], 'my_custom_nonce_'.$post_id)
    ) {
        return;
    }

    if (!current_user_can('edit_post', $post_id)) {
        return;
    }
    // 修正字段名和表单保持一致
    if (isset($_POST['watermark_chk-box'])) {
        update_post_meta($post_id, 'watermark_chk-box', $_POST['watermark_chk-box']);
    } else {
        delete_post_meta($post_id, 'watermark_chk-box');
    }
}

// 回调函数名加单引号，改为字符串格式
add_action('post_submitbox_misc_actions', 'createCheckBoxField');
add_action('save_post', 'saveCustomField');

改动说明：

1. 给add_action的两个回调函数名加上单引号，修复常量未定义的警告
2. 修正saveCustomField函数中POST读取的字段名，和表单的name属性保持一致，解决勾选状态无法保存的问题
3. 将函数声明调整到钩子注册之前，符合PHP代码执行逻辑，避免出现函数未定义的额外错误

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