# 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 File

The calendar plugin has its own configuration file, located at `/path/to/geeklog/plugins/calendar/config.php`. There you will find the following options:

Variable | Default Value | Description
--- | --- | ---
calendarloginrequired | 0 | When set to 1, only registered users can access the calendar Please note that `$_CONF['loginrequired']` in `config.php` 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.
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.
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).
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.
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).
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.
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.
personalcalendars | 0 | Allow account holders to have a personal calendar
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.

## Other Options

Please note that some of the options from Geeklog's main `config.php` 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 `config.php`.
- The names of the states that are listed in a drop-down box when submitting an event are taken from the `$_STATES` array at the end of Geeklog's main `config.php`.