说说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代碼???
你也可以多排除幾個分類。
Php代碼???
2.查詢指定文章
用以下語句檢索某篇指定文章:
Php代碼???
如果你希望在查詢語句中使用Read More功能,請將全局變量$more設為0。
Php代碼???
3.檢索指定頁面
用以下語句檢索某篇指定頁面:
Php代碼???
或者
Php代碼???
檢索子頁面時,需要提供子頁面及其父頁面的別名,用斜線隔開兩者。例如:
Php代碼???
上面都是采取 query_posts($query_string) 的形式來調用該函數,下面介紹另一種方法,用數組傳遞參數變量。
Php代碼???
相比字符串方式,數組形式更加形象直觀,不容易出錯。
下面整理一些經常要用到的參數,有些是我用過的,有些則沒有,算作歸納吧。
分類參數
只顯示特定分類下的文章。
- cat —— 必須使用分類ID
- category_name
- category_and —— 必須使用分類ID
- category_in —— 必須使用分類ID
- category_not_in —— 必須使用分類ID
根據ID顯示單個分類
只顯示來自某一個分類目錄ID(以及該分類目錄下的子分類目錄)的文章:
Php代碼???
根據分類名稱顯示單個分類
只顯示來自某一個分類名稱下的文章:
Php代碼???
根據ID顯示多個分類
顯示來自若干指定分類目錄ID下的文章:
Php代碼???
排除某一分類中的文章
顯示除某一分類文章外的所有文章,被排除的分類ID以減號(’-')作為前綴。
Php代碼???
以上代碼刪除ID為3的分類中的文章。
?
處理多個分類
顯示隸屬于多個分類的文章。下面的代碼可展示同時屬于分類2和分類6的文章:
Php代碼???
如果希望顯示分類2或分類6中的文章,可以使用上面介紹的cat,也可以使用category_in函數 (注意這里不會顯示分類下子分類中的文章) :
Php代碼???
可以用下面這種方式排除多個分類中的文章:
Php代碼???
標簽參數
顯示特定標簽下的文章。
- tag —— 必須使用標簽ID
- tag_id —— 必須使用標簽ID
- tag_and —— 必須使用標簽ID
- tag_in —— 必須使用標簽ID
- tag_not_in —— 必須使用標簽ID
- tag_slug_and ——必須使用標簽ID
- tag_slug_in ——必須使用標簽ID
?
獲取某一標簽中的文章
Php代碼???
獲取若干標簽中任一標簽中的文章
Php代碼???
多個標簽
顯示同時屬于ID為37和47的標簽下的文章:
Php代碼???
若要顯示ID為為37或47的標簽下的文章,可以使用tag參數,也可以用tag_in:
Php代碼???
顯示的文章既不屬于標簽37,也不屬于標簽47:
Php代碼???
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代碼???
文章&頁面參數
檢索單篇文章或頁面。
- ‘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代碼???
或
Php代碼???
注意:第二種方法只能返回最新發表的置頂文章;若當前無置頂文章,返回最新發表文章。
?
返回第一篇置頂文章;若無,則不返回任何內容
Php代碼???
從查詢中排除所有置頂文章
Php代碼???
返回某一分類下所有文章,但不在文章列表上方顯示置頂文章。所有設為“置頂”的文章以正常順序(如日期順序)顯示
Php代碼???
返回某一分類下所有文章,完全不顯示置頂文章,保留分頁
Php代碼???
時間參數
檢索特定時間段內發表的文章。
- 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代碼???
返回12月20日發表的文章
Php代碼???
返回2009年3月1日到3月15日之間發表的文章
Php代碼???
返回最近30天內發表的文章
Php代碼???
返回過去30天到過去60天內發表的文章
Php代碼???
分頁參數
- paged=2 ——顯示點擊“較早的日志”鏈接后出現在第二頁中的文章
- posts_per_page=10 —— 每頁所顯示的文章數量;若值為-1,顯示所有文章。
- order=ASC —— 按時間順序顯示文章,若值為DESC則按逆向時間順序顯示文章(默認)
?
offset(偏移)參數
通過offset參數,你可以移除或忽略正常情況下被查詢集中的一篇或多篇初始文章。
以下顯示最近一篇文章之后的5篇文章:
Php代碼???
排序參數
- 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代碼???
返回自定義字段關鍵字為’color’的文章,無論自定義字段值為何:
Php代碼???
返回自定義字段值為’color’的文章,無論關鍵字為何:
Php代碼???
返回自定義字段值為’green’的頁面,無論自定義字段關鍵字為何:
Php代碼???
返回自定義關鍵字為’color’、自定義字段值不為’blue’的文章和頁面:
Php代碼???
返回自定義字段關鍵字為’miles’、自定義字段值小于等于22的文章。注意,字段值99會被看做大于字段值100,因為數據是以字符串形式而不是數字形式存儲的。
query_posts('meta_key=miles&meta_compare=<=&metavalue=22');?
聯合參數
你可能已經從上面有些例子中看出來了,可以用&符號連接不同參數,如:
Php代碼???
顯示主頁上、當前月份發表的、隸屬于分類13下的文章:
Php代碼???
在WP 2.3中,以下參數聯合會返回同時屬于分類1和分類3的兩篇文章,以文章標題降序排列:
Php代碼???
在WP 2.3和WP 2.5中,以下參數聯合本應返回屬于分類1且帶有“apples”標簽的文章:
Php代碼???
但由于一個bug,代碼沒能顯示出正常結果。有一個解決辦法:利用+號查找多個標簽:
Php代碼???
這就顯示出我們希望顯示的結果了。
?
使用技巧
設置>閱讀中的“博客頁面最多顯示”參數會影響你的查詢結果,要覆蓋設置>閱讀中的設置,需要在標簽中添加’posts_per_page’ 參數。例如:
Php代碼???
?
注意:query_posts函數會改寫并取代頁面的主查詢。為謹慎起見,請不要將query_posts用作其它用途。
?
?
來源: http://www.zuluo.net/2012/2012-01/wordpress-query_posts.html
轉載于:https://www.cnblogs.com/kenshinobiy/p/7309233.html
總結
以上是生活随笔為你收集整理的说说WordPress的主查询函数-query_posts()的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 重写equals和hashCode
- 下一篇: 深入制造 云计算大数据与智能制造论坛将于