is_taxonomy_viewable()


WordPressのis_taxonomy_viewable()関数は、指定されたタクソノミーが公開可能かどうかを判定します。カスタムタクソノミーのpublicパラメータや表示設定を確認します。

構文

is_taxonomy_viewable( string|WP_Taxonomy $taxonomy );
  • $taxonomy (string|WP_Taxonomy) — チェックするタクソノミー名またはWP_Taxonomyオブジェクト

例1: 基本的な使用法

「category」タクソノミーが表示可能かどうかを確認します。

if (is_taxonomy_viewable('category')) { echo '表示可能'; }

例2: カスタムタクソノミーのチェック

「genre」というカスタムタクソノミーの表示可否を確認します。

$viewable = is_taxonomy_viewable('genre');

例3: WP_Taxonomyオブジェクトを使用

タクソノミーオブジェクトを直接渡して確認します。

$tax_obj = get_taxonomy('post_tag'); if (is_taxonomy_viewable($tax_obj)) { /* 処理 */ }

例4: 条件分岐での利用

タクソノミーアーカイブページで表示制御を行います。

if (is_tax() && is_taxonomy_viewable(get_queried_object()->taxonomy)) { the_archive_title(); }

例5: ループ内でのチェック

現在の投稿のタクソノミーが表示可能か確認します。

foreach(get_the_taxonomies() as $tax => $terms) { if (is_taxonomy_viewable($tax)) { echo $terms; } }

例6: 管理画面での使用

管理画面で特定のタクソノミーが公開されているか確認します。

add_action('admin_init', function() { if (is_taxonomy_viewable('product_cat')) { /* 処理 */ } });

例7: カスタムクエリとの連携

クエリで取得したタクソノミーが表示可能かチェックします。

$terms = get_terms(['taxonomy' => 'location']); foreach ($terms as $term) { if (is_taxonomy_viewable($term->taxonomy)) { echo $term->name; } }

注意点

  • この関数はタクソノミーの登録後にのみ動作します
  • パフォーマンスを考慮し、ループ内での過度な使用は避けてください
  • 結果はタクソノミーのpublicとshow_uiパラメータに依存します

関連機能：