WordPress插件开发：插件内如何正常显示后台仪表盘自定义小工具

问题触发常见原因 #

相同代码放在主题functions.php可正常运行，在自定义插件中仅标题可见、内容不输出，通常由以下问题导致：

• 钩子挂载逻辑异常：插件加载顺序早于主题，若wp_dashboard_setup钩子挂载位置错误、优先级被其他逻辑覆盖，会导致回调函数未被正常调用
• 回调函数解析失败：插件环境下命名空间、作用域和主题存在差异，若回调传参格式错误、存在同名函数冲突，核心仅能读取到注册时传入的小工具标题，无法执行内容渲染逻辑
• 语法错误被拦截：原示例代码的输出内容中存在多余的?>字符，部分环境下主题的PHP容错配置会自动忽略该错误，但插件环境下若开启严格错误报告，会直接中断内容输出
• 钩子挂载范围错误：若将注册逻辑写在插件激活回调、前台判断分支内，会导致后台访问时回调未被挂载

可直接使用的修复代码 #

将以下代码放入插件主文件即可正常渲染内容：

// 注册自定义仪表盘小工具
function my_custom_dashboard_widgets() {
    wp_add_dashboard_widget(
        "custom_help_widget",
        "WordPress Tutorials",
        "custom_dashboard_help"
    );
}
// 显式声明钩子优先级，避免被其他逻辑覆盖
add_action("wp_dashboard_setup", "my_custom_dashboard_widgets", 10);

// 小工具内容渲染回调
function custom_dashboard_help() {
    // 修复原代码中多余的字符，直接输出HTML内容即可
    echo "<p>Welcome to your custom dashboard widget! Need help?</p>";
    // 如需输出复杂metabox、自定义HTML结构，直接在此处编写输出逻辑即可
}

类封装插件的正确写法 #

如果你采用类的方式开发插件，需要传入数组格式的回调参数，不能直接传函数名字符串，参考代码：

class Custom_Dashboard_Widget {
    public function __construct() {
        add_action("wp_dashboard_setup", array($this, "register_dashboard_widget"));
    }

    public function register_dashboard_widget() {
        wp_add_dashboard_widget(
            "custom_help_widget",
            "WordPress Tutorials",
            array($this, "render_widget_content")
        );
    }

    public function render_widget_content() {
        echo "<p>Welcome to your custom dashboard widget! Need help?</p>";
        // 自定义内容输出逻辑
    }
}

new Custom_Dashboard_Widget();

排查提示：如果替换代码后仍无法显示内容，可临时在回调函数第一行加echo "测试输出";，确认回调是否被正常调用，再逐步排查是否是HTML结构、JS/CSS加载导致的内容隐藏问题。

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