WordPress:Template Hierarchy

注意: 本文關(guān)于一個高級話題。參見走進模板作為接觸WordPress模板的介紹.

目錄

• 1 介紹
  • 1.1 本文是關(guān)于什么的
  • 1.2 本文適用對象
  • 1.3 條件式標簽和模板層次
• 2 模板文件層次
  • 2.1 概述
  • 2.2 示例
  • 2.3 視覺總覽
  • 2.4 模板層次詳解
  • 2.5 主頁
  • 2.6 單個文章頁面
  • 2.7 WordPress 頁面
  • 2.8 分類頁面
  • 2.9 標簽頁面
  • 2.10 作者頁面
  • 2.11 日期頁面
  • 2.12 搜索結(jié)果頁面
  • 2.13 404 (找不到) 頁面
  • 2.14 附件頁面
• 3 參見

介紹

WordPress模板結(jié)合在一起，就象一個難題的各個部分一樣，生成了你的WordPress站點上的網(wǎng)頁。一些模板(例如頁眉和頁腳模板文件)可以用在所有的網(wǎng)頁上，而另外一些只能在特殊情況下使用。

本文是關(guān)于什么的

本文致力于尋找下面問題的答案：

當WordPress顯示特定的頁面類型時，會使用哪種模板文件呢？

本文適用對象

由于WordPress v1.5 中對主題的介紹，模板已經(jīng)越來越可以自由配置使用了。為了開發(fā) WP主題，要正確的理解WordPress選擇模板文件在blog上顯示多種頁面的方式。如果你想要自定義一個已存在的WordPress主題，本文將幫助你確定哪個模板文件需要編輯。

條件式標簽和模板層次 WordPress提供了很多方法來配合模板查詢類型。WordPress主題開發(fā)人員還使用:Theme_Development#Query-based_Templates|條件式標簽]]來控制生成一個特定的頁面時使用哪個模板。一些WordPress主題可能不能貫徹所有這里說到的模板文件。一些主題使用條件式標簽來載入其他的模板文件。參見主題開發(fā)和條件式標簽

模板文件層次

概述

WordPress使用字符串查詢 —站點上每個連接包含的信息—來決定使用哪個模板或者模板組合來顯示頁面。

首先，WordPress把每個字符串查詢與類型查詢匹配— i.e.決定哪種類型的頁面(搜索頁面,分類頁面,主頁等等.)是所需要的。

然后選定模板—生成網(wǎng)頁頁面內(nèi)容— 據(jù)在某個WordPress主題中哪些模板可用，按照WordPress模板層次的建議排序。

WordPress在現(xiàn)用的主題目錄中通過特定的名字尋找模板文件，使用下邊列在合適的查詢結(jié)果中的第一匹配的模板文件。

除了基本的index.php模板文件以外，主題開發(fā)人員可以選擇是否使用某個特定的模板文件。如果WordPress不能使用匹配名字找到相應(yīng)的模板，它會跳到這個層次中的下一個文件名。如果WordPress不能找到所有的匹配模板文件，index.php(主題主頁模板文件)將被使用。

示例

如果你的blog在http://domain.com/wp/，并且訪問者點擊了一個分類頁面連接如http://domain.com/wp/category/your-cat/，WordPress會在現(xiàn)有的主題目錄中尋找匹配的分類ID。如果這個分類ID是4，WordPress會去尋找一個名字為category-4.php的模板文件。如果沒有找到，WordPress就會去尋找普通分類模板文件，category.php。如果這個文件也不存在，WordPress就會尋找普通文檔模板，archive.php。如果還是沒有找到，WordPress就會返回到主頁模板文件，index.php.

如果訪問者到了你位于http://domain.com/wp/的主頁，WordPress就會尋找一個叫做home.php的模板文件，并且使用它生成請求的頁面。如果沒有找到home.php，WordPress就會在主題目錄中尋找一個叫做index.php的文件，使用這個模板來生成頁面。

視覺總覽

以下代碼顯示出哪個模板文件被用來生成一個基于WordPress模板層次的WordPress頁面了。它還描述了字符串查詢和相應(yīng)的條件式標簽的關(guān)系

| WordPress模板層次結(jié)構(gòu)圖例

Full-Size Image (png)

Download ArgoUML-0.22-File (zargo) (external link)

模板層次詳解

以下部分描述了在模板文件中WordPress調(diào)用的每個查詢類型的順序。

主頁

1. home.php
2. index.php

單個文章頁面

1. single.php
2. index.php

WordPress 頁面

1. 編輯頁面的時候，從"頁面模板"下拉菜單中選擇模板.
2. page.php
3. index.php

注意: 這里指的是WordPress 頁面, 不是blog中的一般文章或者網(wǎng)頁。參見 WordPress 頁面.

分類頁面

1. 分類模板有一個匹配ID. 如果分類的ID是6, WordPress 就會尋找category-6.php
2. category.php
3. archive.php
4. index.php

Note: See WordPress:Category Templates for details.

標簽頁面

1. 標簽?zāi)０逵幸粋€匹配插槽.如果標簽插槽是sometag, WordPress就會搜索 tag-sometag.php
2. tag.php
3. archive.php
4. index.php

Note: See WordPress:Tag Templates for details.

作者頁面

1. author.php
2. archive.php
3. index.php

注意:作者模板 可以用來顯示有關(guān)作者的信息.

日期頁面

舉個例子，一個按月的文檔頁面。

1. date.php
2. archive.php
3. index.php

搜索結(jié)果頁面

1. search.php
2. index.php

404 (找不到) 頁面

1. 404.php
2. index.php

注意: 參見建立一個錯誤404頁面以獲得更多有關(guān)404頁面的信息。

附件頁面

1. attachment.php
2. index.php

注意: 參見圖片附件獲得更多有關(guān)此模板的信息.

參見

以下連接與文章話題直接相關(guān).

主題開發(fā) | 循環(huán) | 條件式標簽 | 模板標簽 | 使用Permalinks