内容模板文件_WordPress主题开发手册

WordPress使用多个模板文件来显示Post post类型。处理博客或其帖子的任何内容都属于Post Post类型。

Index.php

如果没有其他模板文件，index.php将显示Post post类型。如许多地方所述，每个主题都必须有一个index.php文件才能生效。许多基本的主题可以通过使用index.php来显示他们的Post post类型，但上面给出的用例可以证明创建其他模板文件。

通常，您将需要独特的内容结构或布局，具体取决于显示的内容。您可以使用许多模板来根据站点内的上下文自定义内容结构。两个最引人注目的帖子模板文件是home.php和single.php，分别显示帖子和单个帖子。

Home.php

当使用静态首页并且站点具有为博客列表定义的页面时，home.php文件用于指定的博客列表页面。鼓励使用此模板创建自定义页面模板，因为自定义页面模板上的博客分页将无法正常工作。如果在主题index.php中没有home.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（）引入注释。然后有一些分页。最后，内容div被关闭，然后用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 -->

Author.php 和 Date.php

Author.php和date.php是更具体的存档类型文件。如果您需要一个复习，请查看他们在模板范围内适合的位置。通常，archive.php将满足大多数主题的需求，您不需要创建这些模板。

Author.php

如果你正在为多个作者设计一个主题，那么构建一个author.php模板可能是有意义的。在author.php模板中，您可以提供有关作者，他们的图形，拉入他们的社交媒体网站以及他们写的所有帖子的更多信息。这将是依赖于archive.php文件的一个步骤。

此外，您可以使用其作者ID或nicename为个别作者构建特定的author.php文件。例如，说John Doe是有许多客座作者的网站的头号作者。您可能希望所有访客作者的信息与author.php一起显示，但如果作者ID为3，则可以通过创建author-johndoe.php或author-3.php来构建具有John Doe更多信息的特定作者页面。

Date.php

同样，如果您正在构建一个专门针对杂志或新闻网站的主题，那么date.php文件可能会有所修改，因为这些网站经常按日期或问题组织文章和帖子。另外，如果你找到了足够的理由，你可以建立一个day.php，month.php或者year.php。

Category.php, Tag.php 和 Taxonomy.php

如果您需要重新分析哪些类别，标签和分类法，您可以查看他们的页面。通常，您不需要构建这些模板文件。然而，在为食品博客撰写主题的例子中，有一些用例来构建这些特定的模板。在食品博客网站上，类别可能是美食，美食，民族美食和食谱。

您可能希望大部分的博文都以相同的方式显示，除了任何分类为食谱的博客，因为所有食谱都有成分和分析部分。因此，您可能需要构建一个category-recipe.php文件，以在网格视图中显示您的食谱博客文章，其中包含有关配方可见的一些重要详细信息。

此外，也许巧克力是您正在建立的主题的一个非常重要的标签。构建tag-chocolate.php文件可能是有意义的，以便您可以显示巧克力的专门横幅图像。

Search.php

大多数主题都有一个search.php文件，所以用户清楚他们的查询是通过的。通常有一些标题查询结果的标题，例如这个二十五分之二的主题的代码段。

<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只会提取摘录而不是完整内容，因为用户尝试确定文章或页面是否适合其搜索。

下一节：页面模板是可以应用于特定页面或一组页面的特定类型的模板文件。