build_template_part_block_instance_variations()


WordPressのbuild_template_part_block_instance_variations()関数は、テンプレートパーツブロックのインスタンスバリエーションを生成するために使用されます。この関数は、テーマ開発者が動的にテンプレートパーツのバリエーションを作成する際に役立ちます。

構文

build_template_part_block_instance_variations( string $slug, array $args = array() );

引数の説明:

  • $slug (string) — テンプレートパーツのスラッグを指定します。
  • $args (array) — テンプレートパーツに渡す追加の引数を指定します。

例1: 基本的なテンプレートパーツの生成

この例では、シンプルなテンプレートパーツを生成します。

build_template_part_block_instance_variations( 'header' );

例2: カスタム引数を使用したテンプレートパーツの生成

カスタム引数を渡してテンプレートパーツを生成します。

build_template_part_block_instance_variations( 'footer', array( 'class' => 'custom-footer' ) );

例3: 動的なスラッグを使用したテンプレートパーツの生成

動的にスラッグを指定してテンプレートパーツを生成します。

$slug = 'sidebar-' . get_post_type(); build_template_part_block_instance_variations( $slug );

例4: 条件付きでテンプレートパーツを生成

特定の条件に基づいてテンプレートパーツを生成します。

if ( is_front_page() ) { build_template_part_block_instance_variations( 'home-header' ); }

例5: 複数のテンプレートパーツを一度に生成

複数のテンプレートパーツを一度に生成します。

$parts = array( 'header', 'footer' ); foreach ( $parts as $part ) { build_template_part_block_instance_variations( $part ); }

例6: カスタムフィールドを使用したテンプレートパーツの生成

カスタムフィールドの値に基づいてテンプレートパーツを生成します。

$custom_slug = get_post_meta( get_the_ID(), 'custom_template_slug', true ); build_template_part_block_instance_variations( $custom_slug );

例7: テンプレートパーツに動的なクラスを追加

動的にクラスを追加してテンプレートパーツを生成します。

$dynamic_class = 'dynamic-class-' . rand( 1, 10 ); build_template_part_block_instance_variations( 'header', array( 'class' => $dynamic_class ) );

注意点

  • この関数は、テーマ開発者がテンプレートパーツのバリエーションを動的に生成するためのものです。プラグインや他のカスタムコードで使用する場合は、適切なフックやフィルターを使用してください。
  • スラッグは一意である必要があります。重複するスラッグを使用すると、予期しない動作が発生する可能性があります。

関連機能：