wordpress 中強大的 query_posts()函數

今天說說WordPress 的主查詢函數 -query_posts()，因為我正在制作的主題裡面多次用到了這個函數 。

 

query_posts()查詢函數決定了哪些文章出現在WordPress 主 循環（loop）中，正因為如此，query_posts函數僅用於修改主頁循環（Loop），而不是在頁面上生成次級循環。如果你希望在主循環外另外生 成循環，應該新建獨立的WP_Query對象，用這些對象生成循環。在主循環外的循環上使用query_posts會導致主循環運行偏差，並可能在頁面上 顯示出你不希望看到的內容。

 

query_posts()查詢函數函數接收大量參數，格式與URL中的參數格式相同（如p=4表示ID為4的文章）。下面就舉例說說query_posts函數的一些常用的語法格式。

1.從博客主頁上排除某些分類目錄

將以下代碼添加到index.php文件中，使主頁顯示的文章可以來自除分類3以外的任何分類。

Php代碼  

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

 

你也可以多排除幾個分類。

Php代碼  

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

 

2.查詢指定文章

用以下語句檢索某篇指定文章：

Php代碼  

1. <?php  
2. //獲取ID值為5的文章  
3. query_posts('p=5');  
4. ?>  

 

如果你希望在查詢語句中使用Read More功能，請將全局變量$more設為0。

Php代碼  

1. <?php  
2. //獲取ID值為5的頁面  
3. query_posts('p=5');  
4.   
5. global $more;  
6. //初始化$more  
7. $more = 0;  
8.   
9. //循環查詢到的結果  
10. while (have_posts()) : the_post();  
11. the_content('Read the full post ?');  
12. endwhile;  
13. ?>  

 

3.檢索指定頁面

用以下語句檢索某篇指定頁面：

Php代碼  

1. <?php  
2. query_posts('page_id=7'); //獲取頁面ID為7的頁面  
3. ?>  

 

或者

Php代碼  

1. <?php  
2. query_posts('pagename=about');  
3. ?>  

 

檢索子頁面時，需要提供子頁面及其父頁面的別名，用斜線隔開兩者。例如：

Php代碼  

1. <?php  
2. query_posts('pagename=parent/child');  
3. ?>  

 

上面都是采取 query_posts($query_string) 的形式來調用該函數，下面介紹另一種方法，用數組傳遞參數變量。

Php代碼  

1. query_posts(array(  
2.   'cat' => 22,  
3.   'year' => $current_year,  
4.   'monthnum' => $current_month,  
5.   'order' => 'ASC',  
6. ));  

 

相比字符串方式，數組形式更加形象直觀，不容易出錯。

下面整理一些經常要用到的參數，有些是我用過的，有些則沒有，算作歸納吧。

分類參數

只顯示特定分類下的文章。

• cat —— 必須使用分類ID
• category_name
• category_and —— 必須使用分類ID
• category_in —— 必須使用分類ID
• category_not_in —— 必須使用分類ID

根據ID顯示單個分類

只顯示來自某一個分類目錄ID（以及該分類目錄下的子分類目錄）的文章：

Php代碼  

1. query_posts('cat=4');  

 

根據分類名稱顯示單個分類

只顯示來自某一個分類名稱下的文章：

Php代碼  

1. query_posts('category_name=Staff Home');  

 

根據ID顯示多個分類

顯示來自若干指定分類目錄ID下的文章：

Php代碼  

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

 

排除某一分類中的文章

顯示除某一分類文章外的所有文章，被排除的分類ID以減號（’-'）作為前綴。

Php代碼  

1. query_posts('cat=-3');  

 

以上代碼刪除ID為3的分類中的文章。

 

處理多個分類

顯示隸屬於多個分類的文章。下面的代碼可展示同時屬於分類2和分類6的文章：

Php代碼  

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

 

如果希望顯示分類2或分類6中的文章，可以使用上面介紹的cat，也可以使用category_in函數 （注意這裡不會顯示分類下子分類中的文章） ：

Php代碼  

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

 

可以用下面這種方式排除多個分類中的文章：

Php代碼  

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

 

標簽參數

顯示特定標簽下的文章。

• tag —— 必須使用標簽ID
• tag_id —— 必須使用標簽ID
• tag_and —— 必須使用標簽ID
• tag_in —— 必須使用標簽ID
• tag_not_in —— 必須使用標簽ID
• tag_slug_and ——必須使用標簽ID
• tag_slug_in ——必須使用標簽ID

 

獲取某一標簽中的文章

Php代碼  

1. query_posts('tag=cooking');  

 

獲取若干標簽中任一標簽中的文章

Php代碼  

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

 

多個標簽

顯示同時屬於ID為37和47的標簽下的文章：

Php代碼  

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

 

若要顯示ID為為37或47的標簽下的文章，可以使用tag參數，也可以用tag_in：

Php代碼  

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

 

顯示的文章既不屬於標簽37，也不屬於標簽47：

Php代碼  

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

 

tag_slug_in與tag_slug_and工作方式幾乎一致，不同之處在於相匹配的別名不同。

 

作者參數

你也可以根據作者來選擇文章。

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

注意：author_name運行在user_nicename字段上，同時author運行在author id字段上。

顯示ID為1的作者所發表的所有頁面，以標題順序排列頁面，頁面列表上方無置頂文章：

Php代碼  

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

 

文章&頁面參數

檢索單篇文章或頁面。

• ‘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的子頁面。

 

置頂文章參數

置頂文章功能引入於WordPress 2.7。在查詢中，被設為“置頂”的文章會顯示在其它文章之前，除非該文章已經被caller_get_posts=1 參數排除。

• array(‘post__in’=>get_option(‘sticky_posts’)) —— 返回所有置頂文章的數組
• caller_get_posts=1 —— 排除返回的文章上方的置頂文章，但在返回文章列表時，以自然順序將曾經置頂的文章安插在列表中。

 

返回第一篇置頂文章

Php代碼  

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

 

或

Php代碼  

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

 

注意：第二種方法只能返回最新發表的置頂文章；若當前無置頂文章，返回最新發表文章。

 

返回第一篇置頂文章；若無，則不返回任何內容

Php代碼  

1. $sticky = get_option('sticky_posts');  
2. $args = array(  
3. 'posts_per_page' => 1,  
4. 'post__in' => $sticky,  
5. 'caller_get_posts' => 1  
6. );  
7. query_posts($args);  
8. if($sticky[0]) {  
9. // insert here your stuff...  
10. }  

 

從查詢中排除所有置頂文章

Php代碼  

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

 

返回某一分類下所有文章，但不在文章列表上方顯示置頂文章。所有設為“置頂”的文章以正常順序（如日期順序）顯示

Php代碼  

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

 

返回某一分類下所有文章，完全不顯示置頂文章，保留分頁

Php代碼  

1. <?php  
2.   $paged = (get_query_var('paged')) ? get_query_var('paged') : 1;  
3.   $sticky=get_option('sticky_posts');  
4.   $args=array(  
5.     'cat'=>3,  
6.     'caller_get_posts'=>1,  
7.     'post__not_in' => $sticky,  
8.     'paged'=>$paged,  
9.   );  
10.   query_posts($args);  
11. ?>  

 

時間參數

檢索特定時間段內發表的文章。

• 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命令

 

返回最近發表的文章

Php代碼  

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

 

返回12月20日發表的文章

Php代碼  

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

 

返回2009年3月1日到3月15日之間發表的文章

Php代碼  

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

 

返回最近30天內發表的文章

Php代碼  

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

 

返回過去30天到過去60天內發表的文章

Php代碼  

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

 

分頁參數

• paged=2 ——顯示點擊“較早的日志”鏈接後出現在第二頁中的文章
• posts_per_page=10 —— 每頁所顯示的文章數量；若值為-1，顯示所有文章。
• order=ASC —— 按時間順序顯示文章，若值為DESC則按逆向時間順序顯示文章（默認）

 

offset（偏移）參數

通過offset參數，你可以移除或忽略正常情況下被查詢集中的一篇或多篇初始文章。

以下顯示最近一篇文章之後的5篇文章：

Php代碼  

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

 

排序參數

• 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)

 

順序參數

決定以升序或降序排列排序參數

• order=ASC —— 升序，從最低值到最高值
• order=DESC —— 降序，從最高值到最低值

 

自定義字段參數

根據自定義關鍵字或值檢索文章（或頁面）。

• meta_key=
• metavalue=
• meta_compare= —— 用以測試metavalue=的操作符，默認值為 ‘=’，其它可能的值包括’!=’、 ‘>’、’>=’、 ‘<’或 ‘<=’ 。

返回關鍵字為 ‘color’ 且值為’blue’的文章：

Php代碼  

1. query_posts('meta_key=color&metavalue=blue');  

 

返回自定義字段關鍵字為’color’的文章，無論自定義字段值為何：

Php代碼  

1. query_posts('meta_key=color');  

 

返回自定義字段值為’color’的文章，無論關鍵字為何：

Php代碼  

1. query_posts('metavalue=color');  

 

返回自定義字段值為’green’的頁面，無論自定義字段關鍵字為何：

Php代碼  

1. query_posts('post_type=page&metavalue=green');  

 

返回自定義關鍵字為’color’、自定義字段值不為’blue’的文章和頁面：

Php代碼  

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

 

返回自定義字段關鍵字為’miles’、自定義字段值小於等於22的文章。注意，字段值99會被看做大於字段值100，因為數據是以字符串形式而不是數字形式存儲的。

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

 

聯合參數

你可能已經從上面有些例子中看出來了，可以用&符號連接不同參數，如：

Php代碼  

1. uery_posts('cat=3&year=2004');  

 

顯示主頁上、當前月份發表的、隸屬於分類13下的文章：

Php代碼  

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

 

在WP 2.3中，以下參數聯合會返回同時屬於分類1和分類3的兩篇文章，以文章標題降序排列：

Php代碼  

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”標簽的文章：

Php代碼  

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

 

但由於一個bug，代碼沒能顯示出正常結果。有一個解決辦法：利用+號查找多個標簽：

Php代碼  

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

 

這就顯示出我們希望顯示的結果了。

 

使用技巧

設置>閱讀中的“博客頁面最多顯示”參數會影響你的查詢結果，要覆蓋設置>閱讀中的設置，需要在標簽中添加’posts_per_page’ 參數。例如：

Php代碼  

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

 

 

注意：query_posts函數會改寫並取代頁面的主查詢。為謹慎起見，請不要將query_posts用作其它用途。

 

 

來源： http://www.zuluo.net/2012/2012-01/wordpress-query_posts.html