Post List
Updated 2 weeks ago
The Post List element allows showing lists of different post types, including posts, pages, portfolios, and other custom post types.
The element is available within Live Builder and WPBakery builders.
Key differences compared to the Grid element:
- More options for showing posts, including:
-
- Different post types in a single list
- Posts based on custom field values
- Posts based on authors
- Posts based on multiple taxonomies conditions
- Child posts of the chosen post or parent posts without child posts
- Posts, excluding the list of specified ones
- Posts, including/excluding the current one
- Posts of the current query with custom sorting and taxonomy conditions
- Improved loading speed optimization.
- More flexible PHP hooks, which makes it easier to customize the list via custom PHP code.
- Will be constantly updated and improved.
The Post List element does not support the Grid Filter and Grid Order elements. But supports the List Filter, List Search and List Order elements.
Showing Posts on Archive Pages #
The Posts List allows the creation of a custom template for archive pages. Create a new Page Template and include a Post List element that shows "Posts of the current query."
You can use a custom Grid Layout in its Appearance settings and assign this custom Page Template to the relevant archive at Theme Options > Arhives Layout.
Examples of posts based on taxonomy terms #
Show posts of all categories except the selected one #
- Posts with specific taxonomies = If EVERY condition below is met
- Show posts = WITHOUT selected terms
- Select the needed category
Show posts that have any tag #
- Posts with specific taxonomies = If EVERY condition below is met
- Show posts = with ANY of selected terms
- Select the Tags taxonomy
- Leave the "Select terms" field blank
Show posts without tags #
- Posts with specific taxonomies = If EVERY condition below is met
- Show posts = WITHOUT selected terms
- Select the Tags taxonomy
- Leave the "Select terms" field blank
Show "Related posts" based on multiple taxonomies #
- Posts with specific taxonomies = if ANY condition below is met
- Show posts = with the same terms of the current post = Categories
- Show posts = with the same terms of the current post = Tags
You can add more taxonomies in that case.
Show posts that include 2 (or more) categories at the same time #
- Posts with specific taxonomies = if EVERY condition below is met
- Show posts = with ALL selected terms
- Select the needed terms
Show posts of the parent category including all child sub-categories #
- Posts with specific taxonomies = if ANY condition below is met
- Show posts = with ANY of selected terms = Categories = Photography
- Activate the "Include children" switch
Examples of posts based on hierarchy #
Show child pages of the current page #
- Show = Child posts of the current post
Show child pages of the selected page #
- Show = Child posts of selected posts
Show only 1st-level pages (excluding child pages) #
- Activate the "Exclude child posts" switch
Examples of posts based on authors #
Show posts with the same author as the current post #
- Author = Author of the current post
Show posts of selected authors #
- Author = Selected authors
- Select needed authors
Show posts of the current user #
- Author = Current user
In that case:
- Every logged-in user will see only their own posts (of any/selected post type).
- This Post List won't be shown on the frontend for non logged-in users.
Examples of posts based on custom fields #
Show posts with the custom field "Difficulty" set to "Beginners" #
- Posts with specific custom fields = if EVERY condition below is met
- Custom field:
- difficulty (custom field name)
- =
- beginner (value)
How to create Event lists? #
The Post List element allows you to create manageable Event lists without third-party plugins (except the ACF plugin).
First, create the "Events" custom post type.
Then create the "Event Data" field group with the following fields:
- Start Date, Name = start_date, Type = Date picker (formats don't matter)
- End Date, Name = end_date, Type = Date picker (formats don't matter)
Assign this group to your "Events" post type.
Then create several events and specify their start and end dates.
Show future events #
- Posts with specific custom fields = If EVERY condition below is met
- Custom Field:
- start_date
- >
- {{today}}
Show current events #
Events that have already begun but have not yet ended.
- Posts with specific custom fields = If EVERY condition below is met
- Custom Field:
- start_date
- ≤
- {{today}}
- Custom Field:
- end_date
- ≥
- {{today}}
Show past events #
- Posts with specific custom fields = If EVERY condition below is met
- Custom Field:
- end_date
- <
- {{today}}