query posts是一個非常好用的調用文章函數,可以做到同頁面內顯示多種特定范圍的文章,例如可以調用某分類、標簽、日期及作者等不同范圍的文章列表。這些文 章列表可以極大的豐富 wordpress 頁面的內容,并有利于SEO。
二手科學家整理了下query posts調用文章的函數,下面分別說明下。
首先是query posts 的一般寫法。通常是如先定義查詢再加入文章回圈程式碼后再重置查詢。
<?php //定義要顯示的文章范圍查詢 query_posts(); //文章回圈 if ( have_posts() ) : while ( have_posts() ) : the_post(); ?> <!–這邊是當判斷符合時列出的文章清單,你可以用< ?php the_xxx(); >系列來顯示相關的文章資訊–> <?php endwhile; else: ?> <!–這邊是顯示抓無資料時要跑出來的錯誤訊息–> <?php endif; //重置查詢(這是為了避免之后的查詢資料因為上面這段查詢而混亂掉) wp_reset_query(); ?>
下面所有的函數都基于以上框架,只要在 query_posts(); 里輸入相應的參數來顯示出自己想要的文章范圍即可。
1、Category Parameters(文章分類參數)
<?php //僅顯示分類編號為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(標簽參數)
<?php //僅顯示標簽帶有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(作者參數)
<?php //僅顯示作者編號為3的文章 query_posts(‘author=3′); //僅顯示作者編號不為3的文章 query_posts(‘author=-3′); //僅顯示作者名稱為Harriet的文章 query_posts(‘author_name=Harriet’); ?>
4、Sticky Post Parameters(置頂文章參數)
<?php //僅顯示置頂文章 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(文章& 分頁參數)
<?php //顯示文章編號為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(時間參數)
<?php //顯示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(排列順序參數)
<?php //依照發表作者排列 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(分頁參數)
<?php //當值設定true時則為不分頁顯示,直接顯示全部文章 nopaging=true //顯示每頁文章顯示10篇 posts_per_page=10 //頁數,例如當設定為6時則就表示跳到第6頁 paged=6 //排列順序,ASC為按時間順序排列文章,若是DESC則是反向顯示文章 order=ASC ?>
9、組合運用范例
<?php query_posts(‘cat=3&year=2004′); ?> 顯示分類編號為1及3且每頁顯示兩篇、依照標題逆向排列的文章。 <?php query_posts(array(‘category__and’=>array(1,3),‘posts_per_page’=>2,‘orderby’=>title,‘order’=>DESC)); ?> 僅在首頁顯示,并且是在分類編號為13的當月發表文章。 <?php if (is_home()) { query_posts($query_string . ‘&cat=13&monthnum=’ . date(‘n’,current_time(‘timestamp’))); } ?> 顯示分類編號為1且標簽為apples的文章。 <?php query_posts(‘cat=1&tag=apples’); ?>