WordPress插件自定义编辑页面调用add_meta_box后空白，求排查

核心问题 #

你当前的页面是自定义插件管理页面（URL里的page=testingpages），并非WordPress原生的文章/页面编辑页（比如post.php或page.php）。add_meta_boxes钩子是专为原生编辑页面设计的，在自定义页面中调用这个钩子不仅无法渲染元框，还会因缺少编辑页的核心运行环境导致页面空白。

解决办法 #

1. 放弃在自定义页面使用add_meta_box #

add_meta_box依赖WordPress编辑页的$post对象、专属DOM结构等基础环境，自定义页面不具备这些条件，因此这个函数在这里完全无法生效。

2. 手动在自定义页面编写表单区域 #

直接在view-edit.php中编写HTML表单来实现类似元框的功能，示例代码：

// view-edit.php 内容
<div class="wrap">
    <h1><?php _e('编辑测试页面'); ?></h1>
    <form method="post" action="">
        <?php wp_nonce_field('testingpages_edit_action', 'testingpages_nonce'); ?>
        <!-- 自定义表单区域 -->
        <div class="postbox">
            <h2 class="hndle"><span><?php _e('我的自定义区域'); ?></span></h2>
            <div class="inside">
                <p>
                    <label for="testing_field"><?php _e('测试字段'); ?></label>
                    <input type="text" name="testing_field" id="testing_field" class="regular-text" value="<?php echo esc_attr(get_option('testingpages_test_field')); ?>">
                </p>
            </div>
        </div>
        <?php submit_button(__('保存更改')); ?>
    </form>
</div>

3. 添加表单提交处理逻辑 #

在插件主文件中加入提交处理代码，确保数据能正确保存：

// 插件主页面代码
if ($_GET['action'] == 'edit') {
    // 处理表单提交
    if ($_SERVER['REQUEST_METHOD'] == 'POST' && isset($_POST['testingpages_nonce']) && wp_verify_nonce($_POST['testingpages_nonce'], 'testingpages_edit_action')) {
        // 清洗并保存数据
        $testing_field = sanitize_text_field($_POST['testing_field']);
        update_option('testingpages_test_field', $testing_field);
        
        // 显示保存成功提示
        add_action('admin_notices', function() {
            echo '<div class="notice notice-success is-dismissible"><p>' . __('设置已保存') . '</p></div>';
        });
    }
    include('admin/views/view-edit.php');
}

4. 加载admin样式统一界面风格 #

如果想让自定义区域的样式和原生元框一致，在插件主文件中添加样式加载代码：

// 加载WordPress admin样式
function testingpages_enqueue_admin_styles() {
    global $pagenow;
    if ($pagenow == 'admin.php' && isset($_GET['page']) && $_GET['page'] == 'testingpages') {
        wp_enqueue_style('wp-admin');
    }
}
add_action('admin_enqueue_scripts', 'testingpages_enqueue_admin_styles');

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