WordPress中文开发手册

  1. Home
  2. Docs
  3. WordPress中文开发手册
  4. WordPress主题开发
  5. 模板文件
  6. 自定义内容类型

自定义内容类型

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() : 显示或检索帖子类型归档的标题。
Tags ,