The event listings
To display all the event listings, users need to create a new page from the Pages menu at the Admin Panel and add the shortcode [events] or can add the shortcode in the Template file that is attached to the page created.
The shortcode shows the list of your events along with Search filters.
Event Listing Page set-up:
Create a new page following the below mentioned steps:
WP-admin >> Pages >> New Page
[events]
Add a suitable title to it and add the shortcode [events] inside the content area.
It is recommended for you to paste the shortcode into the ‘text’ view of the visual editor to ensure it gets formatted correctly.
Layout of the event listings
Users get mainly two types of layouts to display all the event listings on the website: Box Layout and List layout.
The box layout appears like this in the image:
The Event Listings Shortcode Attributes
The following are the different attributes that are associated with the event listings
Example:
[events per_page="12"]
Example:
[events per_page="12" orderby="event_start_date"]
[events per_page="12" orderby="modified"]
[events per_page="12" orderby="event_start_date" order="ASC/DESC"]
[events per_page="12" orderby="event_start_date" order="ASC/DESC" show_filters="false"]
[events per_page="12" show_categoies="false"]
[events per_page="12" show_event_types="false"]
NOTE: The above attribute is worked only when user has “WP Event Manager Tags” plugin activated in his site.
[events per_page="12" show_tags="false"]
[events per_page="12" show_ticket_prices="false"]
It will work based on user backend settings of “Multi-select Event Categories”, if this setting is enabled then default value will be true else default value of this attribute will be false.If user wants to change the default value then need to pass this attribute in event listing shortcode as per his/her choice.
[events per_page="12" show_category_multiselect="false"]
It will work based on user backend settings of “Multi-select Event Types”, if this setting is enabled then default value will be true else default value of this attribute will be false.If user wants to change the default value then need to pass this attribute in event listing shortcode as per his/her choice.
[events per_page="12" show_event_type_multiselect="false"]
[events per_page="12" show_pagination="true"]
[events per_page="12" show_more="true"]
[events per_page="12" show_pagination="true" featured="true"]
[events per_page="12" show_pagination="true" Cancelled="true"]
[events per_page="12" show_pagination="true" location="europe"]
[events per_page="12" show_pagination="true" keyword="policy"]
Example:
[events selected_datetime="today,2020-08-31"]
[events selected_datetime="tomorrow,2020-08-31"]
NOTE: Date format of the shortcode should must be the same as your date picker format.
[events show_filters="true" selected_event_type="seminaar"]
[events show_filters="false" event_types="seminaar"]
[events show_filters="true" selected_category="Dance"]
[events show_filters="false"categories="seminaar" ]
Example:
[events selected_ticket_price="paid"]
[events selected_ticket_price="free"]
In case, the events to be listed are paid or free, without filters, Use the following codes,
[events ticket_prices="ticket_price_paid"]
[events ticket_prices="ticket_price_free"]
[events per_page="10" show_filters="false" layout_type="box/list"]
[events per_page="10" show_filters="false" ticket_prices="paid/free/donation"]
[events event_online="false"]
If the URL of the page contains a query string and location or keywords is set, the values in the query string will populate the location and keyword fields instead of the above options.
Examples
- Show 10 of the most recent events without filters and pagination
[events per_page="10" show_filters="false"]
- Show 15 events at a time, ordered by title, with categories disabled:
[events per_page="15" orderby="title" show_categories="false"]
- The below mentioned shortcode attribute is added to change the title of an event list.
Title = “Title_String”
[events title="Event List"] (Note : Default value would be "Events") [past_events title="Past Event List"] (Note : Default value would be "Past Events") [upcoming_event title="Upcoming Event List"] (Note : Default value would be "Upcoming Events")
- RSS feed functionality
The RSS feed appears when you filter events on the event listing page. Users can generate RSS feeds for the searched events easily by clicking on the RSS option.
We provide theRSS feed with a html view and if users want RSS in XML then they need to override the template file “rss-event-feed.php” at the child theme side.