glFusion Documentation Project glFusion Wiki

# Calendar Plugin

The Calendar plugin is a great tool which allows users and administrators to create events which will appear in the calendars of users who have appropriate access. Events can include everything from the go-live of your latest application, to business meetings.

When an event is added, it will be added to the site calendar where users can view all the events. Additionally, upcoming events will be displayed in a block on the page. There is also a 'Site Calendar' block which highlights dates with upcoming events.

# Calendar Plugin Configuration Options

Option | Description
--- | ---
Calendar Login Required | When set to True, only registered users can access the calendar. Please note that the Login Required setting in glFusion's main configuration takes precedence over this setting. So when Login Required is True, anonymous users can not access the calendar even when this setting is False.
Only Allow Admins to Submit | When set to True, only site administrators can add events. This will disable the ability for users to submit events.
Hide Calendar Menu Entry | Whether to hide the “Calendar” entry from glFusion's menu bar (when set to True) or to show it (when set to False).
Enable Personal Calendars | Allow account holders to have a personal calendar.
Enable Submission Queue | Whether events submitted by users will have to be approved by an admin first (when set to True) or show up immediately (when set to False).
Show Upcoming Events | Whether to show upcoming events in a separate block.
Upcoming Events Range | Number of days that the “Upcoming Events” block will look ahead.
Hour Mode | Which format to use when submitting or editing an event. Can be 12 (for the 12 hour am/pm format) or 24 (for the 24 hour format).
Event Types | The set of event types that are used both on the public calendar and the user's personal calendar.
Notification Email | Whether to send an email notification when a new event was submitted for the site's calendar (when set to True) or not (when set to False). No notification is ever sent for events in personal calendars.
Delete Events with Owner | Defines what to do when a user is deleted that is the owner of an event. When set to False, all events owned by the deleted user will be assigned to a user of the “Root” group (i.e. the site admin). When set to True, the events are deleted. This only applies to site events - a user's personal events are always deleted.
After Saving Event | 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)

## Other Options

Please note that some of the options from glFusion’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 glFusion’s main configuration.