Event List Shortcode
Summary
Displays a list of upcoming events (from your Events Calendar) on any page. List options include:
- Dynamic list of upcoming events. Filterable by:
- Maximum number of events
- Event categories
- Event tags
- Date Range
- Manual list of specific events, in the order you specify
Display options include:
- List Title (optional)
- List Title Color (grey, black, red)
- Background color (grey or white/none)
- Event Link Text
Usage / Examples
[eventlist]Â (default output)
Lists the next (up to) 3 upcoming events from your site's Events Calendar.
[eventlist max=5]
Lists the next (up to) 5 upcoming events from your site's Events Calendar.
[eventlist max=5 cats="meetings,conferences"]Â (default output)
Lists the next (up to) 5 upcoming events - within either the "meetings" or "conferences" categories - from your site's Events Calendar.
[eventlist type=manual events=142,102,105]
Lists the events with event IDs 142, 102, and 105 from your site's Events Calendar, in that order.Â
All Shortcode Options
title
The heading for the events list. Default is 'Upcoming Events'. To omit the title, use title=''.Â
typeÂ
the type of events list to display. Options are dynamic (default) or manual.
maxÂ
the maximum number of events to display. Default is 3.
cats
Category filter. Only display events in the categories listed. Use commas to separate values.
tags
Tag filter. Only display events tagged with the terms listed. Use commas to separate values.
order
The order events will be displayed in (for dynamic lists). Options are 'ASC' (events listed nearest to furthest-away) or 'DESC' (furthest-away events listed first). Default is 'ASC'.
days
The number of days (from today) to include events from. For example, to only include events occurring in the next 6 months, use days=180.Â
No default value - by default the event list will return the max number of upcoming events regardless of how far in the future they are.Â
linktext
The text to display for the link to each event's full page in the Events Calendar. Default is "More".
background
Background color options (CSS class) for the events list. Options are 'grey-bg' (default) and 'no-bg'.
color_title
Title color options (CSS classes) for the Title text. Options are 'grey' (default), 'red', and 'black'.Â
Â
Â