How Events Appear on Your Site
Events Manager shows your events to visitors as soon as you publish one. It creates an events page with a searchable list, gives every event, location, category and tag a page of its own, and offers blocks, shortcodes and widgets for putting events anywhere else. This page explains what is already there, what controls its content, and which tool to reach for when you want something different.
The events page, as created at installation.
The pages Events Manager uses
When it is first activated, Events Manager creates a handful of ordinary WordPress pages and takes over their content. You choose which page does which job in Events then Settings then Pages.
| Page | Chosen in | What visitors see there |
|---|---|---|
| Events page | Event List/Archives | The list of upcoming events, with the search form above it. |
| Locations page | Location List/Archives | The list of locations. |
| Categories page | Event Categories | The list of event categories. |
| Tags page | Event Tags | The list of event tags. |
| My bookings page | Other Pages | A logged-in visitor's own bookings. See My Bookings. |
| Edit events page, Edit locations page, Manage bookings page | Other Pages | Front-end screens where members manage their own events, locations and bookings. Not set by default. See Event submission forms. |
The first five are created for you. On a new site they are at /events/, /events/locations/, /events/categories/, /events/tags/ and /events/my-bookings/.
You can rename these pages, move them or add them to a menu like any other page. What you type in the page editor is replaced by the list. To keep your own text around it, write the word CONTENTS on a line of the page, and the list is placed there with your text above and below.
Choosing the events page.
Events page options
These are in Events then Settings then Pages then Event List/Archives.
| Setting | Default | What it does |
|---|---|---|
| Events page | the page created at installation | The page that shows the event list. Choose [No Events Page] to have none and build your own with blocks or shortcodes. |
| Show events search? | Yes | Shows the search form above the list. |
| Display calendar in events page? | No | Shows a calendar in place of the list. |
| Event list scope | Future events | The date range the page shows. |
| Event List Limits | 10 | How many events one page of the list holds. More are reached with page links. |
| Default event list ordering | Start date, start time, then name, ascending | The order of the list. |
| Are current events past events? | No | An event that has started but not ended counts as current and stays in the list. Yes drops it once it has started. |
| Include cancelled events? | No | Whether events with the Cancelled status stay in lists. See Cancel an event. |
The other list pages have the same kind of options in their own sections.
Single event, location, category and tag pages
Every published item has its own address:
| Item | Example address | Shows |
|---|---|---|
| Event | /events/harbor-lights-jazz-night/ | Date, time, location, description, and the booking form if bookings are on. |
| Location | /locations/harbor-community-hall/ | Address, description and the upcoming events held there. |
| Category | /events/categories/music/ | The category's description and its upcoming events. |
| Tag | /events/tags/live-music/ | The tag's upcoming events. |
| Organizer | /events/organizers/ followed by the organizer's name | The organizer's upcoming events, when organizers are enabled. See Event organizers. |
A single event page in the default format.
The first parts of these addresses are slugs you can change: event and location slugs with the event types in the General settings, category and tag slugs under Permalink Slugs in Events then Settings then Pages.
Two settings in Events then Settings then Pages then Event Pages decide how an event page is built (locations have the same pair under Location Pages):
| Setting | Default | What it does |
|---|---|---|
| Display events as | Pages | Which theme template wraps the event. Pages uses your theme's page template, which usually has no author or date line. Posts uses the post template. Templates your theme provides are listed too. |
| Override with Formats? | Yes | Yes fills the page with Events Manager's single event format, so the date, location and booking form appear without theme changes. No shows only what you typed in the event's description. |
Formats decide what is shown
Each of these lists and pages is produced from a format: a piece of HTML containing placeholders such as #_EVENTNAME, #_EVENTDATES and #_LOCATIONLINK, which are replaced with the real details of each event. Conditional placeholders such as {has_bookings} show or hide parts of a format depending on the event.
Events Manager comes with a built-in format for everything: the event list, the grid, the single event page, the calendar previews, location and category pages, and more. Until you change something, those are used.
To write your own:
-
Go to Events then Settings then Formatting.
-
Open the Advanced Mode section at the top and click Enable Advanced Mode.
-
Click Save Changes. The sections below now show their format boxes.
-
Open the section for the thing you want to change, for example Events, and set Override Default Formats? to Yes for the format in question, such as the event list or the single event page.
-
Edit the format, and save.
Advanced Mode makes the format boxes editable, one group at a time.
With Advanced Mode, any format you have not overridden keeps the built-in version, including improvements that arrive in updates. Super Advanced Mode makes every format come from the boxes on this page. Sites that started on a version before 6 are in Super Advanced Mode already, with their old formats kept.
Tick Enable Code Editor for Formats at the top of the tab for syntax highlighting in the larger boxes.
The sections of the Formatting tab:
| Section | Holds |
|---|---|
| Events | The default view, list and grid formats, grouped list defaults, the single event page format and excerpts. |
| Search Form | The search form fields and the views visitors may choose. |
| Date/Time | How dates and times are written by placeholders such as #_EVENTDATES. |
| Calendar | Calendar size, style, previews, and the iCal feed settings. |
| Locations, Event Categories, Event Tags | The list and single page formats of each. |
| RSS | The RSS feed. |
| Maps | Map size and the content of map balloons. See Google Maps. |
List, grid, map and calendar views
The same set of events can be laid out in five ways:
| View | Layout |
|---|---|
| List | One event per row, with image, date, time and location. |
| Grouped Lists | The list under date headings, by month unless you change Grouped list default. |
| Grid | Cards in columns, at least 250 pixels wide each. |
| Map | Markers on a map. Needs Google Maps. |
| Calendar | A month calendar. |
Default View, at the top of Events then Settings then Formatting then Events, sets the view the events page opens in. Visitors switch between views with the view button in the search bar, and View Types in the Search Form section sets which ones they are offered. A shortcode chooses its own with view="grid".
Which should I use?
For most sites the events page and the single pages are enough. When you want events somewhere else, such as the home page, a sidebar or a landing page, you have four tools.
| Blocks | Shortcodes | Widgets | Template files | |
|---|---|---|---|---|
| Where it goes | Any page, post or template edited with the block editor | Anywhere text is accepted | Sidebars and footers of classic themes | Your theme's PHP files |
| What it can show | Events list, calendar, locations list | Everything: lists, grids, maps, calendars, search forms, single items, forms | Events list, calendar, locations list | Everything |
| Filters | Scope, category, number | Every search attribute | Scope, category, number | Every search attribute |
| Search form and view switching | No | Yes | No | Yes |
| How you set it up | A settings panel with a live preview | Typing attributes | A form | Writing PHP |
| Skill needed | None | Comfortable copying and editing a line of text | None | PHP and HTML |
In practice:
- Use a block when the page is built in the block editor and you want upcoming events, a calendar or venues with a few options.
- Use a shortcode when you need a filter or a layout the blocks don't offer (a tag, a country, a grid, a map, a search form, pagination), or when your page builder has no block editor.
- Use a widget for a sidebar or footer in a classic theme.
- Use template files or template tags when a developer is building the theme and wants full control of the markup.
A shortcode fits inside a block page too, in the Shortcode block, so the choice is never exclusive.
Go further
Troubleshooting
The events page shows my own text and no events
The page is not chosen as the Events page. Select it in Events then Settings then Pages then Event List/Archives.
A single event page shows only the description
Override with Formats? is set to No in Events then Settings then Pages then Event Pages, or your custom single event format has lost its placeholders. Set it to Yes, and if the page is still bare, turn Override Default Formats? off for the single event page to return to the built-in format.
An event page shows "posted by" and a date under the title
Your theme is using its post template. Set Display events as to Pages.
I can't find the format boxes
They are hidden until Advanced Mode is on. See Formats decide what is shown.
Event, location or category pages give a "page not found" error
Go to Settings then Permalinks and click Save Changes to rebuild the address rules. If it persists, see Troubleshooting.