編輯“WordPress:The Loop in Action”（章節(jié)）

==默認(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>功能檢查是否有新的文章.
#如果有文章的話，一個PHP <tt>[http://www.php.net/while while]</tt>的loop就開始了。只要插入語為邏輯真，<tt>while</tt> loop就會繼續(xù)執(zhí)行。這樣只要函數(shù)<tt>have_posts()</tt> 返回真值，Loop就會繼續(xù)。
#函數(shù)<tt>have_posts()</tt>簡單的在文章集合中檢查下一個項(xiàng)目：如果有另外一個項(xiàng)目，返回true，如果沒有下一個項(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è)置可用，模板就能啟用對來訪者展示文章數(shù)據(jù)。

====標(biāo)題，日期和作者====
下邊的 [[WordPress:Template Tags|模板標(biāo)簽]]獲得當(dāng)前文章的標(biāo)題，還有發(fā)表的時間和誰發(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)容。 這是每個通過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'''這個按鈕包含到[[WordPress:Write_Post_SubPanel#Quicktags|Quicktag]]，然后象這樣<tt>[[WordPress:Customizing_the_Read_More|&lt;!--more--&gt;]]</tt>顯示出來, 在你的文章的正文部分，只有<em>above</em>這部分才會顯示給訪問者。這樣，如果你只是想讓你的首頁面顯示每篇文章的第一句或者前兩句話的話，只需要簡單的在每篇文章的第一行之后插入 <tt>&lt;!--more--&gt;</tt>就可以了。

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

====詳細(xì)資料附====
在每個文章內(nèi)容下邊，在<tt>index.php</tt>模板文件中，是顯示有關(guān)這個文章更多信息的地方，如分類，日期和評論信息。大家知道的[[WordPress:Post_Meta_Data_Section|文章meta數(shù)據(jù)部分]]，如果你是一個已經(jīng)登陸的有充分權(quán)限的使用者，你可會看見"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>

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

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

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

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

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

在這個部分，在Loop結(jié)束后立即通過每個網(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篇文章，這就會產(chǎn)生三個頁面：兩個10篇文章的頁面，還有一個五篇的頁面。導(dǎo)航連接允許訪問者通過文章收集跳轉(zhuǎn)到上一頁還是下一頁。

導(dǎo)航控制是<em>不包含</em>在Loop內(nèi)的，但是<em>包含在</em><tt>if</tt> 條件句內(nèi)，這樣它們只能顯示是否有文章。導(dǎo)航函數(shù)本身也會檢查是否有一些基于現(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時做些什么。那就是說，'''else'''之后的部分只能在Loop沒有文章時才會被顯示。沒有文章顯示出來，舉例來說，訪問者要求某個特殊日子的內(nèi)容，但是那天沒有文章，或者是搜索但是沒有結(jié)果。

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