eme_get_events_list template tag does, this shows a list of events in the page where you put this shortcode. It accepts the following parameters:
limitindicates the maximum number of events to display. Default is 10. If you give the value “0″ there’s no limit.
scopelets you choose which events to show: Choose between
0000-MM(for the events of a specific month)
YYYY-MM-DD(for the events on a single day)
YYYY-MM-DD--YYYY-MM-DD(for the events in a certain period) events
YYYY-MM-DD--today(events from a certain period in time till today
today--YYYY-MM-DD (events from today till a certain period in time)
tomorrow--future: shows events happening in the future, today excluded
+Nd(with N being a number): show events until N days into the future
-Nd(with N being a number): show events until N days in the past
+Nm(with N being a number): show events until N months into the future
-Nm(with N being a number): show events until N months in the past
Nm--Mm, to get the events from month N in the past/future till month M in the past future (eg. scope=-3m–2m , scope=0m–3m)
Nd--Md(with N being a number): show events from day N in the past/future till day M in the past/future (eg. scope=-3d–2d , scope=0d–3d)
orderindicates the order of the events. Choose between ASC (ascendant, default) and DESC (descendant).
formatoverride the format of each item. If not specified, Events Manager Extended will use the format specified in the Default event list format setting of the setting page.
echoindicates whether the list should be printed (
true) or just returned (
false). This option should be ignored, unless you know what you are doing.
categorylimits the events shown to those of a certain category ID. You can specify multiple categories for AND and OR limitations: “1,3″ for events in category 1 OR 3, “1+3″ for events in category 1 AND 3. Use the literal ‘none’ if you want to filter on events without category: “1,none” would mean to show events in category 1 or without category.
location_idlimits the events shown to those of a certain location ID. You can also use OR and AND for multiple locations: “1,3″ (location 1 OR 3) or “1+3″ (location 1 AND 3). Use the literal ‘none’ if you want to filter on events without location: “1,none” would mean to show events in location 1 or without location. When the shortcode [events_list] is used in a location description, you can also use “this_location” as value, to indicate you want to limit the events shown to the ones in the mentioned location.
showperiodfirst show the month/day and then the list of events in that month/day. Choose between
yearly. The date format for the monthly showperiod can be changed in the Settings page.
link_showperiodif showperiod=daily and link_showperiod=1, then the shown days are links that will go to events for just that day
show_ongoingto indicate you want the scopes to include end dates (ongoing events) upon evaluation (like e.g. future events include events starting in the past, but ending in the future), or just the start date. Default: 1
authorlimits the events shown to those of a certain author (loginname). You can specify multiple authors for OR limitations: “admin,admin2″ for events created by user admin OR user admin2
contact_personlimits the events shown to those of a certain contact person (loginname). You can specify multiple contact persons for OR limitations: “admin,admin2″ for events whose contact persons are user admin OR user admin2
pagingcontrols wether or not you want to activate pagination in the events listed. The default is “0″ (off), use “1″ to indicate you want pagination. Period paging is also possible: if you use paging=1, limit=0 and scope=today,this_week,this_month,this_year you’ll be able to browse to previous/next days/weeks/months/years
long_events: if set to 0, events will only be shown on their startdate, if 1 events spanning multiple days will be shown on each of those days. Defaults to 0.
user_registered_only: if set to 1, the result will be a list of events the user has registered for (only works for WP registered users of course). Defaults to 0.
[events_list limit=0 showperiod=monthly]
[events_list scope=2010-00-00--2010-12-31 limit=0]
[events_list scope=0000-04 limit=0]
[events_list category=1,3] (gets you the list of future events in categories with ID 1 OR 3)
[events_list category=1+3] (gets you the list of future events in categories with ID 1 AND 3)
[events_list author=admin45] (gets you the list of future events created by user admin45)
[events_list paging=1 limit=0 scope=this_week] (displays all events of this week, with pagination to previous/next weeks)
As mentioned when explaining the
location_id parameter, you can even use
[events_list] inside a location description, paging and all!