render_block_core_post_terms()


WordPressのrender_block_core_post_terms()関数は、投稿に関連付けられたターム（カテゴリやタグなど）を表示するためのコアブロックをレンダリングするために使用されます。

構文

render_block_core_post_terms( array $attributes, string $content, WP_Block $block );

引数の説明:

  • $attributes(array) — ブロックの属性を指定します。例えば、タームのタイプや表示形式など。
  • $content(string) — ブロックのコンテンツ。通常は空です。
  • $block(WP_Block) — ブロックオブジェクト。ブロックのコンテキストや設定を保持します。

例1: カテゴリを表示する

この例では、投稿に関連付けられたカテゴリを表示します。

echo render_block_core_post_terms( array( 'term' => 'category' ), '', $block );

例2: タグを表示する

この例では、投稿に関連付けられたタグを表示します。

echo render_block_core_post_terms( array( 'term' => 'post_tag' ), '', $block );

例3: カスタムタクソノミーを表示する

この例では、カスタムタクソノミー「genre」を表示します。

echo render_block_core_post_terms( array( 'term' => 'genre' ), '', $block );

例4: リンクなしでタームを表示する

この例では、タームをリンクなしで表示します。

echo render_block_core_post_terms( array( 'term' => 'category', 'isLink' => false ), '', $block );

例5: タームをカンマ区切りで表示する

この例では、タームをカンマ区切りで表示します。

echo render_block_core_post_terms( array( 'term' => 'category', 'separator' => ', ' ), '', $block );

例6: タームをリスト形式で表示する

この例では、タームをリスト形式で表示します。

echo render_block_core_post_terms( array( 'term' => 'category', 'displayAsList' => true ), '', $block );

例7: タームの前にテキストを追加する

この例では、タームの前に「カテゴリ:」というテキストを追加します。

echo render_block_core_post_terms( array( 'term' => 'category', 'prefix' => 'カテゴリ: ' ), '', $block );

注意点

  • この関数は、ブロックエディタ内で使用されることを前提としています。
  • カスタムタクソノミーを使用する場合、タクソノミーが正しく登録されていることを確認してください。
  • タームが存在しない場合、何も表示されません。

関連機能：