関数の概要
get_taxonomies()
は、WordPressで登録されているすべてのタクソノミーのリストを取得するための関数です。この関数を使用することで、カスタムタクソノミーやデフォルトのタクソノミー(カテゴリやタグなど)を含む、サイト上で使用されているすべてのタクソノミーを取得できます。特定の引数を指定することで、特定の条件に一致するタクソノミーのみを取得することも可能です。
パラメータの説明
- $args (array|string): タクソノミーをフィルタリングするための引数の配列またはクエリ文字列。例えば、
'public' => true
と指定することで公開タクソノミーのみを取得できます。 - $output (string): 結果の出力形式を指定します。
names
(デフォルト)またはobjects
のいずれかを指定できます。 - $operator (string): 引数に指定された条件をどのように評価するかを指定します。デフォルトは
and
ですが、or
を指定することもできます。
戻り値
取得したタクソノミーの配列を返します。出力形式によって、タクソノミー名の配列またはタクソノミーオブジェクトの配列となります。
使用例
// すべてのタクソノミー名を取得
$all_taxonomies = get_taxonomies();
// 公開タクソノミーのみを取得
$public_taxonomies = get_taxonomies( array( 'public' => true ) );
// タクソノミーオブジェクトを取得
$taxonomy_objects = get_taxonomies( array(), 'objects' );
foreach ( $taxonomy_objects as $taxonomy ) {
echo $taxonomy->label . '<br>';
}
関連する関数
register_taxonomy()
: 新しいタクソノミーを登録するための関数。unregister_taxonomy()
: 既存のタクソノミーを解除するための関数。get_taxonomy()
: 特定のタクソノミーの詳細を取得するための関数。get_object_taxonomies()
: 特定の投稿タイプに関連付けられたタクソノミーを取得するための関数。