WordPress獲取指定最新評論列表函數get_comments()

get_comments()是可以在主循環外獲取最新評論列表的WordPress函數,通過get_comments()函數可以獲取整站的最新評論,通過設置相關參數還可以實現獲取指定文章、指定用戶、指定ID或指定郵箱的評論,get_comments()函數可以返回評論ID、評論的文章ID、評論用戶、評論郵箱、評論內容等信息。比如要在首頁調用文章ID為1的評論,通過該函數就可以輕易實現。

參數說明
$author_email – (字符串)評論用戶的郵件地址,默認為空。
$author__in – (數組)包含指定用戶ID的評論,默認為空。
$author__not_in – (數組)排除指定用戶ID的評論,默認為空。
$comment__in – (數組)獲取指定ID的評論,默認為空。
$comment__not_in – (數組)排除指定ID的評論,默認為空。
$count – (布爾型)返回評論的數量值,默認為false。
$date_query – (數組)返回限制時間段的評論,或參考WP_Date_Query,默認為空。
$fields – (字符串)返回評論的字段,僅限註釋ID的“ids”或空,默認為空。
$ID – (整型)暫未被使用? (官網註釋Currently unused.),默認為空。
$include_unapproved – (數組)包含未被審核的評論ID或郵箱地址,默認為空。
$karma – (整型)用於檢索匹配註釋的KARMA得分,默認為空。
$meta_key – (字符串)包含的評論自定義字段,默認為空。
$meta_value – (字符串)包含的評論自定義字段值,必須和$meta_key一起使用,默認為空。
$meta_query – (數組)自定義字段查詢條件,參考WP_Meta_Query函數,默認為空。
$number – (整型)返回的評論條數,不設置則不限量數量,默認為空。
$offset – (整型)從第幾條開始的評論,默認為空。
$orderby – (字符串數組)返回的評論排序方式,如果根據“meta_value”或“meta_value_num”排列,那麼必須設置$meta_key參數;如果使用meta_query查詢,那麼必須使用它的數組值。支持的排序方式:comment_agent、comment_approved、comment_author、comment_author_email、comment_author_IP、comment_author_url、comment_content、comment_date、comment_date_gmt、comment_ID、comment_karma、comment_parent、comment_post_ID、comment_type、user_id、meta_value、meta_value_num、the value of $meta_key、and the array keys of $meta_query、Also accepts false, an empty array, or ‘none’ to disable ORDER BY clause,默認為comment_date_gmt。
$order – (字符串)排序順序,可選ASC或DESC,默認DESC。
$parent – (整型)指定ID的子評論,默認為空。
$post_author__in – (數組)獲取指定文章作者ID的評論,默認為空。
$post_author__not_in – (數組)排除指定文章作者ID的評論,默認為空。
$post_ID – (整型)(官網註釋Currently unused),默認為空。
$post_id – (整型)指定單篇文章ID,默認為空。
$post__in – (數組)指定多篇文章ID的評論,默認為空。
$post__not_in – (數組)排除指定文章ID的評論,默認為空。
$post_author – (整型)指定文章作者ID的評論,默認為空。
$post_status – (字符串)文章的狀態,草稿、待審或者已發布,默認為空。
$post_type – (字符串)文章類型,如post、page或自定義文章類型,默認為空。
$post_name – (字符串)文章名稱,默認為空。
$post_parent – (整形)指定父ID的評論,默認為空。
$search – (字符串)搜索匹配,默認為空。
$status – (字符串)評論的狀態,支持“hold”、“approve”、“all”或自定義的評論狀態,默認為all。
$type – (字符串數組)評論的類型,可選“comment”、“pings”(包含“pingback”和“trackback”),或自定義類型,默認為空。
$type__in – (數組)評論的類型,多個類型使用,默認為空。
$type__not_in – (數組)要排除的評論類型,默認為空。
$user_id – (整型)指定會員ID的評論。
函數返回值
注:函數的返回值是數組,數組包含以下字段。

comment_ID – 評論ID
comment_post_ID – 評論父ID
comment_author – 評論用戶名
comment_author_email – 評論用戶郵箱
comment_author_url – 評論用戶網址
comment_author_IP – 評論用戶IP
comment_date – 評論時間,格式(YYYY-MM-DD HH:MM:SS)
comment_date_gmt – 評論的GMT時間(YYYY-MM-DD HH:MM:SS)
comment_content – 評論內容
comment_karma – 評論的karma
comment_approved – 評論狀態(0,1或“spam”)
comment_agent – 評論用戶的工具(瀏覽器、操作系統等信息)
comment_type – 評論的類型(pingback或trackback),空的話表示常規評論
comment_parent – 嵌套評論的父評論(0為頂層)
user_id – 用戶ID(如果評論的用戶是網站註冊用戶則返回)

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *