register_block_core_post_template()


WordPressのregister_block_core_post_template()関数は、ブロックテーマの投稿テンプレートを登録するために使用されます。この関数は、ブロックエディタで使用されるテンプレートを定義し、カスタム投稿タイプや特定のページレイアウトに適用することができます。

構文

register_block_core_post_template( string $post_type, array $template );

引数の説明:

  • $post_type(string) — テンプレートを適用する投稿タイプの名前。
  • $template(array) — テンプレートの構造を定義する配列。ブロックの配列を含む。

例1: 基本的な投稿テンプレートの登録

この例では、標準の投稿タイプに対してシンプルなテンプレートを登録します。

register_block_core_post_template( 'post', array( array( 'core/paragraph', array( 'content' => 'これはサンプルの段落です。' ) ) ) );

例2: カスタム投稿タイプのテンプレート

カスタム投稿タイプ「book」に対してテンプレートを登録します。

register_block_core_post_template( 'book', array( array( 'core/heading', array( 'level' => 2, 'content' => '書籍タイトル' ) ), array( 'core/paragraph', array( 'content' => '書籍の説明をここに記述します。' ) ) ) );

例3: 複数のブロックを含むテンプレート

複数のブロックを使用してテンプレートを作成します。

register_block_core_post_template( 'post', array( array( 'core/image', array( 'align' => 'center' ) ), array( 'core/heading', array( 'level' => 2, 'content' => '見出し' ) ), array( 'core/paragraph', array( 'content' => '本文の内容' ) ) ) );

例4: カスタムブロックを使用したテンプレート

カスタムブロック「my-plugin/custom-block」を使用してテンプレートを定義します。

register_block_core_post_template( 'post', array( array( 'my-plugin/custom-block', array( 'attribute' => 'value' ) ) ) );

例5: テンプレートのロック

テンプレートをロックして編集を制限します。

register_block_core_post_template( 'post', array( array( 'core/paragraph', array( 'content' => 'この内容は編集できません。' ) ), array( 'templateLock' => 'all' ) ) );

例6: カスタム属性を持つブロック

カスタム属性を持つブロックをテンプレートに追加します。

register_block_core_post_template( 'post', array( array( 'core/quote', array( 'align' => 'wide', 'className' => 'custom-quote' ) ) ) );

例7: 動的なブロックを使用

動的なブロックを使用してテンプレートを作成します。

register_block_core_post_template( 'post', array( array( 'core/latest-posts', array( 'postsToShow' => 5 ) ) ) );

注意点

  • テンプレートを登録する際は、投稿タイプが正しく設定されていることを確認してください。
  • テンプレートのロック機能を使用する場合、ユーザーが編集できないように注意してください。
  • カスタムブロックを使用する場合は、そのブロックが正しく登録されていることを確認してください。

関連機能：