概要
remove_meta_box 関数は、WordPress の投稿ページやカスタム投稿タイプの管理画面から特定のメタボックスを削除（非表示）するための関数です。この関数は、管理画面をカスタマイズしたり、ユーザーが不要な情報に気を取られないようにするために使用されます。よく使われる機能としては以下のようなものがあります。
- 不要なメタボックスの削除
- ユーザーインターフェースの簡略化
- カスタム投稿タイプの整理
- 特定のユーザー権限による表示制御
- デフォルトのメタボックスのカスタマイズ
- プラグインメタボックスの非表示
- テーマの管理画面をすっきりさせる
- 管理画面のユーザビリティ向上
構文
remove_meta_box( $id, $post_type, $context );
パラメータ
$id(string) : 削除したいメタボックスの ID。$post_type(string) : メタボックスを削除する対象の投稿タイプ。$context(string) : メタボックスが表示されるコンテキスト（例: ‘normal’, ‘side’, ‘advanced’）。
戻り値
この関数は戻り値を返しません。
関連する関数
使用可能なバージョン
remove_meta_box 関数は、WordPress 2.5.0 以降で利用可能です。
コアファイルのパス
wp-includes/meta.php
サンプルコード
サンプルコード 1: 投稿ページの特定のメタボックスを削除
function my_remove_meta_boxes() {
remove_meta_box('postimagediv', 'post', 'side');
}
add_action('admin_menu', 'my_remove_meta_boxes');
このコードは、投稿のサイドメタボックスからアイキャッチ画像メタボックス (postimagediv) を削除します。
サンプルコード 2: カスタム投稿タイプからメタボックスを削除
function my_custom_post_type_remove_meta_boxes() {
remove_meta_box('commentsdiv', 'my_custom_post_type', 'normal');
}
add_action('admin_menu', 'my_custom_post_type_remove_meta_boxes');
このコードは、特定のカスタム投稿タイプのノーマルメタボックスからコメントメタボックスを削除します。
サンプルコード 3: 特定のユーザー権限に基づいてメタボックスを削除
function my_remove_meta_boxes_for_users() {
if (!current_user_can('administrator')) {
remove_meta_box('slugdiv', 'post', 'normal');
}
}
add_action('admin_menu', 'my_remove_meta_boxes_for_users');
このコードは、管理者以外のユーザーに対してスラッグ（別名）メタボックスを削除します。
サンプルコード 4: 複数のメタボックスを一度に削除
function my_remove_multiple_meta_boxes() {
remove_meta_box('postexcerpt', 'post', 'normal');
remove_meta_box('trackbacksdiv', 'post', 'normal');
}
add_action('admin_menu', 'my_remove_multiple_meta_boxes');
このコードは、投稿から抜粋メタボックスとトラックバックメタボックスを一度に削除します。
サンプルコード 5: 固定ページからメタボックスを削除
function my_remove_meta_boxes_from_pages() {
remove_meta_box('revisionsdiv', 'page', 'normal');
}
add_action('admin_menu', 'my_remove_meta_boxes_from_pages');
このコードは、固定ページからリビジョンメタボックスを削除します。
この関数のアクションでの使用可能性
| アクション名 | 使用例 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | |
| template_redirect | |
| get_header | |
| wp_head |
非推奨または削除されたバージョン
この関数は特定のバージョンで非推奨または削除されていません。