register_and_do_post_meta_boxes() 関数を解説：WordPressでのデフォルトポストメタボックス登録とアクション実行方法

// $postオブジェクトの検証とサポート機能の確認例
function verify_and_setup_meta_box($post) {
    $post_type = $post->post_type;
    if (!post_type_supports($post_type, 'thumbnail')) {
        return; // サムネイルがサポートされていなければ処理を終了
    }
    $args = array('__back_compat_meta_box' => true);
    // サムネイル用メタボックス登録のためのパラメータを用意
    add_meta_box('postimagediv', 'Featured Image', 'post_thumbnail_meta_box', null, 'side', 'low', $args);
}

// 管理画面に「Featured Image」メタボックスが表示される

// 投稿タイプに応じた動的な条件分岐例
if ('attachment' === $post->post_type) {
    // 添付ファイル用の挙動(例：画像編集用スクリプトの読み込み)
    wp_enqueue_script('image-edit');
    add_meta_box('submitdiv', 'Save', 'attachment_submit_meta_box', null, 'side', 'core');
} else {
    // 通常の投稿の場合はPublishメタボックスを登録
    add_meta_box('submitdiv', 'Publish', 'post_submit_meta_box', null, 'side', 'core');
}

// 投稿タイプごとに「Save」または「Publish」メタボックスが管理画面に表示される

// custom meta boxを追加する例
add_action('add_meta_boxes', function($post_type, $post) {
    if ('post' === $post_type) {
        add_meta_box('custom-metabox', 'Custom Info', 'custom_info_meta_box', null, 'normal', 'high');
    }
}, 10, 2);

// 投稿編集画面に「Custom Info」メタボックスが追加される

// do_meta_boxes アクションを利用して、出力前に処理を加える例
add_action('do_meta_boxes', function($post_type, $context, $post) {
    if ('side' === $context && 'post' === $post_type) {
        // 必要であればここでメタボックス内容のフィルタをかける
    }
}, 10, 3);

// メタボックスレンダリング前に追加処理が実行される(画面上には通常通りメタボックスが表示される)

// サムネイルサポートの有無を確認し、メタボックスを登録する例
if (current_theme_supports('post-thumbnails', $post->post_type) && post_type_supports($post->post_type, 'thumbnail')) {
    if (current_user_can('upload_files')) {
        add_meta_box('postimagediv', esc_html(get_post_type_object($post->post_type)->labels->featured_image),
            'post_thumbnail_meta_box', null, 'side', 'low');
    }
}

// 管理画面のサイドバーに「Featured Image」メタボックスが表示される

// カスタムフィールド、ページ属性、著者情報のメタボックス登録例
if (post_type_supports($post->post_type, 'custom-fields')) {
    add_meta_box('postcustom', 'Custom Fields', 'post_custom_meta_box', null, 'normal');
}
if (post_type_supports($post->post_type, 'page-attributes') || count(get_page_templates($post)) > 0) {
    add_meta_box('pageparentdiv', get_post_type_object($post->post_type)->labels->attributes,
        'page_attributes_meta_box', null, 'side');
}
if (post_type_supports($post->post_type, 'author') && current_user_can(get_post_type_object($post->post_type)->cap->edit_others_posts)) {
    add_meta_box('authordiv', 'Author', 'post_author_meta_box', null, 'normal');
}

// 投稿編集画面に「Custom Fields」「Page Attributes」「Author」の各メタボックスが順次表示される

// リビジョン数の取得とメタボックス登録例
if (post_type_supports($post->post_type, 'revisions') && 'auto-draft' !== $post->post_status) {
    $revisions = wp_get_latest_revision_id_and_total_count($post->ID);
    if (!is_wp_error($revisions) && $revisions['count'] > 1) {
        add_meta_box('revisionsdiv', 'Revisions', 'post_revisions_meta_box', null, 'normal');
    }
}

// リビジョン数が2以上の場合、管理画面に「Revisions」メタボックスが表示される

// コメントとピンバックのチェックによるメタボックス登録例
if (comments_open($post) || pings_open($post) || post_type_supports($post->post_type, 'comments')) {
    add_meta_box('commentstatusdiv', 'Discussion', 'post_comment_status_meta_box', null, 'normal');
}
$statuses = get_post_stati(array('public' => true));
if (empty($statuses)) {
    $statuses = array('publish');
}
$statuses[] = 'private';
if (in_array(get_post_status($post), $statuses, true)) {
    if (comments_open($post) || pings_open($post) || $post->comment_count > 0 || post_type_supports($post->post_type, 'comments')) {
        add_meta_box('commentsdiv', 'Comments', 'post_comment_meta_box', null, 'normal');
    }
}

// 対象の投稿編集画面に「Discussion」と「Comments」のメタボックスがそれぞれ表示される

// 添付ファイルが音声の場合のメタボックス登録例
if ('attachment' === $post->post_type && $post->post_mime_type) {
    if (wp_attachment_is('audio', $post)) {
        // 音声用メタボックス登録
        add_meta_box('attachment-id3', 'Metadata', 'attachment_id3_data_meta_box', null, 'normal');
    }
}

// 管理画面に「Metadata」メタボックスが音声添付ファイル用に表示される

// 添付ファイルが動画の場合のメタボックス登録例
if ('attachment' === $post->post_type && $post->post_mime_type) {
    if (wp_attachment_is('video', $post)) {
        // 動画用メタボックス登録
        add_meta_box('video-meta', 'Video Details', 'video_details_meta_box', null, 'normal');
    }
}

// 管理画面に「Video Details」メタボックスが動画添付ファイル用に表示される

// 階層型タクソノミー用メタボックス登録例
$taxonomy = get_taxonomy('category');
if ($taxonomy->show_ui && false !== $taxonomy->meta_box_cb) {
    $tax_meta_box_id = 'categorydiv';
    add_meta_box(
        $tax_meta_box_id,
        $taxonomy->labels->name,
        $taxonomy->meta_box_cb,
        null,
        'side',
        'core',
        array('taxonomy' => 'category')
    );
}

// 投稿編集画面のサイドバーに「カテゴリー」メタボックスが表示される

// 非階層型タクソノミー用メタボックス登録例
$taxonomy = get_taxonomy('post_tag');
if ($taxonomy->show_ui && false !== $taxonomy->meta_box_cb) {
    $tax_meta_box_id = 'tagsdiv-post_tag';
    add_meta_box(
        $tax_meta_box_id,
        $taxonomy->labels->name,
        $taxonomy->meta_box_cb,
        null,
        'side',
        'core',
        array('taxonomy' => 'post_tag')
    );
}

// 管理画面に「タグ」メタボックスが表示される

// 投稿タイプによるスクリプトの読み込み例
if ('attachment' === $post->post_type) {
    wp_enqueue_script('image-edit'); // 添付ファイル用のスクリプト読み込み
} else {
    wp_enqueue_style('editor-style'); // 通常投稿用のスタイル読み込み
}

// 各投稿タイプに応じたスクリプトやスタイルが管理画面に適用される

// 投稿タイプに応じたメタボックス登録の条件分岐例
if ('attachment' === $post->post_type) {
    add_meta_box('submitdiv', 'Save', 'attachment_submit_meta_box', null, 'side', 'core');
} else {
    add_meta_box('submitdiv', 'Publish', 'post_submit_meta_box', null, 'side', 'core');
}

// 添付ファイルと通常投稿で、それぞれ適切なメタボックスが管理画面に登録される

// 古いアクションフックへの対応例(後方互換性のための実装)
do_action_deprecated('dbx_post_advanced', array($post), '3.7.0', 'add_meta_boxes');

// 古いアクションフックが呼び出された場合、デバッグ目的の警告が表示される(実際の画面表示には反映されない)