前面我们介绍了 WordPress 的主循环和全局变量,那么如果需要自定义 WordPress 查询进行一些事情,可以有两种方法,最容易的方法是使用 query_posts
函数,另外一种方法就是自定义 WP_Query。
query_posts 存在的问题
使用 query_posts
直接修改 WordPress 默认的主循环很方便,只要把对应的参数传递给函数即可,主循环的查询即可按照新的参数去查询,但是这样会造成以下的问题:
- 干扰使用到 WordPress 主循环的插件。
- 可能使一些 WordPress 条件判断函数失效。
- 需要去重新设置和处理回滚和偏移等问题。
使用 WP_Query 自定义查询
所以最好的方法是使用 WP_Query 来创建自定义 WordPress 查询,这样创建的查询和 WordPress 主循环隔离开,并不会影响主循环的行为。那么如何是用 WP_Query 呢?
使用 WP_Query
第一步是创建一个实例对象,比如我们要创建一个最新文章列表,就可以使用下面的代码:
<?php
$recent_query = new WP_Query();
$recent_query->query('posts_per_page=5');
?>
上面代码定义了一个叫做 recent_query
的变量,它是类 WP_Query 的一个实例,然后我使用了 WP_Query 的一个方法 query
创建一个新的查询,它的参数和 query_posts 函数的参数一样。
现在就可以开始我们自己的循环了:
<?php while ($recent_query->have_posts()) : $recent_query->the_post(); ?>
<!-- 开始干活 -->
<?php endwhile; ?>
上面我们用了 WP_Query 的两个方法,分别是 have_posts
和 the_post
,这两个方法的具体意思,可以参考这篇文章全局变量和 WordPress 主循环里面的介绍。
这样做的好处是在循环中,我们可以使用 WordPress 标准的文章相关的模板函数,比如下面是使用自定义的 Loop 先是最新5篇文章的完整代码:
<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="https://blog.wpjam.com/article/define-wordpress-loop-using-wp_query/<?php the_permalink() ?>" rel="bookmark"><?php the_title(); ?></a></li>
<?php endwhile; ?>
<?php wp_reset_query(); ?>
</ul>
简单总结
使用 WP_Query 创建自定义 WordPress 查询是不会干扰默认的 WordPress 主循环,使用它我们完全可以在一个页面同时运行两个或者以上完全独立的 WordPress 循环。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END
暂无评论内容