Maps & Week/Day Views
Pro - Everything on this page requires Eventonomy Pro.
Eventonomy Pro adds three ways to see your events that the Free plan does not have: Week and Day hour-grid calendars, which join Grid / List / Month / Upcoming as real browse views with their own tab in the view switcher, and a map view, which is a block you place rather than a tab in the switcher.
What You Will Learn
- How to enable and configure the map view
- Which geocoding providers are supported
- What visitors can do on the map, and what happens to events with no location
- How to use the Week and Day calendar grids
- How to configure the hour range and slot size
Map View
The map view uses the eventonomy-pro/map-view block to plot events as markers on an interactive map, with a dated list of the same events below it.
It runs on Leaflet, which Pro bundles with the plugin, so no map library is loaded from another site and no map API key is needed to show the block. The map tiles come from OpenStreetMap.
What Visitors Can Do
- Zoom and pan the map. The mouse wheel does not zoom while the page scrolls past it, so a visitor is never trapped.
- See clusters. Nearby events group into one numbered circle. Click it, or zoom in, to split it into single pins. A screen reader hears "{n} events, zoom in".
- Open a popup. Click a pin to see the event title, its date and time range, the venue name and a View event link.
- Use the keyboard. Every pin can be reached with Tab and named by its event title. Press Enter on a focused pin to open its popup.
- Use the list. Below the map, each event is a link with its date and venue, sorted by date, soonest first.
The view fits all pins on load. With JavaScript off, the page shows a fixed map image with a link on each pin and the same list, so it still works.
Events With No Location
Only events whose venue has coordinates get a pin. An event with no resolved location is still listed below the map, marked No map location, instead of vanishing. If none of the listed events has a location, the map is replaced by the notice "None of these events has a venue with a map location yet." If there are no upcoming published events at all, the block says "No events to map".
To place an unplaced event, open its venue (Eventonomy → Venues) and complete the address. Pro sends the full address (street, city, region and postal code) to the geocoder, so a fuller address gives a more accurate pin. You can also set the pin yourself: leave Latitude and Longitude empty to use the address, or drag the pin on the venue's map. The Venues list has a Map column showing which venues could not be pinned. See Venues & Organizers.
Enabling Maps & Geocoding
- Go to Eventonomy → Settings → Connections → Maps & geocoding.
- Toggle the feature on.
- Choose your geocoding provider.
- Enter your API key (if the provider requires one).
- Save changes.
Geocoding Providers
| Provider | API key required | Notes |
|---|---|---|
| Nominatim | No | OpenStreetMap-based; free; rate-limited. Suitable for low-volume sites. |
| Mapbox | Yes | Fast, scalable, excellent tile quality. Requires a Mapbox token. |
| Google Maps | Yes | Most accurate geocoding; requires a Google Cloud API key with Maps JavaScript API and Geocoding API enabled. |
How Geocoding Works
When an event is saved with a venue address, Eventonomy sends the address to the configured provider and stores the resulting lat/lng coordinates in the venue catalog. On the single-event page, the map is rendered using the stored coordinates, with no real-time geocoding on the frontend.
If Settings → Appearance → Show a location map on the single event is on and the event has a geocoded address, an embedded map appears automatically.
Map Display Options
Beneath the geocoding fields in the Maps & geocoding card, Pro adds two display settings:
| Setting | Default | What it controls |
|---|---|---|
Default map zoom (evnm_pro_map_default_zoom) |
15 |
Zoom level (1 to 19, higher = more zoomed in) for the single-event map embed. |
Show a map above the events list (evnm_pro_map_on_archive) |
Off | When on, a bounding-box map is rendered above the events listing. |
Placing the Map Block
Add the eventonomy-pro/map-view block to your Events page (or any page), or use the shortcode [eventonomy_map per_page="20"]. In the block's Map settings panel:
| Setting | Default | What it controls |
|---|---|---|
| Events to plot | 20 | How many upcoming published events the block loads (1 to 100). Events that have already ended are left out, following your Days of past events to show setting. |
| Map height (px) | 420 | Height of the map, from 200 to 800. |
| Show event list below map | On | Shows or hides the dated list under the map. |
Private (link-only) events are not plotted for visitors, the same as every other browse surface.
Week View
The week view shows 7 days in a column grid. Each timed event is a block that starts at its start time and is as tall as its duration, so a two-hour workshop fills two hours of the grid. Events that overlap in time sit side by side and share the day's width, instead of hiding one another. All-day events, and the later days of a multi-day event, sit in an All day row at the top. Use the eventonomy-pro/week-view block.
On a phone the grid scrolls sideways and opens on today's column.
Configuring the Week View
Go to Settings → Appearance → Calendar view:
| Setting | What it controls |
|---|---|
| Day starts at | First hour shown in the hour grid (0 to 23, 24-hour format) |
| Day ends at | Last hour shown in the hour grid |
| Time slot size | Granularity of the grid: 15, 30, or 60 minutes |
Directly beneath the hour-grid fields, Pro adds two Week & Day grid caps so a busy calendar stays readable:
| Setting | Default | What it controls |
|---|---|---|
Max events per time slot (evnm_pro_max_per_slot) |
0 (no limit) |
When a slot holds more than this many events, the overflow is replaced by a "+X more" indicator in the cell. |
Max events per day (total across all slots) (evnm_pro_max_per_day) |
0 (no limit) |
When a day holds more than this many events, overflow slots are suppressed and a day-level "+X more" indicator is shown. |
Day View
The day view shows a single day in the same hour-grid format as the week view, with the same full-height duration blocks and side-by-side overlaps. Use the eventonomy-pro/day-view block.
The same hour range and slot size settings from the Calendar view section apply to both week and day grids.
Setting Week or Day as the Default View
Go to Settings → Appearance → Event views → Default view and choose Week or Day. The bare /events/ URL will open that view.
What's Next?
Configure email notifications for RSVPs and event submissions.