Post list shortcodes allow you to query for posts and display them as a list. Currently only blog, news and portfolio posts can be displayed, but there are plans to extend this feature to support any post type.
Each of the post list shortcodes offers quite a lot of options that give you full control over the look and feel of the listings. Additionally, there are a couple of shortcodes that can be nested into the post list shortcodes. These are the [query], [item_settings], [popup_gallery_settings], [selector], [empty_list], [before_list] and [after_list] shortcodes. These provide further possibilities.
[post_list]
Displays a list of blog posts.
The following shortcodes can be nested into the [post_list] shortcode:
[query], [item_settings], [popup_gallery_settings], [selector], [empty_list], [before_list], [after_list]
[post_list col_num="3"]
[query posts_per_page="15" /]
[/post_list]
[post_list]
[query posts_per_page="15" /]
[item_settings datas_to_show="title, category" /]
[/post_list]
You need to create a custom post template and select it for the post list.
[post_list]
[item_settings post_template="id_of_my_post_template" /]
[/post_list]
| Non-Deprecated Attributes: | |
|---|---|
| Post List Layout | |
| col_num | The number of layout columns |
| grid_layout |
Set whether blog posts should be displayed in a grid or the cell height is determined by its content.
Possible values: false, true. Default: true. |
| rendering_order | Specifies whether blog posts should be rendered left to right or top to bottom in multi-column layout (left_right | top_bottom). Default: left_right. |
| Post Filtering | |
| group | Specifies a group identifier or a comma separated list of group identifiers for the posts appearing in the list. This attribute is useful if there are multiple post lists, gallery lists and/or slideshows on the same page and you want each post to appear at most once. In this case, just give the same group identifier to the post lists, gallery lists and slideshows and they will display different posts. |
| Deprecated Attributes: | |
|---|---|
| Post List Layout | |
| columns_num |
Deprecated.
Works the same as the col_num attribute.
Use it instead.
|
| meta_key | |
| order | |
| order_by | |
| posts_per_page |
Deprecated.
Works the same as the posts_per_page attribute of a nested [query] shortcode.
Use it instead.
|
| Post Filtering | |
| exclude_current_post |
Deprecated.
Works the same as the exclude_current_post attribute of a nested [query] shortcode.
Use it instead.
|
| excluded_post_ids |
Deprecated.
Works the same as the excluded_post_ids attribute of a nested [query] shortcode.
Use it instead.
|
| ignore_sticky_posts |
Deprecated.
Works the same as the ignore_sticky_posts attribute of a nested [query] shortcode.
Use it instead.
|
| post_ids | |
| Pagination | |
| ajax_pagination |
Deprecated.
Works the same as the ajax attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| load_more_above_bottom |
Deprecated.
Works the same as the load_more_above_bottom attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| pagination_align |
Deprecated.
Works the same as the align attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| paging_animation |
Deprecated.
Works the same as the paging_animation attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| paging_duration |
Deprecated.
Works the same as the paging_duration attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| pagination_type |
Deprecated.
Works the same as the type attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| show_pagination |
Deprecated.
Works the same as the show attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| Category Settings | |
| categories |
Deprecated.
Works the same as the categories attribute of a nested [query] shortcode.
Use it instead.
|
| categories_include |
Deprecated.
Use the categories or excluded_categories attributes of a nested [query] shortcode instead.
|
| show_categories |
Deprecated.
Works the same as the show attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| show_all_filter |
Deprecated.
Works the same as the show_all_filter attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| show_child_cats_as_filter |
Deprecated.
Works the same as the show_child_cats_as_filter attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| Post Layout | |
| category_icon |
Deprecated.
Works the same as the category_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| category_iconset |
Deprecated.
Works the same as the category_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| comments_icon |
Deprecated.
Works the same as the comments_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| comments_iconset |
Deprecated.
Works the same as the comments_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| datas_to_show |
Deprecated.
Works the same as the datas_to_show attribute of a nested [item_settings] shortcode.
Use it instead.
|
| date_icon |
Deprecated.
Works the same as the date_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| date_iconset |
Deprecated.
Works the same as the date_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| excerpt_length |
Deprecated.
Works the same as the excerpt_length attribute of a nested [item_settings] shortcode.
Use it instead.
|
| excerpt_length_nothumb |
Deprecated.
Works the same as the excerpt_length_nothumb attribute of a nested [item_settings] shortcode.
Use it instead.
|
| heading_class |
Deprecated.
Works the same as the heading_class attribute of a nested [item_settings] shortcode.
Use it instead.
|
| heading_tag |
Deprecated.
Works the same as the heading_tag attribute of a nested [item_settings] shortcode.
Use it instead.
|
| link_type |
Deprecated.
Works the same as the link_type attribute of a nested [item_settings] shortcode.
Use it instead.
|
| post_preview |
Deprecated.
Works the same as the post_preview attribute of a nested [item_settings] shortcode.
Use it instead.
|
| post_template |
Deprecated.
Works the same as the post_template attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_button_skin |
Deprecated.
Works the same as the read_more_button_skin attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_icon |
Deprecated.
Works the same as the read_more_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_iconset |
Deprecated.
Works the same as the read_more_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| tag_icon |
Deprecated.
Works the same as the tag_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| tag_iconset |
Deprecated.
Works the same as the tag_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| user_icon |
Deprecated.
Works the same as the user_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| user_iconset |
Deprecated.
Works the same as the user_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| Post Thumbnail & Overlay | |
| hover_datas_to_show |
Deprecated.
Works the same as the hover_datas_to_show attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_align |
Deprecated.
Works the same as the media_align attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_height |
Deprecated.
Works the same as the media_height attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_width |
Deprecated.
Works the same as the media_width attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_overlay |
Deprecated.
Works the same as the media_overlay attribute of a nested [item_settings] shortcode.
Use it instead.
|
[news_list]
Displays a list of news items.
The following shortcodes can be nested into the [news_list] shortcode:
[query], [item_settings], [popup_gallery_settings], [selector], [empty_list], [before_list], [after_list]
[news_list col_num="3"]
[query posts_per_page="15" /]
[/news_list]
[news_list]
[query posts_per_page="15" /]
[item_settings datas_to_show="title, category" /]
[/news_list]
You need to create a custom post template and select it for the post list.
[news_list]
[item_settings post_template="id_of_my_post_template" /]
[/news_list]
| Non-Deprecated Attributes: | |
|---|---|
| Post List Layout | |
| bottom_news_num | The number of news items to show in the lower box. Default is 0. |
| col_num | The number of layout columns |
| grid_layout |
Set whether news items should be displayed in a grid or the cell height is determined by its content.
Possible values: false, true. Default: false. |
| rendering_order | Specifies whether news items should be rendered left to right or top to bottom in multi-column layout (left_right | top_bottom). Default: top_bottom. |
| show_inner_widget_area |
Specifies whether the News List Inner widget area should be displayed or not ( true | false ). Default is false.
This is the widget area that is placed between the latest and older news blocks. |
| top_news_num | The number of news items to show in the upper box. Default is 8. |
| Recommended Box | |
| recommended_box_height | Specifies the height of the recommended box slideshow, in pixels. Default is 260. |
| recommended_box_skin | Set the skin of the recommended box (available skins). |
| recommended_box_width | Specifies the width of the recommended box slideshow, in pixels. Default is 600. |
| recommended_content_length | Specifies the excerpt length for recommended news items without thumbnail, in characters. Default is 600. If a news item has no thumbnail, the excerpt appears in the content of the slide not in an excerpt box. |
| recommended_excerpt_length | Specifies the excerpt length for recommended news items, in characters. Default is 170. |
| recommended_excerpt_width | Specifies the width of the excerpt box slideshow that is displayed over the background image, in pixels. Default is 240. |
| recommended_posts_num | Specifies the number of recommended news items to display in the recommended slideshow. Default is 600. |
| show_recommended_box | Specifies whether to show the recommended box slideshow, or not ( true | false ). Default is false. |
| Post Filtering | |
| group | Specifies a group identifier or a comma separated list of group identifiers for the posts appearing in the list. This attribute is useful if there are multiple post lists, gallery lists and/or slideshows on the same page and you want each post to appear at most once. In this case, just give the same group identifier to the post lists, gallery lists and slideshows and they will display different posts. |
| Deprecated Attributes: | |
|---|---|
| Post List Layout | |
| columns_num |
Deprecated.
Works the same as the col_num attribute.
Use it instead.
|
| order | |
| order_by | |
| Post Filtering | |
| exclude_current_post |
Deprecated.
Works the same as the exclude_current_post attribute of a nested [query] shortcode.
Use it instead.
|
| excluded_post_ids |
Deprecated.
Works the same as the excluded_post_ids attribute of a nested [query] shortcode.
Use it instead.
|
| post_ids | |
| Pagination | |
| ajax_pagination |
Deprecated.
Works the same as the ajax attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| load_more_above_bottom |
Deprecated.
Works the same as the load_more_above_bottom attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| pagination_align |
Deprecated.
Works the same as the align attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| paging_animation |
Deprecated.
Works the same as the paging_animation attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| paging_duration |
Deprecated.
Works the same as the paging_duration attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| pagination_type |
Deprecated.
Works the same as the type attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| show_pagination |
Deprecated.
Works the same as the show attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| Category Settings | |
| categories |
Deprecated.
Works the same as the categories attribute of a nested [query] shortcode.
Use it instead.
|
| categories_include |
Deprecated.
Use the categories or excluded_categories attributes of a nested [query] shortcode instead.
|
| show_categories |
Deprecated.
Works the same as the show attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| show_all_filter |
Deprecated.
Works the same as the show_all_filter attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| show_child_cats_as_filter |
Deprecated.
Works the same as the show_child_cats_as_filter attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| Post Layout | |
| category_icon |
Deprecated.
Works the same as the category_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| category_iconset |
Deprecated.
Works the same as the category_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| comments_icon |
Deprecated.
Works the same as the comments_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| comments_iconset |
Deprecated.
Works the same as the comments_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| datas_to_show |
Deprecated.
Works the same as the datas_to_show attribute of a nested [item_settings] shortcode.
Use it instead.
|
| date_icon |
Deprecated.
Works the same as the date_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| date_iconset |
Deprecated.
Works the same as the date_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| excerpt_length |
Deprecated.
Works the same as the excerpt_length attribute of a nested [item_settings] shortcode.
Use it instead.
|
| excerpt_length_nothumb |
Deprecated.
Works the same as the excerpt_length_nothumb attribute of a nested [item_settings] shortcode.
Use it instead.
|
| heading_class |
Deprecated.
Works the same as the heading_class attribute of a nested [item_settings] shortcode.
Use it instead.
|
| heading_tag |
Deprecated.
Works the same as the heading_tag attribute of a nested [item_settings] shortcode.
Use it instead.
|
| link_type |
Deprecated.
Works the same as the link_type attribute of a nested [item_settings] shortcode.
Use it instead.
|
| post_preview |
Deprecated.
Works the same as the post_preview attribute of a nested [item_settings] shortcode.
Use it instead.
|
| post_template |
Deprecated.
Works the same as the post_template attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_button_skin |
Deprecated.
Works the same as the read_more_button_skin attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_icon |
Deprecated.
Works the same as the read_more_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_iconset |
Deprecated.
Works the same as the read_more_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| tag_icon |
Deprecated.
Works the same as the tag_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| tag_iconset |
Deprecated.
Works the same as the tag_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| user_icon |
Deprecated.
Works the same as the user_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| user_iconset |
Deprecated.
Works the same as the user_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| Post Thumbnail & Overlay | |
| hover_datas_to_show |
Deprecated.
Works the same as the hover_datas_to_show attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_align |
Deprecated.
Works the same as the media_align attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_height |
Deprecated.
Works the same as the media_height attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_width |
Deprecated.
Works the same as the media_width attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_overlay |
Deprecated.
Works the same as the media_overlay attribute of a nested [item_settings] shortcode.
Use it instead.
|
[portfolio_list]Displays a list of portfolio items.
The following shortcodes can be nested into the [post_list] shortcode: [query], [item_settings], [popup_gallery_settings], [selector], [empty_list], [before_list], [after_list]
[portfolio_list col_num="3"]
[query posts_per_page="15" /]
[/portfolio_list]
[portfolio_list]
[query posts_per_page="15" /]
[item_settings datas_to_show="title, category" /]
[/portfolio_list]
You need to create a custom post template and select it for the post list.
[portfolio_list]
[item_settings post_template="id_of_my_post_template" /]
[/portfolio_list]
| Non-Deprecated Attributes: | |
|---|---|
| Post List Layout | |
| col_num | The number of layout columns |
| grid_layout |
Set whether portfolio items should be displayed in a grid or the cell height is determined by its content.
Possible values: false, true. Default: true. |
| rendering_order | Specifies whether portfolio items should be rendered left to right or top to bottom in multi-column layout (left_right | top_bottom). Default: left_right. |
| Post Layout | |
| preview_as_tooltip | Specifies whether the preview of portfolio items should appear as a tooltip or regular HTML content (true | false). Default is false. |
| Post Filtering | |
| group | Specifies a group identifier or a comma separated list of group identifiers for the posts appearing in the list. This attribute is useful if there are multiple post lists, gallery lists and/or slideshows on the same page and you want each post to appear at most once. In this case, just give the same group identifier to the post lists, gallery lists and slideshows and they will display different posts. |
| Deprecated Attributes: | |
|---|---|
| Post List Layout | |
| columns_num |
Deprecated.
Works the same as the col_num attribute.
Use it instead.
|
| order | |
| order_by | |
| posts_per_page |
Deprecated.
Works the same as the posts_per_page attribute of a nested [query] shortcode.
Use it instead.
|
| Post Filtering | |
| exclude_current_post |
Deprecated.
Works the same as the exclude_current_post attribute of a nested [query] shortcode.
Use it instead.
|
| excluded_post_ids |
Deprecated.
Works the same as the excluded_post_ids attribute of a nested [query] shortcode.
Use it instead.
|
| post_ids | |
| Pagination | |
| ajax_pagination |
Deprecated.
Works the same as the ajax attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| load_more_above_bottom |
Deprecated.
Works the same as the load_more_above_bottom attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| pagination_align |
Deprecated.
Works the same as the align attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| paging_animation |
Deprecated.
Works the same as the paging_animation attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| paging_duration |
Deprecated.
Works the same as the paging_duration attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| pagination_type |
Deprecated.
Works the same as the type attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| show_pagination |
Deprecated.
Works the same as the show attribute of a nested [pagination_settings] shortcode.
Use it instead.
|
| Category Settings | |
| categories |
Deprecated.
Works the same as the categories attribute of a nested [query] shortcode.
Use it instead.
|
| categories_include |
Deprecated.
Use the categories or excluded_categories attributes of a nested [query] shortcode instead.
|
| show_categories |
Deprecated.
Works the same as the show attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| show_all_filter |
Deprecated.
Works the same as the show_all_filter attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| show_child_cats_as_filter |
Deprecated.
Works the same as the show_child_cats_as_filter attribute of a nested [browsing_filter_settings] shortcode.
Use it instead.
|
| Post Layout | |
| category_icon |
Deprecated.
Works the same as the category_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| category_iconset |
Deprecated.
Works the same as the category_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| comments_icon |
Deprecated.
Works the same as the comments_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| comments_iconset |
Deprecated.
Works the same as the comments_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| datas_to_show |
Deprecated.
Works the same as the datas_to_show attribute of a nested [item_settings] shortcode.
Use it instead.
|
| date_icon |
Deprecated.
Works the same as the date_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| date_iconset |
Deprecated.
Works the same as the date_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| excerpt_length |
Deprecated.
Works the same as the excerpt_length attribute of a nested [item_settings] shortcode.
Use it instead.
|
| excerpt_length_nothumb |
Deprecated.
Works the same as the excerpt_length_nothumb attribute of a nested [item_settings] shortcode.
Use it instead.
|
| heading_class |
Deprecated.
Works the same as the heading_class attribute of a nested [item_settings] shortcode.
Use it instead.
|
| heading_tag |
Deprecated.
Works the same as the heading_tag attribute of a nested [item_settings] shortcode.
Use it instead.
|
| link_type |
Deprecated.
Works the same as the link_type attribute of a nested [item_settings] shortcode.
Use it instead.
|
| post_preview |
Deprecated.
Works the same as the post_preview attribute of a nested [item_settings] shortcode.
Use it instead.
|
| post_template |
Deprecated.
Works the same as the post_template attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_button_skin |
Deprecated.
Works the same as the read_more_button_skin attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_icon |
Deprecated.
Works the same as the read_more_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| read_more_iconset |
Deprecated.
Works the same as the read_more_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| tag_icon |
Deprecated.
Works the same as the tag_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| tag_iconset |
Deprecated.
Works the same as the tag_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| user_icon |
Deprecated.
Works the same as the user_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| user_iconset |
Deprecated.
Works the same as the user_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| visit_site_button_skin |
Deprecated.
Works the same as the visit_site_button_skin attribute of a nested [item_settings] shortcode.
Use it instead.
|
| visit_site_icon |
Deprecated.
Works the same as the visit_site_icon attribute of a nested [item_settings] shortcode.
Use it instead.
|
| visit_site_iconset |
Deprecated.
Works the same as the visit_site_iconset attribute of a nested [item_settings] shortcode.
Use it instead.
|
| Post Thumbnail & Overlay | |
| hover_datas_to_show |
Deprecated.
Works the same as the hover_datas_to_show attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_align |
Deprecated.
Works the same as the media_align attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_height |
Deprecated.
Works the same as the media_height attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_width |
Deprecated.
Works the same as the media_width attribute of a nested [item_settings] shortcode.
Use it instead.
|
| thumbnail_overlay |
Deprecated.
Works the same as the media_overlay attribute of a nested [item_settings] shortcode.
Use it instead.
|
| Popup Gallery | |
| enable_popup_galleries |
Deprecated.
Works the same as the enable attribute of a nested [popup_gallery_settings] shortcode.
Use it instead.
|
| popup_galleries |
Deprecated.
Works the same as the popup_galleries attribute of a nested [popup_gallery_settings] shortcode.
Use it instead.
|
| separate_popup_galleries |
Deprecated.
Works the same as the separate attribute of a nested [popup_gallery_settings] shortcode.
Use it instead.
|
| gallery_popup |
Deprecated.
Works the same as the gallery_popup attribute of a nested [popup_gallery_settings] shortcode.
Use it instead.
|