編輯“WordPress:The Loop in Action”

==介紹==
[[WordPress:The Loop|"The Loop"]]是指WordPress主程序中的一個(gè)術(shù)語。你可以在你的[[WordPress:Templates|模板文件]]中使用Loop來想訪問者顯示你的文章。你可以讓模板不帶有Loop，但這樣你就只能顯示來自一篇文章的數(shù)據(jù)了。

WordPress所做的第一件事就是檢查它所需要的所有文件是否存在。接下來，它按照[[WordPress:Registered_User_Features|blog 管理員]]定義的，從數(shù)據(jù)庫收集默認(rèn)的設(shè)置。這包括每頁顯示的文章的數(shù)量，是否允許評(píng)論，等等。一旦這些默認(rèn)的內(nèi)容確定后，WordPress就會(huì)檢查使用者要求什么。這個(gè)信息用來確定從數(shù)據(jù)庫中取出哪篇文章。s

如果使用者不要求特定的文章，分類，頁面或者日期，WordPress使用以前收集的默認(rèn)值確定哪個(gè)文章準(zhǔn)備給使用者閱讀。例如，如果blog管理員在[[WordPress:Administration_Panels|Administration]] > [[WordPress:Administration_Panels#Reading|Settings]] > [[WordPress:Settings_Reading_SubPanel|Reading]]設(shè)置中選擇每頁顯示5篇文章，那么WordPress就會(huì)從數(shù)據(jù)庫中取最新的5篇。如果使用者要求特定的文章，分類，頁面或者日期，那么WordPress就會(huì)根據(jù)這些信息來選擇從數(shù)據(jù)庫中取出哪篇''文章''。

一旦所有這些完成之后，WordPress就連接數(shù)據(jù)庫，得到需要的信息，然后在一個(gè)變量中儲(chǔ)存這個(gè)結(jié)果。進(jìn)入這個(gè)變量的就是Loop，然后在模板中顯示變量的值。
默認(rèn)情況下，如果訪問者沒有選擇特定的文章，頁面，分類或者日期，WordPress會(huì)使用<tt>index.php</tt>顯示所有內(nèi)容。在這個(gè)Loop的討論的第一部分，我們只集中討論<tt>index.php</tt>，和默認(rèn)的blog顯示。接下來，一旦你懂得這些如何工作的時(shí)候，我們來研究Loop在別的模板文件中的作用。

==世界上最簡單的索引頁面==
接下來的是具有所有功能的索引，可以顯示每個(gè)文章的內(nèi)容(僅僅是內(nèi)容)，根據(jù)使用情況準(zhǔn)備Loop，給你看這些的唯一目的就是表明這些對(duì)Loop的技能幾乎沒有必要，在你的<tt>index.php</tt>文件大多數(shù)內(nèi)容中，都是CSS, HTML,和 PHP聲明，可以讓Loop看起來漂亮些。
<pre>
&lt;?php
get_header();
if (have_posts()) :
   while (have_posts()) :
      the_post();
      the_content();
   endwhile;
endif;
get_sidebar();
get_footer(); 
?&gt;
</pre>

==默認(rèn) Loop==
接下來是一步一步的來看WordPress v1.5標(biāo)準(zhǔn)安裝，默認(rèn)情況下，''默認(rèn)'' 和 ''經(jīng)典''主題中l(wèi)oop用法。
=== Loop開始===
在默認(rèn)<tt>index.php</tt>模板文件的頂部，是[[WordPress:The Loop|Loop]]代碼開始的地方。
<pre>&lt;?php if (have_posts()) : ?&gt;<br />
<?php while (have_posts()) : the_post(); ?></pre>

#首先它用<tt>have_posts()</tt>功能檢查是否有新的文章.
#如果有文章的話，一個(gè)PHP <tt>[http://www.php.net/while while]</tt>的loop就開始了。只要插入語為邏輯真，<tt>while</tt> loop就會(huì)繼續(xù)執(zhí)行。這樣只要函數(shù)<tt>have_posts()</tt> 返回真值，Loop就會(huì)繼續(xù)。
#函數(shù)<tt>have_posts()</tt>簡單的在文章集合中檢查下一個(gè)項(xiàng)目：如果有另外一個(gè)項(xiàng)目，返回true，如果沒有下一個(gè)項(xiàng)目，返回false .

===生成文章===
<tt>the_post()</tt>函數(shù)把文章集合中的現(xiàn)用的項(xiàng)目拿出來，并且讓它可以在Loop的循環(huán)中使用。如果沒有<tt>the_post()</tt>，很多主題中使用的[[WordPress:Template Tags|模板標(biāo)簽]]都無法工作了。

一旦文章日期被設(shè)置可用，模板就能啟用對(duì)來訪者展示文章數(shù)據(jù)。

====標(biāo)題，日期和作者====
下邊的 [[WordPress:Template Tags|模板標(biāo)簽]]獲得當(dāng)前文章的標(biāo)題，還有發(fā)表的時(shí)間和誰發(fā)表了它。
<pre>
&lt;h2 id="post-&lt;?php the_ID(); ?&gt;"&gt;
&lt;a href="&lt;?php the_permalink() ?>" rel="bookmark" title="Permanent Link to &lt;?php the_title(); ?&gt;"&gt;
&lt;?php the_title(); ?&gt;&lt;/a&gt;&lt;/h2&gt;
&lt;small&gt;&lt;?php the_time('F jS, Y') ?&gt; &lt;!-- by &lt;?php the_author() ?&gt; --&gt;&lt;/small&gt;
</pre>

====文章內(nèi)容====
<tt>[[WordPress:Template_Tags/the_content|the_content()]]</tt>模板標(biāo)簽顯示文章的內(nèi)容。 這是每個(gè)通過Loop的很重要的部分：
<pre>
&lt;div class="entry"&gt;
&lt;?php the_content('Read the rest of this entry &amp;raquo;'); ?&gt;
&lt;/div&gt;
</pre>
如果你把'''more'''這個(gè)按鈕包含到[[WordPress:Write_Post_SubPanel#Quicktags|Quicktag]]，然后象這樣<tt>[[WordPress:Customizing_the_Read_More|&lt;!--more--&gt;]]</tt>顯示出來, 在你的文章的正文部分，只有<em>above</em>這部分才會(huì)顯示給訪問者。這樣，如果你只是想讓你的首頁面顯示每篇文章的第一句或者前兩句話的話，只需要簡單的在每篇文章的第一行之后插入 <tt>&lt;!--more--&gt;</tt>就可以了。

當(dāng)查看某個(gè)單一的文章的時(shí)候，<tt>&lt;!-- more --&gt;</tt>分隔符會(huì)被忽略。這樣如果讀者想閱讀全部內(nèi)容，而又在所有的文章中都加如<tt>&lt;!-- more --&gt;</tt>分隔符的話，會(huì)迫使讀者點(diǎn)擊每個(gè)單獨(dú)的文章。

====詳細(xì)資料附====
在每個(gè)文章內(nèi)容下邊，在<tt>index.php</tt>模板文件中，是顯示有關(guān)這個(gè)文章更多信息的地方，如分類，日期和評(píng)論信息。大家知道的[[WordPress:Post_Meta_Data_Section|文章meta數(shù)據(jù)部分]]，如果你是一個(gè)已經(jīng)登陸的有充分權(quán)限的使用者，你可會(huì)看見"Edit This"連接，這多虧了<tt>[[WordPress:Template_Tags/edit_post_link|edit_post_link()]]</tt>模板標(biāo)簽函數(shù)。
<pre>
&lt;p class="postmetadata"&gt;
Posted in &lt;?php the_category(', ') ?&gt; 
&lt;strong&gt;|&lt;/strong&gt;
&lt;?php edit_post_link('Edit','','<strong>|</strong>'); ?&gt;  
&lt;?php comments_popup_link('No Comments &#187;', '1 Comment &#187;', '% Comments &#187;'); ?&gt;&lt;/p&gt;
</pre>

如果評(píng)論被激活，或者是該文章有評(píng)論內(nèi)容，<tt>[[WordPress:Template_Tags/comments_popup_link|comments_popup_link()]]</tt>模板標(biāo)簽將會(huì)顯示一個(gè)到評(píng)論內(nèi)容的連接。如果你使用了[[WordPress:Template_Tags/comments_popup_script|評(píng)論彈出窗口]]，這個(gè)連接就會(huì)打開評(píng)論窗口，否則它就會(huì)直接跳轉(zhuǎn)到這篇文章的評(píng)論內(nèi)容。

如果訪問者在瀏覽文章索引(''i.e.:'' 在Loop中不止一篇文章)，<tt>comments_popup_link()</tt>連接將會(huì)把讀者連接到這篇文章的單獨(dú)頁面。

====自動(dòng)尋找Trackback ====
<tt>[[WordPress:Template_Tags/trackback_rdf|trackback_rdf]]</tt>模板標(biāo)簽的功能是輸出機(jī)讀代碼用于自動(dòng)尋找[[WordPress:Glossary#Trackback|trackback]]。

<pre>
&lt;!--
&lt;?php trackback_rdf(); ?&gt;
--&gt;
</pre>

'''注意:'''<tt>trackback_rdf()</tt>標(biāo)簽支持在自身旁邊使用[[WordPress:Commenting_Code|評(píng)論]]。它并非"關(guān)閉"的。
===結(jié)束 Loop===
下面是結(jié)束 Loop。在這之后，各種文章相關(guān)的模板標(biāo)簽不再如如你想要的那樣工作了(如果它們?cè)诠ぷ?它們會(huì)使用Loop的最后一篇文章).這意味著，如果你需要使用一個(gè)工作'''在 Loop內(nèi)'''的模板標(biāo)簽，你需要把如下語句放進(jìn)去。
<pre>
&lt;?php endwhile; ?&gt;
</pre>

在這個(gè)部分，在Loop結(jié)束后立即通過每個(gè)網(wǎng)頁顯示出向前還是向后的導(dǎo)航控制。
<pre>
&lt;div class="navigation"&gt;
&lt;div class="alignleft"&gt;&lt;?php posts_nav_link('','','&amp;laquo; Previous Entries') ?&gt;&lt;/div&gt;
&lt;div class="alignright"&gt;&lt;?php posts_nav_link('','Next Entries &amp;raquo;','') ?&gt;&lt;/div&gt;
&lt;/div&gt;
</pre>
如果blog設(shè)置成每頁顯示10篇文章，而且Loop收集到了25篇文章，這就會(huì)產(chǎn)生三個(gè)頁面：兩個(gè)10篇文章的頁面，還有一個(gè)五篇的頁面。導(dǎo)航連接允許訪問者通過文章收集跳轉(zhuǎn)到上一頁還是下一頁。

導(dǎo)航控制是<em>不包含</em>在Loop內(nèi)的，但是<em>包含在</em><tt>if</tt> 條件句內(nèi)，這樣它們只能顯示是否有文章。導(dǎo)航函數(shù)本身也會(huì)檢查是否有一些基于現(xiàn)有Loop的，它們能連接的內(nèi)容，如果有可連接的內(nèi)容的話只顯示連接。

<pre>
&lt;?php else : ?&gt;
 &lt;h2 class="center"&gt;Not Found&lt;/h2&gt;
 &lt;p class="center"&gt;
&lt;?php _e("Sorry, but you are looking for something that isn't here."); ?&gt;&lt;/p&gt;
</pre>
<tt>else :</tt>語句決定了如果<tt>have_posts()</tt>返回false時(shí)做些什么。那就是說，'''else'''之后的部分只能在Loop沒有文章時(shí)才會(huì)被顯示。沒有文章顯示出來，舉例來說，訪問者要求某個(gè)特殊日子的內(nèi)容，但是那天沒有文章，或者是搜索但是沒有結(jié)果。

<pre>
  &lt;?php endif; ?&gt;
</pre>
這個(gè)語句結(jié)束了這樣的條件句："如果有文章這樣，如果沒有文章那樣".一旦條件語句結(jié)束了，默認(rèn)的index.php模板包括了邊欄，最后是頁腳。

==其它模板中的Loop==
WordPress可以使用不同的模板文件，用不同的方式顯示你的blog。在默認(rèn)WordPress主題中，有用于索引瀏覽的[[WordPress:Templates|模板文件]]，分類瀏覽和文檔瀏覽，就象一個(gè)瀏覽單獨(dú)文章的模板。這些都會(huì)用到[[WordPress:The Loop|Loop]]，但是這些都沒有太大的差距，就象[[WordPress:Template_Tags|模板標(biāo)簽]]之間的不同用法似的。

至于那些沒有分開的模板文件的情況，WordPress使用默認(rèn)時(shí)的<tt>index.php</tt>。如果訪問者請(qǐng)求閱讀一個(gè)單獨(dú)的文章時(shí)，WordPress會(huì)首先查找一個(gè)名字為<tt>single.php</tt>的文件。如果這個(gè)文件存在，它就會(huì)用來顯示這個(gè)文章。如果不存在，WordPress就會(huì)使用<tt>index.php</tt>來顯示文章。這叫做[[WordPress:Template Hierarchy|模板層次]].

如果你正在制作你自己的[[WordPress:Using Themes|主題]]，在默認(rèn)主題中查看[[WordPress:Templates|模板文件]]，作為參考，很有用。同樣，使用你的主題的<tt>index.php</tt>作為你的其他模板文件的模板也是很有用的。因?yàn)槟銊?chuàng)建了更多的模板文件，這樣做可能會(huì)帶給你一個(gè)已知的工作頁面，從這里開始作出更改。
===不同的歸檔格式===
<em>archive</em>是歷史文章的集合。在默認(rèn)時(shí)，文章在主索引中顯示的是最新的[http://mydatapages.com/chronological.html 按時(shí)間順序的]記錄。當(dāng)訪問者點(diǎn)擊某個(gè)文檔連接時(shí)，或者他們手動(dòng)請(qǐng)求某個(gè)特定時(shí)間時(shí)，(使用<nowiki>http://www.example.com/blog/index.php?m=200504</nowiki>或者 <nowiki>http://www.example.com/blog/2005/04</nowiki> 來選擇所有2005年4月后的文章)，WordPress將顯示<em>archive</em>內(nèi)容。默認(rèn)情況下，歸檔將使用<tt>index.php</tt>，然后和你的首頁一樣，只顯示出2005年四月后的文章。

當(dāng)WordPress為訪問者準(zhǔn)備[[WordPress:Creating_an_Archive_Index|歸檔界面]]時(shí)，它會(huì)在你現(xiàn)用的主題目錄中明確的尋找一個(gè)叫做<tt>archive.php</tt>的文件，如果你想在首頁上使歸檔的意思明確表達(dá)，那么把<tt>index.php</tt>復(fù)制到<tt>archive.php</tt>，并且按需求編輯<tt>archive.php</tt>文件。

例如，如果你只想在歸檔列表上顯示文章標(biāo)題，不包含文章內(nèi)容，你可以使用如下代碼：

<pre>
&lt;?php get_header(); ?&gt;
 &lt;div id="content" class="narrowcolumn"&gt;

  &lt;?php if (have_posts()) : ?&gt;
   &lt;?php while (have_posts()) : the_post(); ?&gt;
     &lt;div class="post"&gt;
     &lt;h2 id="post-&lt;?php the_ID(); ?&gt;"&gt;
&lt;a href="&lt;?php the_permalink() ?&gt;" rel="bookmark" title="Permanent Link to &lt;?php the_title(); ?&gt;"&gt;&lt;?php the_title(); ?&gt;&lt;/a&gt;&lt;/h2&gt;
     &lt;small&gt;&lt;?php the_time('F jS, Y') ?&gt; &lt;!-- by &lt;?php the_author() ?&gt; --&gt;&lt;/small&gt;
      &lt;/div&gt;
    &lt;?php endwhile; ?&gt;
&lt;div class="navigation"&gt;
&lt;div class="alignleft"&gt;
&lt;?php posts_nav_link('','','&amp;laquo; Previous Entries') ?&gt;
&lt;/div&gt;
&lt;div class="alignright"&gt;
&lt;?php posts_nav_link('','Next Entries &amp;raquo;','') ?&gt;
&lt;/div&gt;
  &lt;/div&gt;
&lt;?php else : ?&gt;
  &lt;h2 class="center"&gt;Not Found&lt;/h2&gt;
 &lt;p class="center"&gt;&lt;?php _e("Sorry, but you are looking for something that isn't here."); ?&gt;&lt;/p&gt;
  &lt;?php endif; ?&gt;
&lt;/div&gt;
&lt;?php get_sidebar(); ?&gt;
&lt;?php get_footer(); ?&gt;
</pre>

===不同的分類格式===
和歸檔界面一樣，WordPress為[[WordPress:Category_Templates|分類界面]]尋找分開的模板文件。如果訪問者點(diǎn)擊了一個(gè)分類連接，他們會(huì)看到分類外觀，WordPress會(huì)只從分類中準(zhǔn)備帶有文章的Loop，限制每個(gè)blog默認(rèn)設(shè)置下的文章的數(shù)目。

要想讓你的分類界面和索引界面不同的話，復(fù)制一個(gè)<tt>index.php</tt>文件并重命名為<tt>category.php</tt>，對(duì)于分類界面，向一個(gè)分配過的文章列出分類也許不是必須的，所以我們忽略這一步。取而代之的，我們?cè)陧撁骓敳柯暶鞣诸悾?
<pre>
&lt;?php get_header(); ?&gt;
 &lt;div id="content" class="narrowcolumn"&gt;
 &lt;p&gt;
 &lt;strong&gt;
  &lt;?php single_cat_title('Currently browsing '); ?&gt;
  &lt;/strong&gt;&lt;br /&gt;
 &lt;?php echo category_description(); ?&gt;
 &lt;/p&gt;
 &lt;?php if (have_posts()) : ?&gt;
   &lt;?php while (have_posts()) : the_post(); ?&gt;
     &lt;div class="post"&gt;
      &lt;h2 id="post-&lt;?php the_ID(); ?&gt;"&gt;
&lt;a href="&lt;?php the_permalink() ?&gt;" rel="bookmark" title="Permanent Link to &lt;?php the_title(); ?&gt;"&gt;
&lt;?php the_title(); ?&gt;&lt;/a&gt;&lt;/h2&gt;
   &lt;small&gt;
     &lt;?php the_time('F jS, Y') ?&gt; 
        &lt;!-- by &lt;?php the_author() ?&gt; --&gt;
   &lt;/small&gt;
 &lt;/div&gt;
&lt;?php endwhile; ?&gt;
 &lt;div class="navigation"&gt;
   &lt;div class="alignleft"&gt;
    &lt;?php posts_nav_link('','','&amp;laquo; Previous Entries') ?&gt;
   &lt;/div&gt;
   &lt;div class="alignright"&gt;
    &lt;?php posts_nav_link('','Next Entries &amp;raquo;','') ?&gt;
   &lt;/div&gt;
 &lt;/div&gt;
&lt;?php else : ?&gt;
  &lt;h2 class="center"&gt;Not Found&lt;/h2&gt;
&lt;p class="center"&gt;&lt;?php _e("Sorry, but you are looking for something that isn't here."); ?&gt;&lt;/p&gt;
 &lt;?php endif; ?&gt;
&lt;/div&gt;
&lt;?php get_sidebar(); ?&gt;
&lt;?php get_footer(); ?&gt;
</pre>

===不同分類的不同格式===
如在[[WordPress:Template Hierarchy|模板層次]]中敘述的，[[WordPress:Category_Templates|為每個(gè)分類創(chuàng)建分開的模板文件]]是可行的。只需要建立名字為<tt>category-<b><u>X</u></b>.php</tt>的文件，這里<b><u>X</u></b>是用數(shù)字表示的分類。仔細(xì)考慮你是否需要給某個(gè)分類建立全新的完整模板。

讓我們來看兩個(gè)分類，"Plants" 和 "Flowers"，分類ID分別為3和4。在輸出的地方的每個(gè)文章標(biāo)題旁邊，你都想要有個(gè)植物或者花的圖片，取決于哪個(gè)分類被顯示，你可以這樣：

* 使用兩個(gè)分開的文件, <tt>category-3.php</tt> 和 <tt>category-4.php</tt>, 每個(gè)文件給每個(gè)文章標(biāo)題使用不同的<tt>img</tt>標(biāo)簽。
* 在你的默認(rèn)<tt>category.php</tt>文件中使用條件判斷，來查看是否當(dāng)前分類是"Plants"或者 "Flowers" (或者都不是), 然后顯示合適的圖片：
<pre>
&lt;?php if (is_category('3') ):
 // we're in the Plants category, so show a plant ?&gt;
 &lt;img src='/images/plant.png' alt='a plant' /&gt;
&lt;?php } elseif (is_category('4') ):
 // we're in the Flowers category, so show a flower ?&gt;
 &lt;img src='/images/flower.png' alt='a pretty flower' /&gt;
&lt;?php endif; // end the if, no images for other other categories ?&gt;
</pre>

如果你添加了另外一個(gè)分類，"Cars"，你想讓它用一個(gè)<em>引人注目</em>的方式顯示出來，那么一個(gè)分開的<tt>category-<b><u>X</u></b>.php</tt>則是你最合適的選擇。
=== 不同分類的不同CSS ===

很多使用者想給特定的分類建立單獨(dú)的CSS文件。這很容易實(shí)現(xiàn)。記住樣式表是在HTML文件中的<tt>&lt;head&gt;</tt>部分定義并且加載的。WordPress使用<tt>header.php</tt>文件，在默認(rèn)<tt>header.php</tt>文件中，找到下列語句：
<pre>
&lt;link rel="stylesheet" href="&lt;?php bloginfo('stylesheet_url'); ?&gt;" type="text/css" media="screen" /&gt;
</pre>
And change it to something like this:
<pre>
&lt;?php if ( is_category('5') ) { // Load special CSS for "Cars" category ?&gt;
  <link rel="stylesheet" href="<?php bloginfo('template_url'); ?>/category-5.css" type="text/css" media="screen" />;
&lt;?php } else { ?&gt;
   <link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>" type="text/css" media="screen" />
&lt;?php } ?&gt;
</pre>

<strong>注意:</strong> 汽車分類模板使用<tt>category-5.css</tt>文件取代默認(rèn)版面。在這個(gè)例子中，CSS文件在應(yīng)用的分類模板文件之后被命名，而不是真正的分類名。這樣你就明白 <tt>category-5.css</tt> 是和<tt>category-5.php</tt>文件聯(lián)系在一起的了.

===不同的單一文章格式===
當(dāng)瀏覽任意單一的文章(或者 [[WordPress:Glossary#Permalink|permalink]])的時(shí)候，如果有的話，WordPress會(huì)使用<tt>single.php</tt>。
在這個(gè)部分，在WordPress默認(rèn)的single.php文件中，提供了有關(guān)當(dāng)前文章的[[WordPress:Post_Meta_Data_Section|文章meta數(shù)據(jù)信息]]：
<pre>
<p class="postmetadata alt">
<small>
This entry was posted on &lt;?php the_time('l, F jS, Y') ?&gt; at &lt;?php the_time() ?&gt; 
and is filed under &lt;?php the_category(', ') ?&gt;.
You can follow any responses to this entry through 
the &lt;?php comments_rss_link('RSS 2.0'); ?&gt; feed.
&lt;?php
if (('open' == $post-&gt;comment_status) && ('open' == $post->ping_status)) {
// Both Comments and Pings are open
?&gt;
  You can &lt;a href="#respond"&gt;leave a response&lt;/a&gt;, or 
  &lt;a href="&lt;?php trackback_url(display); ?&gt;"&gt;trackback&lt;/a&gt; 
from your own site.
&lt;?php 
} elseif (!('open' == $post-&gt;comment_status) && ('open' == $post->ping_status)) {
// Only Pings are Open 
?&gt;
  Responses are currently closed, but you can 
  &lt;a href="&lt;?php trackback_url(display); ?&gt; "&gt;trackback&lt;/a&gt; 
from your own site.
&lt;?php
} elseif (('open' == $post-&gt;comment_status) && !('open' == $post->ping_status)) { 
// Comments are open, Pings are not 
?&gt;
  You can skip to the end and leave a response. Pinging is currently not allowed.
&lt;?php
} elseif (!('open' == $post-&gt;comment_status) && !('open' == $post->ping_status)) { 
// Neither Comments, nor Pings are open 
?&gt;
  Both comments and pings are currently closed.
&lt;?php 
} 
edit_post_link('Edit this entry.','',''); ?&gt;
&lt;/small&gt;
&lt;/p&gt;
</pre>
這種信息—不論評(píng)論是公開還是關(guān)閉—是相當(dāng)不適合放在一個(gè)索引上，歸檔或者分類界面的；那也是為什么只包含在<tt>single.php</tt>模板文件中的原因。

==其他Loop技巧==
既然你已經(jīng)對(duì)WordPress Loop的基本使用有了一個(gè)全面的了解，我們開始介紹更多的Loop效果和技巧。

===靜態(tài)首頁===

你如何顯示一些blog中特別的<em>僅僅</em>存在于你的首頁上的東西呢？對(duì)，就是只在你的首頁或者主頁上的，站點(diǎn)上別的任何地方都看不到的。簡單！我們把這稱為''靜態(tài)首頁''。站點(diǎn)的首頁并不真的是靜態(tài)的。它只是使用了Loop讓它看起來如此罷了。

想讓這個(gè)Loop技巧實(shí)現(xiàn)，使用[[WordPress:Conditional_Tags#The_Main_Page|is_home()]]條件式模板標(biāo)簽函數(shù)。

在你的 <tt>index.php</tt>, 使用<tt>if ()</tt> 條件句來有條件的輸出附加內(nèi)容：

<pre>
&lt;?php get_header(); ?&gt;
&lt;?php if (is_home()) {
 // we're on the home page, so let's show a picture of our new kitten!
 echo "&lt;img src='/images/new_kitty.jpg' alt='Our new cat, Rufus!' /&gt;";
 // and now back to our regularly scheduled home page
} ?&gt; 
</pre>

如果訪問者請(qǐng)求某個(gè)具體文章，頁面，分類或者日期時(shí)，函數(shù)<tt>is_home()</tt>不會(huì)產(chǎn)生真值，這樣它只顯示在"主"頁上。

參見[[WordPress:Creating a Static Front Page|創(chuàng)建一個(gè)靜態(tài)首頁]]以獲得更多信息。

===只顯示摘錄===
顯示摘錄而不是全文的最簡單的方法，把所有的<tt>[[WordPress:Template_Tags/the_content|the_content]]()</tt>實(shí)例用<tt>[[WordPress:Template_Tags/the_excerpt|the_excerpt()]]</tt>代替，如果你沒有建立你的文章的外部摘錄，這個(gè)函數(shù)將自動(dòng)的顯示文章的前120個(gè)詞。
<pre>
&lt;div class="entry"&gt;
&lt;?php the_excerpt(); ?&gt;
&lt;/div&gt;
</pre>

===顯示摘錄或者全部文章取決于文章編號(hào)===
某些情況下，如在文檔頁面上，如果只有一篇文章的話你可能想顯示全部的內(nèi)容，或者有多篇文章顯示摘錄。你可以自定義Loop來實(shí)現(xiàn)。

<pre>
<?php if (have_posts()) : ?>

  <?php if (($wp_query->post_count) > 1) : ?>
     <?php while (have_posts()) : the_post(); ?>
       <!-- Do your post header stuff here for excerpts-->
          <?php the_excerpt() ?>
       <!-- Do your post footer stuff here for excerpts-->
     <?php endwhile; ?>

  <?php else : ?>

     <?php while (have_posts()) : the_post(); ?>
       <!-- Do your post header stuff here for single post-->
          <?php the_content() ?>
       <!-- Do your post footer stuff here for single post-->
     <?php endwhile; ?>

  <?php endif; ?>

<?php else : ?>
     <!-- Stuff to do if there are no posts-->

<?php endif; ?>

</pre>

===Different Headers/Sidebars/Footers===
WordPress offers the <tt>get_header()</tt>, <tt>get_sidebar()</tt>, and <tt>get_footer()</tt> [[WordPress:Include Tags]] for use in your [[WordPress:Templates|template files]].  These functions make it easy to define a standard header/sidebar/footer which is easily editable.  Any changes made to these files will immediately be made visible to viewers, without any work on your part.

===不同的頁眉/邊欄/頁腳===
WordPress在[[WordPress:Templates|模板文件]]中提供<tt>get_header()</tt>，<tt>get_sidebar()</tt>, 和<tt>get_footer()</tt> 幾個(gè)[[WordPress:Include Tags|包含標(biāo)簽]]使用。這些函數(shù)讓定義標(biāo)準(zhǔn)的頁眉/邊欄/頁腳更加簡單。任何對(duì)這些文件的改動(dòng)會(huì)立刻顯示給訪問者，你不用做任何工作。

But sometimes you might not <em>want</em> a sidebar.  If you don't want a sidebar, simply exclude the call to the <tt>get_sidebar()</tt> function from your template.  For example, the <tt>single.php</tt> template in the WordPress default theme does not include a sidebar.

有時(shí)你可能不<em>想</em>要邊欄。如果你不想要邊欄，只需簡單的把<tt>get_sidebar()</tt>函數(shù)的調(diào)用從模板中刪除。如，WordPress 默認(rèn)主題中的模板不包括<tt>single.php</tt>。

To create your own <strong>different</strong> sidebar, you have two choices.
# Include the sidebar contents directly into the template file on which you're working.  If you want category-3 to have a different sidebar, edit <tt>category-3.php</tt> and include the necessary HTML and PHP to generate your distinctive sidebar.
# Use the PHP <tt>[http://www.php.net/include include]</tt> function, to include another file.  The WordPress <tt>get_sidebar()</tt> function <em>only</em> loads <tt>sidebar.php</tt>.  If you make a file named <tt>sideleft.php</tt>, you would include it like this:
<pre>
&lt;?php include(TEMPLATEPATH . '/sideleft.php'); ?&gt;
</pre>

眼建立你自己的<strong>不同的</strong> 邊欄，你有兩種選擇。
# 把邊欄內(nèi)容直接包含到你正在操作的模板文件中。如果你想要category-3 擁有不同的邊欄, 編輯<tt>category-3.php</tt>，把必須的HTML和PHP代碼包含進(jìn)去來生成這個(gè)唯一的邊欄。
# 使用PHP的<tt>[http://www.php.net/include 包含]</tt> 函數(shù), 來包含另外一個(gè)文件。 WordPress <tt>get_sidebar()</tt> 函數(shù) <em>只</em> 加載<tt>sidebar.php</tt>. 如果你有個(gè)文件名為<tt>sideleft.php</tt>, 你可以象這樣把它涵蓋進(jìn)去：:
<pre>
&lt;?php include(TEMPLATEPATH . '/sideleft.php'); ?&gt;
</pre>

Using the WordPress default [[WordPress:Template Hierarchy]], if you want to use the same elements on multiple or different templates, it's probably best to put them in separate template files and use the PHP <tt>include()</tt> function.  If the element you're adding is specifically for one template file, it's probably best to include it directly in that template file.

使用WordPress默認(rèn)的[[WordPress:Template Hierarchy|模板層次]]，如果你想在多個(gè)或者不同的模板中使用相同的元素，你最好把它們放到分開的模板文件中，并使用PHP<tt>include()</tt>函數(shù)。如果這個(gè)你添加的元素是特別為某一模板使用的，最好是把它直接包含到那個(gè)模板中去。

==Summary==
We've just scratched the surface of what can be done with the Loop.  As a reminder, the following are resources that will help you customize your own [[WordPress:The Loop|WordPress Loop]].

* [[WordPress:Templates|Template Files]]
* [[WordPress:Template Tags]]
* [[WordPress:Template Hierarchy]]
* [[WordPress:Conditional Tags]]

==概要==
We've just scratched the surface of what can be done with the Loop.  As a reminder, the following are resources that will help you customize your own [[WordPress:The Loop|WordPress Loop]].

* [[WordPress:Templates|Template Files]]
* [[WordPress:Template Tags]]
* [[WordPress:Template Hierarchy]]
* [[WordPress:Conditional Tags]]

我們剛才簡單說了下我們使用Loop能做些什么。作為提醒，下邊的內(nèi)容可能會(huì)幫助你自定義你自己的[[WordPress:The Loop|WordPress Loop]]。

* [[WordPress:Templates|模板文件]]
* [[WordPress:Template Tags|模板標(biāo)簽]]
* [[WordPress:Template Hierarchy|模板層次]]
* [[WordPress:Conditional Tags|條件式標(biāo)簽]]

==Resources==
* [http://www.obeattie.com/2006/05/02/wordpress-the-loop/ oBeattie : The Loop]
* [http://www.themelab.com/2008/04/04/the-ultimate-guide-to-the-wordpress-loop/ The Ultimate Guide to the WordPress Loop]

==資源==
* [http://www.obeattie.com/2006/05/02/wordpress-the-loop/ oBeattie : The Loop]
* [http://www.themelab.com/2008/04/04/the-ultimate-guide-to-the-wordpress-loop/ WordPress Loop終極指南]