Eventonomy

Single Event Block

The Single Event block (eventonomy/single-event) displays one event in full: a hero image, a meta sidebar (date, venue, organizer), an add-to-calendar link, and a placeholder for the RSVP form.

When to Use It

Add it to your single-event template so every event page renders the same way. This is the main block behind your individual event pages; pair it with the RSVP block below it so visitors can respond right away.

How to Add It

Block Editor:

  1. Open your single-event template in the Block Editor (or Site Editor, depending on your theme).
  2. Click + and search for Eventonomy Single Event.
  3. Insert the block.

On a single-event template, the block automatically detects and displays the current event; you don't need to configure anything.

Shortcode:

[eventonomy_event id="42"]

Use the shortcode form (with a specific event ID) if you want to embed one particular event on a regular page, such as featuring one event on your home page.

Settings

Setting Attribute Type Default Description
Event ID eventId number 0 Which event to show. On a single-event template this is detected automatically; only set an ID if you want to hard-code a specific event on a non-template page.
Layout layout string (inherit) Force a layout for this placement only, ignoring the per-event and site settings. One of classic, compact, or with Pro poster, online, agenda. Leave empty to inherit. An unrecognised value falls back to classic.

Layouts

Since 1.6.0 the single event page can render in more than one shape. Free ships two layouts and Pro adds three more.

Layout Plan Best for Shape
Classic Free Paid, ticketed, single-session events Cover image, hero, two columns with a sticky registration rail on the right. The default, and unchanged from earlier versions.
Compact Free Embeds, sidebars, small meetups, narrow themes One narrow column, short cover, registration inline below the content.
Poster Pro Festivals, concerts, club nights Tall image-led cover, one centred column, registration as an inline card.
Online Pro Webinars, streams, remote workshops No map. Joining details are promoted, and the location row is replaced by the platform.
Agenda Pro Conferences, multi-day summits, recurring classes Leads with the list of upcoming dates, and keeps the registration rail.

Choosing a layout

You can set it at three levels. The most specific one wins:

  1. This placement - the layout attribute on the block (see Settings above). Useful when you drop a single-event block onto a landing page and want it to look different there.
  2. This event - the Layout picker in the event editor, under Display. Overrides the site default for that event only.
  3. The whole site - Settings -> Appearance -> Single event layout.

If nothing is set, Eventonomy uses Classic. Two safety rules apply:

  • A virtual event with no explicit choice uses Online automatically when Pro is active, since a map and a venue row make no sense for it.
  • A layout that is not registered - for example poster after Pro is deactivated - falls back to Classic rather than erroring. Your pages keep working.

Recurring events

Agenda is the layout for a series. It lists the upcoming dates first, so a member sees "and eleven more dates" as a list rather than a note. The list is capped and shows a count ("Showing the next 12 of 40 dates"), so a daily event with a year of dates stays readable.

For developers

Each layout is a template you can override from your theme, and each is composed from parts you can override individually. See Recipe: Override a Template and the evnm_single_event_layouts filter in Hooks and Filters.

What Visitors Can Do

Visitors read the full event details (hero image, date and venue, organizer, description) and can add the event to their own calendar via the add-to-calendar link.

A few parts of the page adapt to the event and your settings:

  • Who's going - a small stack of recent attendee avatars with the going count appears near the registration area (setting: Show who's going, on by default). Names appear only as hover/screen-reader labels; emails are never shown, and guests count toward the number but are never pictured.
  • Location map - with Show a location map on, events that have coordinates get an embedded OpenStreetMap plus an "Open in Maps" link; an address without coordinates gets just the link.
  • Online events - virtual events show an "Online event" badge instead of a venue. The join link is shown only to confirmed registrants: a prominent Join event button from 1 hour before the start until the event ends (developers can shift the lead time with the evnm_join_button_lead_seconds filter), and a quiet link before that window. Visitors who haven't registered never see the join URL.

Related Blocks

RSVP