WordPress主题中使用模板文件,但首先让我们了解术语。
## 模板术语
使用WordPress主题时,术语“模板”以不同的方式使用:
- 主题中存在模板文件,并表达您的网站的显示方式。
- 页面模板是仅适用于页面以更改其外观的页面模板。 页面模板可以应用于单个页面,页面部分或一类页面。
- 模板标签是内置的WordPress功能,您可以在模板文件中使用来检索和显示数据(如the_title()和the_content())。
- 模板层次结构是WordPress用于根据所请求的内容决定要使用哪个主题模板文件的逻辑。
## 模板文件
WordPress主题由模板文件组成。这些是包含HTML,模板标签和PHP代码混合的PHP文件。
当您构建主题时,您将使用模板文件来影响网站不同部分的布局和设计。例如,您可以使用header.php模板来创建一个页头,或者使用comments.php模板来包含评论。
当有人访问您网站上的页面时,WordPress会根据请求加载模板。由模板文件显示的内容类型由与模板文件相关联的帖子类型确定。模板层次结构描述了WordPress将根据请求的类型以及主题中是否存在模板来加载哪个模板文件。服务器然后解析模板中的PHP,并将HTML返回给访问者。
最关键的模板文件是index.php,如果在模板层次结构中找不到更具体的模板,那么它就是全部的模板。虽然主题只需要一个index.php模板,通常主题包括许多模板来显示不同的内容类型和上下文。
## 模板部分
模板部分是作为另一个模板的一部分包括的一个模板,例如站点头。 模板部分可以嵌入多个模板,简化主题创建。 常见的模板部分包括:
- header.php 用于生成站点的头文件
- footer.php 用于生成页脚
- sidebar.php 用于生成侧边栏
- searchform.php 用于生成搜索表单
虽然上述模板文件是WordPress中的特殊情况,仅适用于页面的一部分,您可以创建任意数量的模板部分,并将它们包含在其他模板文件中。
## 常用的WordPress模板文件
以下是WordPress识别的一些基本主题模板和文件的列表。
- `index.php` 主模板文件。 所有主题都是必需的。
- `style.css` 主要样式表。 它在所有主题中都是必需的,并且包含主题的信息标题。
- `rtl.css` 如果网站语言的文本方向是从右到左,则自动包含从右到左的样式表。
- `comments.php` 评论模板。
- `front-page.php` 首页模板始终用作站点首页(如果存在),无论管理员>设置>阅读上的设置如何。
- `home.php` 默认情况下,主页模板是首页模板。 如果您没有将WordPress设置为使用静态首页,则此模板用于显示最新的帖子。
- `header.php` 标题模板文件通常包含您的站点的文档类型,元信息,样式表和脚本的链接以及其他数据。
- `singular.php` 单独的模板用于没有找到single.php的帖子,或者当没有找到page.php的页面时。 如果没有找到singular.php,则使用index.php。
- `single.php` 当访问者请求单个帖子时,使用单个帖子模板。
- `single-{post-type}.php` 访问者从自定义帖子类型请求单个帖子时使用的单个帖子模板。 例如,single-book.php将用于从定制的帖子类型命名的书中显示单个帖子。 如果不存在自定义帖子类型的特定查询模板,则使用index.php。
- `archive-{post-type}.php` 当访问者请求自定义帖子类型归档时,将使用归档文件类型模板。 例如,archive-books.php将用于显示自定义帖子类型命名书籍的帖子存档。 如果archive-{post-type} .php不存在,则使用archive.php模板文件。
- `page.php` 当访问者请求单独的页面(内置模板)时,将使用页面模板。
- `page-{slug}.php` 访问者请求特定页面时使用页面插件模板,例如使用“about”slug(page-about.php)的页面插件模板。
- `category.php` 当访问者按类别请求帖子时,将使用类别模板。
- `tag.php` 当访问者通过标签请求帖子时,使用标记模板。
- `taxonomy.php` 当访问者在自定义分类法中请求术语时,将使用分类术语模板。
- `author.php` 访问者加载作者页面时,将使用作者页面模板。
- `date.php` 日期/时间模板在通过日期或时间请求帖子时使用。 例如,使用这些子生成的页面:
- http://example.com/blog/2014/
- http://example.com/blog/2014/05/
- http://example.com/blog/2014/05/26/
- `archive.php` 当访问者按类别,作者或日期请求帖子时,使用归档模板。 注意:如果存在类似于category.php,author.php和date.php的更多特定模板,则此模板将被覆盖。
- `search.php` 搜索结果模板用于显示访问者的搜索结果。
- `attachment.php` 当查看单个附件(如图像,pdf或其他媒体文件)时,将使用附件模板。
- `image.php` 图像附件模板是attachment.php的更具体的版本,在查看单个图像附件时使用。 如果不存在,WordPress将使用attachment.php。
- `404.php` 当WordPress找不到与访问者请求相匹配的帖子,页面或其他内容时,将使用404模板。
## 使用模板文件
在WordPress模板中,您可以使用模板标签动态显示信息,包括其他模板文件,或以其他方式自定义您的网站。
例如,在index.php中,您可以在最终生成的页面中包含其他文件:
- 要包括标题,请使用 get_header()
- 要包含边栏,请使用 get_sidebar()
- 要包括页脚,请使用 get_footer()
- 要包含搜索表单,请使用 get_search_form()
- 要包括自定义主题文件,请使用 get_template_part()
以下是WordPress模板标记的示例,以将特定的模板包含在您的页面中:
```
<?php get_sidebar(); ?>
<?php get_template_part( 'featured-content' ); ?>
<?php get_footer(); ?>
```
- 简介
- 主题开发
- 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
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类