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
- 添加自定義端點
- 自定義內容類型
- 修改回應
- 模式
- 詞匯表
- 路由和端點
- 控制器類