query posts是一個非常好用的調用文章函數，可以做到同頁面內顯示多種特定范圍的文章，例如可以調用某分類、標簽、日期及作者等不同范圍的文章列表。這些文章列表可以極大的豐富 wordpress 頁面的內容，并有利于SEO。二手科學家整理了下query posts調用文章的函數，下面分別說明下。 

首先是query posts 的一般寫法。通常是如先定義查詢再加入文章回圈程式碼后再重置查詢。 

代碼如下:

//定義要顯示的文章范圍查詢 

query_posts(); 

//文章回圈 

if ( have_posts() ) : while ( have_posts() ) : the_post(); 

?> 

系列來顯示相關的文章資訊–> 

endwhile; else: 

?> 

endif; 

//重置查詢(這是為了避免之后的查詢資料因為上面這段查詢而混亂掉) 

wp_reset_query(); 

?> 

下面所有的函數都基于以上框架，只要在 query_posts(); 里輸入相應的參數來顯示出自己想要的文章范圍即可。 

1、Category Parameters（文章分類參數） 

cat – 輸入分類編號來顯示出該分類內的文章 

category_name – 輸入分類名稱來顯示出該分類內的文章 

category__and – 顯示同時被列入多個分類的文章(限輸入分類編號來識別) 

category__in – 顯示該分類內的文章，但不包括子分類內的文章(限輸入分類編號來識別) 

category__not_in – 除某分類內的文章，其他分類及子分類文章均顯示(限輸入分類編號來識別) 

代碼如下:

//僅顯示分類編號為4的文章(包括子分類文章) 

query_posts(‘cat=4′); 

//僅顯示分類名稱為Codex的文章(包括子分類文章) 

query_posts(‘category_name=Codex ‘); 

//顯示多個分類內的文章(包括各子分類文章) 

query_posts(‘cat=2,6,17,38′); 

//除了分類編號為3的文章(包括子分類文章)，其他文章都顯示 

query_posts(‘cat=-3′); 

//顯示同時有分類編號為2及6的文章 

query_posts(array(‘category__and’ => array(2,6))); 

//顯示分類編號為6的文章(但不包括子分類文章) 

query_posts(array(‘category__in’ => array(6))); 

//除了分類編號為2及6的文章，子分類及其他分類文章都顯示 

query_posts(array(‘category__not_in’ => array(2,6))); 

?> 

2、Tag Parameters（標簽參數） 

tag – 輸入標簽名稱來顯示含有該標簽的文章 

tag_id – 輸入標簽編號來顯示含有該標簽的文章 

tag__and – 顯示符合含有多個特定標簽的的文章(限輸入標簽編號來識別) 

tag__in – 顯示符合其中一個特定標簽的的文章(限輸入標簽編號來識別) 

tag__not_in – 只要有該標簽的文章一律不顯示(限輸入標簽編號來識別) 

tag_slug__and – 顯示符合含有多個特定標簽的的文章(限輸入標簽代稱來識別) 

tag_slug__in – 顯示符合其中一個特定標簽的的文章(限輸入標簽代稱來識別) 

代碼如下:

//僅顯示標簽帶有cooking的文章 

query_posts(‘tag=cooking’); 

//僅顯示標簽帶有bread或baking的文章 

query_posts(‘tag=bread,baking’); 

//僅顯示標簽帶有bread及baking及recipe的文章 

query_posts(‘tag=bread+baking+recipe’); 

//僅顯示標簽帶有編號37及47的文章 

query_posts(array(‘tag__and’ => array(37,47)); 

//僅顯示標簽帶有編號37或47的文章 

query_posts(array(‘tag__in’ => array(37,47)); 

//僅顯示標簽不帶有編號37或47的文章 

query_posts(array(‘tag__not_in’ => array(37,47)); 

?> 

3、Author Parameters（作者參數） 

author – 輸入作者編號來顯示該作者發表的文章 

author_name – 輸入作者名稱來顯示該作者發表的文章 

代碼如下:

//僅顯示作者編號為3的文章 

query_posts(‘author=3′); 

//僅顯示作者編號不為3的文章 

query_posts(‘author=-3′); 

//僅顯示作者名稱為Harriet的文章 

query_posts(‘author_name=Harriet’); 

?> 

4、Sticky Post Parameters（置頂文章參數） 

代碼如下:

//僅顯示置頂文章 

array(‘post__in’=>get_option(‘sticky_posts’)) 

//將文章的置頂屬性清除掉，以正常文章順序排序(例如發表日期)顯示出來 

caller_get_posts=1 

?> 

顯示文章，但不顯示置頂文章。 

代碼如下:

query_posts(array(“post__not_in” =>get_option(“sticky_posts”))); 

?> 

顯示分類編號為6的文章、每頁顯示3 篇文章，并且將此分類下文章的置頂屬性清除掉，以正常文章順序排序（例如發表日期）顯示出來。

代碼如下:

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

?> 

5、Post & Page Parameters（文章& 分頁參數） 

代碼如下:

//顯示文章編號為27的文章 

‘p’ => 27 

//顯示文章代稱為about-my-life的文章 

‘name’ => ‘about-my-life’ 

//顯示分頁編號為7的分頁 

‘page_id’ => 7 

//顯示分頁代稱為about的分頁 

‘pagename’ => ‘about’ 

//當文章超過5篇時就僅顯示5篇文章并且搭配換頁程式碼顯示換頁連結，設為-1則不換頁全部顯示。 

‘posts_per_page’ => 5 

//當設定為6時就顯示6篇文章，設為-1則顯示范圍內的全部文章。 

‘showposts’ => 6 

//僅顯示文章編號為5,12,2,14,7的這5篇文章 

‘post__in’ => array(5,12,2,14,7) 

//僅顯示文章編號不為5,12,2,14,7的其他全部文章 

‘post__not_in’ => array(6,2,8) 

//顯示文章類型為分頁的文章，預設值為post (文章)，可以使用的數值有attachment(媒體檔頁面), page(分頁), post(文章),或revision(修訂)。 

‘post_type’ => ‘page’ 

//顯示文章狀態為公開性質的文章，可以使用的數值有pending(審核中), draft(草稿), future(排程), private(私人), trash(垃圾) 。

‘post_status’ => ‘publish’ 

//顯示文章范圍內的第93頁 

‘post_parent’ => 93 

?> 

6、Time Parameters（時間參數） 

顯示12月20日發表的文章列表。 

代碼如下:

query_posts(‘monthnum=12&day=20′); 

?> 

顯示本周發表文章列表。 

代碼如下:

$week = date(‘W’); 

$year = date(‘Y’); 

query_posts(‘year=’ . $year .‘&w=’ .$week ); 

?> 

顯示最近30天內發表的文章列表。 

代碼如下:

function filter_where($where = ”) { 

$where .= ” AND post_date > ‘” . date(‘Ym-d’, strtotime(‘-30 days’)) . “‘”; 

return $where; 

} 

add_filter(‘posts_where’, ‘filter_where’); 

query_posts($query_string); 

?>

7、Orderby Parameters（排列順序參數） 

//依照發表作者排列 

orderby=author 

//依照日期排列 

orderby=date 

//依照標題排列 

orderby=title 

//依照最后編輯時間排列 

orderby=modified 

//依照分頁順序排列(僅適用于分頁) 

orderby=menu_order 

// (不知道XD…) 

orderby=parent 

//依照文章編號排列 

orderby=ID 

//隨機排列 

orderby=rand 

//依照自訂欄位數值排列 

orderby=meta_value 

//依照預設排列 

orderby=none 

//依照回響數排列 

orderby=comment_count 

?> 

8、Pagination Parameters（分頁參數） 

代碼如下:

//當值設定true時則為不分頁顯示，直接顯示全部文章 

nopaging=true 

//顯示每頁文章顯示10篇 

posts_per_page=10 

//頁數，例如當設定為6時則就表示跳到第6頁 

paged=6 

//排列順序，ASC為按時間順序排列文章，若是DESC則是反向顯示文章 

order=ASC 

?> 

9、組合運用范例 

顯示分類編號為3且是在2004年發表的文章。 

代碼如下:

query_posts(‘cat=3&year=2004′); 

?> 

顯示分類編號為1及3且每頁顯示兩篇、依照標題逆向排列的文章。 

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

?> 

僅在首頁顯示，并且是在分類編號為13的當月發表文章。 

if (is_home()) { 

query_posts($query_string . ‘&cat=13&monthnum=’ . date(‘n’,current_time(‘timestamp’))); 

} 

?> 

顯示分類編號為1且標簽為apples的文章。 

query_posts(‘cat=1&tag=apples’); 

?>