首页    >    中文手册    >   WordPress主循环

WordPress主循环

ven 星期四,2009/04/23 06:44

WordPress主循环

WordPress用主循环（The Loop）显示用户的文章。通过The Loop，WordPress可以将每篇文章显示在当前页面，并将这些文章按The Loop标签中的指定标准进行排版。The Loop中的任何HTML或PHP代码重复出现在每篇文章上。若WordPress文档宣布“该标签必须出现在The Loop中”，于是指定的模板标签或插件就会重复出现在每篇文章中。

例如，WordPress 1.5中The Loop默认显示的信息包括：每篇文章的标题（(the_title()），时间（the_time()）以及类别（the_category()）。关于文章的其它信息则由相应的模板标签或（仅供高级用户）通过访问$post变量显示，运行The Loop时已经在当前文章信息中设置了该变量。

The Loop基本知识参见运行中的The Loop（主循环）。

使用The Loop

The Loop应该存储在index.php以及任何用以显示文章信息的模板中，存放位置取决于WordPress版本。所以请先“确定正在使用的WordPress版本”。

WordPress 1.5 – 2.7

在主题模板的顶端应该包含对页眉模板的调用。如果用户在自己的版块设计（设计的不是模板）中使用The Loop，需要将WP_USE_THEMES设为false。

<?php define('WP_USE_THEMES', false); get_header(); ?>

The Loop开始于：

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>

结束于：

<?php endwhile; else: ?>  
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>  
<?php endif; ?>

WordPress 1.2

在索引页面顶端应该包含对wp-blog-header.php的调用。记住，一定要将wp-blog-header.php的路径设为wp-blog-header.php文件存放的位置：

<?php /* Don't remove this line. */ require('./wp-blog-header.php'); ?>

The Loop开始于：

<?php if ( $posts ) : foreach ( $posts as $post ) : start_wp(); ?>

结束于：

<?php endforeach; else: ?>  
<p><?php _e('Sorry, no posts matched your criteria.'); ?></p>   
<?php endif; ?>

Loop示例

为某一类别的文章作特别样式设计

仅供WordPress 1.5版本

本示例使用WordPress 1.5版的语句规则，显示文章的标题（标题将被用作文章的固定链接）、类别和内容。这是一个仅有框架的简单实例；通过用CSS进行样式设计，用户的模板中可以轻松显示更多信息。

为了更具有说明性，这个例子还为编号为3的类别中的文章做了特殊设计。需要用 in_category() 模板标签来完成这一设计。

<!– –>标签是HTML评论标签；使用这个示例时这些标签都不会显示在web浏览器中。它们的存在目的就是解释以下代码。

 <!-- Start the Loop. -->
 <?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>

 <!-- The following tests if the current post is in category 3. -->
 <!-- If it is, the div box is given the CSS class "post-cat-three". -->
 <!-- Otherwise, the div box will be given the CSS class "post". -->
 <?php if ( in_category('3') ) { ?>
           <div class="post-cat-three">
 <?php } else { ?>
           <div class="post">
 <?php } ?>

 <!-- Display the Title as a link to the Post's permalink. -->
 <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>

 <!-- Display the Time. -->
 <small><?php the_time('F jS, Y'); ?></small>

 <!-- Display the Post's Content in a div box. -->
 <div class="entry">
   <?php the_content(); ?>
 </div>

 <!-- Display a comma separated list of the Post's Categories. -->
 <p class="postmetadata">Posted in <?php the_category(', '); ?></p>
 </div> <!-- closes the first div box -->

 <!-- Stop The Loop (but note the "else:" - see next line). -->
 <?php endwhile; else: ?>

 <!-- The very first "if" tested to see if there were any Posts to -->
 <!-- display.  This "else" part tells what do if there weren't any. -->
 <p>Sorry, no posts matched your criteria.</p>

 <!-- REALLY stop The Loop. -->
 <?php endif; ?>

注意：使用HTML代码时一定要在<?php  ?>标签外使用。PHP代码（即使是大括号）都必须放在 <?php  ?>标签内。即使在if和else语句中，用户也可以启动或停止PHP代码以点缀HTML代码。如上例所示。

删除某一分类的文章

供WordPress 1.5或更高版本

本示例可使特定分类不显示在页面上。基本用法基于上个示例。

 <?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>

 <!-- If the post is in the category we want to exclude, we simply pass to the next post. -->
 <?php if (in_category('3')) continue; ?>
 
 <div class="post">
 
  <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
 
  <small><?php the_time('F jS, Y'); ?></small>
 
  <div class="entry">
    <?php the_content(); ?>
  </div>

  <p class="postmetadata">Posted in <?php the_category(', '); ?></p>
 </div> <!-- closes the first div box -->

 <?php endwhile; else: ?>
 <p>Sorry, no posts matched your criteria.</p>
 <?php endif; ?>

注意：在主页中使用该示例时，需要为分类存档使用不同模板。否则仅仅在查看分类存档时，WordPress也会删除分类3中所有文章。

如果想使用同样的模板也可以通过 is_home()标签解决上述问题：

...  
<?php if (in_category('3') && is_home() ) continue; ?>  
...

这样分类3中的文章就只会在主页上被删除。根据指定页面的特定条件是否为真，其他条件标签也可以控制输出结果。

请注意，即使文章不显示在主页上，但WordPress在统计所显示的文章总数时仍然将它计算在内——这就是说，如果设置在WordPress主页上显示7篇文章，其中2篇属于分类3，这样在主页上就只会显示5篇文章。在布局和设计FAQ上可以找到更详细的说明，如果只是希望在the loop中删除一个类别，也可以使用 query_posts。

多循环

本段内容针对The Loop的高级用户，因此有一定技术难度——但也无需担心。文章会从简单的地方切入。只要有点常识，有点耐心，有点热情，同样可以操作多循环。

首先，“为什么要使用多循环？”总的来说，原因就是，用户可能希望对一组文章进行一种操作，对另一组文章进行另一种操作，但希望两组文章最终出现在同一网页中。这里的操作可以使任一种操作；只要PHP技术过硬，想象力够丰富，任何操作都不是难题。

分析下面的示例前需要了解一些基本循环的知识，基本循环由以下部分组成：

     <?php if (have_posts()) : ?>
               <?php while (have_posts()) : the_post(); ?>    
     <!-- do stuff ... -->
     <?php endwhile; ?>

将以上代码译成英文就是（了解PHP和代码语言的人可以忽略本段内容）：如果要显示文章，请逐篇选择。根据<!– do stuff … –>显示列表中的文章。点击最后一篇文章时终止运行。do stuff命令行与模板相关。

Do suff旁：这是一个简单示例，代码段的占位符可决定如何在网页上显示文章并进行排版。根据用户对WordPress外观的希望，下列代码可以有所改变。查看Kubrick主题的index.php文件时，会发现do stuff区域显示如下：

<?php while (have_posts()) : the_post(); ?>

对上述代码来说：

<?php comments_popup_link('No Comments »', '1 Comment »', '% Comments »'); ?>

这里是编码人员的说明：have_posts()和the_post()都是围绕全局变量$wp_query对象的便捷包装器，在$wp_query对象中操作所有动作。在博客的页眉以及GET 和 PATH_INFO的变量中调用$wp_query。$wp_query获取这些变量，然后创建并执行数据库查询，从而返回文章数组。该数组被存放在对象中并返回到博客页眉，在页眉处数组被放入全局数组$posts（兼容原有文章loop）。

WordPress将博客页眉加载完毕后，会回到模板中，这样就完成了文章loop。have_posts()调用 $wp_query->have_posts()，后者检查循环计数器，确认是否有文章遗留在文章数组中。 the_post()调用$wp_query->the_post()，后者加速循环计数器并设置全局变量$post以及所有全局文章数据。循环负载过多会导致have_posts()返回false。

循环示例

以下是两个使用多循环的示例，使用关键在于$wp_query只能调用一次。调用rewind_posts()或创建一个新查询对象，可增加调用$wp_query的调用次数。示例1显示了这种用法。示例2则用变量来存储查询结果。示例3记录update_post_caches()的用法；避免产生常见插件问题。最后，“活动的多循环”中介绍了很多方法，多循环通过这些方法可以推广博客主页上特定类别的文章。

多循环示例1

调用rewind_posts()使相同查询进行再次循环。该动作将重置循环计数器，而后进行再次循环。

  <?php rewind_posts(); ?>
 
  <?php while (have_posts()) : the_post(); ?>
    <!-- Do stuff... -->
  <?php endwhile; ?>

完成初始查询中的文章后，可以使用另一个查询。通过调用query_posts()可循环使用$wp_query对象， 而后重复循环。query_posts将执行新查询，创建新文章数组并重置循环计数器。

  // Get the last 10 posts in the special_cat category.
  <?php query_posts('category_name=special_cat&showposts=10'); ?>

  <?php while (have_posts()) : the_post(); ?>
    <!-- Do special_cat stuff... -->
  <?php endwhile;?>

如果希望保持初始查询，可以创建新的查询对象。

<?php $my_query = new WP_Query('category_name=special_cat&showposts=10'); ?>

<?php while ($my_query->have_posts()) : $my_query->the_post(); ?>
  <!-- Do special_cat stuff... -->
<?php endwhile; ?>

全局变量 have_posts() and the_post()都使用$wp_query，因此这里不使用这两个全局变量而使用查询对象my_query，然后调用新$my_query对象。

多循环示例2

另一种多循环使用方法解决了have_posts() and the_post()不能使用的情况。首先将初始查询存入变量，然后用另一个循环为变量重新赋值。完成以上操作后就可以使用所有依靠变量的标准函数了。

例如：

// going off on my own here
<?php $temp_query = $wp_query; ?>
<!-- Do stuff... -->

<?php query_posts('category_name=special_cat&showposts=10'); ?>

<?php while (have_posts()) : the_post(); ?>
  <!-- Do special_cat stuff... -->
<?php endwhile; ?>

// now back to our regularly scheduled programming
<?php $wp_query = $temp_query; ?>

注意： PHP5中，引用对象时使用“=”操作符，而不像php4中使用复制的链接。用下列代码以使示例2能在PHP5 中运行：

 // going off on my own here
 <?php $temp_query = clone $wp_query; ?>
 <!-- Do stuff... -->
 
 <?php query_posts('category_name=special_cat&showposts=10'); ?>
 
 <?php while (have_posts()) : the_post(); ?>
   <!-- Do special_cat stuff... -->
 <?php endwhile; ?>
 
 // now back to our regularly scheduled programming
 <?php $wp_query = clone $temp_query; ?>

示例2在WordPress 2.1中无法运行。

多循环示例3——插件

事实证明，某些插件与多循环无法保持良好运行状态。人们发现在这样的情况下，那些处理关键字和文章标签的插件只能在页面的首例循环中运行，页面中的循环由所有文章的子集组成。如果上述情况属实，可以尝试执行基本循环，该循环添加了 update_post_caches($posts)函数。该函数重置文章缓存且未被记录。仅在页面的第一次循环检索到文章子集时，第二次循环可执行基本循环。

将：

   <?php if (have_posts()) : ?>
               <?php while (have_posts()) : the_post(); ?>    
     <!-- Do stuff... -->
   <?php endwhile; ?>

修改为：

   <?php if (have_posts()) : ?>
               <?php while (have_posts()) : the_post(); update_post_caches($posts); ?>
     <!-- Do stuff... -->
   <?php endwhile; ?>
活动的多循环

了解多循环用法的最佳方式是给出用法的实例。多循环的最普遍用法可能就是在一个页面上显示两个（或更多）文章列表。当网站管理员需要计算最新文章以及特定类别文章时，可使用多循环的这一用法。

若将格式和CSS问题忽略不计，假定需要两个文章列表。要求其中一列列出最新文章（最近添加的10篇标准文章），另一列中则只列出“featured”类别中的一篇文章。这样就首先显示出该类别中所有文章，而后显示第二列文章（标准文章）。难处在于，一篇文章不能同时在两个类别中显示。

第一步，从“featured”类别中获取一篇文章。

  <?php $my_query = new WP_Query('category_name=featured&showposts=1');
  while ($my_query->have_posts()) : $my_query->the_post();
  $do_not_duplicate = $post->ID; ?>
    <!-- Do stuff... -->
  <?php endwhile; ?>

将以上代码译成英文：

将$wp_query值设置与“featured”类别中的所有文章的查询结果相等，然后得到一篇文章。将变量$do_not_duplicate的值设置为返回的的单篇文章编号。Do stuff命令行表示与检索到的文章相关的所有选项。

注意：下一步要用$do_not_duplicate的值来确定同一篇文章不同时出现在这两个列表中。

第二步，进行再次循环以获取最近X篇文章（X不为1）。

以下代码从X篇最新文章（X由WordPress首选项决定）中扣留已经在初始循环中显示的文章，然后根据Do stuff显示剩余文章：

  <?php if (have_posts()) : while (have_posts()) : the_post(); 
  if( $post->ID == $do_not_duplicate ) continue; update_post_caches($posts); ?>
   <!-- Do stuff... -->
  <?php endwhile; endif; ?>

将以上代码译成英文：

获取所有文章，如果有文章等于$do_not_duplicate，继续下一步操作，如果没有文章等于 $do_not_duplicate，则根据Do stuff显示所有文章。更新缓存以优化标签和关键字插件的运行。记住， $do_not_duplicate变量中包含已经显示的文章的编号。

最终结果

如果没有格式排版，代码最终显示结果如下：

  <?php $my_query = new WP_Query('category_name=featured&showposts=1');
  while ($my_query->have_posts()) : $my_query->the_post();
  $do_not_duplicate = $post->ID;?>
    <!-- Do stuff... -->
  <?php endwhile; ?>
    <!-- Do other stuff... -->
  <?php if (have_posts()) : while (have_posts()) : the_post(); 
  if( $post->ID == $do_not_duplicate ) continue; update_post_caches($posts); ?>
   <!-- Do stuff... -->
  <?php endwhile; endif; ?>

最终显示结果是一个具有两个列表的页面。第一个列表中仅有一篇文章——“feature”类别中的最新文章。第二个列表中包含X篇最新文章（X由WordPress首选项决定），这其中不包括第一个列表中所显示的文章。因此，如果“feature”类别中的原有文章被新文章取代，则原有文章被加入标准文章列表区（取决于用户设置的文章显示数量以及文章频率）。这一技术与模板层级联合生成不同外观的home.php和index.php。参见本页最下方的相关资源。

第一类别中多篇文章注意事项

若showposts大于等于2，这就需要稍微修改一下代码。变量$do_not_duplicate应被转换成一个数组，而非单个值。否则初始循环将终止，$do_not_duplicate值等于最新文章编号。最终导致再次循环中出现重复文章。要解决该问题，请将

<?php $my_query = new WP_Query('category_name=featured&showposts=1');
 while ($my_query->have_posts()) : $my_query->the_post();
 $do_not_duplicate = $post->ID;?>

替换为

<?php $my_query = new WP_Query('category_name=featured&showposts=2');
  while ($my_query->have_posts()) : $my_query->the_post();
  $do_not_duplicate[] = $post->ID ?>

注意，“showposts”可以设为任何数字。这将$do_not_duplicate 转换为数组。 然后将

<?php if (have_posts()) : while (have_posts()) : the_post(); if( $post->ID ==    
  $do_not_duplicate ) continue; update_post_caches($posts); ?>

替换为

<?php if (have_posts()) : while (have_posts()) : the_post(); 
 if (in_array($post->ID, $do_not_duplicate)) continue;
 update_post_caches($posts); ?>

在这里用户可以保留showposts设置等值的样式（本例中值为2）。

文章来源

这篇关于多循环的文章整合了Ryan Boren和Alex King 在 Hackers Mailing List 上对循环的讨论以及MaxPower 上的教程。

更多The Loop相关资源

学习更多关于WordPress 主循环以及只在主循环内部运行的模板标签相关知识，请参阅：

外部资源：

分类：中文手册

* 版权声明：作者WordPress啦！ 转载请注明出处。

相关文章