The event listings

For showing all the event listings, users need to create a new page from pages menu at admin panel and must add shortcode [events] or also can add the shortcode in template file which bound with the created page.
The shortcode outputs a list of your events/the event listings as well as filters for searching.

Setup for the event listings

Create a new page, follow the path, WP-admin >> Pages >> New Page and name it something along the lines of “Events” and then inside the content area add the shortcode:

[events]

It is best to insert the shortcode into the ‘text’ view of the visual editor to ensure it gets formatted correctly.

Layout of the event listings

The users get a 2 type of layout for all the events listed on the website, a box layout and a list layout of the event listings.

The box layout appears like this in the image:

The list 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

• per_page: Defaults to the ‘per page’ option in settings. This controls how many events get listed per page.
• orderby: Supports title, ID, name, modified, parent, rand,event_start_date,featured.
• order: Defaults to ‘ASC’. Can be set to ‘ASC’ or ‘DESC’ to choose the sorting direction.
• show_filters: Defaults to true. Shows filters above the event list letting the user narrow the list by keyword, location, and event type. Once a filter is chosen, active filters are listed above the events, as is an ‘RSS’ link for the current search.
• show_categories: Defaults to true when categories are enabled. If enabled, the filters will also show a dropdown letting the user choose a event category to filter by.
• show_event_types: Defaults to true when event types are enabled. If enabled, the filters will also show a dropdown letting the user choose a event type to filter by.
• show_tags: Defaults to true when event tags are enabled. If you want to hide event tags from event listing page set it to false.
• show_ticket_prices: Defaults to true when ticket prices are enabled. If enabled, the filters will show a dropdown letting the user choose a event by prices, i.e paid or free
• show_category_multiselect: Defaults to true when event category multiselect are enabled. If enabled, the filters will allow users to select multiple categories at a time.
• show_event_type_multiselect: Defaults to true when event type multiselect are enabled. If enabled, the filters will allow users to select multiple event types at a time
• show_pagination: Defaults to false. Enable this to show numbered pagination instead of the ‘load more events’ link
• show_more: Defaults to false. Enable this to show pages as ‘show more’ rather than page numbers.
• featured: Set to true to show only featured events, false to show no featured events, or leave out entirely to show both (featured first).
• cancelled: Set to true to show only cancelled events, false to show no cancelled events, or leave out entirely to respect the default settings.
• location: Enter a location keyword to search by default.
• keywords: Enter a keyword to search by default.
• selected_datetime: Select the range of date & time to showcase particular event happening in that time frame. It takes, “Today, Tomorrow, and all the dates.
  Example:

  [events selected_datetime="today,2020-08-31"]

  [events selected_datetime="tomorrow,2020-08-31"]

  NOTE: Date format of the shortcode should be same as your date picker format

• selected_event_type: When filters are true, the shortcode allows you to display events in accordance with selected event type.
• event_types: When filters are false, the shortcode allows you to display events in accordance with selected event type.
• selected_category: When filters are true, the shortcode allows you to display events in accordance with selected event category.
• categories: When filters are false, the shortcode allows you to display events in accordance with selected event category.
• selected_ticket_price: This will accept paid/free/donation as values to list by default this will display the events paid or free with filters.
  Example:

  [events selected_ticket_price="paid"]

  [events selected_ticket_price="free"]

  In case events to be listed are paid or free, without filters, Use the following code,

  [events ticket_prices="ticket_price_paid"]

  [events ticket_prices="ticket_price_free"]

• layout_type:This will accept box or list value in layout type.Default it will take box.
• ticket_prices:This will accept paid/free/donation as values to list by default.
• event_online: The shortcode takes the value, True or False. The shorcode helps to display the online events on the event listing page:

  [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 keywords 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"]