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