render_block_core_post_template()


WordPressのrender_block_core_post_template()関数は、投稿テンプレートブロックをレンダリングするために使用されます。この関数は、投稿のリストやグリッド表示を動的に生成する際に役立ちます。

構文

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

引数の説明:

  • $attributes (array) — ブロックの属性を指定します。例えば、表示する投稿数やレイアウト設定など。
  • $content (string) — ブロックのコンテンツを指定します。通常は空です。
  • $block (WP_Block) — 現在のブロックオブジェクトを指定します。

例1: 基本的な投稿テンプレートのレンダリング

この例では、投稿テンプレートブロックをレンダリングします。

echo render_block_core_post_template( array( 'postType' => 'post', 'displayPostContent' => true ), '', $block );

例2: カスタム投稿タイプの表示

カスタム投稿タイプ「event」の投稿を表示します。

echo render_block_core_post_template( array( 'postType' => 'event', 'postsToShow' => 5 ), '', $block );

例3: 投稿内容を表示しない設定

投稿のタイトルのみを表示し、内容は表示しません。

echo render_block_core_post_template( array( 'postType' => 'post', 'displayPostContent' => false ), '', $block );

例4: グリッドレイアウトの設定

投稿をグリッドレイアウトで表示します。

echo render_block_core_post_template( array( 'postType' => 'post', 'layout' => array( 'type' => 'grid' ) ), '', $block );

例5: 特定のカテゴリーの投稿を表示

カテゴリーIDが2の投稿のみを表示します。

echo render_block_core_post_template( array( 'postType' => 'post', 'categories' => array( 2 ) ), '', $block );

例6: 投稿の並び順を変更

投稿を新しい順に並べ替えて表示します。

echo render_block_core_post_template( array( 'postType' => 'post', 'order' => 'desc', 'orderBy' => 'date' ), '', $block );

例7: カスタムクエリの使用

カスタムクエリを使用して特定の条件に合致する投稿を表示します。

echo render_block_core_post_template( array( 'postType' => 'post', 'query' => array( 'author__in' => array( 1 ) ) ), '', $block );

注意点

  • この関数は、ブロックエディター内での使用を前提としています。テーマやプラグインで直接使用する場合は、適切なコンテキストを確保してください。
  • 属性やクエリの設定を誤ると、意図しない投稿が表示される可能性があります。テスト環境で確認してから本番環境に適用してください。

関連機能：