WordPress主题开发手册：文章模板文件

WordPress使用多个模板文件来显示【文章】这个文章类型。处理博客或其文章的任何内容都属于【文章】文章类型。

文章目录

Index.php

如果没有其他模板文件，index.php将显示【文章】文章类型。如许多地方所述，每个主题都必须有一个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
/**
 * 用来显示单个文章或所有附件的模板
 *
 * @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文件的一个步骤。

另外，您可以在author.php使用作者ID或nicename为个别作者构建特定的文件。例如，假设John Doe是一个包含许多来宾作者的网站的主要作者。您可能希望所有来宾作者的信息都显示在author.php中，那您可以依据nicename John Doe来创建 author-johndoe.php或依据 John Doe 的ID为3来创建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文件，因此用户可以清楚地查询到它们。通常有某种形式的标头标识查询结果，例如在 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中，通常只会提取摘要而不是全文内容。

这篇文章对您有用吗？是 3 否 2

{{userData.name}}已认证