Realm Event Finder

Search and browse upcoming Realm events on your church website. Events sync from your Realm custom calendar subscription feed into Firesky daily. Visitors can search, filter by event type, open details, and register on Realm via external links.

Supported providers

Realm — Events sync from your Realm custom calendar iCal subscription feed.

Embed

<rm-event-finder></rm-event-finder>

Optional attributes

Attribute	Description	Default
`calendar-feed-url`	Realm `CalendarSubscriptionFeed` URL. Usually set in the dashboard.	Church default feed URL
`time-zone`	IANA time zone for event display, such as `America/Chicago`.	Church reporting timezone
`default-location`	Shown on cards and detail when an event has no location. Set to an empty string to hide the location row. Also readable from the page query `?default-location=`.	`church`
`only-featured`	When `true`, shows only events marked featured in the Firesky dashboard (similar to MP’s Featured Events widget). Also readable from `?only-featured=true`.	`false`

Example (featured-only embed):

<rm-event-finder only-featured="true"></rm-event-finder>

Example (full finder):

<rm-event-finder time-zone="America/Chicago"></rm-event-finder>

Setup

In Realm, open Groups → Calendar and select your custom calendar.
Click Subscribe → Copy Link (the URL should contain CalendarSubscriptionFeed).
In Firesky, open Dashboard → Widgets → Realm Event Finder and paste the feed URL.
Select Realm as your CHMS in Settings → Profile.
Use Refresh events (or wait for the daily 5:00 AM Arizona sync) to populate the events cache.
Optionally configure Event types and edit events (images, addresses, types) in the dashboard.
Add allowed origins and embed the widget on your site.

Dashboard management

Configuration — Calendar feeds, featured events, test connection, manual sync
Event types — Church-specific categories for filters (nullable on each event)
Events — Mark events as featured, upload images, set addresses, assign types. Firesky overrides protect your edits from Realm sync until you revert.

Featured events

In Dashboard → Widgets → Realm Event Finder → Events, check Featured on any upcoming event. In the full widget embed, featured events appear in a Featured section at the top. For a standalone featured list (like MP Featured Events), embed with only-featured="true" — visitors see only featured events, or Stay tuned for upcoming featured events! when none are marked.

Pin Realm Event Finder to the dashboard sidebar from the widget page for quick access (church-wide).

Features

Card grid with event images or gradient fallbacks
Keyword search across title, location, and description
Filter by calendar (multi-feed) and church-configured event type
In-widget event detail view with address
Register on Realm for registration events
Add-to-calendar download (.ics)
Daily automatic sync at 5:00 AM Arizona time

Limitations

No in-widget registration (visitors register on Realm)
Event images are Firesky-managed only (not imported from Realm)
Congregation/ministry filters are not available from the iCal feed

Requirements

Church CHMS set to Realm in Dashboard → Settings → Profile
Realm calendar subscription feed URL configured in the widget dashboard
Allowed origins in Dashboard → Widgets → Allowed origins