Calendar_XH facilitates the administration and display of event calendars and lists on CMSimple_XH websites.
This version is a fork of Calendar 1.2.10. Note that svasti has developed Calendar 1.2 further and that version offers plenty more features at the cost of greatly increased complexity.
Table of Contents
Calendar_XH requires CMSimple_XH ≥ 1.7.0 with the Fa_XH plugin, and PHP ≥ 5.5.4.
The lastest release is available for download on Github.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
- Backup the data on your server.
- Unzip the distribution on your computer.
- Upload the whole directory
calendar/to your server into CMSimple_XH's
- Set write permissions for the subdirectories
- Navigate to Plugins → Calendar in the back-end to check if all requirements are fulfilled.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select Plugins → Calendar.
You can change the default settings of Calendar_XH under Config. Hints for the options will be displayed when hovering over the help icon with your mouse.
Localization is done under Language. You can translate the character strings to your own language if there is no appropriate language file available, or customize them according to your needs.
The look of Calendar_XH can be customized under Stylesheet.
The administration of the events is done in the back-end (Plugins → Calendar → Edit Events). Note that adding and deleting events happens only temporarily; you have to save the events to make that change permanent.
Alternatively, you can embed the event editor on a normal CMSimple_XH page, so the events can be edited by non-admins also. Use the following plugin call:
Besides normal events, it is also possible to define birthdays by
### as location, the name of the birthday child as event and
the date of birth as start date.
You can show the event calendar either from the template:
or only on a page:
All defined events of the current month are highlighted in the calendar, and linked to the event page that is defined in the language settings of Calendar_XH.
The event list is supposed to be embedded on the event page that is defined in the language settings of Calendar_XH with the following plugin call:
Optionally, you can show the next scheduled event in a marquee like manner, either from the template:
or on a page:
To import existing
.ics files (iCalendar format), you have to put them
content/ folder (right besides the
calendar.csv file). Then
navigate to Plugins → Calendar → Import where you can actually
import the desired file(s). Note that the imported events are treated as
new events; importing the same
.ics file multiple times will add all
events multiple times.
Calendar_XH is unsuitable for lots of events. Depending on the server, roughly 100 events should be fine, but more events may cause issues.
Calendar_XH 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 3 of the License, or (at your option) any later version.
Calendar_XH is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantibility 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 Calendar_XH. If not, see http://www.gnu.org/licenses/.
Copyright © 2005-2006 Michael Svarrer
Copyright © 2007-2008 Tory
Copyright © 2008 Patrick Varlet
Copyright © 2011 Holger Irmler
Copyright © 2011-2013 Frank Ziesing
Copyright © 2017-2019 Christoph M. Becker
The Calendar plugin for CMSimple has originally be developed by Michael Svarrer, and then been improved by Tory, Patrick Varlet, Holger Irmler and Frank Ziesing. Many thanks to all these developers!
The plugin logo has been designed by Alessandro Rei. Many thanks for publishing this icon under GPL.