自己定义wordpress主循环

文章目录

wordpress中可以自己定义输出文章,如按分类,日期等等,该操作一般都是在wordpress的主循环中完成。wordpress的主循环一般使用query_posts()函数,本文将对query_posts()函数做详细的介绍。

query_posts()函数说明

query_posts()函数通过大量的参数可以设置什么样的文章,内容出现在wordpress主循环中。如下面所举得例子:

  • 仅在博客主页上显示一篇文章(通过设置>阅读进行设置)
  • 显示某一特定时间段内发表的所有文章
  • 在主页显示近期发表文章
  • 更改文章排列顺序
  • 仅显示某一分类目录中的文章
  • 排除一个或多个分类

重要提示:
query_posts函数仅用于修改主页循环(Loop)。如果你希望在主循环外另外生成循环,应该新建独立的WP_Query对象,用这些对象生成循环。在主循环外的循环上使用query_posts会导致主循环运行偏差,并可能在页面上显示出你不希望看到的内容。query_posts函数会改写并取代页面的主查询。为谨慎起见,请不要将query_posts用作其它用途。

query_posts()函数用法

在主循环开始前,对你的某个模板文件的query_posts()安排一个调用,wp_query对象会利用参数生成新的SQL查询。当你开始调用时,WordPress主循环会忽略通过URL接收到的其它参数(如页面编号或分类),而根据query_posts()函数的查询结果进行循环输出。首先给出一个例子:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<?php
//The Query 
query_posts(‘posts_per_page=5);
//The Loop 
if ( have_posts() ) : while ( have_posts() ) : the_post(); 
.. 
endwhile; else: 
.. 
endif;
 
//Reset Query 
wp_reset_query();
 
?>

如果你希望保留URL接收到的其它参数(如页面编号或分类),可以在对query_posts()的调用中使用$query_string全局变量。例如,要设置文章的显示顺序而不影响查询字符串的剩余部分,可以将以下代码添加到主循环(loop)之前:

1
2
global $query_string;  
query_posts($query_string . "&order=ASC");

以这种方式使用query_posts时,参数所引用的部分必须以&符号开头。这个在wordpress主题制作用有大量的应用。

query_posts()函数示例

1、博客主页排除分类

将以下代码添加到index.php文件中,使主页显示的文章可以来自除分类3以外的任何分类。

1
2
3
4
5
<?php
if (is_home()) {
query_posts("cat=-3");
}
?>

你也可以多排除几个分类:

1
2
3
4
5
<?php
if (is_home()) {
query_posts("cat=-1,-2,-3");
}
?>

2、检索指定文章或页面

1
2
3
4
<?php
// retrieve one post with an ID of 5
query_posts(‘p=5);
?>

如果你希望在查询语句中使用Read More功能,请将全局变量$more设为0。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
<?php
// retrieve one post with an ID of 5
 
query_posts(‘p=5);
 
global $more;
 
// set $more to 0 in order to only get the first part of the post
 
$more = 0;
 
// the Loop
 
while (have_posts()) : the_post();
 
// the content of the post
 
the_content(‘Read the full post ?’);
 
endwhile;
 
?>

检索指定页面:

1
2
3
4
5
<?php
 
query_posts(‘page_id=7); //retrieves page 7 only
 
?>

或者

1
2
3
4
5
<?php
 
query_posts(‘pagename=about’); //retrieves the about page only
 
?>

检索子页面时,需要提供子页面及其父页面的别名,用斜线隔开两者。例如:

1
2
3
4
5
<?php
 
query_posts(‘pagename=parent/child’); // retrieve the child page of a parent
 
?>

3、query_posts传递变量

有两种方法可以给给查询传递变量,你可以根据自己的需求从中选择一种。使用时,将代码添加到循环中。
(1)在这个例子中,我们在运行查询语句前先连结所有查询。首先赋值变量,然后连结变量并运行。这里我们要从别处引入一个分类变量。

1
2
3
4
5
6
7
8
9
<?php
 
$categoryvariable=$cat; // assign the variable as current category
 
$query= ‘cat=. $categoryvariable.&orderby=date&order=ASC’; // concatenate the query
 
query_posts($query); // run the query
 
?>

(2)这个示例将使用双引号来告诉PHP将引号中的内容当成表达式。在下面的例子中,我们要获取当前月份、年份时间,然后让query_posts获取当前月/年的文章,并且以升序方式在页面最上方显示发表日期最早的文章。

1
2
3
4
5
6
7
8
9
10
11
<?php
 
$current_month = date(‘m’);
 
$current_year = date(‘Y’);
 
query_posts("cat=22&year=$current_year&monthnum=$current_month&order=ASC");
 
?>
 
<!– put your loop here –>

(3)该示例说明了怎样生成一个完整的文章分页列表。我们可以用默认的$query_string来命令query_posts给我们显示一个完整的文章列表。也可以将posts_per_page查询语句从-1改成你希望在每页显示的文章数。在后面这种情况下,你可以用posts_nav_link 来导航所生成的存档。

1
2
3
4
5
6
7
8
9
10
<?php
 
query_posts($query_string.&posts_per_page=-1);
 
while(have_posts()) { the_post();
 
<!– put your loop here –>
 
}
?>

(4)如果你不需要使用$query_string变量,可以在一些复杂的情况下使用一个更简单易读的方法。这个方法就是,将参数放入数组。那么通过下面的代码,也可以生成2中的查询:

1
2
3
4
5
6
7
8
9
10
11
query_posts(array(
 
‘cat’ => 22,
 
‘year’ => $current_year,
 
‘monthnum’ => $current_month,
 
‘order’ => ‘ASC’,
 
));

query_posts()函数参数

这里并没有列出完整的参数列表。我们在这里介绍这些参数,只是为了让你多了解一些关于如何设置查询的信息。

1、分类参数

只显示特定分类下的文章。

  • cat —— 必须使用分类ID
  • category_name
  • category_and —— 必须使用分类ID
  • category_in —— 必须使用分类ID
  • category_not_in —— 必须使用分类ID

根据ID显示单个分类
只显示来自某一个分类目录ID(以及该分类目录下的子分类目录)的文章:

1
query_posts('cat=4');

根据分类名称显示单个分类
只显示来自某一个分类名称下的文章:

1
query_posts('category_name=Staff Home');

根据ID显示多个分类
显示来自若干指定分类目录ID下的文章:

1
query_posts('cat=2,6,17,38');

排除某一分类中的文章
显示除某一分类文章外的所有文章,被排除的分类ID以减号(’-’)作为前缀。

1
query_posts('cat=-3');

以上代码删除ID为3的分类中的文章。

处理多个分类
显示隶属于多个分类的文章。下面的代码可展示同时属于分类2和分类6的文章:

1
query_posts(array('category__and' => array(2,6)));

如果希望显示分类2或分类6中的文章,可以使用上面介绍的cat,也可以使用category_in函数 (注意这里不会显示分类下子分类中的文章) :

1
query_posts(array('category__in' => array(2,6)));

可以用下面这种方式排除多个分类中的文章:

1
query_posts(array('category__not_in' => array(2,6)));

2、标签参数

显示特定标签下的文章。

  • tag —— 必须使用标签ID
  • tag_id —— 必须使用标签ID
  • tag_and —— 必须使用标签ID
  • tag_in —— 必须使用标签ID
  • tag_not_in —— 必须使用标签ID
  • tag_slug_and ——必须使用标签ID
  • tag_slug_in ——必须使用标签ID

获取某一标签中的文章

1
query_posts('tag=cooking');

获取若干标签中任一标签中的文章

1
query_posts('tag=bread+baking+recipe');

多个标签
显示同时属于ID为37和47的标签下的文章:

1
query_posts(array('tag__and' => array(37,47));

若要显示ID为为37或47的标签下的文章,可以使用tag参数,也可以用tag_in:

1
query_posts(array('tag__in' => array(37,47));

显示的文章既不属于标签37,也不属于标签47:

1
query_posts(array('tag__not_in' => array(37,47));

tag_slug_in与tag_slug_and工作方式几乎一致,不同之处在于相匹配的别名不同。

3、作者参数

  • author=3
  • author=-3 ——排除ID为3的作者所发表的文章
  • author_name=Harriet

注意:author_name运行在user_nicename字段上,同时author运行在author id字段上。

显示ID为1的作者所发表的所有页面,以标题顺序排列页面,页面列表上方无置顶文章:

1
query_posts('caller_get_posts=1&author=1&post_type=page&post_status=publish&orderby=title&order=A

4、文章&页面参数

  • ‘p’ => 27 —— 通过文章ID显示该文章
  • ‘name’ => ‘about-my-life’ —— 对某篇文章的查询,查询中含有文章别名
  • ‘page_id’ => 7 —— 对ID为7的页面的查询
  • ‘pagename’ => ‘about’ —— 注意,这不是页面标题,而是页面路径
  • 用’posts_per_page’ => 1 – use ‘posts_per_page’ => 3 展示3篇文章。用’posts_per_page’ => -1展示所有文章
  • ‘showposts’ => 1 – use ‘showposts’ => 3 展示3篇文章。用’showposts’ => -1展示所有文章。已弃用。
  • ‘post__in’ => array(5,12,2,14,7) —— 指定希望检索的文章ID
  • ‘post__not_in’ => array(6,2,8) ——排除不希望检索的文章ID
  • ‘post_type’ => ‘page’ ——返回页面;默认值为post;可用值包括any, attachment, page, post或revision。any可检索到除修订版外的所有页面类型。
  • ‘post_status’ => ‘publish’ —— 返回已发布页面。可用值还包括pending, draft, future, private, trash。关于inherit请见get_children。trash状态新增于WordPress 2.9。
  • ‘post_parent’ => 93 —— 返回页面93的子页面。

5、置顶文章参数

置顶文章功能引入于WordPress 2.7。在查询中,被设为“置顶”的文章会显示在其它文章之前,除非该文章已经被caller_get_posts=1参数排除。

  • array(‘post__in’=>get_option(‘sticky_posts’)) —— 返回所有置顶文章的数组
  • caller_get_posts=1 —— 排除返回的文章上方的置顶文章,但在返回文章列表时,以自然顺序将曾经置顶的文章安插在列表中。

返回第一篇置顶文章

1
2
$sticky=get_option(‘sticky_posts’) ;
query_posts(‘p=. $sticky[0]);

1
2
3
4
5
6
$args = array(
‘posts_per_page’ => 1,
‘post__in’ => get_option(‘sticky_posts’),
‘caller_get_posts’ => 1
);
query_posts($args);

注意:第二种方法只能返回最新发表的置顶文章;若当前无置顶文章,返回最新发表文章。

返回第一篇置顶文章;若无,则不返回任何内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
$sticky = get_option(‘sticky_posts’);
 
$args = array(
 
‘posts_per_page’ => 1,
 
‘post__in’ => $sticky,
 
‘caller_get_posts’ => 1
 
);
 
query_posts($args);
 
if($sticky[0]) {
 
// insert here your stuff…
 
}

从查询中排除所有置顶文章

1
query_posts(array("post__not_in" =>get_option("sticky_posts")));

返回某一分类下所有文章,但不在文章列表上方显示置顶文章。所有设为“置顶”的文章以正常顺序(如日期顺序)显示

1
query_posts('caller_get_posts=1&posts_per_page=3&cat=6');

返回某一分类下所有文章,完全不显示置顶文章,保留分页

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<?php
 
$paged = (get_query_var(‘paged’)) ? get_query_var(‘paged’) : 1;
 
$sticky=get_option(‘sticky_posts’);
 
$args=array(
 
‘cat’=>3,
 
‘caller_get_posts’=>1,
 
‘post__not_in’ => $sticky,
 
‘paged’=>$paged,
 
);
 
query_posts($args);
 
?>

6、时间参数

检索特定时间段内发表的文章。

  • hour= -hour (时,-范围从0到23)
  • minute= – minute (分,-范围从0到60)
  • second= – second (秒,-范围从0到60)
  • day= – day of the month (日,-范围从1到31)
  • monthnum= – month number (月,-范围从1到12)
  • year= – 4 digit year (年,如2009)
  • w= – week of the year(一年中的第几周,-范围从0到53),使用 MySQL WEEK command Mode=1命令

返回最近发表的文章

1
2
$today = getdate();  
query_posts('year=' .$today["year"] .'&monthnum=' .$today["mon"] .'&day=' .$today["mday"] );

返回12月20日发表的文章

1
query_posts(monthnum=12&day=20' );

返回2009年3月1日到3月15日之间发表的文章

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
<?php
//based on Austin Matzko’s code from wp-hackers email list
 
function filter_where($where =) {
 
//posts for March 1 to March 15, 2009
 
$where .= " AND post_date >= ’2009-03-01′ AND post_date < ’2009-03-16′";
 
return $where;
 
}
 
add_filter(‘posts_where’, ‘filter_where’);
 
query_posts($query_string);
 
?>

返回最近30天内发表的文章

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<?php
 
//based on Austin Matzko’s code from wp-hackers email list
 
function filter_where($where =) {
 
//posts in the last 30 days
 
$where .= " AND post_date > ‘" . date(‘Y-m-d’, strtotime(-30 days’)) . "’";
 
return $where;
 
}
 
add_filter(‘posts_where’, ‘filter_where’);
 
query_posts($query_string);
 
?>

返回过去30天到过去60天内发表的文章

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<?php
 
//based on Austin Matzko’s code from wp-hackers email list
 
function filter_where($where =) {
 
//posts 30 to 60 days old
 
$where .= " AND post_date >= ‘" . date(‘Y-m-d’, strtotime(-60 days’)) . "’" . " AND post_date <= ‘" . date(‘Y-m-d’, strtotime(-30 days’)) . "’";
 
return $where;
 
}
 
add_filter(‘posts_where’, ‘filter_where’);
 
query_posts($query_string);
 
?>

7、分页参数

  • paged=2 ——显示点击“较早的日志”链接后出现在第二页中的文章
  • posts_per_page=10 —— 每页所显示的文章数量;若值为-1,显示所有文章。
  • order=ASC —— 按时间顺序显示文章,若值为DESC则按逆向时间顺序显示文章(默认)

8、offset(偏移)参数

通过offset参数,你可以移除或忽略正常情况下被查询集中的一篇或多篇初始文章。
以下显示最近一篇文章之后的5篇文章:
query_posts(‘posts_per_page=5&offset=1′);

9、排序参数

  • orderby=author
  • orderby=date
  • orderby=category ——注意:该参数不能用于WordPress 2.8,可能已经被废止
  • orderby=title
  • orderby=modified
  • orderby=menu_order
  • orderby=parent
  • orderby=ID
  • orderby=rand
  • orderby=meta_value —— meta_key=some value语句也应出现在查询参数中
  • orderby=none – no order —— (新增于 WP 2.8)
  • orderby=comment_count ——(新增于 WP 2.9)

10、顺序参数

决定以升序或降序排列排序参数

  • order=ASC —— 升序,从最低值到最高值
  • order=DESC —— 降序,从最高值到最低值

11、自定义字段参数

根据自定义关键字或值检索文章(或页面)。

  • meta_key=
  • meta_value=
  • meta_compare= —— 用以测试meta_value=的操作符,默认值为 ‘=’,其它可能的值包括’!=’、 ‘>’、’>=’、 ‘<’或 ‘<=’ 。

返回关键字为 ‘color’ 且值为’blue’的文章

1
query_posts('meta_key=color&meta_value=blue');

返回自定义字段关键字为’color’的文章,无论自定义字段值为何

1
query_posts('meta_key=color');

返回自定义字段值为’color’的文章,无论关键字为何

1
query_posts('meta_value=color');

返回自定义字段值为’green’的页面,无论自定义字段关键字为何

1
query_posts('post_type=page&meta_value=green');

返回自定义关键字为’color’、自定义字段值不为’blue’的文章和页面

1
query_posts('post_type=any&meta_key=color&meta_compare=!=&meta_value=blue');

返回自定义字段关键字为’miles’、自定义字段值小于等于22的文章。注意,字段值99会被看做大于字段值100,因为数据是以字符串形式而不是数字形式存储的。

1
query_posts('meta_key=miles&meta_compare=<=&meta_value=22');

12、联合参数

你可能已经从上面有些例子中看出来了,可以用&符号连接不同参数,如:

1
query_posts('cat=3&year=2004');

显示主页上、当前月份发表的、隶属于分类13下的文章:

1
2
3
4
5
if (is_home()) {
 
query_posts($query_string .&cat=13&monthnum=. date(‘n’,current_time(‘timestamp’)));
 
}

在WP 2.3中,以下参数联合会返回同时属于分类1和分类3的两篇文章,以文章标题降序排列:

1
query_posts(array('category__and'=>array(1,3),'posts_per_page'=>2,'orderby'=>title,'order'=>DESC));

在WP 2.3和WP 2.5中,以下参数联合本应返回属于分类1且带有“apples”标签的文章:

1
query_posts('cat=1&tag=apples');

但由于一个bug,代码没能显示出正常结果。详情请见Ticket #5433。有一个解决办法:利用+号查找多个标签:

1
query_posts('cat=1&tag=apples+apples');

这就显示出我们希望显示的结果了。

本文出自 TENNFY博客,转载时请注明出处及相应链接。

本文永久链接: https://www.tennfy.com/269.html

下一篇文章:

上一篇文章:

发表评论

电子邮件地址不会被公开。 必填项已用 * 标注

*

5 + 6 = ?


您可以使用这些 HTML 标签和属性: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

返回顶部