fbpx
How can we help?

The event listings

Created On
Last Updated On
Print

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]

Wp Event Manager The Event Listings Setup

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.

Wp Event Manager Event Listings Layout

The box 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 determines how many events can be listed in a single 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 to let users narrow down the event lists by mentioning keyword, location, and other filter options. Once a filter is chosen, Active filters are listed above the events, as 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 from settings. If enabled, the filters will show a dropdown that lets the user choose an event category to filter by.
    • [events per_page="12" show_categoies="false"]
  • show_event_types: Defaults to true when event types are enabled from backend settings. If enabled, the filters will also show a dropdown letting the user choose an event type to filter by.
    • [events per_page="12" show_event_types="false"]
  • show_tags: Defaults to true when event tags are enabled from backend settings. If you want to hide event tags from the Event Listing page set it to 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"]
  • 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.

      • 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"]
  • show_event_type_multiselect: Defaults to true when event type Multiselect is enabled. If enabled, the filters will allow users to select multiple Event Types at a time.

      • 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"]
  • 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 “true”. 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 canceled events, false to show no canceled 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 a range of date & time to showcase a particular event happening during that time. 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 must be the same as your date picker format.

  • selected_event_type: When filters are true, the shortcode allows you to display events in accordance with the 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 the 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 the 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 the selected Event Category.
    • [events show_filters="false"categories="seminaar" ]
  • selected_ticket_price: This will accept paid/free/donation as values to the list. By default this will display the events as paid or free with filters.
    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"]
  • layout_type:This will accept box or list value in layout type. By default it will take the box value.
    • [events per_page="10" show_filters="false" layout_type="Box/List"]
  • ticket_prices:This will accept paid/free/donation as values(one at a time) to list by default.
    • [events per_page="10" show_filters="false" ticket_prices="paid/free/donation"]
  • event_online: The shortcode takes the value, True or False. It helps 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 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.

    Tags:
    Quick Links
    Close