get_taxonomy()

関数の概要

get_taxonomy() は、指定されたタクソノミーの詳細情報を取得するための関数です。この関数を使用することで、特定のタクソノミーに関する情報(ラベル、設定、階層構造など)を取得し、タクソノミーのプロパティや設定内容を確認できます。

パラメータの説明

  1. $taxonomy (string): 詳細情報を取得したいタクソノミーの名前。

戻り値

指定されたタクソノミーの詳細情報を含む WP_Taxonomy オブジェクトを返します。指定されたタクソノミーが存在しない場合は false を返します。

使用例

// タクソノミー 'category' の詳細情報を取得
$category_taxonomy = get_taxonomy( 'category' );

if ( $category_taxonomy ) {
    echo '<h2>Category Taxonomy Details:</h2>';
    echo '<p>Name: ' . $category_taxonomy->name . '</p>';
    echo '<p>Label: ' . $category_taxonomy->label . '</p>';
    echo '<p>Hierarchical: ' . ( $category_taxonomy->hierarchical ? 'Yes' : 'No' ) . '</p>';
    echo '<p>Public: ' . ( $category_taxonomy->public ? 'Yes' : 'No' ) . '</p>';
} else {
    echo '<p>The specified taxonomy does not exist.</p>';
}

// タクソノミー 'genre' の詳細情報を取得
$genre_taxonomy = get_taxonomy( 'genre' );

if ( $genre_taxonomy ) {
    echo '<h2>Genre Taxonomy Details:</h2>';
    echo '<p>Name: ' . $genre_taxonomy->name . '</p>';
    echo '<p>Label: ' . $genre_taxonomy->label . '</p>';
    echo '<p>Hierarchical: ' . ( $genre_taxonomy->hierarchical ? 'Yes' : 'No' ) . '</p>';
    echo '<p>Public: ' . ( $genre_taxonomy->public ? 'Yes' : 'No' ) . '</p>';
} else {
    echo '<p>The specified taxonomy does not exist.</p>';
}

関連する関数

  • register_taxonomy(): 新しいタクソノミーを登録するための関数。この関数を使用して、新たなタクソノミーをカスタム投稿タイプや既存の投稿タイプに関連付けることができます。
  • unregister_taxonomy(): 既存のタクソノミーを解除するための関数。不要になったタクソノミーを投稿タイプから削除するために使用します。
  • get_object_taxonomies(): 特定のオブジェクトタイプに関連付けられたタクソノミーを取得するための関数。特定の投稿タイプにどのようなタクソノミーが関連付けられているかを確認できます。
  • get_taxonomies(): 登録されているすべてのタクソノミーを取得するための関数。全タクソノミーを一覧表示する場合に使用します。
  • register_taxonomy_for_object_type(): 既存のタクソノミーを特定のオブジェクトタイプに関連付けるための関数。新たに追加した投稿タイプに既存のタクソノミーを適用する場合に便利です。