[WordPress] 取得貼文列表，或者設定參數取得對應的貼文分類列表- get_posts()

要在 WordPress 取得文章的列表，是使用 get_posts() 這個 function，如果不丟任何參數則會回傳最新的文章。

而完整的參數依官網的文件說明如下：

get_posts( array $args = null );

$args 可帶入的值如下：

$args

(array) (Optional) Arguments to retrieve posts. See WP_Query::parse_query() for all available arguments.

• 'numberposts'
  (int) Total number of posts to retrieve. Is an alias of $posts_per_page in WP_Query. Accepts -1 for all. Default 5.
• 'category'
  (int|string) Category ID or comma-separated list of IDs (this or any children). Is an alias of $cat in WP_Query. Default 0.
• 'include'
  (int[]) An array of post IDs to retrieve, sticky posts will be included. Is an alias of $post__in in WP_Query. Default empty array.
• 'exclude'
  (int[]) An array of post IDs not to retrieve. Default empty array.
• 'suppress_filters'
  (bool) Whether to suppress filters. Default true.

 

Default value: null

也就是說如果我們要去取得目錄 id 是 1 的文章，而且要取得 3 篇，則把 $args 設定為下：

$args=array(
  'numberposts'=> 3,
  'category'   => 2,
);
$posts=get_posts( $args );

接下來就可以用迴圈把資料撈出來：

foreach($posts as $value):
  echo $value->ID; //文章 ID
  echo $value->post_title; //文章標題
endforeach; 

不清楚有哪些內容可以讀的，可以利用 var_dump($posts); 去取得完整資訊。

回傳的內容會長這樣：

撈出來的文章是沒有文章縮圖的，如果有需要顯示縮圖，則可以利用 get_the_post_thumbnail() 這個 function 去取得。

更多內容可以參考官方文件說明