get_template_part()


WordPressのget_template_part()関数は、テーマ内で再利用可能なテンプレートパーツを読み込むために使用されます。これにより、コードの重複を避け、テーマのメンテナンスが容易になります。

構文

get_template_part( string $slug, string $name = null );

引数の説明:

  • $slug (string) — 読み込むテンプレートファイルのスラッグ（必須）。
  • $name (string) — テンプレートファイルの名前（オプション）。指定すると、スラッグと名前を組み合わせたファイルが読み込まれます。

例1: 基本的なテンプレートパーツの読み込み

スラッグを指定してテンプレートパーツを読み込みます。

<?php get_template_part( 'content' ); ?>

例2: スラッグと名前を指定してテンプレートパーツを読み込む

スラッグと名前を指定して、特定のテンプレートパーツを読み込みます。

<?php get_template_part( 'content', 'single' ); ?>

例3: ループ内でのテンプレートパーツの使用

ループ内でテンプレートパーツを使用して、投稿の内容を表示します。

<?php while ( have_posts() ) : the_post(); get_template_part( 'content', get_post_format() ); endwhile; ?>

例4: カスタム投稿タイプ用のテンプレートパーツ

カスタム投稿タイプ用のテンプレートパーツを読み込みます。

<?php get_template_part( 'content', 'custom-post-type' ); ?>

例5: 条件分岐を使用したテンプレートパーツの読み込み

条件に応じて異なるテンプレートパーツを読み込みます。

<?php if ( is_single() ) { get_template_part( 'content', 'single' ); } else { get_template_part( 'content', 'archive' ); } ?>

注意点

  • テンプレートファイルはget_template_part()が呼び出されたテーマディレクトリ内に存在する必要があります。
  • ファイル名は{$slug}-{$name}.phpの形式で命名する必要があります。
  • 指定したファイルが存在しない場合、WordPressは{$slug}.phpを探します。

関連機能：