block_core_post_terms_build_variations() の説明と使用例

WordPressのblock_core_post_terms_build_variations()関数は、ブロックエディタ内で使用されるターム（カテゴリーやタグなど）のバリエーションを生成するために利用されます。この関数は、投稿に関連付けられたタームを動的に表示するためのバリエーションを作成します。

構文

block_core_post_terms_build_variations( array $args );

$args(array) — タームのバリエーションを生成するための設定を含む配列。

例1: 基本的な使用例

この例では、投稿に関連付けられたタームのバリエーションを生成します。

block_core_post_terms_build_variations( array( 'taxonomy' => 'category' ) );

例2: タグのバリエーションを生成

タグに関連するバリエーションを生成する例です。

block_core_post_terms_build_variations( array( 'taxonomy' => 'post_tag' ) );

例3: カスタムタクソノミーのバリエーションを生成

カスタムタクソノミーを使用してバリエーションを生成します。

block_core_post_terms_build_variations( array( 'taxonomy' => 'custom_taxonomy' ) );

例4: 複数のタクソノミーを指定

複数のタクソノミーを指定してバリエーションを生成します。

block_core_post_terms_build_variations( array( 'taxonomy' => array( 'category', 'post_tag' ) ) );

例5: タームの表示形式を変更

タームの表示形式を変更する例です。

block_core_post_terms_build_variations( array( 'taxonomy' => 'category', 'format' => 'list' ) );

例6: タームのリンクを無効化

タームのリンクを無効化して表示します。

block_core_post_terms_build_variations( array( 'taxonomy' => 'category', 'link' => false ) );

例7: タームの数を制限

表示するタームの数を制限します。

block_core_post_terms_build_variations( array( 'taxonomy' => 'category', 'number' => 5 ) );

例8: タームの並び順を指定

タームの並び順を指定して表示します。

block_core_post_terms_build_variations( array( 'taxonomy' => 'category', 'orderby' => 'name', 'order' => 'ASC' ) );

注意点

この関数は主にブロックエディタ内で使用されるため、テーマやプラグイン開発時に直接使用する機会は限られています。
引数の指定を誤ると、期待した結果が得られない場合があります。

構文