get_taxonomies()


WordPressのget_taxonomies()関数は、登録されているタクソノミー(分類法)の一覧を取得するために使用されます。カスタムタクソノミーを含むすべてのタクソノミーを取得することが可能です。

構文

get_taxonomies( array $args = array(), string $output = 'names', string $operator = 'and' );

引数の説明:

  • $args (array) — タクソノミーをフィルタリングするための引数を指定します。デフォルトは空の配列です。
  • $output (string) — 戻り値の形式を指定します。’names’(デフォルト)または’objects’を指定できます。
  • $operator (string) — 複数の条件を指定する場合の演算子を指定します。’and’(デフォルト)または’or’を指定できます。

例1: すべてのタクソノミーを取得する

この例では、登録されているすべてのタクソノミーを取得します。

$taxonomies = get_taxonomies(); print_r($taxonomies);

例2: 公開されているタクソノミーのみを取得する

この例では、公開されているタクソノミーのみを取得します。

$args = array('public' => true); $taxonomies = get_taxonomies($args); print_r($taxonomies);

例3: タクソノミーオブジェクトを取得する

この例では、タクソノミーのオブジェクト形式でデータを取得します。

$taxonomies = get_taxonomies(array(), 'objects'); print_r($taxonomies);

例4: カスタム投稿タイプに関連するタクソノミーを取得する

この例では、特定のカスタム投稿タイプに関連するタクソノミーを取得します。

$args = array('object_type' => array('custom_post_type')); $taxonomies = get_taxonomies($args); print_r($taxonomies);

例5: タクソノミーのスラッグとラベルを表示する

この例では、タクソノミーのスラッグとラベルを表示します。

$taxonomies = get_taxonomies(array(), 'objects'); foreach ($taxonomies as $taxonomy) { echo 'Slug: ' . $taxonomy->name . ', Label: ' . $taxonomy->label . '<br>'; }

例6: タクソノミーの説明を取得する

この例では、タクソノミーの説明を取得します。

$taxonomies = get_taxonomies(array(), 'objects'); foreach ($taxonomies as $taxonomy) { echo 'Description: ' . $taxonomy->description . '<br>'; }

例7: タクソノミーの階層構造を確認する

この例では、タクソノミーが階層的かどうかを確認します。

$taxonomies = get_taxonomies(array(), 'objects'); foreach ($taxonomies as $taxonomy) { echo 'Hierarchical: ' . ($taxonomy->hierarchical ? 'Yes' : 'No') . '<br>'; }

例8: カスタムタクソノミーのみを取得する

この例では、カスタムタクソノミーのみを取得します。

$args = array('_builtin' => false); $taxonomies = get_taxonomies($args); print_r($taxonomies);

注意点

  • get_taxonomies()は、デフォルトでは組み込みタクソノミー(カテゴリーやタグなど)も含みます。
  • カスタムタクソノミーを取得する場合は、'_builtin' => falseを引数に指定します。
  • 戻り値の形式を’objects’にすると、タクソノミーの詳細な情報を取得できます。

関連機能: