使用 WP_Query 而不是 query_posts 自定义 WordPress 查询

2023-04-13 11:17:00 浏览数 (1)

前面我们介绍了 WordPress 的主循环和全局变量,那么如果需要自定义 WordPress 查询进行一些事情,可以有两种方法,最容易的方法是使用 query_posts 函数,另外一种方法就是自定义 WP_Query。

query_posts 存在的问题

使用 query_posts 直接修改 WordPress 默认的主循环很方便,只要把对应的参数传递给函数即可,主循环的查询即可按照新的参数去查询,但是这样会造成以下的问题:

  • 干扰使用到 WordPress 主循环的插件。
  • 可能使一些 WordPress 条件判断函数失效。
  • 需要去重新设置和处理回滚和偏移等问题。

使用 WP_Query 自定义查询

所以最好的方法是使用 WP_Query 来创建自定义 WordPress 查询,这样创建的查询和 WordPress 主循环隔离开,并不会影响主循环的行为。那么如何是用 WP_Query 呢?

使用 WP_Query 第一步是创建一个实例对象,比如我们要创建一个最新文章列表,就可以使用下面的代码:

代码语言:javascript复制
<?php
	$recent_query = new WP_Query();
	$recent_query->query('posts_per_page=5');
?>

上面代码定义了一个叫做 recent_query 的变量,它是类 WP_Query 的一个实例,然后我使用了 WP_Query 的一个方法 query 创建一个新的查询,它的参数和 query_posts 函数的参数一样。

现在就可以开始我们自己的循环了:

代码语言:javascript复制
<?php while ($recent_query->have_posts()) : $recent_query->the_post(); ?>
	 <!-- 开始干活 -->
<?php endwhile; ?>

上面我们用了 WP_Query 的两个方法,分别是 have_poststhe_post,这两个方法的具体意思,可以参考这篇文章全局变量和 WordPress 主循环里面的介绍。

这样做的好处是在循环中,我们可以使用 WordPress 标准的文章相关的模板函数,比如下面是使用自定义的 Loop 先是最新5篇文章的完整代码:

代码语言:javascript复制
<h3>最新日志</h3>

<ul>

<?php
	$recent_query = new WP_Query();
	$recent_query->query('posts_per_page=5');
?>

<?php while ($recent_query->have_posts()) : $recent_query->the_post(); ?>

	<li><a href="<?php the_permalink() ?>" rel="bookmark"><?php the_title(); ?></a></li>

<?php endwhile; ?>

<?php wp_reset_query(); ?>

</ul>

简单总结

使用 WP_Query 创建自定义 WordPress 查询是不会干扰默认的 WordPress 主循环,使用它我们完全可以在一个页面同时运行两个或者以上完全独立的 WordPress 循环。

0 人点赞