get_taxonomies() の使い方｜説明・引数・注意点

説明

基本構文

get_taxonomies( array|string $args = array(), string $output = 'names', string $operator = 'and' ): string[]|WP_Taxonomy[]

引数

• $args：絞り込み条件（public、object_type など）
• $output：names または objects
• $operator：and / or

戻り値

タクソノミーの名前（またはオブジェクト）の配列。

使い方（サンプル）

$list = get_taxonomies( array( 'public' => true ) );

注意点

• カスタムタクソノミーだけを取得するには _builtin => false を指定します。

実務での使いどころ

• 登録されているタクソノミーの、名前の一覧を取得するとき。
• 独自に追加したタクソノミーだけを、取得するとき（'_builtin' => false）。

よくあるミスと対処

• $output の既定は names（名前の配列）。オブジェクトが欲しいときは、objects を指定する。
• init フックより前に呼び、登録が済んでいない。
• 絞り込みの指定を、しない。標準のタクソノミーも含まれる。

NG例

$list = get_taxonomies(); // 標準のタクソノミーも含まれる

OK例

$list = get_taxonomies( array( 'public' => true, '_builtin' => false ), 'objects' );
foreach ( $list as $tax ) {
	echo esc_html( $tax->label );
}

使い分け早見表

関連項目

get_taxonomy()、taxonomy_exists()

公式リファレンス：get_taxonomies() | Function | WordPress Developer Resources