投稿テンプレートファイル（Post Template Files）

Index.php

index.php は、他にテンプレートファイルがない場合に Post ポストタイプを表示します。多くの場所で述べられているように、すべてのテーマには index.php ファイルが必要です。多くの基本的なテーマは、Post ポストタイプを表示するために index.php を使用するだけで済みますが、上記の使用例は他のテンプレートファイルを作成する正当な理由となります。

表示される内容に応じて、ユニークなコンテンツ構造やレイアウトが必要になることがよくあります。サイト内のコンテキストに基づいてコンテンツ構造をカスタマイズするために使用できるテンプレートは多数あります。最も注目すべきポストテンプレートファイルは home.php と single.php で、それぞれポストのフィードと単一のポストを表示します。

Home.php

静的なフロントページが使用され、サイトにブログリスト用に定義されたページがある場合、home.php ファイルが指定されたブログリストページに使用されます。このテンプレートの使用は、カスタムページテンプレートを作成するよりも推奨されます。なぜなら、カスタムページテンプレートでのブログのページネーションは正しく機能しないからです。テーマに home.php がない場合は、index.php が代わりに使用されます。

Single.php

テンプレート構造をできるだけシンプルに構築し、実際に必要でない限り、テンプレートを増やさないことが賢明です。したがって、ほとんどのテーマ開発者は single-post.php ファイルを作成しません。なぜなら single.php は十分に特定的だからです。ほとんどのテーマには single.php が必要です。以下は、テーマ Twenty Fifteen の single.php ファイルの例です。

<?php
/**
 * The template for displaying all single posts and attachments
 *
 * @package WordPress
 * @subpackage Twenty_Fifteen
 * @since Twenty Fifteen 1.0
 */
get_header(); ?>
   <div id="primary" class="content-area">
   <main id="main" class="site-main" role="main">
   <?php
   // Start the loop.
   while ( have_posts() ) : the_post();
   /*
             * Include the post format-specific template for the content. If you want to
             * use this in a child theme, then include a file called called content-___.php
             * (where ___ is the post format) and that will be used instead.
   */
   get_template_part( 'content', get_post_format() );
   // If comments are open or we have at least one comment, load up the comment template.
   if ( comments_open() || get_comments_number() ) :
   comments_template();
   endif;
   // Previous/next post navigation.
   the_post_navigation( array(
   'next_text' => '<span class="meta-nav" aria-hidden="true">' . __( 'Next', 'twentyfifteen' ) . '</span> ' .
   '<span class="screen-reader-text">' . __( 'Next post:', 'twentyfifteen' ) . '</span> ' .
   '<span class="post-title">%title</span>',
   'prev_text' => '<span class="meta-nav" aria-hidden="true">' . __( 'Previous', 'twentyfifteen' ) . '</span> ' .
   '<span class="screen-reader-text">' . __( 'Previous post:', 'twentyfifteen' ) . '</span> ' .
   '<span class="post-title">%title</span>',
   ) );
   // End the loop.
   endwhile;
   ?>
   </main><!-- .site-main -->
   </div><!-- .content-area -->
<?php get_footer(); ?>

上記のコード例では、ヘッダーが get_header() で取り込まれ、その後に2つの HTML タグがあります。次に the Loop が始まり、template tag get_template_part( ``````````'content'``````````, get_post_format()); が get_post_format() でポストタイプを判断して適切なコンテンツを取り込みます。次に、comments がテンプレートタグ comments_template() で取り込まれます。その後、pagination があります。最後に、コンテンツの div が閉じられ、フッターが get_footer() で取り込まれます。

Singular.php

WordPress バージョン 4.3 では、singular.php が追加され、ポスト用の single.php の後、ページ用の page.php とその各バリエーションの階層に入ります。このテンプレートは is_singular() のルールに従い、ポストタイプに関係なく単一のポストに使用されます。これらのファイルの両方に同じコードを使用していたテーマ（または一方を他方に含めていたテーマ）は、今や1つのテンプレートに簡素化できます。

Archive.php

開発者がテンプレートにパーマリンクとともにメタデータを含めない限り、archive.php は使用されません。メタデータはポストに関連付けられた情報です。たとえば、投稿された日付、著者、ポストに使用される categories, tags, or taxonomies などがメタデータの例です。ウェブサイトの訪問者がメタデータをクリックすると、archive.php はそのメタデータに関連付けられたポストをレンダリングします。たとえば、訪問者が著者の名前をクリックすると、archive.php はその著者によるすべてのポストを表示します。

一般的に、archive.php によって表示されるページのタイトルは、ユーザーがクリックしたメタデータの名前になります。したがって、ユーザーが著者の名前をクリックした場合、他の著者のポストを表示するページ名は著者の名前になり、しばしばメタデータに関する追加の説明があるかもしれません。以下は、Twenty Fifteen の archive.php ファイルからのコード例です。このスニペットは、archive.php ファイルを home.php または index.php ファイルと異なるものにする唯一のコードの部分です。

<header class="page-header">
   <?php
   the_archive_title( '<h1 class="page-title">', '</h1>' );
   the_archive_description( '<div class="taxonomy-description">', '</div>' );
   ?>
</header>
<!-- .page-header -->

Author.php and Date.php

Author.php と date.php は、より特定的なアーカイブタイプのファイルです。リフレッシャーが必要な場合は、template heirarchy の中でどのように位置付けられているかを確認してください。一般的に、archive.php はほとんどのテーマのニーズに十分であり、これらのテンプレートを作成する必要はありません。

Author.php

複数の著者向けに設計されたテーマを構築している場合、author.php テンプレートを作成することは理にかなっています。author.php テンプレートでは、著者に関する詳細情報、グラバター、ソーシャルメディアサイトを取り込み、彼らが書いたすべてのポストを表示できます。これは、archive.php ファイルに依存するよりも一歩進んだものです。

さらに、著者 ID またはニックネームを使用して、個々の著者用の特定の author.php ファイルを作成できます。たとえば、ジョン・ドーが多くのゲスト著者を持つサイトの主な著者であるとします。すべてのゲスト著者の情報を author.php で表示したいかもしれませんが、ジョン・ドーの著者 ID が 3 の場合、author-johndoe.php または author-3.php を作成して、彼に関する詳細情報を表示する特定の著者ページを作成することができます。

Date.php

同様に、雑誌やニュースウェブサイト向けに設計されたテーマを構築している場合、date.php ファイルを作成することは理にかなっています。これらのウェブサイトは、記事やポストを日付や号で整理することがよくあるからです。さらに、十分な正当性がある場合は、day.php、month.php、または year.php を作成することもできます。

Category.php, Tag.php, and Taxonomy.php

カテゴリ、タグ、& タクソノミーについてのリフレッシャーが必要な場合は、彼らのページを確認できます。通常、これらのテンプレートファイルを構築する必要はありません。しかし、フードブロガー向けのテーマを構築する例では、これらの特定のテンプレートを構築するためのいくつかの使用例があります。フードブロガーのウェブサイトでは、カテゴリは「素晴らしいレストラン」、「美しい料理」、「エスニック料理」、「レシピ」などになる可能性があります。

ほとんどのブログポストは同じ方法で表示されることを望むかもしれませんが、レシピとしてカテゴライズされたブログは除外されるかもしれません。なぜなら、すべてのレシピには材料と手順のセクションがあるからです。したがって、レシピブログポストを重要な詳細が見えるグリッドビューで表示するために、category-recipe.php ファイルを作成したいかもしれません。

さらに、チョコレートはあなたが構築しているテーマにとって非常に重要なタグかもしれません。特化したバナー画像を表示するために tag-chocolate.php ファイルを作成することは理にかなっています。

Search.php

ほとんどのテーマには search.php ファイルがあり、ユーザーにクエリが通過したことを明確に示します。クエリ結果を識別するための何らかのヘッダーがあることが一般的で、これは Twenty Fifteen のテーマに見られるスニペットのようなものです。

<header class="page-header">
<h1 class="page-title">
   <?php printf( __( 'Search Results for: %s', 'twentyfifteen' ), get_search_query() ); ?>
</h1>
</header><!-- .page-header -->

このコードスニペットは、get_search_query() で検索されたクエリを取り込みます。通常、search.php は、ユーザーが記事やページが検索に適合するかどうかを判断しようとしているため、全文ではなく抜粋のみを取り込みます。