Events and the calendar feed
Keep a calendar of events in m.social and show it on your website from one public feed.
The calendar feed
Every event you save in Events goes into the workspace's public calendar feed straight away. Your website reads the feed, so you update events in one place.
The feed needs a feed slug, which an admin sets in Settings. Once it is set, the Events page shows the feed URL with a copy button.
The feed lists events that have not finished, soonest first: an event drops off once its end time passes, or 12 hours after its start when it has no end time. Deleting an event removes it from the feed.
Event fields
Title and start are required. Everything else is optional and left out of the feed when empty.
- Start and End: entered in the workspace's time zone. The end decides when the event leaves the feed.
- Type and Type label: see Event types.
- Location, and Speaker or convenor.
- Motion: the motion for a debate, if there is one.
- Summary: a short description for your site.
- RSVP or ticket URL, and Image URL.
- External ID: your own reference, if another system also tracks the event. When set, the feed uses it as the event's id.
Event types
Every event has one of four types: Public, Competitive, Workshop or Social. Your site can filter or style events by it; the feed sends the type as public, comp, workshop or social.
Type label is shown instead of the type name when you want something more specific, such as Public Debate.
Showing events on your website
Your web developer fetches https://msocial.ie/api/feeds/your-slug/events from the page and renders the list. It returns JSON, needs no key, and can be read from any website.
The feed may be cached for up to five minutes, so a change can take that long to show. Field names are in Feeds for your website.