概要
get_taxonomies関数は、WordPressにおけるタクソノミー情報を取得するための関数です。この関数は、カスタム分類（タクソノミー）のリストを取得し、タクソノミーの管理や表示に役立ちます。具体的には以下のような場面でよく使われます。
- カスタムtaxonomyの一覧表示
- タクソノミーに関連するカスタム投稿タイプの管理
- タクソノミーの設定でのオプション追加
- フィルタやサブメニューの表示
- タクソノミーアーカイブページの構築
- カテゴリやタグのリストを製作
- タクソノミーのカスタマイズによるSEO向上
- プラグインの設定画面におけるタクソノミーの選択
構文
get_taxonomies( $args, $output, $operator );
パラメータ
$args(mixed) – 取得するタクソノミーをフィルタリングするための条件。デフォルトは空。$output(string) – 出力形式。'names'（デフォルト）または'objects'を指定可能。$operator(string) – 複数のタクソノミーを取得する場合に使用する論理演算子。デフォルトは'and'。
戻り値
- 指定した条件に基づくタクソノミーの名前またはオブジェクトの配列。
関連する関数
使用可能なバージョン
- WordPress 2.3.0 以降
コアファイルのパス
wp-includes/taxonomy.php
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| 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 | 〇 |
この関数は特定のWordPressバージョンで非推奨または削除されたことはありません。
サンプルコード
サンプルコード 1: カスタムタクソノミーの取得
$taxonomies = get_taxonomies(array('public' => true), 'names');
foreach ($taxonomies as $taxonomy) {
echo $taxonomy . '<br>';
}
説明: 公開されているすべてのタクソノミーの名前を取得し、それを表示します。
サンプルコード 2: タクソノミーオブジェクトの取得
$taxonomies = get_taxonomies([], 'objects');
foreach ($taxonomies as $taxonomy) {
echo $taxonomy->label . '<br>';
}
説明: すべてのタクソノミーオブジェクトを取得し、各タクソノミーのラベルを表示します。
サンプルコード 3: 特定のタクソノミー情報の取得
$custom_taxonomies = get_taxonomies(array('_builtin' => false), 'names');
print_r($custom_taxonomies);
説明: ビルトインでないカスタムタクソノミーの名前を取得し、配列として表示します。
サンプルコード 4: タクソノミーの数を取得
$count = count(get_taxonomies());
echo 'Total taxonomies: ' . $count;
説明: 現在登録されているすべてのタクソノミーの数をカウントし、その数を表示します。
サンプルコード 5: 指定のタクソノミーの詳細を取得
$taxonomy = get_taxonomies(array('name' => 'category'), 'objects');
if (!empty($taxonomy)) {
echo 'Taxonomy label: ' . $taxonomy[0]->label;
}
説明: ‘category’という名前のタクソノミーのオブジェクトを取得し、対応するラベルを表示します。