热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

WordPress查询函数参考:query_posts

描述Query_posts 可以用来控制在循环TheLoop中显示哪些文章。它可以接受各种参数,就像你的URL中使用的参数(例如:参数p,p4表示只显示ID为4的文章).通常的用法:在你的首页只显示一篇文章(若只想显示一个独立的页面page,可以通过WordPress管理后台,设置-

描述

Query_posts?可以用来控制在循环The Loop中显示哪些文章。它可以接受各种参数,就像你的URL中使用的参数(例如:参数p,p=4表示只显示ID为4的文章).

通常的用法:

  • 在你的首页只显示一篇文章(若只想显示一个独立的页面page,可以通过WordPress管理后台,设置 -> 阅读,在那里修改).
  • 显示一个特定的时间段内的所有文章.
  • 在首页只显示最新的文章.
  • 改变文章的显示顺序.
  • 只显示某个特定分类下的文章.
  • 不显示某个或多个分类下的文章.

重要提示

The query_posts function is intended to be used to modify the main page Loop?only. It is not intended as a means to create secondary Loops on the page. If you want to create separate Loops outside of the main one, you should create separate?WP_Query?objects and use those instead. Use of query_posts on Loops other than the main one can result in your main Loop becoming incorrect and possibly displaying things that you were not expecting.

The query_posts function overrides and replaces the main query for the page. To save your sanity, do not use it for any other purpose.

用法

Usage Note

Place a call to?query_posts()?in one of your?Template?files before?The Loop?begins. The?wp_query?object will generate a new SQL query using your parameters. When you do this, WordPress ignores the other parameters it receives via the URL (such as page number or category). If you want to preserve that information, you can use the?$query_string?global variable in the call to?query_posts().

For example, to set the display order of the posts without affecting the rest of the query string, you could place the following before?The Loop:

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

When using?query_posts?in this way, the quoted portion of the argument?must?begin with an ampersand (&).

 

Parameters

This is not an exhaustive list yet. It is meant to show some of the more common things possible with setting your own queries.

 

Category Parameters

Show posts only belonging to certain categories.

  • cat?- must use cat ids
  • category_name
  • category__and?- must use cat ids
  • category__in?- must use cat ids
  • category__not_in?- must use cat ids

Show One Category by ID

Display posts from only one category ID (and any children of that category):

query_posts('cat=4');

Show One Category by Name

Display posts from only one category by name:

query_posts('category_name=Staff Home');

Show Several Categories by ID

Display posts from several specific category IDs:

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

Exclude Posts Belonging to Only One Category

Show all posts?except?those from a category by prefixing its ID with a '-' (minus) sign.

query_posts('cat=-3');

This excludes any post that belongs to category 3.

Multiple Category Handling

Display posts that are in multiple categories. This shows posts that are in both categories 2 and 6:

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

To display posts from either category 2 OR 6, you could use?cat?as mentioned above, or by using?category__in(note this does not show posts from any children of these categories):

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

You can also exclude multiple categories this way:

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

 

Tag Parameters

Show posts associated with certain tags.

  • tag
  • tag_id?- must use tag ids
  • tag__and?- must use tag ids
  • tag__in?- must use tag ids
  • tag__not_in?- must use tag ids
  • tag_slug__and
  • tag_slug__in

Fetch posts for one tag

query_posts('tag=cooking');

Fetch posts that have either of these tags

query_posts('tag=bread,baking');

Fetch posts that have all three of these tags:

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

Multiple Tag Handling

Display posts that are tagged with both tag id 37 and tag id 47:

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

To display posts from either tag id 37 or 47, you could use?tag?as mentioned above, or explicitly specify by using?tag__in:

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

Display posts that do not have any of the two tag ids 37 and 47:

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

The?tag_slug__in?and?tag_slug__and?behave much the same, except match against the tag's slug.

Also see?Ryan's discussion of Tag intersections and unions.

 

作者参数

你也可以通过作者限定文章

  • author=3
  • author=-3?通过“负号”排除作者id为3的文章
  • author_name=Harriet

注释:?author_name为定义于user_nicename中的字段,author为作者的id。

排除置顶文章后依照标题排序显示所有作者ID为1的已发布页面

query_posts('caller_get_posts=1&author=1&post_type=page&post_status=publish&orderby=title&order=ASC');

 

Post & Page Parameters

Retrieve a single post or page.

  • 'p' => 27?- use the post ID to show that post
  • 'name' => 'about-my-life'?- query for a particular post that has this?Post Slug
  • 'page_id' => 7?- query for just Page ID 7
  • 'pagename' => 'about'?- note that this is not the page's title, but the page's path
  • 'posts_per_page' => 1?- use?'posts_per_page' => 3?to show 3 posts. Use?'posts_per_page' => -1?to show all posts
  • 'showposts' => 1?- use?'showposts' => 3?to show 3 posts. Use?'showposts' => -1?to show all posts.Deprecated in favor of posts_per_page
  • 'post__in' => array(5,12,2,14,7)?- inclusion, lets you specify the post IDs to retrieve
  • 'post__not_in' => array(6,2,8)?- exclusion, lets you specify the post IDs NOT to retrieve
  • 'post_type' => 'page'?- returns?Pages; defaults to value of?post; can be?any,?attachment,?page,?post, orrevision.?any?retrieves any type except revisions. Also can designate custom post types (e.g. movies).
  • 'post_status' => 'publish'?- returns publish works. Also could use?pending,?draft,?future,?private,?trash. For?inherit?see?get_children. Status of?trash?added with?Version 2.9.
  • 'post_parent' => 93?- return just the child Pages of Page 93.

To return both posts and custom post type movie

query_posts( array( 'post_type' => array('post', 'movie') ) );

 

Sticky Post Parameters

Sticky posts first became available with WordPress Version 2.7. Posts that are set as Sticky will be displayed before other posts in a query, unless excluded with the?caller_get_posts=1?parameter.

  • array('post__in'=>get_option('sticky_posts'))?- returns array of all sticky posts
  • caller_get_posts=1?- To exclude sticky posts being included at the beginning of posts returned, but the sticky post will still be returned in the natural order of that list of posts returned.

To return just the first sticky post:

$sticky=get_option('sticky_posts')?; 
query_posts('p=' . $sticky[0]);

or

$args = array(
	'posts_per_page' => 1,
	'post__in'  => get_option('sticky_posts'),
	'caller_get_posts' => 1
);
query_posts($args);

Note: the second method returns only the more recent sticky post; if there are not sticky posts, it returns the last post published.

To return just the first sticky post or nothing:

$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...
}

To exclude all sticky posts from the query:

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

Return ALL posts with the category, but don't show sticky posts at the top. The 'sticky posts' will still show in their natural position (e.g. by date):

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

Return posts with the category, but exclude sticky posts completely, and adhere to paging rules:

3,
   'caller_get_posts'=>1,
   'post__not_in' => $sticky,
   'paged'=>$paged,
   );
query_posts($args);
?>

 

Time Parameters

Retrieve posts belonging to a certain time period.

  • hour=?- hour (from 0 to 23)
  • minute=?- minute (from 0 to 60)
  • secOnd=?- second (0 to 60)
  • day=?- day of the month (from 1 to 31)
  • mOnthnum=?- month number (from 1 to 12)
  • year=?- 4 digit year (e.g. 2009)
  • w=?- week of the year (from 0 to 53) and uses the?MySQL WEEK command Mode=1.

Returns posts for just the current date:

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

Returns posts for just the current week:

$week = date('W');
$year = date('Y');
query_posts('year=' . $year .'&w=' .$week );

Returns posts dated December 20:

query_posts( 'mOnthnum=12&day=20' );

Return posts for posts for March 1 to March 15, 2009:

= '2009-03-01' AND post_date <'2009-03-16'";
    return $where;
  }
add_filter('posts_where', 'filter_where');
query_posts($query_string);
?>

Return posts from the last 30 days:

 '" . date('Y-m-d', strtotime('-30 days')) . "'";
    return $where;
  }
add_filter('posts_where', 'filter_where');
query_posts($query_string);
?>

Return posts 30 to 60 days old

= '" . 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);
?>

 

Pagination Parameters

  • nopaging=true?- will disable pagination, displaying all posts
  • posts_per_page=10?- number of posts to show per page
  • paged=2?- show the posts that would normally show up just on page 2 when using the "Older Entries" link. You should set this to?get_query_var( 'paged' )?if you want your query to work with pagination.
  • order=ASC?- show posts in chronological order, DESC to show in reverse order (the default)

 

Offset Parameter

You can?displace?or pass over one or more initial posts which would normally be collected by your query through the use of the offset parameter.

The following will display the 5 posts which follow the most recent (1):

query_posts('posts_per_page=5&offset=1');

 

Orderby Parameters

Sort retrieved posts by this field.

  • orderby=author
  • orderby=date
  • orderby=title
  • orderby=modified
  • orderby=menu_order?Note:?Only works with?Pages.
  • orderby=parent
  • orderby=ID
  • orderby=rand
  • orderby=meta_value?Note:?A?meta_key=keyname?must also be present in the query.
  • orderby=none?- no order (available with?Version 2.8)
  • orderby=comment_count?- (available with?Version 2.9)

 

Order Parameters

Designates the ascending or descending order of the ORDERBY parameter.

  • order=ASC?- ascending order, lowest to highest value
  • order=DESC?- descending order, highest to lowest value

 

Custom Field Parameters

Retrieve posts (or?Pages) based on a custom field key or value.

  • meta_key=
  • meta_value=
  • meta_compare=?- operator to test the?meta_value=, default is '=', with other possible values of '!=', '>', '>=', '<', or '<='

Returns posts with custom fields matching both a key of 'color' AND a value of 'blue':

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

Returns posts with a custom field key of 'color', regardless of the custom field value:

query_posts('meta_key=color');

Returns posts where the custom field value is 'color', regardless of the custom field key:

query_posts('meta_value=color');

Returns any?Page?where the custom field value is 'green', regardless of the custom field key:

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

Returns both posts and?Pages?with a custom field key of 'color' where the custom field value IS NOT EQUAL TO 'blue':

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

Returns posts with custom field key of 'miles' with a custom field value that is LESS THAN OR EQUAL TO 22. Note the value 99 will be considered greater than 100 as the data is stored as strings, not numbers.

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

 

Combining Parameters

You may have noticed from some of the examples above that you combine parameters with an ampersand (&), like so:

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

Posts for category 13, for the current month on the main page:

if (is_home()) {
query_posts($query_string . '&cat=13&mOnthnum=' . date('n',current_time('timestamp')));
}

At 2.3 this combination will return posts belong to both Category 1 AND 3, showing just two (2) posts, in descending order by the title:

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

In 2.3 and 2.5 one would expect the following to return all posts that belong to category 1 and is tagged "apples"

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

A bug prevents this from happening. See?Ticket #5433. A workaround is to search for several tags using +

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

This will yield the expected results of the previous query. Note that using 'cat=1&tag=apples+oranges' yields expected results.

 

Examples

 

Exclude Categories From Your Home Page

Placing this code in your?index.php?file will cause your home page to display posts from all categories?exceptcategory ID 3.

You can also add some more categories to the exclude-list (tested with WP 2.1.2):

 

Retrieve a Particular Post

To retrieve a particular post, you could use the following:

If you want to use the?Read More?functionality with this query, you will need to set the global?$more?variable to 0.

 

Retrieve a Particular Page

To retrieve a particular page, you could use the following:

or

For child pages, the slug of the parent and the child is required, separated by a slash. For example:

 

Passing variables to query_posts

You can pass a variable to the query with two methods, depending on your needs. As with other examples, place these above your Loop:

 

Example 1

In this example, we concatenate the query before running it. First assign the variable, then concatenate and then run it. Here we're pulling in a category variable from elsewhere.

 

 

Example 2

In this next example, the double quotes tell PHP to treat the enclosed as an expression. For this example, we are getting the current month and the current year, and telling?query_posts?to bring us the posts for the current month/year, and in this case, listing in ascending order so we get the oldest post at the top of the page.


 

Example 3

This example explains how to generate a complete list of posts, dealing with pagination. We can use the default?$query_string?telling?query_posts?to bring us a full posts listing. We can also modify theposts_per_page?query argument from -1 to the number of posts you want to show on each page; in this last case, you'll probably want to use?posts_nav_link()?to navigate the generated archive.

 

Example 4

If you don't need to use the?$query_string?variable, another method exists that is more clear and readable, in some more complex cases. This method puts the parameters into an array. The same query as in Example 2 above could be done like this:

query_posts(array(
 'cat'      => 22, 
 'year'     => $current_year, 
 'monthnum' => $current_month, 
 'order'    => 'ASC',
));

As you can see, with this approach, every variable can be put on its own line, for easier reading.

 

Preserving the Original Query (Pagination etc.)

By default running query_posts will completely overwrite all existing query variables on the current page. Pagination, categories dates etc. will be lost and only the variables you pass into query_posts will be used.

If you want to preserve the original query you can merge the original query array into your parameter array:

global $wp_query;
query_posts(
	array_merge(
		array('cat' => 1),
		$wp_query->query
	)
);

 

 

Usage Tips

The "Blog pages show at most" parameter in Settings > Reading can influence your results. To overcome this, add the 'posts_per_page' parameter. For example:

query_posts('category_name=The Category Name&posts_per_page=-1');  //returns ALL from the category

 

Resources

 

Related

See also index of?Function Reference?and index of?Template Tags.

推荐阅读
  • MySQL缓存机制深度解析
    本文详细探讨了MySQL的缓存机制,包括主从复制、读写分离以及缓存同步策略等内容。通过理解这些概念和技术,读者可以更好地优化数据库性能。 ... [详细]
  • PHP 5.2.5 安装与配置指南
    本文详细介绍了 PHP 5.2.5 的安装和配置步骤,帮助开发者解决常见的环境配置问题,特别是上传图片时遇到的错误。通过本教程,您可以顺利搭建并优化 PHP 运行环境。 ... [详细]
  • 本文详细介绍了 GWT 中 PopupPanel 类的 onKeyDownPreview 方法,提供了多个代码示例及应用场景,帮助开发者更好地理解和使用该方法。 ... [详细]
  • 资源推荐 | TensorFlow官方中文教程助力英语非母语者学习
    来源:机器之心。本文详细介绍了TensorFlow官方提供的中文版教程和指南,帮助开发者更好地理解和应用这一强大的开源机器学习平台。 ... [详细]
  • Explore a common issue encountered when implementing an OAuth 1.0a API, specifically the inability to encode null objects and how to resolve it. ... [详细]
  • 1:有如下一段程序:packagea.b.c;publicclassTest{privatestaticinti0;publicintgetNext(){return ... [详细]
  • 深入理解 SQL 视图、存储过程与事务
    本文详细介绍了SQL中的视图、存储过程和事务的概念及应用。视图为用户提供了一种灵活的数据查询方式,存储过程则封装了复杂的SQL逻辑,而事务确保了数据库操作的完整性和一致性。 ... [详细]
  • 构建基于BERT的中文NL2SQL模型:一个简明的基准
    本文探讨了将自然语言转换为SQL语句(NL2SQL)的任务,这是人工智能领域中一项非常实用的研究方向。文章介绍了笔者在公司举办的首届中文NL2SQL挑战赛中的实践,该比赛提供了金融和通用领域的表格数据,并标注了对应的自然语言与SQL语句对,旨在训练准确的NL2SQL模型。 ... [详细]
  • 本文详细介绍了 Dockerfile 的编写方法及其在网络配置中的应用,涵盖基础指令、镜像构建与发布流程,并深入探讨了 Docker 的默认网络、容器互联及自定义网络的实现。 ... [详细]
  • 数据库内核开发入门 | 搭建研发环境的初步指南
    本课程将带你从零开始,逐步掌握数据库内核开发的基础知识和实践技能,重点介绍如何搭建OceanBase的开发环境。 ... [详细]
  • 扫描线三巨头 hdu1928hdu 1255  hdu 1542 [POJ 1151]
    学习链接:http:blog.csdn.netlwt36articledetails48908031学习扫描线主要学习的是一种扫描的思想,后期可以求解很 ... [详细]
  • 在现代网络环境中,两台计算机之间的文件传输需求日益增长。传统的FTP和SSH方式虽然有效,但其配置复杂、步骤繁琐,难以满足快速且安全的传输需求。本文将介绍一种基于Go语言开发的新一代文件传输工具——Croc,它不仅简化了操作流程,还提供了强大的加密和跨平台支持。 ... [详细]
  • 题目Link题目学习link1题目学习link2题目学习link3%%%受益匪浅!-----&# ... [详细]
  • 网络运维工程师负责确保企业IT基础设施的稳定运行,保障业务连续性和数据安全。他们需要具备多种技能,包括搭建和维护网络环境、监控系统性能、处理突发事件等。本文将探讨网络运维工程师的职业前景及其平均薪酬水平。 ... [详细]
  • MySQL 数据库迁移指南:从本地到远程及磁盘间迁移
    本文详细介绍了如何在不同场景下进行 MySQL 数据库的迁移,包括从一个硬盘迁移到另一个硬盘、从一台计算机迁移到另一台计算机,以及解决迁移过程中可能遇到的问题。 ... [详细]
author-avatar
爱情de眷恋_558
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有