Events

The events shortcode allows you to display and customize event listings based on a variety of parameters. Below is a detailed breakdown of the available options:

Parameter	Options	Description
format	horizontal, live-session, on-demand, agenda, calendar, wave-card, null	Specifies the event layout format. horizontal supports highlighting via highlight_position.
width	full, 1/2, 1/3, 1/4	Defines the width of the event display.
highlight_position	Numerical (e.g., 1, 2)	Sets the position of the highlighted event. Works only with the horizontal format.
include	main_only, all	Determines whether to display only main events or include all events. Ignored if event_id is provided.
event_id	Numerical (e.g., 1)	Displays sub-events of a specific event.
lang	en, pt, es, cn, kr, all	Filters events by language.
date	upcoming, past, all	Filters events by date. Defaults to upcoming.
day	Specific date (YYYY-MM-DD, e.g., 2021-06-21)	Retrieves events occurring on the specified date.
terms	Numerical list (e.g., 1,2,3)	Filters events based on specific terms (comma-separated).
terms_operator	and, or	Defines how terms are combined for filtering. Defaults to and.
limit	Numerical (e.g., 5)	Limits the number of events displayed. Also applies to the number of items per page if pagination is enabled.
list_unconnected	yes, no (default: no)	Includes or excludes events not connected to other entities.
paginate	yes	Enables pagination. Remove this parameter if pagination is not required.
channel_id	Numerical (e.g., 1)	Lists events assigned to a specific channel.
exclude_channel_id	Numerical (e.g., 1)	Excludes events assigned to a specific channel.
event_type	single-session, multi-session, super-event	Filters events by type.
event_format	broadcast, meeting	Filters events by format.
event_badges	Comma-separated list (e.g., webinar,conference)	Filters events by badges.
no_results_message	Text	Customizes the message displayed if no events are found.
attendance_mode	remote, in_person, hybrid	Filters events by attendance mode.

By default, only upcoming events are shown. If you want to include past events or a series, specify date="all" to ensure they remain visible.

---

Shortcode Examples

1. Highlighted Horizontal Layout

[events 
    format="horizontal" 
    highlight_position="2" 
    date="upcoming" 
    limit="3"]

2. Display Marketing Webinars Only

[events terms="marketing"]

3. Past Sub-events for a Super Event

[events 
    display="all"
    event_id="123"]

4. Upcoming Events with Pagination

[events 
    format="horizontal"
    date="upcoming" 
    paginate="yes"]