1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
4 <title>Geeklog Documentation - Calendar Plugin</title>
5 <link rel="stylesheet" type="text/css" href="../docstyle.css" title="Dev Stylesheet">
9 <p><a href="http://www.geeklog.net/" style="background:transparent"><img src="../images/newlogo.gif" alt="Geeklog" width="243" height="90"></a></p>
10 <div class="menu"><a href="index.html">Geeklog Documentation</a> - Calendar Plugin</div>
12 <h1>Calendar Plugin</h1>
14 <p>Events and the calendar used to be an integral part of the Geeklog core code,
15 but have been moved to a plugin as of Geeklog 1.4.1.</p>
17 <h2><a name="config.php">Configuration</a></h2>
19 <p>The calendar's configuration can be changed from the Configuration admin
22 <h3><a name="general">General Calendar Settings</a></h3>
25 <tr><th style="width:25%">Variable</th>
26 <th style="width:25%">Default Value</th>
27 <th style="width:50%">Description</th>
30 <td><a name="desc_calendarloginrequired">calendarloginrequired</a></td>
32 <td>When set to 1, only registered users can access the calendar<br>
33 Please note that <code>$_CONF['<a
34 href="config.html#desc_loginrequired">loginrequired</a>']</code> in
35 Geeklog's main configuration takes precedence over this setting. So when
36 <code>'loginrequired'</code> is set to 1, anonymous users can not access
37 the calendar even when <code>'calendarloginrequired'</code> is set
41 <td><a name="desc_hidecalendarmenu">hidecalendarmenu</a></td>
43 <td>Whether to hide the "Calendar" entry from Geeklog's menu bar (when set to
44 1) or to show it (when set to 0).</td>
47 <td><a name="desc_personalcalendars">personalcalendars</a></td>
49 <td>Allow account holders to have a personal calendar</td>
52 <td><a name="desc_eventsubmission">eventsubmission</a></td>
54 <td>Whether events submitted by users will have to be approved by an admin
55 first (when set = 1) or show up immediately (when set = 0).</td>
58 <td><a name="desc_showupcomingevents">showupcomingevents</a></td>
60 <td>Whether to show upcoming events (0 = no, 1 = yes) in a separate
64 <td><a name="desc_upcomingeventsrange">upcomingeventsrange</a></td>
66 <td>Number of days that the "Upcoming Events" block will look
70 <td><a name="desc_hour_mode">hour_mode</a></td>
72 <td>Which format to use when submitting or editing an event. Can be 12 (for
73 the 12 hours am/pm format) or 24 (for the 24 hours format).<br>
74 Uses the same value as <a
75 href="config.html#desc_hour_mode">$_CONF['hour_mode']</a> by default.</td>
78 <td><a name="desc_event_types">event_types</a></td>
79 <td>Anniversary, Appointment, Birthday, Business, Education, Holiday, Meeting, Miscellaneous, Personal, Phone Call, Special Occasion, Travel, Vacation</td>
80 <td>The set of event types that are used both on the public calendar and the
81 user's personal calendar.</td>
84 <td><a name="desc_notification">notification</a></td>
86 <td>Whether to send an email notification when a new event was submitted for
87 the site's calendar (when set to = 1) or not (when set to = 0).<br>
88 No notification is ever sent for events in personal calendars.</td>
91 <td><a name="desc_delete_event">delete_event</a></td>
93 <td>Defines what to do when a user is deleted that is the owner of an event.
94 When set to 0, all events owned by the deleted user will be assigned to a
95 user of the "Root" group (e.g. the site admin). When set to 1, the events
96 are deleted. This only applies to site events - a user's personal events
97 are always deleted.</td>
100 <td><a name="desc_aftersave">aftersave</a></td>
102 <td>Which page to go to after an event has been saved:
104 <li>'item': display the event details</li>
105 <li>'list': show admin's list of events (default)</li>
106 <li>'plugin': display the calendar</li>
107 <li>'home': display the site's homepage</li>
108 <li>'admin': go to the "Admin Home" page, i.e. Command & Control</li>
114 <h2><a name="others">Other Options</a></h2>
116 <p>Please note that some of the options from Geeklog's main configuration
117 are also relevant for the calendar plugin:</p>
119 <li>Times and dates are formatted according to the current language and the
120 <a href="config.html#languages_locale">locale settings</a> from Geeklog's
121 main configuration.</li>
125 <h2><a name="autotags">Autotags</a></h2>
127 <p>The Calendar Plugin provides one <a href="http://www.geeklog.net/article.php/autolinks" title="geeklog.net: About Autolinks and Autotags">autotag</a>,
128 <code>[event:]</code>. You can use this autotag to link to an event in the
129 calendar without having to type out the URL. Simply add the event's ID after
130 the colon. It will then create a link to that event and use the event's title
131 as the link text. Alternatively, you can add your own link text after the ID
132 (but before the closing bracket).</p>
134 <p>For example, on geeklog.net:</p>
136 <li><code>[event:20090805065311513]</code> will be translated to: <code><a href="http://www.geeklog.net/calendar/event.php?eid=20090805065311513">FrOSCon - Free and Open Source Software Conference</a></code></li>
137 <li><code>[event:20090805065311513 FrOSCon 2009]</code> will be translated to: <code><a href="http://www.geeklog.net/calendar/event.php?eid=20090805065311513">FrOSCon 2009</a></code></li>
142 <a href="http://wiki.geeklog.net/">The Geeklog Documentation Project</a><br>
143 All trademarks and copyrights on this page are owned by their respective owners. Geeklog is copyleft.