[list-posts parameters]
Parameters
| Parameter | Description | Required | Values | Default |
|---|---|---|---|---|
| id | Display a specific post id | Any WordPress post ID | ||
| category | Display from a specific category | Any WordPress category | ||
| category_in | Include a category | Any WordPress category ID. Can include multiple separated by commas. | ||
| category_not_in | Exclude a category | Any WordPress category ID. Can include multiple separated by commas. | ||
| tag_in | Include a tag | Any WordPress tag ID or slug. Can include multiple separated by commas. | ||
| tag_not_in | Exclude a tag | Any WordPress tag ID or slug. Can include multiple separated by commas. | ||
| show_related_tags | List posts that a tagged similarly to the post currently being viewed | yes | ||
| order_by | How to arrange posts | menu_order, title (alpha order), date (date created), modified (datelast modified), rand (random), title_last_word | menu_order | |
| order | How to order posts | ASC (ascending), DESC (descending) | ASC | |
| number | Limit to a set number of posts | any number | all posts | |
| posts_per_page | Limit to a set number of posts per page and enable pagination. | any number | ||
| view | How to display the posts | summary, complete, list, grid, carousel | summary | |
| excerpt | how many words to display from content | any number | 50 | |
| photo_position | Position of photo | left, right, left-wrap, right-wrap, inline | ||
| photo_shape | What shape to apply to the feature image | photo, wide, rectangle, square, circle, unmodified | photo | |
| photo_maxwidth | The maximum width of the photo | any number with unit (i.e. 200px) | ||
| align | Align of content | left, center, right | ||
| readmore_style | Style of ‘Read More’ link | button | ||
| title_tag | Tag to be used for post title | h1,h2,h3,h4,h5,h6 | h2 | |
| title_size | Text size of title | any number with unit (i.e. 1.5em) | ||
| title_color | Color of title | Any hex or color name | ||
| content_size | Text size of content | any number with unit (i.e. 1.5em) | ||
| content_color | Color of content | Any hex or color name | ||
| elements | Override the default elements and specify your own list of elements | title, photo, excerpt, content, link | ||
| elements_headings | When using the elements feature above, by default the headings are hidden. Set this to ‘show’ to display the headings. | show, hide |
For view=’grid’ only
| Parameter | Description | Required | Values | Default |
|---|---|---|---|---|
| grid_columns | Arrange posts in this number of columns | no | 2,3,4,5 | 2 |
For view=’carousel’ only
| Parameter | Description | Required | Values | Default |
|---|---|---|---|---|
| carousel_pagination | Show pagination dots | no | no,yes | yes |
| carousel_autoplay | Autoplay carousel | no | no,yes | no |
| carousel_delay | How long to pause on each post | no | any number (seconds) | 10 |
| carousel_transition | Transition type | no | fade,horizontal,vertical,none | horizontal |
Elements example:
[list-posts view='grid' elements='photo,excerpt']
The above shortcode will list the posts in a grid, and the elements pulled from each post will be (and only be) the photo and excerpt.