編輯“WordPress:Theme Development”（章節(jié)）

==一個主題的解析==
WordPress主題位于<tt>wp-content/themes/</tt>中的子目錄中。主題的子目錄包含有所有的主題的樣式表文件，[[WordPress:Stepping Into Templates|模板文件]]，一個任意的函數(shù)文件(<tt>functions.php</tt>),和圖像。例如，一個叫做"測試"的主題可能會在<tt>wp-content/themes/test/</tt>目錄中。

WordPress包含有兩個主題可以下載，一個是"經(jīng)典的" 一個是"默認的"主題。這兩個主題是不同的并且使用不同的函數(shù)和標簽來產(chǎn)生它們的網(wǎng)頁內(nèi)容和外觀。為這些主題仔細地檢查文件來知道怎樣更好地建立你自己的主題文件。

WordPress主題除了圖像外，包括三種主要類型的文件。一是樣式表稱為<tt>style.css</tt>，這控制了網(wǎng)頁的外表（外觀），
二是有選擇的函數(shù)文件(<tt>functions.php</tt>). 其他的文件是[[WordPress:Stepping Into Templates|模板文件]]，這控制著從數(shù)據(jù)庫到被展示成一個網(wǎng)頁的網(wǎng)頁產(chǎn)生信息的方式，讓我們看下這些個性化的。
===主題樣式表===

除了提供你的主題的CSS樣式信息外，樣式表，<tt>style.css</tt> '''''必須'''''提供評論形式主題的詳細信息。'''''兩個主題不能有同樣的詳細信息'''''列在它們的評論標題上，因為這會引起[[WordPress:Administration_Panels#Design_-_Change_the_Look_of_your_Blog|主題選擇對話]]的錯誤。如果你通過復制一個現(xiàn)存的主題來制作你自己的主題，首先要確定你已經(jīng)更改了這個信息。

下面是樣式表前幾行的例子，稱作樣式表標題，是主題的"Rose":
<pre>/*   
主題名: Rose
主題 URI: 主題的主頁
描述: 一個注意的描述
作者:你的名字
作者URI: 你的-URI
模板: 使用-這個-來-定義-一個-母-主題—任意的
版本: 一個-數(shù)字—有選擇的
.
如果有的話，一般的評論/許可聲明。
.
*/</pre>

如果存在的話，最簡單的主題只包括一個<tt>style.css</tt>文件和圖像。要創(chuàng)建這樣的一個主題，你必須通過在<tt>style.css</tt>標題評論中編輯<tt>Template:</tt>行，來規(guī)定一套模板來''繼承''使用主題。例如，如果你想要"Rose"主題來繼承其它的一個稱作"測試"的主題的模板，你就會將評論中的<tt>Template: test</tt>放入Rose的tt>style.css</tt>開端?，F(xiàn)在"test" 是"Rose"的母主題，只包含有一個<tt>style.css</tt>文件和一個相關的圖像，都在<tt>wp-content/themes/Rose</tt>目錄中。''(注：規(guī)定一個母主題會從主題&mdash中繼承''所有的''主題文件；意思是子主題目錄中的任何模板文件都會被忽視。)''

<tt>style.css</tt>中的評論標題行要求WordPress能夠辨別一個主題并且將它顯示在[[WordPress:Administration_Panels#Design_-_Change_the_Look_of_your_Blog|設計]] > [[WordPress:Administration_Panels#Themes|主題]]下的[[WordPress:Administration_Panels|管理面板]]上作為一個擁有其它安裝主題的可供選擇的主題選項。

'''注''' : ''當在評論標題的<tt>Template:</tt>部分定義一個母主題的時候，你必須使用那個樣式的目錄名。例如，將默認的WordPress主題用作母主題，不要寫成<tt>模板: WordPress 默認</tt>,要寫成<tt>模板: 默認</tt>,因為默認是這個主題的目錄。''
===函數(shù) 文件===

一個主題可以有選擇的使用一個函數(shù)文件，這個文件在主題子目錄中，并且命名為<tt>functions.php</tt>。文件基本像一個[[WordPress:Plugins|插件]]那樣運行，而且如果它呈現(xiàn)在你使用的主題中，會在WordPress初始化（管理網(wǎng)頁和外部網(wǎng)頁）的時候，自動載入。建議使用這個文件：

*定義你的主題多個文件中使用的函數(shù)
*設置一個管理界面，提供給用戶顏色，樣式，和你的主題的其它方面的選項
"默認"WordPress主題包含一個<tt>functions.php</tt>文件，這個文件定義了函數(shù)和一個管理界面，這樣你可能想將它用作一個模型。因為<tt>functions.php</tt>基本起一個插件的作用，[[WordPress:Function_Reference|函數(shù)_參考]]列出了擁有關于你怎樣處理這個文件的更多信息的最后位置。
===主題模板文件===
[[WordPress:Stepping Into Templates|模板]]是PHP原始文件，根據(jù)訪客要求，用來產(chǎn)生網(wǎng)頁的。讓我們來看看可以被定義為主題的一部分的不同的模板。

WordPress能夠使你為你的博客的不同部分分別定義模板；然而，使你的博客正常地運行，并不一定需要所有的這些不同的模板文件。模板是根據(jù)[[WordPress:Template Hierarchy|模板層級]]選擇和產(chǎn)生的，取決于一個特別的主題中有什么樣的模板。作為一個主題開發(fā)者，你可以選擇你想執(zhí)行使用多少的模板自定義。例如，作為一個極端的例子，你可以為網(wǎng)絡博客上產(chǎn)生的和顯示的''所有的''網(wǎng)頁，只使用一個模板文件，稱為<tt>index.php</tt>作為模板。一個更加通常的用法是使用不同的模板文件產(chǎn)生不同的結(jié)果，允許最大化的自定義。

===='''基本的模板'''====

在最小化值的時候，一個WordPress主題包含有兩個文件：
* <tt>style.css</tt>
* <tt>index.php</tt>

這兩個文件都歸屬于主題的目錄。<tt>index.php</tt> [[WordPress:Stepping Into Templates|模板文件]]非常地靈活。它可以被用來包括關于標題，工具條，頁腳，內(nèi)容，類別，歸檔，搜索，錯誤和你的站點上的用戶創(chuàng)建的其它的網(wǎng)頁的所有參數(shù)。或者它可以被''再次地分''到模塊模板文件，每個部分都具有一部分的工作量。

如果你沒有提供其它任何的模板文件，WordPress會使用內(nèi)置的默認文件。例如，如果你既沒有一個<tt>comments.php</tt>也沒有一個<tt>comments-popup.php</tt>模板文件，WordPress就會自動地使用<tt>wp-comments.php</tt> 和<tt>wp-comments-popup.php</tt>模板文件，使用[[WordPress:Template Hierarchy|模板層級]]。這些默認模板可能不太匹配你的主題，因此你可能需要提供你自己的模板。一般基本的文件用來再次地切分（屬于主題的目錄）是：

* <tt>header.php</tt>
* <tt>sidebar.php</tt>
* <tt>footer.php</tt>
* <tt>comments.php</tt>
* <tt>comments-popup.php</tt>

使用這些模塊的模板文件，你可以將這些模板標簽放到<tt>index.php</tt>上級文件中來包括或者''得到''這些units,你想讓它們出現(xiàn)在最后產(chǎn)生的網(wǎng)頁的位置。

*包含標題，使用<tt>[[WordPress:Include Tags#The Header Template|get_header()]]</tt>模板標簽。
*要包含工具條，使用<tt>[[WordPress:Include Tags#The Sidebar Template|get_sidebar()]]</tt> 模板標簽。
*要包含頁腳，使用<tt>[[WordPress:Include Tags#The Footer Template|get_footer()]]</tt>模板標簽。

下面是關于''包含'' 用法的一個例子：

<pre>&lt;?php get_sidebar(); ?&gt;

&lt;?php get_footer(); ?&gt;</pre>
關于這些不同模板運行以及怎樣在模板里面產(chǎn)生不同信息的更多內(nèi)容，請閱讀[[WordPress:Templates|模板]]文件。
===='''以詢問為基礎的模板'''====
WordPress可以為不同的''詢問'' 形式載入不同的[[WordPress:Stepping Into Templates|模板]]。有兩種方法可以做到這一點：作為內(nèi)置的[[WordPress:Template Hierarchy|模板層級]]的一部分，通過在模板文件中的[[WordPress:The Loop|Loop]]使用[[WordPress:Conditional Tags|引起條件反應的標簽]]。
要使用[[WordPress:Template Hierarchy|模板層級]]，你只要提供特別目的的模板文件，這個會自動地用來覆蓋<tt>index.php</tt>。例如，如果你的主題提供一個模板叫做<tt>category.php</tt>，并且提供一個正被查詢的類別，<tt>category.php</tt>而不是<tt>index.php</tt>將會被載入。如果<tt>category.php</tt>沒有出現(xiàn)，<tt>index.php</tt>會照常使用。

通過提供一個例如，稱作<tt>category-6.php</tt>的文件，你可以在模板層級中得到更加詳細的信息---當為一個ID號碼為6的類別產(chǎn)出網(wǎng)頁的時候，這個文件而不是<tt>category.php</tt>會被用到。（如果你以一個站點管理者的身份連接主機，你可以在[[WordPress:Administration_Panels#Manage_-_Change_your_content|管理]] > [[WordPress:Administration_Panels#Categories|類別]]中找到類別的ID數(shù)字）。更詳細地看看這個過程是怎樣進行的，請看看[[WordPress:Category Templates|類別模板]]。

如果你的主題需要更多地控制使用的模板文件而不是[[WordPress:Template Hierarchy|模板層級]]中所提供的內(nèi)容，你可以使用[[WordPress:Template Hierarchy|引起條件反應的標簽]]。引起條件反應的標簽基本上是用來檢查看看在[[WordPress:The_Loop_in_Action|WordPress Loop]]內(nèi)的，一些特別的條件是否是真的，然后你就可以根據(jù)那個情況，載入一個特別的模板，或者在屏面上放一些特別的文本。

例如，給一個特別類別中的文章產(chǎn)出一個樣式表，代碼可能看起來像這樣的：
<pre><?php
if (is_category(9)) {
   //查找類別9中的文章
  include(TEMPLATEPATH . '/single2.php');
} else {
   // 每隔一篇文章便放入一個這個
   include(TEMPLATEPATH . '/single1.php');
}
?></pre>

或者，使用一個查詢，這個查詢可能看起來像：
<pre><?php
$post = $wp_query->post;
if ( in_category('9') ) {
   include(TEMPLATEPATH . '/single2.php');
} else {
  include(TEMPLATEPATH . '/single1.php');
}
?></pre>

在任一的情況下，這個例子代碼會產(chǎn)生不同的模板，這些模板的使用取決于類別上顯示的文章。詢問條件并不局限于類別，然而—請看看[[WordPress:Conditional Tags|引起條件反應的標簽]]文章來看看所有的選項。

=== 媒體圖標 ===

'''這個特色是 [http://trac.wordpress.org/ticket/6751 當前在 WordPress 2.5中破壞了]。'''

WordPress使用媒體icons來代表你的博客和管理界面上的[[WordPress:Using_Image_and_File_Attachments|附屬文件]]，前提是這些icons存在。

它要查找當前主題的<tt>images</tt>目錄中的媒體類型所命名的圖像文件。（對于Wordpress2.2而言，默認的主題只有一個媒體圖標，<tt>audio.jpg</tt>.)
例如，對于[http://en.wikipedia.org/wiki/Internet_media_type MIME 類型] <tt>audio/mpeg</tt>的一個附屬裝置，WordPress在這些位置中尋找一個圖標文件，在找到第一個匹配文件后，便停止（請看看<tt>[[WordPress:Function_Reference/wp_mime_type_icon|wp_mime_type_icon]]</tt>):
# <var>我的_主題</var>/圖像/audio.jpg
# <var>我的_主題</var>/圖像/audio.gif
# <var>我的_主題</var>/圖像/audio.png
# <var>我的_主題</var>/圖像/mpeg.jpg
# <var>我的_主題</var>/圖像/mpeg.gif
# <var>我的_主題</var>/圖像/mpeg.png
# <var>我的_主題</var>/圖像/audio_mpeg.jpg
# <var>我的_主題</var>/圖像/audio_mpeg.gif
# <var>我的_主題</var>/圖像/audio_mpeg.png

===主題模板文件列表===

下面是WordPress 識別的主題模板文件的列表。當然，你的主題可以包含任何其它的樣式表，圖像，或者文件。''只要牢記下面的內(nèi)容對于WordPress具有一些特別的意思—更多的信息請看看[[WordPress:Template Hierarchy|模板層級]]。 ''
;<tt>style.css</tt>:主要的樣式表。這個'''必須'''包含在你的主題中，而且它必須為你的主題包含信息標題。

;<tt>index.php</tt>:主要的模板。如果你的主題提供它自己的模板，<tt>index.php</tt>必須呈現(xiàn)。

;<tt>comments.php</tt>:評論模板。如果沒有出現(xiàn)，來自"默認"主題的<tt>comments.php</tt>正被使用。

;<tt>comments-popup.php</tt>:彈出的評論模板。如果沒有出現(xiàn)，來自"默認"主題的<tt>comments-popup.php</tt>正被使用。

;<tt>home.php</tt>: 主頁是模板。

;<tt>single.php</tt>:單一的文章模板。當一篇單一的文章被查詢的時候，便會用到這個模板。對于這個和其它的查詢模板，如果查詢模板沒有出現(xiàn)，就會用到<tt>index.php</tt>。

;<tt>page.php</tt>:網(wǎng)頁模板。當一個單獨的[[WordPress:Pages|網(wǎng)頁]]得到查詢的時候，便會用到這個。

;<tt>category.php</tt>: The [[WordPress:Category Templates|類別模板]]。當一個類別得到詢問的時候，便會用到這個。

;<tt>author.php</tt>:[[WordPress:Author Templates|作者模板]]。查詢一個作者的時候，會使用到這個。

;<tt>date.php</tt>:日期/時間模板。當查詢一個日期或者時間的時候，便會用到這個模板。年，月，日，時，分，秒。

;<tt>archive.php</tt>:歸檔模板。當查詢一個類別，作者或者日期的時候，便會用到這個模板。注意這個模板會被<tt>category.php</tt>, <tt>author.php</tt>, 和<tt>date.php</tt>覆蓋，因為后者有各自的查詢形式。

;<tt>search.php</tt>:搜索結(jié)果模板。當執(zhí)行一個搜索的時候，便會用到這個模板。

;<tt>404.php</tt>:'''[[WordPress:Creating_an_Error_404_Page|404 沒有找到]]'''模板。當WordPress找不到匹配查詢的一篇文章或者網(wǎng)頁的時候，便會用到這個模板。

這些文件有關于WordPress的特別意思因為這些文件用來作<tt>index.php</tt>替代品，條件是這些文件存在，根據(jù)[[WordPress:Template Hierarchy|模板層級]]，而且相應的[[WordPress:Conditional Tags|引起條件反應的標簽]] (a.k.a <tt>is_*();</tt> 函數(shù)) 返回是真。

===來自一個模板的參考文件===
WordPress默認主題（以Michael Heilemann的[http://binarybonsai.com/kubrick/ Kubrick]WordPress1.2布局為基礎）提供了一個非常好的例子，關于查詢是怎樣映射進模板的。

代碼<tt><?php bloginfo('template_directory'); ?></tt>將模板目錄的URL嵌入了模板產(chǎn)出中。你可以將任何額外的URI信息添加到你的主題的參考文件的這個輸出中。

代碼<tt><?php bloginfo('stylesheet_directory'); ?></tt>嵌入了目錄的URI，這個URI將當前的主題樣式表包含到模板輸出中。你可以添加任何額外的URI到你的主題的參考文件的輸出中，特別是樣式表使用的那些。

恒量TEMPLATEPATH是當前主題模板目錄絕對路徑的一個參考（后面沒有/）。

注意用在樣式表中的URIs與樣式表相關，但是與指代樣式表的網(wǎng)頁并不相關。這就避免了在CSS文件中包含PHP代碼來規(guī)定類別。例如，如果你的主題包含了一個<tt>images/</tt>目錄，你只需要在CSS中規(guī)定這個相關的目錄，像這樣的：
<pre style="font-size: 0.9em">h1 { 背景圖像: URL(圖像/my_background.jpg); }</pre>
對于模板中的參考文件以以上的方式使用URIs是一個好的做法，因為，這樣你的模板就不會取決于絕對路徑了。
===定義自定義模板===

使用WordPress插件系統(tǒng)來定義額外的模板，這種模板以你自己自定義的標準為基礎，是可能的。這個高級的功能通過使用<tt>template_redirect</tt> [[WordPress:Plugin API#Current Hooks For Actions|action hook]]可以得到實現(xiàn)。更多的關于創(chuàng)建插件的信息可以在[[WordPress:Plugin API|插件API]]參考中找到。

===插件API Hooks===

當開發(fā)一個主題的時候，最好牢記你的主題應該得到了設置，這樣它就能夠很好地配合你（或者其它的主題用戶）可能決定安裝的WordPress插件。插件通過"Action Hooks"來給WordPress添加泛函性（請看看[[WordPress:Plugin API|插件API]]得到更多的信息）。大多數(shù)Action Hooks是在WordPress核心PHP代碼內(nèi)部，因此你的主題不要為它們的運行準備任何特別標簽。但是有幾個Action Hooks的確需要呈現(xiàn)在你的主題上，為了使插件能夠直接地在你的頁眉，頁腳，工具條，或者在網(wǎng)頁上顯示信息。下面是你需要的特別Action Hook模板標簽列表：

; wp_head 
: Goes in the [[WordPress:Glossary#HTML|HTML]] <tt>&lt;head&gt;</tt> 主題元素; <tt>header.php</tt> 模板. 例子插件使用: 添加 javascript 代碼。 

: 用法: <tt><nowiki><?php do_action('wp_head'); ?></nowiki></tt> 
:''-or-''&nbsp; <tt><nowiki><?php wp_head(); ?></nowiki></tt>
; wp_footer
: 在一個主題的"頁腳"中; <tt>footer.php</tt> 模板。例子插件使用: 在頁腳的底部，嵌入需要在所有內(nèi)容運行之后運行的PHP代碼。
: 用法: <tt><nowiki><?php do_action('wp_footer'); ?></nowiki></tt> 
:''-or-''&nbsp; <tt><nowiki><?php wp_footer(); ?></nowiki></tt>

; wp_meta 
: 通常在主題的菜單或者工具條的<tt><nowiki><li>Meta</li></nowiki></tt>部分; <tt>sidebar.php</tt> 模板。 例子插件使用: 包括一個旋轉(zhuǎn)的廣告或者一個標簽cloud。

: 用法: <tt><nowiki><?php do_action('wp_meta'); ?></nowiki></tt> 
:''-or-''&nbsp; <tt><nowiki><?php wp_meta(); ?></nowiki></tt>

;評論_形式
: 在 <tt>comments.php</tt> 和<tt>comments-popup.php</tt>中, 直接在評論形式的關閉標簽 (<code><nowiki></form></nowiki></code>)前面。 例子插件使用: 顯示一個評論預覽。

: 用法: <tt><nowiki><?php do_action('comment_form', $post->ID); ?></nowiki></tt> 

對于一個真正的世界用法的例子，你將會發(fā)現(xiàn)這些插件hooks包含在默認主題的模板中。