Insert a blog post list using the blog shortcode. Add the shortcode to a page or other content area to produce a list of blog posts. Optional parameters allow customization of the display.
[hr] [blog category=»10″ style=»1″ posts_per_page=»1″ paging=»false» image_width=»280″ image_height=»180″ excerpt_length=»40″ read_more=»read more» show_category_list=»false» orderby=»rand»] [clear]Example shortcode:
[code][blog category=»1″ style=»1″ posts_per_page=»5″ paging=»false» image_width=»280″ image_height=»180″ excerpt_length=»60″ read_more=»read more» show_category_list=»false» orderby=»rand»][/code] [hr] [four_fifth] [blog category=»10″ posts_per_page=»1″ paging=»false» image_width=»514″ image_height=»200″ excerpt_length=»50″ read_more=»read more» show_category_list=»false» orderby=»rand»] [/four_fifth] [one_fifth_last] [/one_fifth_last] [clear]Example shortcode:
[code][blog category=»1″ posts_per_page=»5″ paging=»false» image_width=»415″ image_height=»200″ excerpt_length=»35″ read_more=»read more» orderby=»rand»][/code] [hr]Blog from Categories
[code][blog category=»7,8,9″][/code]Parameters
- style
- (int) (Optional) The post list layout style. Values: 1, 2
- category
- (string) The category ID’s to pull posts from. Can be entered as a comma separated list.
- images
- (bool) (Optional) Show featured image in blog list. (true/false)
- image_width
- (integer) (Optional) The featured image height. Set to «0» for auto.
- image_height
- (integer) (Optional) The featured image width. Set to «0» for auto.
- post_content
- (string) (Optional) Display excerpt or full post. Values: excerpt, full
- excerpt_length
- (integer) (Optional) The length of the excerpt, number of words to display. Set to «-1» for no excerpt.
- show_date
- (bool) (Optional) Show or hide the post date. (true/false)
- author_link
- (bool) (Optional) Show or hide the author name and link. (true/false)
- comments_link
- (bool) (Optional) Show or hide the comments link. (true/false)
- show_category_list
- (bool) (Optional) Show or hide the list of categories assigned to the post. (true/false)
- show_tag_list
- (bool) (Optional) Show or hide the list of tags assigned to the post. (true/false)
- posts_per_page
- (integer) (Optional) The number of posts to display on each page.
- paging
- (bool) (Optional) Enable paging. (true/false)
- read_more
- (string) (Optional) Shows entered text at the end of the excerpt linking to full post. For example: read_more=»More…»
Examples
Posts from categories with paging and post details:
[blog category="7,8,9" author_avatar="true" show_date="true" paging="true"]
Posts from categories, full post no images:
[blog category="7,8,9" post_content="full" images="false"]
[hr]
Blog from Pages
Blogs may also be generated from pages using a list of page ID’s or the child pages from a parent page ID.
Page Parameters
- post_type
- (string) (Required) Directs the query to use pages instead of posts. Must include the value «page».
- page_id
- (string) The page ID’s to include. Can be entered as a comma separated list.
- post_parent
- (integer) (Optional) Show child pages of the selected parent. Similar to using a category for posts.
Examples
Pages from list of page ID’s:
[blog post_type="page" page_id="10,11,12"]
Child pages from parent page ID:
[blog post_type="page" post_parent="9"]
[hr]
Order and Orderby Parameters
- order
- (string) (Optional) Designates the ascending or descending order of the «orderby» parameter.
- «ASC» – ascending order from lowest to highest values (1, 2, 3; a, b, c).
- «DESC» – descending order from highest to lowest values (3, 2, 1; c, b, a).
- orderby
- (string) (Optional) Sort posts by.
- ‘none’ – No order.
- ‘id’ – Order by post id.
- ‘author’ – Order by author.
- ‘title’ – Order by title.
- ‘date’ – Order by date. (default)
- ‘modified’ – Order by last modified date.
- ‘parent’ – Order by post/page parent id.
- ‘rand’ – Random order.
- ‘comment_count’ – Order by number of comments
- ‘menu_order’ – Order by Page Order.
Examples
Display random posts:
[blog category="8" orderby="rand"]
Display popular posts:
[blog category="8" orderby="comment_count"]
[hr]
Advanced Parameters
For advanced usage, you can add most parameters accepted by WP_Query . The shortcode can use any of these parameters which are string or an integer values. Arrays are not supported.
Example use of WP_Query s
parameter used to return a query filtered by a search term.
- s
- (string) (Optional) Search string for filtering upon a given term.
- cat
- (string) (Optional) Include or exclude categories. Prefix with a ‘-‘ (minus) sign to exclude.
- author
- (int) (Optional) Results by author id.
- Many, many more…
- See all WP_Query parameters.
Display posts based on search results:
[blog category="8" s="Lorem Ipsum"]
[clear]
Display all posts except those from a category by prefixing its id with a ‘-‘ (minus) sign:
[blog cat="-8"]
[clear]