WordPressのダッシュボードカスタマイズ

WordPressのダッシュボードからデフォルトのウィジェットを消したり、独自のウィジェットを追加したりする方法。

デフォルトのウィジェットを削除する

remove_meta_box関数でウィジェットの削除が可能。remove_meta_boxは、ダッシュボードだけでなく、投稿画面のウィジェット削除でも使えます。

remove_meta_box($id, $page, $context);

$id

ウィジェットのID。他のウィジェットとの重複不可。

$page

スクリーン名。ダッシュボードの場合は、dashboard

$context

デフォルトの表示位置。ダッシュボードの場合は、normal もしくは side

CODE 1

function remove_dashboard_meta_boxes( $screen_id ) {
	global $wp_meta_boxes;

	if ( $screen_id == 'dashboard' ) {
		$meta_boxes = array(
			'normal' => array(
				'dashboard_right_now', // 現在の状況
				'network_dashboard_right_now', // 現在の状況（ネットワーク管理）
				'dashboard_recent_comments', // 最近のコメント
				'dashboard_incoming_links', // 被リンク
				'dashboard_plugins', // プラグイン
			),
			'side' => array(
				'dashboard_quick_press', // クイック投稿
				'dashboard_recent_drafts', // 最近の下書き
				'dashboard_primary', // WordPress 開発ブログ
				'dashboard_secondary' // WordPress フォーラム
			)
		);
		foreach ( $meta_boxes as $context => $arr ) {
			foreach ( $arr as $id ) {
				if ( isset( $wp_meta_boxes[$screen_id][$context]['core'][$id] ) ) {
					remove_meta_box( $id, $screen_id, $context );
				}
			}
		}
	}
}
add_action( 'do_meta_boxes', 'remove_dashboard_meta_boxes' );

独自のウィジェットを追加する

「俺のメモ」というメモを記入出来るボックスを追加するサンプル。wp_add_dashboard_widgetという関数で追加が可能。引数の指定は第４まで。

wp_add_dashboard_widget( $widget_id, $widget_name, $callback, $control_callback );

$widget_id

ウィジェットのID。他のウィジェットとの重複不可。

$widget_name

ウィジェットのタイトル

$callback

ウィジェットを表示する際に実行される関数名

$control_callback

ウィジェットで設定などを行う場合に実行される関数名。表示のみとなるウィジェットでは指定不要

CODE 2

function add_my_dashoboard_meta_box( $screen_id ) {
	if ( $screen_id == 'dashboard' ) {
		wp_add_dashboard_widget( 'my_dashoboard_meta_box', '俺のメモ', 'my_dashoboard_meta_box', 'my_dashoboard_meta_box_controll' );
	}
}
add_action( 'do_meta_boxes', 'add_my_dashoboard_meta_box' );


function my_dashoboard_meta_box() {
	$widget_options = get_option( 'dashboard_widget_options' );
	$my_dashoboard_meta_box = isset( $widget_options['my_dashoboard_meta_box'] ) ? $widget_options['my_dashoboard_meta_box'] : '';
?>
	<p><?php echo nl2br( esc_html( $my_dashoboard_meta_box ) ); ?></p>
<?php
}


function my_dashoboard_meta_box_controll() {
	$widget_options = get_option( 'dashboard_widget_options' );
	$my_dashoboard_meta_box = isset( $widget_options['my_dashoboard_meta_box'] ) ? $widget_options['my_dashoboard_meta_box'] : '';
?>
	<textarea name="my_dashoboard_meta_box" cols="50" rows="5"><?php echo esc_html( $my_dashoboard_meta_box ); ?></textarea>
<?php
}

function my_dashoboard_meta_box_controll_update() {
	$widget_options = get_option( 'dashboard_widget_options' );
	if ( ! $widget_options ) {
		$widget_options = array();
	}
	if ( isset( $_POST['my_dashoboard_meta_box'] ) ) {
		$widget_options['my_dashoboard_meta_box'] = stripslashes_deep( $_POST['my_dashoboard_meta_box'] );
		update_option( 'dashboard_widget_options', $widget_options );
	}
}
add_action( 'load-index.php', 'my_dashoboard_meta_box_controll_update' );