WordPress add_meta_box参数异常 自定义元框字段值保存失败

1. 文章列表/快速编辑页面的screen参数 #

所有展示文章列表、支持快速编辑的管理页面，screen ID规则统一为 edit-{post_type}：

• 默认文章（post）的列表页screen参数为 edit-post
• 自定义文章类型works的列表页screen参数为 edit-works
  如果要给快速编辑模块加字段，挂载对应逻辑时直接用对应screen ID即可。

2. 元框字段保存失败的修复 #

你的代码存在3个直接导致保存失败/显示异常的问题，逐一修正即可：

• 核心错误：表单字段名与保存逻辑的键名不匹配。select表单的name属性值为typechild2022_field（下划线分隔），但保存函数中判断$_POST是否存在字段时，写的键名是typechild2022-field（中划线分隔），判断条件永远不成立，字段值不会触发保存逻辑。
• 选项匹配错误：第三个状态选项的value属性写的是In-Progress，但selected()判断用的值是In Progress，二者不一致会导致该选项选中状态无法正常回显。
• 缺失必要校验：保存逻辑没有加nonce安全校验、用户权限判断，也没有排除自动保存、修订版本的场景，存在安全隐患，也可能在非编辑提交场景触发异常。

修正后的完整代码 #

// 注册元框
function add_custom_box() {
    $screens = ["works", "post"]; 
    foreach ( $screens as $screen ) {
        add_meta_box(
            'book-status',
            'Book Status',
            'custom_box_html',
            $screen,
            'side',
            'high' // 可配置优先级，固定侧边栏靠前显示位置
        );
    }
}
add_action( 'add_meta_boxes',  'add_custom_box' );

// 元框渲染回调
function custom_box_html( $post ) {
    // 输出安全校验nonce字段
    wp_nonce_field( 'save_book_status', 'book_status_nonce' );
    $value = get_post_meta( $post->ID, '_wporg_meta_key', true );
    ?>  
    <label for="typechild2022-field"> 
        <?php esc_html_e('Select Book Status', 'typechild2022'); ?> 
    </label>
    <select name="typechild2022_field" id="typechild2022-field" class="postbox"> 
        <option value="Select" <?php selected($value, "Select"); ?> >
            <?php esc_html_e("Select", 'typechild2022'); ?>
        </option>
        <option value="Published" <?php selected($value, "Published"); ?> >
            <?php esc_html_e("Published", 'typechild2022'); ?>
        </option>
        <!-- 统一value值和selected判断的参数 -->
        <option value="In Progress" <?php selected($value, "In Progress"); ?> >
            <?php esc_html_e("In Progress", 'typechild2022'); ?>
        </option>
    </select>
    <?php
}

// 保存元数据逻辑
function wporg_save_postdata( $post_id ) {
    // 校验nonce合法性
    if ( !isset( $_POST['book_status_nonce'] ) || !wp_verify_nonce( $_POST['book_status_nonce'], 'save_book_status' ) ) {
        return;
    }
    // 跳过自动保存触发的逻辑
    if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
        return;
    }
    // 校验当前用户是否有对应文章的编辑权限
    if ( !current_user_can( 'edit_post', $post_id ) ) {
        return;
    }
    // 字段名和表单name属性完全对齐
    if ( array_key_exists( 'typechild2022_field', $_POST ) ) {
        update_post_meta(
            $post_id,
            '_wporg_meta_key',
            sanitize_text_field( $_POST['typechild2022_field'] ) // 对输入内容做安全清洗，避免非法数据入库
        );
    }
}
add_action( 'save_post', 'wporg_save_postdata' );

补充说明：之前遇到的side上下文在自定义文章类型下不生效的问题，除PHP版本过低导致参数顺序解析错误外，也可以在注册CPT时确认supports配置是否开启了editor支持，部分自定义CPT如果没开启编辑器侧边栏组件支持，也会导致元框默认落到编辑器底部区域。

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