The Events listing template turns a page into the intranet’s events page: a list, week or month view of upcoming events, with filters by event type. It is normally applied to a page called Events. To apply it, edit the page and choose Events listing under Page Attributes, Template. Then go to Options, Modules, Events and choose that page as the Events page, so breadcrumbs, menu highlighting and “More events” links point to it. The Events module must be switched on. For the full set-up, see Setup the events page.
What the events page shows
From the top: the page title, any content typed into the page’s editor (a good place for a short introduction or a link to the booking process), a row of three layout icons (list, week, month), the Upcoming / Past events toggle if it is switched on, a row of event type filters, and then the events themselves. In list view the right-hand column holds the Events Landing widget area.
List view
Upcoming events, soonest first. An event is upcoming when its start date is today or later. Each card shows a date block with the day and month, the title, the full date (a range for a multi-day event), the start time, the location, an Online meeting link if the event has one, and the first 20 words of the excerpt or content. The number of events per page comes from Settings, Reading, “Blog pages show at most”, with page links underneath. When nothing is coming up the page says “No upcoming events.”
Week and month views
Week view is a row of seven days, Monday to Sunday. Month view is a calendar grid for the month. An event that runs over several days appears on every day it covers, with its start time shown on the first day only. The heading in the middle shows the current week or month; select it to open a date picker and jump to any date. The arrows either side move a week or a month at a time. They disappear when there are no events further in that direction, and the calendar never goes more than two years ahead. Selecting an event type filter in these views updates the grid without reloading the page.
Event type filters
The filter row shows All followed by every top-level event type that has at least one published event. Selecting one narrows the page to that type, and the choice carries over when switching between list, week and month. Event types are managed under Events, Event types (see Event types and Manage event types). A link to an event type’s own archive page is sent to the events page with that filter applied, as long as the Events page option is set.
Events listing options on the page
These two settings are in the Events listing options box on the right of the page edit screen, and only appear once the template has been chosen and the page saved.
Show past events
Off by default. Switch it on to add an Upcoming / Past events toggle to the list view. Past events are those with a start date before today, most recent first. It also lets people move back in time in the week and month views; with it off, the calendar cannot go earlier than the current week or month.
Default layout
List view, Week view or Month view. The default is List view. This is the layout shown when someone arrives at the page. People can switch layouts with the icons, but their choice is not remembered between visits.
Options that affect the events page
Go to Options, Modules, then the Events tab.
- Events page: the page that uses this template.
- Change past events to draft status: off by default. When on, an event is set back to draft within a few minutes of its end date and time passing, so it leaves every listing and search. With this on, the Past events toggle has nothing to show, so use one or the other.
- Google Maps API key: needed for the map on an event’s own page, not for this listing.
See Module settings and options.
Widget area
The Events Landing widget area, under Appearance, Widgets, appears in the right-hand column in list view only; the week and month views use the full width. The separate Event Sidebar area appears on each event’s own page. To show upcoming events elsewhere, such as the homepage, use the Events widget; its “More events” link goes to the Events page.
What the page draws on
Published events, added under Events in the admin menu. Each needs a start date, end date, start time and end time; location, online meeting link and map are optional. See Add or edit an event.