File Manager
<h3>Notice:</h3>
<p>Version 1.0 of the Calguy Calendar module is a complete fork of the old calendar module. However, this module is not compatible in any way with the other module.</p>
<h3>What does this do?</h3>
<p>Calguys Calendar is a module for displaying events on your page. When the
module is installed, a "Calguys Calendar" admin page is added to the plugins menu
that will allow you to manage your events.</p>
<h3>Security</h3>
<p>The user must belong to a group with the 'Modify Calendar' permission
in order to add, edit, or delete calendar event entries.</p>
<h3>How do I use it?</h3>
<ol>
<li>Put the cms_module tag in the page content. Make sure it is not enclosed in <pre>...</pre> tags. You will need to view source code for this. The code would look something like:<br />
<tt>{cms_module module="CGCalendar"}</tt><br />
<li>Style the calendar appropriately for your display (an example stylesheet is provided for this purpose)</li>
</ol>
<br/>
<p><b>To attach the sample stylesheet to your template:</b></p>
<ol>
<li>Go to "Layout -> Templates"</li>
<li>Click the CSS icon (Attach Stylesheet to Template) button to the right of your template</li>
<li>Choose "Calguys Calendar CSS example" from the drop-down menu.</li>
<li>Click the "Add a Stylesheet" button.</li>
</ol>
<br/>
<h3>Admin Themes</h3>
<p>This modules admin panel <em>(version 1.14+) relies heavily on styles and tools in the CMSMS OneEleven admin theme. It may not function propery (or at least look properly) in other admin themes that don't directly replicate these styles.</p>
<h3>Parameters</h3>
<table border=0 cellpadding=3 cellspacing=0>
<tr>
<td>action</td>
<td>Acceptable values:<br>
"default" - Specifies the default action, works in conjunction with the "display" parameter below.<br/>
"search" - Display a form for advanced searching of calendar events.<br/>
"myevents" - Display a list of all of a users events, and allow adding, editing or deleting those events<br/>
"addedit_event" - Display a form allowing to add or edit a single event.;
</td>
</tr>
<tr>
<td>display</td>
<td>Acceptable values:<br>
"calendar" - displays events for the current month in a traditional grid. Inclues links to prev. and next months.<br/>
"event" - display a detail report for a specific event. To use this display mode, the event_id parameter must be specified.<br/>
"list" - displays events for the current month as a list. Includes links to prev. and next months.<br/>
"weeklist" - displays events for the current week as a list. Includes links to prev. and next weeks.<br/>
"yearlist" - displays events for the current year in a list. Includes links to prev. and next years.<br/>
"pastlist" - displays all past events. No prev/next links.<br/>
"upcominglist" - displays all upcoming events. No prev/next links.<br/>
Defaults to "calendar" <em>(optional)</em>
</td>
</tr>
<tr>
<td>category</td>
<td>Only display items for that category. Leaving unset, will show all categories. Note that
you can limit to multiple categories by separating each one with a comma. This parameter can be
used with the myevents action and with the various display options. If multiple category names are specified
a match is done on ANY of the categories specified. <em>(optional)</em></td>
</tr>
<tr>
<td>month</td>
<td>Display entries for a particular month. If year is not set, then the current year is
assumed. This option only works if display is set to "list" or "calendar". <em>(optional)</em></td>
</tr>
<tr>
<td>year</td>
<td>Display entries for a particular year.
This option only works if display is set to "list" or "calendar". <em>(optional)</em></td>
</tr>
<tr>
<td>limit</td>
<td><em>(optional)</em> Set the maximum number of events to display. This option only applies to the "list", "pastlist" or "upcominglist" views. The maximum value for the limit parameter is 1000 events. The "pastlist" and "upcominglist" views support pagination. The various list views do not.</em></td>
</tr>
<tr>
<td>use_session</td>
<td>Use session variables to store the current date of a calendar view. This will allow a calendar to remember the date setting over numerous page views and while scrolling to different months. In the search form it allows saving the search settings until the browser is reset. Default is false. If use_session is enabled, all navigation links are inline links and will replace the original tag.<em>(optional)</em></td>
</tr>
<tr>
<td>inline <em>(deprecated)</em></td>
<td>Set to 1 to set all of the navigation links to inlined mode (they will replace the oringal tag). Default is 0. It is recommended you use the ni_ (non inline) or in_ (inline) prefixes to navigation links in smarty. i.e: href={$navigation.in_prev} to create an inline link. Note, this does not allow the calendar view to remember its date and month between page refreshes. If you are displaying the calendar in the sidebar you may want to employ both the use_session and the inline parameters (or use inline or non-inline urls in templates). <em>(optional)</em></td>
</tr>
<tr>
<td>reverse</td>
<td>Set to true to display events in reverse chronological order. Applicable to "list", "pastlist" and "upcominglist" displays. Default is false. For the "pastlist", reverse=true is assumed.<em>(optional)</em></td>
</tr>
<tr>
<td>detailpage="pagealias"</td>
<td>Page to display Calendar event details in. This can either be a page alias or an id. Used to allow details to be displayed in a different template from the summary. Default is current page. <em>(optional)</em></td>
</tr>
<tr>
<td>event_id</td>
<td>Used with the display=event mode, this parameter allows you to display information about a specific event on demand.</td>
</tr>
<tr>
<td>limit</td>
<td>Used with the list displays, this parameter allows specifying a maximum number of events to display, and then provides pagination capabilities.</td>
</tr>
<tr>
<td>calendartemplate</td>
<td>Used with display=calendar, this parameter allows you to specify a non default calendar template.</td>
</tr>
<tr>
<td>eventtemplate</td>
<td>Used with display=event, or you can also specify this parameter on any Calendar module call, this parameter allows you to specify a non default event template. This parameter will have no effect if pretty urls are enabled.</td>
</tr>
<tr>
<td>listtemplate</td>
<td>Used with display=list, this parameter allows you to specify a non default list template.</td>
</tr>
<tr>
<td>upcominglisttemplate</td>
<td>Used with display=upcominglist, this parameter allows you to specify a non default upcominglist template.</td>
</tr>
<tr>
<td>unique_only</td>
<td>Used with display=upcominglist, and with action=search, this parameter allows you to specify that only one event with a certain name should be returned. Default value is 0';
</tr>
<tr>
<td>displayforday</td>
<td>Used with display=upcominglist, this parameter specifies that 00:01 of the current day should be used for calculating wether an event should be displayed, rather than the current server time.</td>
</tr>
</table>
<h3>Custom Fields</h3>
<p>It is possible to define a number of custom fields to associate with each event using the Fields tab in the admin. Once one or more fields has been defined the values of that field for each event can be set using the events tab in the admin. These field values can be rendered using a template using the syntax event.fields.fieldname. Hint - insert {debug} into your template see all the data passed to the template.</p>
<h3>Examples</h3>
<h4>Example of allowing Comments on Calendar events</h4>
<p>Install the CGFeedback module and put this in your Calendar "Event Template":</p>
<pre>{CGFeedBack'key1='CGCalendar' key2=$event.event_id}</pre>
<h3>Support</h3>
<p>This module does not include commercial support. However, there are a number of resources available to help you with it:</p>
<ul>
<li>Discussion of this module may also be found in the <a href="http://forum.cmsmadesimple.org">CMS Made Simple Forums</a>.</li>
<li>The author, calguy1000, can often be found in the <a href="irc://irc.freenode.net/#cms">CMS IRC Channel</a>.</li>
<li>Lastly, you may have some success emailing the author directly.</li>
</ul>
<h3>Copyright and License</h3>
<p>Copyright © 2008-2013, Robert Campbell <a href="mailto:calguy1000@cmsmadesimple.org"><calguy1000@cmsmadesimple.org></a>. All Rights Are Reserved.</p>
<p>This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.</p>
<p>However, as a special exception to the GPL, this software is distributed
as an addon module to CMS Made Simple. You may not use this software
in any Non GPL version of CMS Made simple, or in any version of CMS
Made simple that does not indicate clearly and obviously in its admin
section that the site was built with CMS Made simple.</p>
<p>This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Or read it <a href="http://www.gnu.org/licenses/licenses.html#GPL">online</a></p>
<h3>History</h3>
<p>This module originated as the Calendar module for CMSMS by Rob Allen <em>(akrabat)</em>. It was forked to CGCalendar by Robert Campbell <em>(calguy1000)</em> in 2008, and since then has had numerous contributions by Morten Poulsen <em>(morten@poulsen.org)</em>.</p>
File Manager Version 1.0, Coded By Lucas
Email: hehe@yahoo.com