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只会提取摘录而不是完整内容,因为用户尝试确定文章或页面是否适合其搜索。
- 简介
- 主题开发
- WordPress许可证
- 什么是主题
- 开发环境
- 主题开发示例
- 主题基础
- 模板文件
- 主样式表(style.css)
- 文章类型
- 规划主题文件
- 模板层级
- 模板标签
- 循环
- 主题函数
- 连接主题文件和目录
- 使用CSS和JavaScript
- 条件标签
- 类别,标签和自定义分类
- 模板文件
- 内容模板文件
- 页面模板文件
- 附件模板文件
- 自定义内容类型
- 部分和其他模板文件
- 评论模板
- 分类模板
- 404页面
- 主题功能
- 核心支持的功能
- 管理菜单
- 自定义Headers
- 自定义Logo
- 文章格式
- 置顶文章
- Sidebars
- Widgets
- 导航菜单
- 分页
- 媒体
- Audio
- Images
- Galleries
- Video
- 精选图片和缩略图
- 国际化
- 本地化
- 辅助功能
- 主题选项 – 自定义API
- 定制对象
- 改进用户体验的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定义控件
- 高级用法
- 主题安全
- 数据消毒/逃避
- 数据验证
- 使用随机数
- 常见漏洞
- 高级主题
- 子主题
- UI最佳实践
- JavaScript最佳做法
- 主题单元测试
- 验证你的主题
- Plugin API Hooks
- 发布你的主题
- 所需的主题文件
- 测试
- 主题评论指南
- 写文档
- 提交你的主题到WordPress.org
- 参考文献
- 模板标签列表
- 条件标签列表
- 编码标准
- HTML编码标准
- CSS编码标准
- JavaScript编码标准
- PHP编码标准
- 插件开发
- 插件开发简介
- 什么是插件
- 插件基础
- 头部要求
- 包括软件许可证
- 启用 / 停用 Hooks
- 卸载方法
- 最佳做法
- 插件安全
- 检查用户功能
- 数据验证
- 保护输入
- 保护输出
- 随机数
- Hooks
- Actions
- Filters
- 自定义Hooks
- 高级主题
- 管理菜单
- 顶级菜单
- 子菜单
- 短代码
- 基本短码
- 封闭短码
- 带参数的短代码
- TinyMCE增强型短码
- 设置
- 设置API
- 使用设置API
- 选项API
- 自定义设置页面
- 元数据
- 管理帖子元数据
- 自定义元数据
- 渲染元数据
- 自定义文章类型
- 注册自定义文章类型
- 使用自定义文章类型
- 分类
- 使用自定义分类
- 在WP 4.2+中使用“split术语”
- 用户
- 创建和管理用户
- 使用用户元数据
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服务器端PHP和入队
- Heartbeat API
- 概要
- 计划任务
- 了解WP-Cron计划
- 安排WP-Cron 事件
- 将WP-Cron挂接到系统任务计划程序中
- WP-Cron简单测试
- 国际化
- 本地化
- 如何国际化您的插件
- 国际化安全
- WordPress.org
- 详细插件指南
- 规划您的插件
- 如何使用Subversion
- 插件开发者常见问题
- 开发工具
- Debug Bar 和附加组件
- 辅助插件
- REST API手册
- 资源
- 文章
- 文章修订
- 文章类型
- 文章状态
- 类别
- 标签
- 页面
- 评论
- 分类
- 媒体
- 用户
- 设置
- 使用REST API
- 全局参数
- 分页
- 链接和嵌入
- 发现
- 认证
- 经常问的问题
- 骨干JavaScript客户端
- 客户端库
- 扩展REST API
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类