文章模板

WordPress使用许多模板文件来显示“文章”（post）这种文章类型（post type）。任何与博客或其文章相关的内容都属于这个post类型。

Index.php

如果没有其他模板文件，index.php将显示“post”这种文章类型。正如许多地方所说，每个主题都必须有一个index.php文件才有效。许多基本的主题可以只使用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()包含进来的，然后是两个html标签，接下来循环开始，先用模板标签 get_template_part( 'content', get_post_format()); 通过get_post_format()来确定文章格式，得到对应的模板片段并包含进来。然后是使用模板标签comments_template()用来显示评论内容。然后是分页代码。最后，内容divs被关闭，使用get_footer()插入页脚。

Singular.php

WordPress 4.3版本增加了singular.php，它在层次结构中排在用于文章的single.php和用于页面page.php之后。这个模板遵循is_singular()的规则，用于单个文章，与文章类型无关。那些在这两个文件中使用相同代码的主题（或在其中一个文件直接引入另一个）现在可以简化为一个模板。

Archive.php

除非开发者在他们的模板中使用带有元数据的永久链接，否则archive.php将不会被使用。元数据是与文章相联系的信息。例如，某物发布的日期，作者，以及任何类别，标签，或用于文章的分类法都是元数据的例子。当一个网站的访问者点击元数据时，archive.php将呈现与该元数据相关的文章。例如，如果一个访问者点击一个作者的名字，archive.php将显示该作者的所有文章。

通常情况下，archive.php显示的页面标题将是用户点击的元数据的名称。因此，如果用户点击了作者的名字，显示所有其他作者的文章的页面名称将是作者的名字，而且经常会有一个关于元数据的额外描述。下面是Twenty Fifteen在其achive.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 -->

此外，也许巧克力是你正在建立的主题的一个非常重要的标签。建立一个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将只显示摘录而不是完整的内容，因为用户正试图确定该文章或页面是否符合他们的搜索。

Index.php

Home.php

Single.php

Singular.php

Archive.php

Author.php and Date.php

Author.php

Date.php

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

Search.php