WordPress 后台的仪表盘（Dashboard）是用户登录后看到的第一个界面。默认情况下它显示“概览”、“活动”、“快速草稿”、“WordPress 新闻”等几个面板。对于需要给用户提供关键数据概览或快捷操作的项目，定制仪表盘小工具可以大幅提升后台的实用性。

仪表盘小工具本质上是 add_meta_box 的一种特殊应用。注册仪表盘小工具使用 wp_add_dashboard_widget 函数，通常在 wp_dashboard_setup 钩子中调用：

add_action('wp_dashboard_setup', 'add_custom_dashboard_widgets');
function add_custom_dashboard_widgets() {
    wp_add_dashboard_widget(
        'my_stats_widget',                 // 小工具 ID
        '网站统计数据',                    // 标题
        'render_stats_dashboard_widget'    // 渲染回调函数
    );
}

function render_stats_dashboard_widget() {
    $post_count = wp_count_posts('post')->publish;
    $page_count = wp_count_posts('page')->publish;
    $comment_count = wp_count_comments()->total;
    ?>
    <div class="stats-grid" style="display:grid;grid-template-columns:1fr 1fr 1fr;gap:15px;">
        <div class="stat-box" style="background:#f8f9fa;padding:15px;border-radius:6px;text-align:center;">
            <div style="font-size:28px;font-weight:bold;color:#2271b1;"><?php echo $post_count; ?></div>
            <div style="color:#666;">已发布文章</div>
        </div>
        <div class="stat-box" style="background:#f8f9fa;padding:15px;border-radius:6px;text-align:center;">
            <div style="font-size:28px;font-weight:bold;color:#2271b1;"><?php echo $page_count; ?></div>
            <div style="color:#666;">页面数量</div>
        </div>
        <div class="stat-box" style="background:#f8f9fa;padding:15px;border-radius:6px;text-align:center;">
            <div style="font-size:28px;font-weight:bold;color:#2271b1;"><?php echo $comment_count; ?></div>
            <div style="color:#666;">评论总数</div>
        </div>
    </div>
    <?php
}

这个例子在仪表盘上创建了一个显示文章、页面、评论数量的统计面板。你可以扩展它，加入待审核评论数、用户数、订单数（WooCommerce）等更多指标。

对于多用户网站，你可能需要根据用户角色显示不同的仪表盘小工具。在 wp_dashboard_setup 中检查 current_user_can 来决定是否注册某个小工具：

if (current_user_can('manage_woocommerce')) {
    wp_add_dashboard_widget('order_stats', '订单统计', 'render_order_widget');
}

这样只有有权限的用户才能看到订单统计面板。

仪表盘小工具的数据可以来自外部 API。比如，你可以创建一个显示 RSS 订阅的小工具，显示某个行业新闻的最新动态。也可以创建一个显示服务器状态的小工具，显示磁盘空间、内存使用率、PHP 错误日志等系统信息。

在回调函数中输出的内容会直接显示在仪表盘上。你可以使用任何 HTML、CSS 和 JavaScript，但建议保持与 WordPress 后台风格一致的样式。WordPress 后台已经加载了 jQuery，你可以用 wp_enqueue_script 添加自定义 JS 脚本实现动态刷新数据：

add_action('admin_enqueue_scripts', 'enqueue_dashboard_widget_scripts');
function enqueue_dashboard_widget_scripts($hook) {
    if ($hook != 'index.php') return;
    wp_enqueue_script('my-dashboard-widget', get_stylesheet_directory_uri() . '/js/dashboard-widget.js', array('jquery'), '1.0', true);
}

$hook == 'index.php' 是判断当前页面是否为仪表盘的依据，这样可以避免在其他后台页面加载不必要的脚本。

如果需要让用户能够配置小工具的显示选项，你可以在回调函数中输出设置表单，并利用 wp_ajax 处理保存。不过仪表盘小工具本身不内置设置 API，你需要自己实现存储逻辑，通常用 update_user_meta 保存每个用户的偏好设置。

移除默认的仪表盘小工具也是常见的定制需求。有些网站不希望显示 WordPress 新闻，或者不希望显示“活动”面板：

add_action('wp_dashboard_setup', 'remove_default_dashboard_widgets');
function remove_default_dashboard_widgets() {
    remove_meta_box('dashboard_activity', 'dashboard', 'normal');
    remove_meta_box('dashboard_primary', 'dashboard', 'side');
    remove_meta_box('dashboard_quick_press', 'dashboard', 'side');
    remove_meta_box('dashboard_right_now', 'dashboard', 'normal');
}

企业后台通常会保留“概览”并移除“WordPress 新闻”，这样后台看起来更专业。

仪表盘小工具开发的好处是能显著提升后台的用户体验，让操作人员在一个页面上就能获取关键信息和执行常用操作。对于客户项目来说，定制仪表盘也是展示专业度的一个细节。