What this module does
Upendo Events Form lets approved staff create and manage website events. An event can include dates, time zone, description, organizer, category, tags, venue, registration links, images, downloads, audiences, SEO details, and a public status.
The module includes an Event Manager list and an event editor. Public visitors see only events that are published and allowed to appear on a public detail page.
Who can do what
- Superusers: Can manage all events across the available portals, configure publisher roles, approve pending work, publish events, create categories and tags, and manage event files and images.
- Elevated users: Members of Administrators, Site Admin, or Upendo Client, plus superusers. They can manage all events and use event administration features.
- Event publishers: Members of the roles selected in Event Settings. They can create events and edit events they organize, but they cannot publish them.
- General content editors: Need the event module's website view permission to load it. They gain event editing only when they are also an elevated user or an event publisher.
- Visitors: Can view eligible public events, registration links, downloads, and calendar files. They do not manage events.
These rules are separate from normal page and module permissions. A user may be able to edit a page but still be unable to edit an event.
Event status
- Draft: Not ready for public display. A publisher's new event stays in draft until an elevated user reviews it.
- Published: Available to the public when public detail is allowed.
- Archived: Kept for history but no longer treated as an active event.
- Cancelled: Shows that the event will not happen. Use the public description or notification process to explain the change.
Create or update an event
The editor is grouped into these areas:
- Basics: Website, title, slug, summary, full description, start, end, time zone, and all-day choice.
- Classification: Organizer, category, and tags.
- Venue: Venue name, public location text, address, country, and map coordinates.
- Calls to Action: Registration button and URL, plus a secondary action.
- Flags: Status, public detail page, featured flag, and free-event flag.
- SEO: SEO title, description, and canonical URL.
- Files & Images: Hero, list, and thumbnail images, alt text, and a download file or URL.
- Features and Audiences: Extra event highlights and intended audience labels.
The form checks the title, slug, dates, links, and other required values before saving. It also checks whether a slug is already in use.
Approval workflow
An event publisher can save a draft but cannot publish it. An elevated user reviews the draft and can approve it by changing it to Published or leave it as a draft. When a publisher edits an already approved event, the approved event remains public while the new changes wait for review.
Elevated reviewers can approve or deny pending updates and may add a reviewer message. The result is stored in the event Change Log, and the submitter receives the workflow notification when configured.
Images and downloads
Images are stored in managed portal folders. Use the correct image type and provide useful alt text. Allowed image formats and size limits are checked before upload. A download can use a managed portal file or a download URL, but do not provide both unless the form clearly allows it.
Public visitor experience
Published events can appear in event lists, detail pages, search results, and calendar downloads depending on the site's companion modules and page setup. A visitor can use the registration button, secondary action, event location, and download link that staff provide.
An event may be published but still not have a public detail page when Allow Public Detail Page is off.
Event Manager
Event Manager supports search, website selection, upcoming or past scope, status, category, featured-only filtering, pending-update filtering, page size, sorting, editing, and copying. Elevated users can open Event Settings and choose the roles that may create and edit their own events.
Safe publishing checklist
- Confirm the time zone and start/end times.
- Confirm the slug and public detail setting.
- Check the organizer, category, tags, venue, registration URL, and contact details.
- Add alt text to every image.
- Check SEO title and description.
- Preview the public event page before publishing.
- Use the approval workflow when a publisher submits a draft or update.
- Do not place private notes or secrets in public fields.