WordPress自定义文章类型元框提交后数据未保存至数据库

错误点梳理 #

• 未挂载保存钩子：save_product_metabox_data函数没有绑定到WordPress的保存文章钩子，导致提交时不会触发保存逻辑。
• Nonce验证参数倒置：wp_verify_nonce的正确调用顺序是wp_verify_nonce($_POST['nonce字段名'], '动作标识')，你把参数写反了，导致验证失败直接终止保存。
• array_intersect_key用法错误：该函数需要第二个参数是键名数组，你传的是值数组，无法匹配到$_POST中的目标字段，最终没有数据可保存。
• 语法冗余逗号：add_meta_box和update_post_meta的参数末尾存在多余逗号，虽不致命但可能引发低版本PHP兼容性问题。
• 前端标签拼写错误：label fro="unit"中的fro应为for，影响前端标签关联功能。

修复后的完整代码 #

public function setup_post_type()
{
    $post_type_supports = [
        'title',
        'editor',
        'revisions',
        'thumbnail'
        //'custom-fields'
    ];

    register_post_type( 
        'products',
        [
            'label' => 'Products',
            'description' => 'Temporary products managment',
            'show_in_rest' => true,
            'rest_namespace' => $this->namespace,
            'public' => true,
            'supports' => $post_type_supports,
            'show_ui' => true,
            'show_in_menu' => true,
            'menu_icon' => 'dashicons-store',
            'register_meta_box_cb' => [$this, 'register_product_metabox']
        ]
    );

    // 挂载保存钩子，指定仅处理products类型
    add_action('save_post_products', [$this, 'save_product_metabox_data']);
}

public function register_product_metabox()
{
    add_meta_box( 
        'temporary_product_metabox', 
        'Products informations', 
        [$this, 'product_metabox_content'], 
        'products' // 移除多余逗号
    );
}

public function product_metabox_content()
{
    wp_nonce_field('product_metabox', 'product_metabox_nonce');
    // 回显已保存的元数据，提升编辑体验
    $product_code = get_post_meta(get_the_ID(), 'product_code', true);
    $category = get_post_meta(get_the_ID(), 'category', true);
    $unit = get_post_meta(get_the_ID(), 'unit', true);
    $info = get_post_meta(get_the_ID(), 'info', true);
    $start_date = get_post_meta(get_the_ID(), 'start_date', true);
    $end_date = get_post_meta(get_the_ID(), 'end_date', true);
    ?>
        <p>
            <label for="cod-prod">Product code</label>
        </p>
        <p>
            <input type="text" id="cod-prod" name="product_code" value="<?php echo esc_attr($product_code); ?>">
        </p>            
        <p>
            <label for="category">Category</label>            
        </p>
        <p>
            <input type="text" id="category" name="category" value="<?php echo esc_attr($category); ?>">
        </p>
        <p>
            <label for="unit">Unit</label> <!-- 修复fro拼写错误 -->
        </p>
        <p>
            <select name="unit" id="unit">
                <option disabled <?php echo empty($unit) ? 'selected' : ''; ?>>Select an option</option>
                <option value="kg" <?php selected($unit, 'kg'); ?>>kg</option>
                <option value="pcs" <?php selected($unit, 'pcs'); ?>>pcs</option>
            </select>
        </p>            
        <p>
            <label for="info">Info</label>
        </p>
        <p>
            <input type="text" name="info" id="info" value="<?php echo esc_attr($info); ?>">
        </p>
        <p>
            <label for="start">Start date</label>
        </p>
        <p>
            <input type="date" id="start" name="start_date" value="<?php echo esc_attr($start_date); ?>">
        </p>            
        <p>
            <label for="end">End date</label>
        </p>
        <p>
            <input type="date" id="end" name="end_date" value="<?php echo esc_attr($end_date); ?>">
        </p>
    <?php
}

public function save_product_metabox_data($post_id)
{
    // 修复nonce验证参数顺序，同时检查nonce字段是否存在
    if (!isset($_POST['product_metabox_nonce']) || !wp_verify_nonce($_POST['product_metabox_nonce'], 'product_metabox')) {
        return;
    }

    // 跳过自动保存和修订版本
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    if (wp_is_post_revision($post_id)) return;

    // 修复array_intersect_key用法：将目标键转为键名数组
    $target_keys = [
        'product_code' => true,
        'category' => true,
        'unit' => true,
        'info' => true,
        'start_date' => true,
        'end_date' => true
    ];

    $post_meta = array_intersect_key($_POST, $target_keys);

    foreach ($post_meta as $key => $val) {
        // 对输入值进行安全过滤
        $sanitized_val = sanitize_text_field($val);
        // 移除update_post_meta的多余逗号
        update_post_meta($post_id, $key, $sanitized_val);
    }
}

额外优化说明 #

• 添加了元数据回显逻辑，编辑时能看到已保存的值，提升用户体验
• 增加了自动保存、修订版本的判断，避免不必要的保存操作
• 对输入值进行安全过滤，防止恶意代码注入
• 修复了下拉框的选中状态逻辑

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