主題中使用模板標簽來從數據庫中檢索內容。 內容可以是從博客標題到完整側邊欄的任何內容。 模板標簽是將內容拉入主題的首選方法,因為:
- 他們可以打印動態內容;
- 它們可以用于多個主題文件; 和
- 他們將主題分為更小,更易理解的部分。
## 什么是模板標簽?
模板標簽只是一段代碼,可以讓WordPress從數據庫中獲取一些內容。 它分為三個組成部分:
- 一個PHP代碼標簽
- WordPress函數
- 可選參數
您可以使用模板標簽來調用另一個主題文件或數據庫中的某些信息。
例如,模板標簽get_header()告訴WordPress獲取header.php文件并將其包含在當前主題文件中。 同樣,get_footer()告訴WordPress獲取footer.php文件。
還有其他種類的模板標簽:
- the_title() - 告訴WordPress從數據庫中獲取頁面或帖子的標題,并將其包含。
- bloginfo('name') - 告訴WordPress將博客標題從數據庫中取出并將其包含在模板文件中。
如果仔細觀察最后一個例子,您還將看到括號之間有一個參數。 參數可以讓你做兩件事情:
要求具體的信息和
以某種方式格式化信息。
下面廣泛的介紹了這些參數,但是請注意,您可以發送WordPress特定的說明,了解您希望顯示數據的方式。
## 為什么要使用模板標簽
通過封裝特定內容塊的所有代碼,模板標簽使得在主題文件中包含模板的各種部分以及維護主題非常容易。
創建一個header.php文件并擁有所有的主題模板,如single.php,page.php,front-page.php等,引用一個使用get_header()的主題文件比復制和粘貼代碼更容易 進入每個主題文件。 它也使維護更容易。 每當您在header.php文件中進行更改時,更改將自動轉移到所有其他主題文件中。
使用模板標簽的另一個原因是顯示動態數據,即來自數據庫的數據。 在標題中,您可以手動添加標題標簽,如下所示:
```
<title>My Personal Website<title>
```
但是,這樣做意味著您隨時要更改網站的標題時手動編輯主題。 相反,更容易地包含bloginfo('name')模板標簽,該標簽自動從數據庫中提取站點標題。 現在,您可以在WordPress中更改您的網站的標題,而不必對主題模板進行硬編碼。
## 如何使用模板標簽
使用模板標簽非常簡單。 在任何模板文件中,您可以通過簡單地打印一行php代碼來調用模板標簽來使用模板標簽。 打印header.php文件很簡單:
```
get_header();
```
## 參數
一些模板標簽可以讓您傳遞參數。 參數是確定從數據庫檢索到的內容的額外信息。
例如,bloginfo()模板標簽允許你給它一個參數,告訴WordPress你想要的具體的信息。 要打印博客名稱,您只需傳遞參數“name”,如下所示:
```
bloginfo( 'name' );
```
要打印博客正在運行的WordPress版本,您將傳遞一個參數“version”:
```
bloginfo( 'version' );
```
對于每個模板標簽,參數不同。 可以在代碼引用的特定模板標簽頁上找到參數列表以及可以做的工作。
## 在循環中使用模板標簽
許多模板標簽在WordPress循環中工作。 這意味著它們被包含在模板文件中,作為php“循環”的一部分,它根據循環內的指令生成用戶看到的頁面。
WordPress循環以:
```
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
```
在循環中工作的模板標簽必須位于以下循環結束部分之前的中間區域:
```
endwhile;
else :
_e( 'Sorry, no posts matched your criteria.', 'devhub' );
endif;
```
需要在循環內部的一些模板標簽包括
- the_content()
- the_excerpt()
- next_post()
- previous_post()
某些功能需要循環的主要原因是因為它們需要設置全局后置對象。
如果要使用的模板標簽不必在循環中
- wp_list_cats()
- wp_list_pages()
那么你可以把它放在你想要的任何文件中,例如在邊欄,頁眉或頁腳模板文件中。
這些是通常不需要全局后置對象的函數。
## 附件
- [條件標簽](themes/conditional-tags.md)
- [完整的模板標簽列表](themes/list-of-template-tags.md)
- 簡介
- 主題開發
- 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
- 添加自定義端點
- 自定義內容類型
- 修改回應
- 模式
- 詞匯表
- 路由和端點
- 控制器類