To render events to your visitors, you can use the provided snippets:

  • AgendaList used for rendering a list of events
  • AgendaDetail used for showing one specific event on a detail page

There are also other snippets to help you render calendars, categories, and locations

By default repeating events are scheduled for 100 recurrences. 

You have two possibilities to change that:

  1. Setup the cronjob to refresh recurring events automatically for up to 100 recurrences in the future from the current date.
  2. Increase the agenda.repeating_max_occurrance system setting to a larger value.

Yes!

Agenda comes with a number of system settings. Configure them with a comma separated list of resource IDs to use as parent resources. When set up, a new resource selection field will be added to the edit windows in the manager.

  • For events: agenda.parents_event
  • For categories: agenda.parents_category
  • For calendars: agenda.parents_calendar
  • For locations: agenda.parents_location

When creating the feed for events to be imported, you can set how often the feed should be checked for new or updated events, with a minimum interval of once a minute.

You also need to set up the cron job to fire often enough for the feed refreshes to happen at the right time.

Yes, you will need to enter a Google Maps API Key in the agenda.google_maps_api_key system setting to use the map. 

In the project in the Google Cloud Platform console, activate the Maps JavaScript API and the Geocoding API. 

They're both ways of organising your events into logical sections, and can be filtered on in the AgendaList snippet.

Calendar is best seen as the "owner" or "target" for an event. For example a conference center could use calendars for organising events as "Public events", "Private parties" and "Staff-only events", which are then shown in different sections of the website. 

Category is then the type of event, which could be a sub-filter on the detail pages. For example "Weddings", "Conference", "Expo", "Training/workshops". 

For events grouped into a location or room, you can use the Locations functionality as well. That can also be used with maps, ideal for businesses with different venues or events hosted in varying places.

If you use Feeds or recurring events, yes, the cron job is required for Agenda to work as expected. 

If your server doesn't allow you to configure cron jobs, you can trigger it through web requests as well using online cron job services. 

Yes, enable the agenda.debug system setting. A new log will be created in {core_path}/cache/logs/agenda.log with a lot of debug information. 

By default, errors are logged to the standard MODX error log.

Yes, multiple events can overlap in days and/or times.