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