如何在post-new.php页面添加自定义选项？（无插件，从零开发主题）

嘿，我来帮你搞定这两个纯WordPress主题开发的问题，全程不用插件，直接在主题代码里实现：

其实post-new.php和post-edit.php共用WordPress的文章编辑界面，咱们可以通过**自定义元框（Meta Box）**来添加额外选项，步骤如下：

1. 注册自定义元框
   在主题的functions.php里添加代码，用add_meta_box()函数注册一个新的元框，它会同时出现在新建文章（post-new.php）和编辑文章页面：

function custom_post_options_meta_box() {
    add_meta_box(
        'custom_post_options', // 元框唯一ID
        '文章自定义选项', // 元框显示标题
        'render_custom_post_options_meta_box', // 负责渲染内容的回调函数
        'post', // 应用的文章类型，可替换为page或自定义文章类型
        'normal', // 显示位置（normal/side/advanced）
        'default' // 显示优先级
    );
}
add_action('add_meta_boxes', 'custom_post_options_meta_box');

2. 渲染元框内容
   接下来写上面指定的渲染回调函数，在元框里添加你需要的表单控件（比如输入框、下拉选单等）：

function render_custom_post_options_meta_box($post) {
    // 添加入站安全验证的nonce字段，防止恶意提交
    wp_nonce_field('save_custom_post_options', 'custom_post_options_nonce');

    // 获取已保存的自定义值（如果有）
    $custom_subtitle = get_post_meta($post->ID, '_custom_post_subtitle', true);
    $custom_layout = get_post_meta($post->ID, '_custom_post_layout', true);
    ?>
    <p>
        <label for="custom_post_subtitle">文章副标题：</label>
        <input type="text" id="custom_post_subtitle" name="custom_post_subtitle" value="<?php echo esc_attr($custom_subtitle); ?>" style="width:100%;">
    </p>
    <p>
        <label for="custom_post_layout">文章布局：</label>
        <select id="custom_post_layout" name="custom_post_layout" style="width:100%;">
            <option value="full-width" <?php selected($custom_layout, 'full-width'); ?>>通栏布局</option>
            <option value="two-column" <?php selected($custom_layout, 'two-column'); ?>>双栏布局</option>
        </select>
    </p>
    <?php
}

3. 保存元框数据
   最后添加保存回调函数，把用户输入的数据安全地存到文章元数据里：

function save_custom_post_options_meta_box($post_id) {
    // 验证nonce、权限和自动保存状态，确保操作合法
    if (!isset($_POST['custom_post_options_nonce']) || !wp_verify_nonce($_POST['custom_post_options_nonce'], 'save_custom_post_options')) {
        return;
    }
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }
    if (!current_user_can('edit_post', $post_id)) {
        return;
    }

    // 保存副标题字段
    if (isset($_POST['custom_post_subtitle'])) {
        update_post_meta($post_id, '_custom_post_subtitle', sanitize_text_field($_POST['custom_post_subtitle']));
    }
    // 保存布局选择字段
    if (isset($_POST['custom_post_layout'])) {
        update_post_meta($post_id, '_custom_post_layout', sanitize_text_field($_POST['custom_post_layout']));
    }
}
add_action('save_post', 'save_custom_post_options_meta_box');

刷新post-new.php页面，你就能看到自己添加的自定义选项了～

这个本质也是自定义元框的应用，只是需要在前端模板里根据保存的值控制侧边栏显示，步骤如下：

1. 注册并渲染侧边栏控制元框
   同样在functions.php里添加代码，这次咱们做一个复选框：

function sidebar_control_meta_box() {
    add_meta_box(
        'sidebar_control',
        '侧边栏设置',
        'render_sidebar_control_meta_box',
        'post',
        'side', // 放在编辑页面的侧边栏区域，更符合用户操作习惯
        'default'
    );
}
add_action('add_meta_boxes', 'sidebar_control_meta_box');

function render_sidebar_control_meta_box($post) {
    wp_nonce_field('save_sidebar_control', 'sidebar_control_nonce');
    // 获取已保存的禁用状态
    $disable_sidebar = get_post_meta($post->ID, '_disable_sidebar', true);
    ?>
    <p>
        <label for="disable_sidebar">
            <input type="checkbox" id="disable_sidebar" name="disable_sidebar" value="1" <?php checked($disable_sidebar, '1'); ?>>
            禁用当前文章的侧边栏
        </label>
    </p>
    <?php
}

2. 保存侧边栏设置
   添加保存函数，记录用户的选择：

function save_sidebar_control_meta_box($post_id) {
    // 同样做安全验证
    if (!isset($_POST['sidebar_control_nonce']) || !wp_verify_nonce($_POST['sidebar_control_nonce'], 'save_sidebar_control')) {
        return;
    }
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) {
        return;
    }
    if (!current_user_can('edit_post', $post_id)) {
        return;
    }

    // 根据复选框状态更新元数据
    $disable_sidebar = isset($_POST['disable_sidebar']) ? '1' : '0';
    update_post_meta($post_id, '_disable_sidebar', $disable_sidebar);
}
add_action('save_post', 'save_sidebar_control_meta_box');

3. 在模板里判断是否显示侧边栏
   打开主题的single.php（或对应的自定义文章类型模板），找到侧边栏的渲染代码（通常是get_sidebar()），加上判断逻辑：

// 获取当前文章的侧边栏禁用状态
$disable_sidebar = get_post_meta(get_the_ID(), '_disable_sidebar', true);

// 如果没有禁用，就显示侧边栏
if ($disable_sidebar !== '1') {
    get_sidebar();
}

这样用户在新建/编辑文章时勾选“禁用侧边栏”，前端就不会加载侧边栏了～

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