tag_description()


WordPressのtag_description()関数は、指定されたタグの説明を取得するために使用されます。この関数は、タグの説明を表示する際に便利です。

構文

tag_description( int $tag_id );
  • $tag_id(int) — 説明を取得したいタグのIDを指定します。

例1: タグの説明を表示する

この例では、タグIDが5のタグの説明を表示します。

<?php echo tag_description( 5 ); ?>

例2: 現在のタグの説明を表示する

現在表示されているタグアーカイブページのタグ説明を表示します。

<?php echo tag_description( get_queried_object_id() ); ?>

例3: タグの説明を条件付きで表示する

タグに説明が設定されている場合のみ、その説明を表示します。

<?php if ( tag_description() ) { echo tag_description(); } ?>

例4: タグの説明をHTMLタグ付きで表示する

タグの説明を<p>タグで囲んで表示します。

<?php echo '<p>' . tag_description( get_queried_object_id() ) . '</p>'; ?>

例5: 特定のタグの説明を取得して変数に代入する

タグIDが10のタグの説明を取得し、変数に代入します。

<?php $tag_desc = tag_description( 10 ); ?>

例6: タグの説明をフィルタリングして表示する

タグの説明をフィルタリングして表示します。この例では、説明文の最初の50文字だけを表示します。

<?php echo substr( tag_description( get_queried_object_id() ), 0, 50 ); ?>

注意点

  • タグの説明が設定されていない場合、tag_description()は空の文字列を返します。
  • タグIDが無効な場合、関数は何も返しません。

関連機能：