Blog

The blog shortcode displays posts. The options for this shortcode are shown below.

Option Default Example Description
columns 3 columns="5" The number of columns of posts can be 1 to 6
posts (empty) posts="1,15,19" A comma separated list of post IDs to show
categories (empty) categories="1,5,12" A comma separated list of category IDs to show posts from
category__and (empty) category__and="1,5,12" A comma separated list of category IDs to show posts from, the posts
must be in ALL specified categories
category__not_in (empty) category__not_in="1,5,12" A comma separated list of category IDs to exclude posts from
author (empty) author="5" Show only posts from the user with this ID
show_title 1 show_title="0" Show the title of the post, 1 is true 0 is false
show_meta 1 show_meta="0" Show the post meta data, 1 is true 0 is false
show_date (empty) show_date="0" Show the post meta data, 1 is true 0 is false, an empty string will inherit
the option from the theme options panel
show_description 1 show_description="0" Show the post description (excerpt), 1 is true 0 is false
description_length (empty) description_length="40" The length of the excerpt in words
full_description 0 full_description="1" Show the full post content instead of the excerpt, 1 is true 0 is false
show_read_more 1 show_read_more="0" Show the “Read More” button below the post, 1 is true 0 is false
read_more (empty) read_more="Continue Reading" The text for the “Read More” button
image 1 image="0" Show the post thumbnail image, 1 is true 0 is false
image_type (empty) image_type="left" The type of featured image.

  • “below” – Below title (full width)
  • “above” – Above title (full width)
  • “left” – Float left
  • “right” – Float right
image_width 0 image_width="200" The width of the featured image, set to 0 for full width
image_height 0 image_height="200" The height of the featured image, set to 0 to automatically scale
paging 0 paging="1" Posts will be spread over multiple pages, 1 is true 0 is false
max -1 max="9" Number of posts to show, or posts per page if paging is on, -1 to show all
offset 0 offset="10" Number of post to displace or pass over
orderby ‘date’ orderby="comment_count" Specify the order of the posts

  • none – no specified ordering
  • ID – order by post ID
  • author – order by author
  • title – order by title
  • date – order by date
  • modified – order by date modified
  • parent – order by parent
  • rand – random order
  • comment_count – order by number of comments
  • menu_order – order by menu order setting
order DESC order="ASC" The direction of above ordering, ASC for ascending, DESC for descending

Examples

[blog]
[blog categories="7,30" show_title="0" show_meta="0" image_type="left" image_width="200" paging="1" max="6"]

Still having trouble? Head over to the forums.

Forums