WordPress主题系统支持自定义帖子类型的自定义模板。 支持属于自定义帖子类型的帖子的单个显示的自定义模板已被支持,因为WordPress 3.0版和对归档显示的自定义模板的支持已在版本3.1中添加。
## 自定义帖子类型 - 模板层次结构
WordPress将通过模板层次结构,并使用它首先遇到的模板文件。所以如果要为您的acme_product自定义帖子类型创建一个自定义模板,一个好的开始是复制single.php文件,将其保存为single-acme_product.php并进行编辑。
但是,如果您不想创建自定义模板文件,WordPress将使用您的主题中已存在的文件,这将是archive.php和single.php和index.php文件。
可以使用single.php和archive.php模板文件分别显示单个帖子及其归档,自定义帖子类型的单个帖子将使用single-{post_type} .php他们的档案将使用archive-{post_type} .php如果您没有这个帖子类型的存档页面,您可以传递BLOG_URL?post_type = {post_type}其中{post_type}是register_post_type()函数的$ post_type参数。因此,对于上述示例,您可以为单个产品帖子及其归档创建单个acme_product.php和archive-acme_product.php模板文件。
或者,您可以在任何模板文件中使用is_post_type_archive()函数来检查查询是否显示给定帖子类型的归档页面以及post_type_archive_title()以显示帖子类型标题。
## 自定义帖子类型模板
- single- {post-type} .php 访问者从自定义帖子类型请求单个帖子时使用的单个帖子模板。 例如,single-acme_product.php将用于显示名为acme_product的自定义帖子类型中的单个帖子。
- archive- {post-type} .php 当访问者请求自定义帖子类型归档时,将使用归档文件类型模板。 例如,archive-acme_product.php将用于显示名为acme_product的自定义帖子类型的帖子存档。 如果archive-{post-type} .php不存在,则使用archive.php模板文件。
- search.php 搜索结果模板用于显示访问者的搜索结果。 要包含您的自定义帖子类型的搜索结果,请参阅下面的代码示例。
- index.php 如果定制帖子类型的特定查询模板(single-{post-type} .php,single.php,archive- {post-type} .php,archive.php,search.php)为 不存在。
## 搜索自定义帖子类型
默认情况下,搜索结果不包括自定义帖子类型内容到搜索结果中。 代码可以附加到functions.php以在搜索结果中包含CPT:
```
// Show posts of 'post', 'page', 'acme_product' and 'movie' post types on home page
function search_filter( $query ) {
if ( !is_admin() && $query->is_main_query() ) {
if ( $query->is_search ) {
$query->set( 'post_type', array( 'post', 'page', 'acme_product', 'movie' ) );
}
}
}
add_action( 'pre_get_posts','search_filter' );
```
在上面的代码中,函数search_filter挂钩在pre_get_posts上。 此功能将限制搜索结果显示帖子,页面和自定义帖子类型movie和acme_product。
## 参考方法
- register_post_type() : 注册一个帖子类型。
- is_post_type_archive() : 检查是否查询现有的帖子类型归档页面。
- post_type_archive_title() : 显示或检索帖子类型归档的标题。
- 简介
- 主题开发
- 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
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类