內容簡介
此外掛可將短碼標籤放入任何靜態頁面或文章中,以使用 get_posts 範本標籤來顯示文章列表。更多此外掛關於詳細資訊,請查看它的主要頁面。
預設會顯示最新的五篇文章,以相反的日期排序,但它亦包含從 get_posts 範本標籤中提供的任何選項。
只需將以下程式碼放入頁面或文章中,您可以在同一頁面上使用多次:
[get_posts]
上述預設用法將返回相反日期排序的最新的5篇文章。
除了 get_posts 範本標籤提供的所有選項,它也會接受一些額外的選項:
ul_class。這是指定項目清單的類別,預設為“get_posts_class”。
fields。這是要顯示的逗號分隔欄位列表,取自 wp_posts 資料表欄位,您可以在其中使用一些更有趣的欄位,例如 post_title、post_date 和 post_excerpt(您會在上面引用的表格描述中找到更多欄位)。默認為“post_title”。除了標準欄位外,您還可以在這裡使用 "post_featured_image" 來撤回對應的特色圖片,或 "custom_text" 來添加自己的文本。
fields_classes。這是另一個逗號分隔的列表,可讓您為上述指定的每個欄位分配一個類別,該類別將通過包在標籤中提供,而不會影響該欄位。此列表的默認值為 "post_title_class"。
fields_make_link。另一個逗號分隔的列表,讓您選擇哪些欄位是指向該文章的連結。它是一個值為"true"或"false"的列表,值"true"將使相應的欄位成為連結。默認為 "true"。
post_featured_image_size。默認為“縮略圖(thumbnail)”,但也可以設定為“中等(medium)”,“大型(large)”和“完整尺寸(full)”(您上傳的圖像大小)。
custom_text_value。如果您選擇 "custom_text" 作為要顯示的欄位之一,則會顯示此內容。
以下是一些範例:
[get_posts tag="my favorite tag" numberposts=5 orderby="title"]
這會顯示標題為 “my favourite tag” 的五篇文章,以標題排序的項目清單。
[get_posts tag="my favorite tag" fields="post_title, post_date, post_excerpt, post_featured_image, custom_text" fields_classes="class1, class2, class3, class4, class5" fields_make_link="true, false, false, false, true", custom_text_value="Read More"]
此選項會顯示標題為 “my favourite tag” 的文章列表,包括標題、日期和摘要。標題將以 "class1" 為類,日期以 "class2" 為類,摘要以 "class3" 為類。只有標題會提供指向文章的鏈接。此外還會顯示文章的特色圖(縮略圖大小)和 “Read More”。
請查看get_posts 範本標籤文檔,以獲取更多關於此選單的詳細資訊。
外掛標籤
開發者團隊
原文外掛簡介
This plugin adds the ability to put a shortcode tag in any static page or post and have it display a list of posts using the get_posts template tag. For more detailed information about this plugin, please check out its home page.
By default it will show the 5 most recent posts ordered in reverse date order,
but it will accept any of the options provided by the get_posts template tag.
To use it, just put the following into the HTML of any page or post, use as many times as you like on the same page:
[get_posts]
This default usage will return the last 5 posts in reverse chronological order.
Along with all the options provided by the get_posts template tag, it will also
accept a few additional options:
ul_class. This is the class assigned to the bullet list, with a default of “get_posts_class”.
fields. This is a comma separated list of fields to show, taken right from the wp_posts database table fields. Some of the more interesting fields you can use in this list include post_title, post_date, and post_excerpt (you’ll find more in the table description referenced above). The default is “post_title”. In addition to standard fields, you can also use “post_featured_image” here to pull the corresponding featured image, or “custom_text” to add your own text.
fields_classes. Another comma separated list that lets you assign a class to each of the fields specified above, which will be provided via a tag wrapped around the field. The default value for this list is “post_title_class”.
fields_make_link. One more comma separated list that lets you choose which of your fields are links to the post. It is a list of either “true” or “false” values … values of “true” make the corresponding field a link. The default is “true”.
post_featured_image_size. Defaults to “thumbnail” but can also be “medium”, “large” and “full” (the size of the image you uploaded).
custom_text_value. If you choose “custom_text” as one of the fields to display, this is what will be displayed.
A couple of examples:
[get_posts tag="my favorite tag" numberposts=5 orderby="title]
Shows a bulleted list consisting of the titles of 5 posts with the tag “my favorite tag” ordered by title.
[get_posts tag="my favorite tag" fields="post_title, post_date, post_excerpt, post_featured_image, custom_text" fields_classes="class1, class2, class3, class4, class5" fields_make_link="true, false, false, false, true", custom_text_value="Read More"]
Shows a bulleted list consisting of the titles, post dates, and excerpts of posts with the tag “my favorite tag”. The title will be wrapped in a tag with a class of “class1”, the date with a of class “class2”, and the excerpt with “class3”. Only the title will provide a link to the post. Also shows the post’s featured image (in thumbnail size) and “Read More”.
Check the get_posts template tag documentation for all of the possible options associated with the tag, and the wp_posts database table fields for all possible field names.
