The Loop（循环）

发表评论

A+

The Loop（循环）是 WordPress 用来显示文章的 PHP 代码。使用 The Loop，WordPress 可以在当前页面处理每一篇要显示的文章，在 Loop 内的任何 HTML 或者 PHP 代码将会针对每篇文章执行一次。

当 WordPress 文档说”该标签必须用在循环内”（例如一些特定的模板标签）时，那该标签将会针对每篇文章都重复执行一次。例如，The Loop 默认针对每篇文章都重复执行下面的这些信息：

标题 (the_title())
时间 (the_time())
分类 (the_category()).

通过使用合适的模板标签，或者使用 $post 变量（Loop 运行时与当前文章信息相同），你也可以显示关于文章的其他信息。

对于初学者来说，请参看使用 The Loop。

使用 Loop

The Loop 应该放置于 index.php 中或者任何其他用来显示文章信息的模板之中。

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; ?>

也可是使用如下的语法结构：

<?php
if ( have_posts() ) {
while ( have_posts() ) {
the_post();
//
// Post Content here
//
} // end while
} // end if
?>

Loop 例子

某些分类的文章显示不同样式

下面的例子显示每篇文章的标题，分类及内容。如果文章属于 ID 为 ‘3’ 的分类，则赋予它不同的样式。为了达成此目的，使用了 in_category() 函数。请仔细阅读注释以明确每段代码的作用。

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
<?php if ( in_category( '3' ) ) : ?>
<div class="post-cat-three">
<?php else : ?>
<div class="post">
<?php endif; ?>
<h2><a href="<?php the_permalink(); ?>" rel="bookmark" title="Permanent Link to <?php the_title_attribute(); ?>"><?php the_title(); ?></a></h2>
<small><?php the_time('F jS, Y'); ?> by <?php the_author_posts_link(); ?></small>
<div class="entry">
<?php the_content(); ?>
</div>
<p class="postmetadata"><?php _e( 'Posted in' ); ?> <?php the_category( ', ' ); ?></p>
</div>
<?php endwhile; else : ?>
<p><?php _e( 'Sorry, no posts matched your criteria.' ); ?></p>
<?php endif; ?>

排除某些分类的文章

这个例子展示了如何隐藏某个或某几个分类的文章。在这个例子中，分类 3 和分类 8 的文章被排除。

<?php $query = new WP_Query( 'cat=-3,-8' ); ?>
<?php if ( $query->have_posts() ) : while ( $query->have_posts() ) : $query->the_post(); ?>
<div class="post">
<h2><a href="<?php the_permalink() ?>" rel="bookmark" title="Permanent Link to <?php the_title_attribute(); ?>"><?php the_title(); ?></a></h2>
<small><?php the_time( 'F jS, Y' ); ?> by <?php the_author_posts_link(); ?></small>
<div class="entry">
<?php the_content(); ?>
</div>
<p class="postmetadata"><?php _e( 'Posted in' ); ?> <?php the_category( ', ' ); ?></p>
</div>
<?php endwhile;
wp_reset_postdata();
else : ?>
<p><?php _e( 'Sorry, no posts matched your criteria.' ); ?></p>
<?php endif; ?>

多重 Loops

本节内容讲述 Loop 的高级应用。这有一点难度，但是不要被吓到，我们将从一个简单的例子开始，用一点推理、耐心以及乐观的态度，你也可以掌握多重 loops。

首先，为什么要使用多重循环？一般来说，答案是你想对一组文章做一些事情，然后对另一组文章做不同的事情，但将两组文章显示在同一页面上。”一些事情”可以是任何事情，只受限与你的 PHP 水平及你的想象力。

下面我们将举一些例子，但首先我们来看一下基本的 Loop，它包含：

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

上面代码的意思是：如果要显示文章，则取出它们，一次一篇。对于每篇文章，根据 <!– do stuff … –> 的内容显示它。当获取到最后一篇文章时，停止。

关于 Do stuff：在上面的例子中，它代表一大推代码，决定如何显示每篇文章。这些代码可以根据你的喜好改变。

Loop 例子

下面是三个使用多重循环的例子。使用多重循环的关键是 $wp_query 只能调用一次。为了解决这个问题，我们可以通过调用 rewind_posts() 重复使用冲讯，或者可以创建一个新的查询对象。这在例子1中得到体现。而在例子2中，是使用一个变量存储一个查询。最后，”应用多重循环”将多种方法结合在一起。

多重循环示例1

调用 rewind_posts() 可以重复使用同一个查询。这将重置 loop 计数器，允许你再循环一次。

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

如果你使用完了原始查询，然后你想使用另一个查询，你可以通过调用 query_posts() 重复使用 $wp_query 对象。query_posts() 将执行一个新的查询，建立一个新的文章数组，重置 loop 计数器。

// 获取 special_cat 分类下的最新10篇文章
<?php query_posts( 'category_name=special_cat&posts_per_page=10' ); ?>
<?php while ( have_posts() ) : the_post(); ?>
<?php endwhile; ?>

如果你不想改变原始查询，你可以创建一个新的查询对象。

<?php $my_query = new WP_Query( 'category_name=special_cat&posts_per_page=10' ); ?>
<?php while ( $my_query->have_posts() ) : $my_query->the_post(); ?>
<?php endwhile; ?>

上面的循环中不能使用全局函数 have_posts() 及 the_post()，因为它们使用的是 $wp_query 对象。作为替代，你可以调用 $my_query 对象内的方法。

多重循环示例2

这是另一个绕开 have_posts() 及 the_post() 使用多重循环的方法。你可以先把原始查询存储在一个变量里，然后把它分配给另一个循环。这样，你就可以使用所有依赖全局变量的标准函数了。

比如:

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

应用多重循环

理解如何使用多重循环的最佳方法是展示一个完整的例子，或许多重循环最常见的例子就是在同一页面展示两组（或更多）文章列表。这常常出现在网站管理员不仅想要展示最新文章，也想展示某一分类文章的情况下。

步骤1. 从 ‘featured’ 分类中获取一篇文章

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

这段代码的意思：

将 $my_query 的值设置为查询出来（根据名称”featured”）的所有文章（这里只查询一篇）。同时，将变量 $do_not_duplicate 设置成返回文章的 ID。

我们将在下一步用到 $do_not_duplicate 的值，以确保不会在两个列表中出现相同的文章。

步骤2. 第二个循环，获取最新 X 篇文章（除了步骤1中的那篇）

下面的代码获取最新 X 篇（WordPress 后台可以设置）文章（除了步骤1中那篇文章之外），并把它们根据 Do stuff 显示出来：

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

这段代码的意思：

获取所有文章，如果某篇文章等值于 $do_not_duplicate，什么都不做（继续循环），否则执行 Do stuff 的代码。

最终代码

下面是全部的代码：

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

该代码将在一个页面生成两个列表。第一个列表只包含一篇文章—— ‘feature’ 分类下的最新一篇。第二个列表包含除了第一个列表外的，最新的 X 篇（WordPress 后台设置的数字）文章。

如果第一个分类下有多篇文章

如果 posts_per_page =2 或者更多，你需要稍微改变一下代码。变量 $do_not_duplicate 需要由一个值变成一个数组。将下面的代码：

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

替换为：

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

“posts_per_page” 可以是任何数字，上面的代码将 $do_not_duplicate 改变成数组。然后将

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

替换为：

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

还有一种方法，你可以把整个 $do_not_duplicate 数组传递给 $wp_query，这样只有满足你需要的文章才会被查询到：

<?php query_posts( array( 'post__not_in' => $do_not_duplicate ) );
if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>

应注意到查询参数不再是一个字符串，而是一个数组，设置了 post__not_in 选项。

嵌套循环

嵌套循环的意思是在第一个循环尚未结束，又开始第二个循环。

$my_query = new WP_Query( 'cat=3' );
if ( $my_query->have_posts() ) {
while ( $my_query->have_posts() ) {
$my_query->the_post();
the_content();
}
}
wp_reset_postdata();

嵌套循环结束后应该重置主循环数据，这样一些全局变量又存储了正确的数值。

使用 Loop