register_taxonomy() を解説：WordPressでカスタム分類（タクソノミー）を登録する方法

<?php
// カスタム分類「sample_taxonomy」を投稿タイプ「post」に登録する例
function register_sample_taxonomy() {
    $labels = array(
        'name'              => 'サンプル分類',
        'singular_name'     => 'サンプル分類',
        'search_items'      => 'サンプル分類を検索',
        'all_items'         => 'すべてのサンプル分類',
        'edit_item'         => 'サンプル分類を編集',
        'update_item'       => 'サンプル分類を更新',
        'add_new_item'      => '新規サンプル分類を追加',
        'new_item_name'     => '新しいサンプル分類名',
        'menu_name'         => 'サンプル分類'
    );
    $args = array(
        'labels'            => $labels,
        'hierarchical'      => true, // 階層構造(カテゴリーのような振る舞い)
        'show_ui'           => true,
        'query_var'         => true,
        'rewrite'           => array('slug' => 'sample-terms'),
        'show_in_rest'      => true  // REST API対応
    );
    register_taxonomy('sample_taxonomy', 'post', $args);
}
add_action('init', 'register_sample_taxonomy');

// 管理画面に「サンプル分類」のメニューが表示され、投稿編集画面でタクソノミーが利用できる状態になります。

<?php
// カスタム投稿タイプ「book」と連携するタクソノミー「genre」を登録する例
function register_book_genre() {
    $labels = array(
        'name'              => 'ジャンル',
        'singular_name'     => 'ジャンル',
        'search_items'      => 'ジャンルを検索',
        'all_items'         => 'すべてのジャンル',
        'edit_item'         => 'ジャンルを編集',
        'update_item'       => 'ジャンルを更新',
        'add_new_item'      => '新規ジャンルを追加',
        'new_item_name'     => '新しいジャンル名',
        'menu_name'         => 'ジャンル'
    );
    $args = array(
        'labels'            => $labels,
        'hierarchical'      => true,
        'show_ui'           => true,
        'query_var'         => true,
        // URLで「books/genre」と表示する設定
        'rewrite'           => array( 'slug' => 'books/genre', 'with_front' => false ),
        'show_in_rest'      => true
    );
    register_taxonomy( 'genre', 'book', $args );
}
add_action( 'init', 'register_book_genre' );

// 「book」投稿タイプの管理画面に「ジャンル」メニューが追加され、投稿編集画面にはカテゴリー選択用のチェックボックスが表示されます。

<?php
// initフック内でタクソノミーを登録する例
function my_register_taxonomy() {
    register_taxonomy( 'sample_tax', 'post', array(
        'labels'       => array( 'name' => 'サンプルタクソノミー' ),
        'hierarchical' => false,
        'rewrite'      => array( 'slug' => 'sample-tax' )
    ) );
}
add_action( 'init', 'my_register_taxonomy' );

// 正しいタイミングでタクソノミー「sample_tax」が登録され、管理画面およびフロントエンドに反映されます。

<?php
$labels = array(
    'name'              => 'トピック',
    'singular_name'     => 'トピック',
    'search_items'      => 'トピックを検索',
    'all_items'         => 'すべてのトピック',
    'edit_item'         => 'トピックを編集',
    'update_item'       => 'トピックを更新',
    'add_new_item'      => '新規トピックを追加',
    'new_item_name'     => '新しいトピック名',
    'menu_name'         => 'トピック'
);

<?php
$args = array(
    'hierarchical' => true, // カテゴリー形式で階層化する場合
    'labels'       => $labels,
    'show_ui'      => true,
);
register_taxonomy( 'custom_category', 'post', $args );

// カテゴリ形式のタクソノミー「custom_category」が投稿画面に階層的なチェックボックスとして表示されます。

<?php
$args = array(
    'rewrite' => array(
        'slug'       => 'custom-topic',   // URLに使われるスラッグ
        'with_front' => false             // フロントベースを除外
    ),
    'labels'  => $labels,
);
register_taxonomy( 'custom_topic', 'post', $args );

// URLが「https://example.com/custom-topic/」の形式でアクセス可能になります。

<?php
$args = array(
    'show_in_rest' => true,         // REST API対応
    'rest_base'    => 'custom-topic', // エンドポイントのベース名の指定
    'labels'       => $labels,
);
register_taxonomy( 'custom_topic', 'post', $args );

// REST API経由で「custom_topic」が利用可能になり、エンドポイントは「/wp-json/wp/v2/custom-topic」となります。

<?php
function register_taxonomy_with_default() {
    $labels = array(
        'name' => 'トピック'
    );
    $args = array(
        'labels'       => $labels,
        'hierarchical' => false,
        // 初期タームの設定
        'default_term' => array(
            'name'        => '未分類',
            'slug'        => 'uncategorized',
            'description' => '初期状態のターム'
        )
    );
    register_taxonomy( 'topic', 'post', $args );
}
add_action( 'init', 'register_taxonomy_with_default' );

// タクソノミー「topic」が登録されると、自動的に「未分類」というタームが挿入されます。

<?php
function insert_default_term() {
    // タクソノミー「topic」に対して「未分類」というタームが存在しなければ追加する
    if ( ! term_exists( 'uncategorized', 'topic' ) ) {
        wp_insert_term(
            '未分類',      // ターム名
            'topic',       // タクソノミー指定
            array(
                'slug'        => 'uncategorized',
                'description' => '初期状態のターム'
            )
        );
    }
}
add_action( 'init', 'insert_default_term' );

// 登録時に「topic」タクソノミーに新たに「未分類」タームが自動で作成されます(すでに存在する場合は作成されません)。

<?php
// initフックでタクソノミーを登録
function my_custom_taxonomy() {
    $labels = array(
        'name'          => 'サンプル分類',
        'singular_name' => 'サンプル分類'
    );
    $args = array(
        'labels'        => $labels,
        'hierarchical'  => false,
        'rewrite'       => array( 'slug' => 'sample-tax' ),
        'show_in_rest'  => true
    );
    register_taxonomy( 'sample_tax', 'post', $args );
}
add_action( 'init', 'my_custom_taxonomy' );

// 「sample_tax」が正しいタイミングで登録され、管理画面に反映されます。

<?php
// タクソノミー「genre」専用のフック処理
function after_genre_registered( $taxonomy, $object_type, $args ) {
    error_log( "タクソノミー「{$taxonomy}」が登録されました。" );
}
add_action( 'registered_taxonomy_genre', 'after_genre_registered', 10, 3 );

// タクソノミー「genre」が登録されると、エラーログに登録完了のメッセージが出力されます。

<?php
function check_taxonomy_registration( $taxonomy, $object_type, $args ) {
    // 登録後の状態をログに記録する
    error_log( "Taxonomy {$taxonomy} has been registered for " . print_r( $object_type, true ) );
}
add_action( 'registered_taxonomy', 'check_taxonomy_registration', 10, 3 );

// 登録完了後、サーバーログにタクソノミーの情報が記録され、検証がしやすくなります。

<?php
function taxonomy_post_register_action( $taxonomy, $object_type, $args ) {
    // 登録後の追加処理
    // 例: キャッシュクリアや他の設定の初期化
    error_log( "追加処理を実行：タクソノミー {$taxonomy} 登録完了" );
}
add_action( 'registered_taxonomy', 'taxonomy_post_register_action', 15, 3 );

// タクソノミー登録後に、追加処理として設定した処理が自動的に呼び出され、エラーログに記録されます。