Agenda Agenda System Settings
Agenda contains some system settings in the agenda namespace.
These are available in the MODX system settings panel and in the settings tab (cog icon) of the Agenda custom manager page.
| Key | Name | Description | Default |
|---|---|---|---|
| agenda.category_required | Category Required | An event requires a category. | Yes |
| agenda.cronjob_id | Cronjob ID | String, that has to be added to the cronjob url as cronjob_id parameter. | - |
| agenda.debug | Debug | Log debug information in the MODX error log. | No |
| agenda.default_timezone | Default Timezone | Default time zone for events. | Europe/Berlin |
| agenda.detail_id | Detail ID | ID of a resource containing AgendaDetail snippet call. | - |
| agenda.editor_type | Editor Type | Editor type for text fields (htmleditor, modx-texteditor or textarea). | htmleditor |
| agenda.extended_event_fields | Extended Event Fields | JSON encoded array of extended event fields. | - |
| agenda.extended_location_fields | Extended Location Fields | ** Since 1.4.0 ** JSON encoded array of extended location fields. | - |
| agenda.extended_repeat_fields | Extended Repeat Fields | ** Since 1.4.0 ** JSON encoded array of extended repeat fields. | - |
| agenda.extended_xtypes_script | Extended xtypes Script | ** Since 1.4.0 ** Url to a script, that defines custom xtypes. Relative to the manager url or (if absolute) to the base url. | - |
| agenda.google_maps_api_key | Google Maps API Key | Request a Google Maps API Key. | - |
| agenda.google_maps_default_lat | Google Maps Default Latitude | Default latitude for the displayed map when creating/editing a location. | 51.977825 |
| agenda.google_maps_default_lng | Google Maps Default Longitude | Default longitude for the displayed map when creating/editing a location. | 7.291066 |
| agenda.google_maps_default_zoom | Google Maps Standard Zoom | Default zoom for the displayed map when creating/editing a location. | 9 |
| agenda.google_maps_region | Google Maps API Region Code Biasing | Preferred region for the geocoding result. | - |
| agenda.image_mediasource | Image Media Source | Media source for event images. | 1 |
| agenda.import_export_type | Import/Export Type | ** Since 1.5.0 ** File type of the imported/exported files. Can be set to ‘csv’, ‘excel’, ‘yaml’ | csv |
| agenda.list_id | List ID | ID of a resource containing an AgendaList snippet call. | - |
| agenda.locale | Locale | Set the locale for Agenda. Leave blank to use the MODX system setting ‘locale’. See the PHP documentation for more information. | - |
| agenda.manager_date_alt_formats | Date Alt Formats | ** Since 1.4.0 ** Multiple date formats separated by “|” to try when parsing a user input value and it does not match the defined format. Each format must be valid according to Ext JS Date. | (lexicon) |
| agenda.manager_date_format | Date Format | The format must be valid according to Ext JS Date. | (lexicon) |
| agenda.manager_date_format_long | Date Format (long) | The format must be valid according to Ext JS Date. | (lexicon) |
| agenda.manager_time_format | Time Format | The format must be valid according to Ext JS Date. | (lexicon) |
| agenda.manager_time_increment | Time Steps | Number of minutes between individual time values in the time selection field. | 15 |
| agenda.parents_calendar | Calendar Parent Resources | Comma-separated list of parent resources to select a resource connected with a calendar. | - |
| agenda.parents_category | Category Parent Resources | Comma-separated list of parent resources to select a resource connected with a category. | - |
| agenda.parents_event | Event Parent Resources | Comma separated list of parent resources to select a resource connected with an event. | - |
| agenda.parents_location | Location Parent Resources | Comma separated list of parent resources to select a resource connected with a location. | - |
| agenda.repeating_max_occurance | Maximum Occurance | Maximum orccurance of repeating events. | 100 |
| agenda.use_category | Use Category | Show the category input in the event edit window. Show the categories column in the events grid. Show the categories tab in the Agenda custom manager page. | Yes |
| agenda.use_context | Use Contexts | Show the context input in the event edit window. | Yes |
| agenda.use_location | Use Location | Show the location input in the event edit window. Show the locations tab in the Agenda custom manager page. | Yes |
| agenda.video_mediasource | Video Media Source | Media Source for Event Videos. | 1 |
The settings agenda.extended_event_fields, agenda.extended_repeat_fields and
agenda.extended_location_fields can use @FILE or @CHUNK bindings. Path
placeholders like {core_path}, {base_path} and {assets_path} can be used.
All paths have to stay inside the MODX base path because of security reasons.