article_list

Usage

[article_list parameter="value"]

A list of Posts or Pages. Parameters allow for different display styles as well as determining whether or not to display excerpts, dates, sorting dropdown, pagination of results, etc.

Examples:

[article_list menu='homepage-featured'  excerpts='true' att_top='article_date' class='card-three card-display']

[article_list parent_id=474  show_images=false]

Parameters

Required (only one of the ones listed)

post_ids – a comma separated list of ids of posts to be included

The easiest way to find the post id is to open the post in the dashboard – the id will be part of the url

menu – the name of the menu to pull the articles from

category – the name of the category to pull the article from

parent_id – the id of the parent page to list the children pages

Optional

• id – the html id of the article list
  • default value: null
  • enter a html id (text)
• class – the html class of the article list
  • default value: “list-style”
  • card-three card-display (If you want the list to appear as 3 cards per row)
  • card-four card-display (If you want the list to appear as 4 cards per row)
  • no-excerpt suppresses the excerpt text. This is useful when wanting to display an image and header only
• title
  • the title of the article list
• excerpts – whether to show the article excerpts
  • true or false
• att_top – name of field to use for top attribution
  • media_type_display, article_date, categories
• att_bottom – name of field to use for bottom attribution
  • media_type_display, article_date, categories
• show_sort – show the sort dropdown
  • true or false (default)
• max_items – max number of articles to display on one page
  • Default is 12
• paginate – show paginate if more items then declared in max_items
  • **Note: only menu and category can use pagination
  • true or false (default)
• show_images – show featured image thumbnails
  • true (default) or false
• show_title – show the title, link, attribution etc
  • true (default) or false
• sortorder  – how will the article list items sorted
  • asc or desc (default)
• sortby – which attribute will the article list be sorted by
  • title or date (default)

Examples

[article_list category="sample"]

This is the default display for posts specified by category

[article_list post_ids="971, 966" title="Sample Article List"]

Adding post_ids allow a custom list. The title attribute can be customized.

[article_list post_ids="966" excerpts="true"]

Excerpts by default contain a string from the post body. To make custom excerpts add excerpts from the Screen Options menu in the post dashboard.

[article_list category="sample" class="card-four card-display" ]

Four-card display (can include ‘no-border’ within the class statement to hide tiles)

[article_list category="sample" class="card-five card-display no-border"]

Five-card display with no borders

[article_list post_ids="969" excerpts="true"]

Excerpts by default contain a string from the post body. To make custom excerpts add excerpts from the Screen Options menu in the post dashboard.

[article_list post_ids="971" att_top="article_date" excerpts="true"]

Att_top puts an item above the title. Here is the date the post was published.

[article_list post_ids="974" att_bottom="categories" excerpts="true"]

Att_top puts an item below the post excerpt. Here is the name of the post’s category.

[article_list category="sample" show_sort="true"]

Shows the sort order of the list and allows users to change the order.

[article_list category="sample" max_items="2"]

Max number of items within a category, defaults to newest posts.

Pagination only works on pages that are only article lists

[article_list post_ids="966" show_images="false" excerpts="true"]

Displays posts without featured image. Posts without featured images will show an empty placeholder by default.

[article_list category="sample" sortorder="asc" sortby="title"]

Changes default sorting