has_term_meta()


WordPressのhas_term_meta()関数は、指定されたタームに関連付けられたメタデータが存在するかどうかを確認するために使用されます。

構文

has_term_meta( int $term_id, string $meta_key = '', mixed $meta_value = '' );

引数の説明:

  • $term_id (int) — 確認したいタームのID。
  • $meta_key (string) — 確認したいメタデータのキー（省略可能）。
  • $meta_value (mixed) — 確認するメタデータの値（省略可能）。

例 1: 特定のタームにメタデータが存在するか確認

<?php if ( has_term_meta( get_queried_object_id(), 'example_key' ) ) { echo 'メタデータが存在します。'; } ?>

例 2: 特定の値を持つメタデータを確認

<?php if ( has_term_meta( get_queried_object_id(), 'example_key', 'example_value' ) ) { echo '指定された値が見つかりました。'; } ?>

例 3: メタデータが存在しない場合の処理

<?php
if ( ! has_term_meta( get_queried_object_id(), 'custom_key' ) ) {
    echo 'このタームにはメタデータが設定されていません。';
}
?>

例 4: 条件に基づいてカスタムメタデータを追加

<?php
if ( ! has_term_meta( get_queried_object_id(), 'new_key' ) ) {
    add_term_meta( get_queried_object_id(), 'new_key', 'new_value' );
}
?>

例 5: メタデータの存在を確認して表示

<?php
if ( has_term_meta( get_queried_object_id(), 'display_key' ) ) {
    echo get_term_meta( get_queried_object_id(), 'display_key', true );
}
?>

注意点

  • この関数はタームメタデータにのみ使用され、投稿メタデータやユーザーメタデータには使用できません。
  • $meta_keyまたは$meta_valueを指定しない場合、タームに関連するすべてのメタデータの存在を確認します。

関連機能：