概要
has_term 関数は、投稿記事にタクソノミーが付属しているか調べるために使用される関数です。主に以下のような機能を実装する際に利用されます。
- 投稿が特定のカテゴリに属しているかの確認
- カスタムタクソノミーの存在確認
- タグの有無判定
- 特定の条件に基づく表示コンテンツの制御
- テーマやプラグインの設定における条件分岐
- 投稿のフィルタリング
- ユーザーインターフェースの動的変更
- SEO最適化に向けた分類管理
構文
has_term( $term, $taxonomy, $post );
パラメータ
– $term (string|int): 確認したいタームのスラッグ、ID、または配列。
– $taxonomy (string): 確認したいタクソノミーの名前(例: ‘category’, ‘post_tag’)。
– $post (int|WP_Post): 確認対象の投稿オブジェクトまたはそのID。指定しない場合は現在の投稿が使用される。
戻り値
– タクソノミーが指定したタームを含む場合には true、そうでない場合には false を返します。
関連する関数
– term_exists
– get_the_terms
– wp_get_post_terms
– has_category
– has_tag
使用可能なバージョン
– WordPress 2.5.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 |
この関数は、特定のバージョンで非推奨や削除はされていません。