fbpx

How can we help?

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]

WP Event Manager The Event listings Setup

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:

WP Event Manager Event listings Layout

The list layout appears like this in the image:

WP Event Manager The Event listings Frontend

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.
  • Example:

    [events per_page="12"]
  • orderby: Supports title, ID, name, modified, parent, rand,event_start_date,featured.
  • Example:

    [events per_page="12" orderby="event_start_date"]
    [events per_page="12" orderby="modified"]
  • order: Defaults to ‘ASC’. Can be set to ‘ASC’ or ‘DESC’ to choose the sorting direction.
  • [events per_page="12" orderby="event_start_date" order="ASC/DESC"]
  • 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.
  • [events per_page="12" orderby="event_start_date" order="ASC/DESC" show_filters="false"]
  • 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.
  • [events per_page="12" show_categoies="false"]
  • 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.
  • [events per_page="12" show_event_types="false"]
  • 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.
  • [events per_page="12" show_tags="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
  • [events per_page="12" show_ticket_prices="false"]
  • 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.
  • [events per_page="12" show_category_multiselect="false"]
  • 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
  • [events per_page="12" show_event_type_multiselect="false"]
  • show_pagination: Defaults to false. Enable this to show numbered pagination instead of the ‘load more events’ link
  • [events per_page="12"  show_pagination="true"]
  • show_more: Defaults to false. Enable this to show pages as ‘show more’ rather than page numbers.
  • [events per_page="12" show_more="true"]
  • featured: Set to true to show only featured events, false to show no featured events, or leave out entirely to show both (featured first).
  • [events per_page="12" show_pagination="true" featured="true"]
  • cancelled: Set to true to show only cancelled events, false to show no cancelled events, or leave out entirely to respect the default settings.
  • [events per_page="12" show_pagination="true" Cancelled="true"]
  • location: Enter a location keyword to search by default.
  • [events per_page="12" show_pagination="true" location="europe"]
  • keywords: Enter a keyword to search by default.
  • [events per_page="12" show_pagination="true" keyword="policy"]
  • 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.
  • [events show_filters="true" selected_event_type="seminaar"]
  • event_types: When filters are false, the shortcode allows you to display events in accordance with selected event type.
  • [events show_filters="false" event_types="seminaar"]
  • selected_category: When filters are true, the shortcode allows you to display events in accordance with selected event category.
  • [events show_filters="true" selected_category="Dance"]
  • categories: When filters are false, the shortcode allows you to display events in accordance with selected event category.
  • [events show_filters="false"categories="seminaar" ]
  • 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.
  • [events per_page="10" show_filters="false" layout_type="Box/List"]
  • ticket_prices:This will accept paid/free/donation as values to list by default.
  • [events per_page="10" show_filters="false" ticket_prices="paid/free/donationt"]
  • 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"]
Was this article helpful?
How can we improve this article?
How Can We Improve This Article?
Next The Event Dashboard
Quick Links