文章模板文件

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

Index.php

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

通常,您将需要独特的内容结构或布局,具体取决于显示的内容。 您可以使用许多模板来根据站点内的上下文自定义内容结构。 两个最引人注目的文章模板文件是home.phpsingle.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.phpindex.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.phpdate.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.phpmonth.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中, 通常只会提取摘要而不是全文内容。

该文章对您有帮助吗?

暂无评论

发表评论