Calendar Module
The Calendar Module displays an interactive calendar in Month, Week or Day view and lets registered users and/or administrators add and edit events. The calendar can be integrated into any EditMe page with a simple include tag, and supports multiple calendars within the same site.
Version History
| 1.0 | 2010-03-26 |
Initial Release |
| 1.1 | 2010-05-05 | Remove need for "calendar-security" page |
| 1.2 | 2010-07-09 | Fix character encoding bug causing events to disappear |
| 1.3 | 2010-09-21 | Fix bug causing error when used in pages with a Policy applied |
Inserting the Calendar
You can display a calendar on any page. Just insert the following into the editor where you want the calendar display.
[[include:Calendar]]
When you save, the calendar will be displayed in the default Month view. You can set a different default view as follows:
[[include:Calendar default=week]]
[[include:Calendar default=day]]
The calendar also supports a basic view without time slots. This can be shown in any of the three modes as follows:
[[include:Calendar view=basic]]
Finally, you can choose to display a calendar without weekend days as follows:
[[include:Calendar weekends=no]]
Multiple Calendars
By default, a calendar included in a page will display event data associated with that page. You can display a calendar that shows event data from another page (in this example, one named AnotherPage) as follows:
[[include:Calendar page=AnotherPage]]
Security
The calendar allows creation and editing of events. The page associated with event data defines the default security behavior. For example, if Registered users can edit the page associated with events, they'll be able to add and edit events. If they can view, but not edit, they'll see the calendar but won't be able to add or edit events.
Administrators can over-ride the page security by clicking the Settings button
at the top of the calendar.
Registered users can only edit events in the calendar that they created. Anonymous users cannot add or edit events.
Adding and Editing Events
To add an event to the calendar, click the Add button: ![]()
Add a title for the event; this will be displayed on the calendar. A Start Date is also required.
For a single day event, leave the End Date blank.
For an all day event, leave the Start and End Time blank. If a Start Time is given, then an End Time is required.
The Description will be displayed when an event is clicked. If a Link is provided, it will be displayed after the Description.
