# Calendar Plugin

Events and the calendar used to be an integral part of the Geeklog core code, but have been moved to a plugin as of Geeklog 1.4.1.

## Configuration

The calendar's configuration can be changed from the Configuration admin panel:

### General Calendar Settings

Variable | Default Value | Description
--- | --- | ---
calendarloginrequired | 0 | When set to 1, only registered users can access the calendar Please note that `$_CONF['loginrequired']` in Geeklog's main configuration takes precedence over this setting. So when `'loginrequired'` is set to 1, anonymous users can not access the calendar even when `'calendarloginrequired'` is set to 0.
hidecalendarmenu | 0 | Whether to hide the "Calendar" entry from Geeklog's menu bar (when set to 1) or to show it (when set to 0).
personalcalendars | 0 | Allow account holders to have a personal calendar
eventsubmission | 1 | Whether events submitted by users will have to be approved by an admin first (when set = 1) or show up immediately (when set = 0).
showupcomingevents | 1 | Whether to show upcoming events (0 = no, 1 = yes) in a separate block.
upcomingeventsrange | 14 | Number of days that the "Upcoming Events" block will look ahead.
hour_mode | 12 | Which format to use when submitting or editing an event. Can be 12 (for the 12 hours am/pm format) or 24 (for the 24 hours format). Uses the same value as $_CONF['hour_mode'] by default.
event_types | Anniversary, Appointment, Birthday, Business, Education, Holiday, Meeting, Miscellaneous, Personal, Phone Call, Special Occasion, Travel, Vacation | The set of event types that are used both on the public calendar and the user's personal calendar.
notification | 0 | Whether to send an email notification when a new event was submitted for the site's calendar (when set to = 1) or not (when set to = 0). No notification is ever sent for events in personal calendars.
delete_event | 0 | Defines what to do when a user is deleted that is the owner of an event. When set to 0, all events owned by the deleted user will be assigned to a user of the "Root" group (e.g. the site admin). When set to 1, the events are deleted. This only applies to site events - a user's personal events are always deleted.

aftersave

'list'

Which page to go to after an event has been saved:

- 'item': display the event details
- 'list': show admin's list of events (default)
- 'plugin': display the calendar
- 'home': display the site's homepage
- 'admin': go to the "Admin Home" page, i.e. Command & Control

recaptcha

1

Requires the reCAPTCHA plugin v1.2.4+ to be installed, setup with the proper keys, and enabled. reCAPTCHA options include:

- 0: Disabled, don't show reCAPTCHA
- 1: Use reCAPTCHA V2 Checkbox
- 2: Use reCAPTCHA V2 Invisible
- 4: Use reCAPTCHA V3 (default)

For more about how reCAPTCHA helps fight SPAM see the reCAPTCHA plugin docs or visit the Google reCAPTCHA website.

recaptcha_score | 0.5 | Specify score threshold for reCAPTCHA V3. Valid value is 0.0 (even a bot could pass for a human) - 1.0 (only a human will be accepted).
default_permissions[0] | Read-Write | Default permission for Owner of new events.
default_permissions[1] | Read-Only | Default permission for Group of new events.
default_permissions[2] | Read-Only | Default permission for all logged in users of new events.
default_permissions[3] | Read-Only | Default permission for all anonymous visitors of new events.
autotag_permissions_event[0] | Use | Usage permission for autotag by autotag Owner (Default Root User).
autotag_permissions_event[1] | Use | Usage permission for autotag by Calendar Admin Group.
autotag_permissions_event[2] | Use | Usage permission for autotag by all logged in users.
autotag_permissions_event[3] | Use | Usage permission for autotag by anonymous users.

### Events Block

Variable | Default Value | Description
--- | --- | ---
block_enable | true | Enable block.
block_isleft | 1 | Whether to display the block on the left (when set to 1) or right (when set to 0).
block_order | 50 | The order the block appears in the column.
block_topic_option | 'all' | Set to 'All' for block to appear on all pages. Set to 'Homepage Only' for block to appear on just the homepage. Set to 'Selected Topics' for block to appear only in Topics selected in the Topic setting.
block_topic |  | The topics the block will appear for if the Topic Options is set to 'Select Topics'.
block_group_id | Calendar Admin | The group used by permissions.
block_permissions[0] | Read-Only | View permission for dynamic block by block Owner (Default Root User).
block_permissions[1] | Read-Only | View permission for dynamic block by assigned Admin Group (see config option block_group_id).
block_permissions[2] | Read-Only | View permission for dynamic block by all logged in users.
block_permissions[3] | Read-Only | View permission for dynamic block by anonymous users.

## Other Options

Please note that some of the options from Geeklog's main configuration are also relevant for the calendar plugin:

- Times and dates are formatted according to the current language and the locale settings from Geeklog's main configuration.

## Autotags

The Calendar Plugin provides one autotag, `[event:]`. You can use this autotag to link to an event in the calendar without having to type out the URL. Simply add the event's ID after the colon. It will then create a link to that event and use the event's title as the link text. Alternatively, you can add your own link text after the ID (but before the closing bracket).

For example, on geeklog.net:

- `[event:20090805065311513]` will be translated to: `<a href="https://www.geeklog.net/calendar/event.php?eid=20090805065311513">FrOSCon - Free and Open Source Software Conference</a>`
- `[event:20090805065311513 FrOSCon 2009]` will be translated to: `<a href="https://www.geeklog.net/calendar/event.php?eid=20090805065311513">FrOSCon 2009</a>`