Originally developed by Michael Svarrer in 2005, modified by Tory and Bob, revised and enlarged by Svasti and Holger and again by Svasti
Calendar produces calendars with marked event days, which are linked to an event list.
Usage is aimed at being self-explanatory.
A look at the plugin config settings however is recommended.
$plugin_cf['calendar']['eventlist_start_moves_with_clicked_event']="1";
./userfiles/calendar/
and move all content files to that folder. ../../../images/calendar/
and move the provided backgrounds to that folder. "."
or "-"
or "/"
to deliminate the numerals in dates, i.e. 01.01.2011 or 01-01-2011 or 01/01/2011. If you change this setting later, exceptions, additional days and provisional dates will be erased and your event list will not show anything. After saving the event file, the event list will work again, however the above mentioned date entries will be lost. {{{PLUGIN:events();}}}
to show the event-list. If you don't want an event-list, select no event-list page
in event-list config.eventlist start moves with clicked event
makes the shown period shift to the month of the clicked event instead of getting enlarged. The advantage is that the clicked event is usually at the beginning of the list. A link to reset the event list is added at the beginning. (As the list may also shift to the past, settings "show no past events" and "past events in gray" are overridden in the shifted list.) event page
. You can enter just the name of the event page or the relative URL-address starting with "?" or the relative URL-address of a page of a subsite starting with "./". eventlist template
the name of the template file, this template will be used as standard in your event-list. case | variables | |||||
---|---|---|---|---|---|---|
1 - headline announcing the time period shown | %period% %start% %till% %end% | |||||
2 - headline weekly section | %weekly% | |||||
3 - weekday header | %longweekday% %shortweekday% | |||||
4 - weekly events | %bookedout% %longweekday% %shortweekday% %time% %date% %field1% %mainfield% %field3% %infolink% %description% | |||||
5 - past weekly events | %ended% %longweekday% %shortweekday% %time% %date% %field1% %mainfield% %field3% %infolink% %description% | |||||
6 - headline single events section | %single% | |||||
7 - month header | %month% %year% | |||||
8 - yearly events with age calculation | %bookedout% %date% %time% %field1% %mainfield% %age% %field3% %infolink% %description% | |||||
9 - yearly events | %bookedout% %date% %time% %field1% %mainfield% %field3% %infolink% %description% | |||||
10 - past yearly events | %ended% %date% %time% %field1% %mainfield% %field3% %infolink% %description% | |||||
11 - single events | %bookedout% %date% %time% %field1% %mainfield% %field3% %infolink% %description% | |||||
12 - past single events | %ended% %date% %time% %field1% %mainfield% %field3% %infolink% %description% |
<p>%description%</p>
, but rather <div>%description%</div>
.{{{PLUGIN:events('','','','','','','Name of the template file');}}}
1
instead of a file name the spreadsheet table style is used, without value the standard as set in config is used.)day.month
, movable holidays depending on the Easter date as easter +/- x day
(x = number of days before or after Easter) and movable holidays occuring on a fixed weekday following or preceding a fixed date as n days m Weekday day.month
, meaning n days before or after the mth weekday before or after the fixed date. Weekday names must be entered in English, the words "day" or "days" work both, negative numbers mean "before".{{{PLUGIN:nextevent();}}}
<?php echo nextevent();?>
.<?php echo calendar(); if ($nextevent) echo nextevent(); ?>
. The marquee will be shown under the calendar. To activate the marquee, write into the page #CMSimple $nextevent="show";#
.plugins>calendar>images>
. The icon sets go in pairs; the set for past events is in another folder with the same name and "past" added. Added sets will automatically be listed in the setting options.Backup
you can copy your event list under a new name, e.g. the name "archive". If you delete afterwards in your normal event file some event entries, they will still be there in your "archive". You can add to this archived list from time to time your standard list with the merge function (which has automatic duplicate avoidance), thus building up a list of past events. {{{PLUGIN:events('starting month','starting year','duration in months','0','name of archive file','','',1);}}}
second-calendar filename
(no spaces, only english letters). If the file doesn't exist, the plugin will create it. This second calendar can have its own event page. Enter the pagename where you put this list under second-calendar_eventpage
. (Either just the pagename or starting with ?Function Call | Result | Used for |
---|---|---|
editevents2() |
event input table for second calendar | password protected pages |
calendar2() |
one month small second calendar | template |
calendar12() |
one month small combined calendar of standard and second calendar | " |
multicalendar2() |
2 or more months second calendar | template + pages |
multicalendar12() |
2 or more months combined calendar of standard and second calendar | " |
year2() |
year view of second calendar | pages |
year12() |
year view of combined calendar of standard and second calendar | " |
bigcalendar2() |
big one month of second calendar | pages |
bigcalendar12() |
big one month of combined calendar of standard and second calendar | " |
events2() |
list of events of second calendar | pages |
events12() |
list of events of combined calendar of standard and second calendar | " |
nextevent12() |
marquee of next coming events based on the standard and second calendar | template |
{{{PLUGIN:multicalendar2(3,4);}}}
etc.)calendar12()
are only shortcuts based on the full calls.{{{PLUGIN:editevents();}}}
on the page. For security reasons the filebrowser is disabled so that visitors are prevented from deleting or uploading files.{{{PLUGIN:editevents('extraevents');}}}
{{{PLUGIN:editevents2();}}}
same-event-calendar_for_all_subsites
.z-index
value in config. You have to experiment to find a fitting value. There seems to be no upper limit to z-index, so you may start with 10 and if this doesn't give the wanted result, try 100, 1000, 10000.left
so that pop-ups always open to the left side.#CMSimple $output.=[function call];#
instead of {{{…}}}.<?php echo [function call];?>
#CMSimple $output.=[function call];#
{{{PLUGIN:[function call];}}}
editevents(["filename"])
creates the event editing tableeditevents2()
the same for the 2nd calendar.calendar ([year],[month],["special_eventpage"],["size"].[number],[columns],
["file"],["additional_file"],[use_eventpage_of_calendar2])
Dětské letní tábory 2012
?Start:Latest_News:Hot
or ?Anfang:Neu_hier%3F
./
followed by the subsite abbreviation, e.g.: ./de/?Willkomen:Neu_hier%3F:Weiter
calendar2 ([year],[month],["special_eventpage"],["size"].[number],[columns])
calendar12 ([year],[month],["special_eventpage"],["size"].[number],[columns])
multicalendar([number],[columns],["file"],["additional_file"])
function multicalendar2([number],[columns])
function multicalendar12([number],[columns])
year([year],[columns],["file"],["special_eventpage"])
year2([year],[columns])
year12([year],[columns])
bigcalendar()
bigcalendar2()
bigcalendar12()
events([month],[year],[future_months],[past_months],["filename"],["additional_file"],[style],[past_events])
events2([month],[year],[future_months],[past_months])
events12([month],[year],[future_months],[past_months])
nextevent([number],["file"],["additional_file"])
nextevent12()
Written by Svasti Nov 2011 - Sept 2012