在wordpress控制面板增加挂件或设置项

wordpress最大的好处就是开放者可以根据自己的需求，自由的深入开发。我们希望在wordpress后台的首页（欢迎页面）增加一些快捷设置项，那么通过非常简单的程序即可实现。

在乌徒帮之前的文章中，实现了在文章增加或修改页增加postmeta_box，用到了add_meta_box函数，然而，要在仪表盘（dashboard）增加一些挂件，在后台首页就实现一些设置应该如何对主题进行修改呢？我们将用到wp_add_dashboard_widget。

图片即本文思路来源：wpengineer

我们通过下面的一段代码得以实现这一功能

/**
* Content of Dashboard-Widget
*/
function my_wp_dashboard_test() {
echo 'Test Add Dashboard-Widget';
}

/**
* add Dashboard Widget via function wp_add_dashboard_widget()
*/
function my_wp_dashboard_setup() {
wp_add_dashboard_widget( 'my_wp_dashboard_test', __( 'Test My Dashboard' ), 'my_wp_dashboard_test' );
}

/**
* use hook, to integrate new widget
*/
add_action('wp_dashboard_setup', 'my_wp_dashboard_setup');

wp_add_dashboard_widget函数是本功能的关键，你通过wp_dashboard_setup的hook将新的内容或挂件添加到仪表盘。

function wp_add_dashboard_widget( $widget_id, $widget_name, $callback, $control_callback = null )

函数必须有三个参数：

1、ID，它是挂件的唯一标识，将反映在数据库中，也将反映在widget挂件的div容器id中。

2、name，它是挂件的名称，将显示为挂件的标题，同时也将作为挂件在顶部“显示选项”内的名称。

3、callback_function，回调函数，即调用哪一个函数来执行该挂件的内容。在上面的代码中即my_wp_dashboard_test。在my_wp_dashboard_test你可以规定要显示的内容（html代码），也可以进行数据处理，例如实现update_option等函数操作。

你可以在my_wp_dashboard_setup函数中加入多个wp_add_dashboard_widget，以实现增加多个仪表盘的挂件。