Building a single event page

A single event page is a template plus a handful of blocks that read the event they sit on. HappenBoard ships a working template, so this guide covers what you already have and how to change it.

What you get without doing anything

On a block theme, HappenBoard registers a Single Event template and WordPress uses it for every event. It lays out, in order:

  • the event title, with the date and time under it, end time included
  • the featured image in a 16 by 9 frame with rounded corners
  • a countdown to the start, without seconds
  • a wide column holding the description, the sign-up form, and the next eight dates when the event repeats
  • a narrow column holding the venue, the organizer, Add to Calendar buttons, and the categories and tags

Four more templates come with it: Events Archive (a calendar followed by a list of ten events), Event Category (a twelve-event grid in three columns), Single Booking Type (the page of a bookable service, with its booking flow already on it) and an all-dates page for recurring events, reachable at /events/your-event/all-dates/.

These are registered block templates, so they need a block theme and WordPress 6.7 or later. With a classic theme, your theme renders the event page and these templates are not used.

Editing the template

  1. Go to Appearance → Editor.
  2. Open Templates and choose Single Event.
  3. Rearrange, add and remove blocks as you would in any template, then save.

Your saved version takes precedence over the one the plugin provides, and keeps doing so through plugin updates. To go back to the original, clear your customisations from the same screen.

The blocks that read the current event

Event Date & Time

Shows the next date of the event. Once every date has passed it falls back to the most recent one, so a page for a finished event still carries a date.

  • Show end date/time: on by default. Same-day events show just the end time; events that span days show the full end date.
  • Show timezone: off by default. Adds your site timezone in brackets.

Event Venue

  • Show "Venue" label: off by default.
  • Show address: on by default.
  • Show map: off by default. It needs latitude and longitude on the venue, so fill those in on the venue first.
  • Map provider: Use site default (Integrations), OpenStreetMap (no API key) or Google Maps (requires API key). Google falls back to OpenStreetMap when no key is saved, so the map never breaks.
  • Map height (px): from 120 to 800, in steps of 20.
  • Map zoom: from 1 to 19.

For an online or hybrid event the block also prints the meeting link, introduced by the provider name you picked on the event. A fully online event shows the link on its own, with no address and no map.

Event Organizer

  • Show "Organizer" label: off by default.
  • Show email link: on by default.

When the event points at a saved organizer, the name links to that organizer’s own page. When you typed a name straight onto the event instead, it appears as plain text.

Event Description

  • Excerpt only: off by default. Renders the excerpt instead of the full content.

The full content passes through the same filters as any post, so shortcodes, embeds and other plugins keep working inside an event description.

Event Categories & Tags

  • Show categories and Show tags: both on by default.
  • Link to archive: on by default. Turn it off to show the terms as plain chips.

Event Series

The all-dates list for a recurring event.

  • Heading: leave it empty to hide the heading entirely.
  • Maximum dates to show: from 1 to 200. The default is 24.
  • Group by month: on by default, with a month and year heading per group.
  • Show recurrence summary: on by default. Prints a plain sentence such as every 2 weeks, with the end date or the number of occurrences when the rule has one.

Blocks that step aside

Every block above prints nothing when the event has no matching data. No organizer means no organizer line, no venue means no venue block, a one-off event means no date list. You can therefore put all of them on a single template and let each event decide what shows up.

Patterns to start from

Five of the bundled patterns are made for single event pages:

  • Single event hero: featured image, title, date, countdown and Add to Calendar buttons.
  • Event CTA strip: Add to Calendar buttons plus the sign-up form, for a sidebar column.
  • Venue spotlight: venue card with map, address, calendar buttons and sign-up form.
  • Speakers strip: three placeholder speaker cards you fill in per event.
  • Sponsor tiers: three tiers of logo placeholders.

What’s next