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.
Calendar_XH is a plugin for CMSimple_XH. It requires CMSimple_XH ≥ 1.7.0, and PHP ≥ 7.0.0.
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'splugins/directory. - Set write permissions for the subdirectories
config/,css/andlanguages/. - 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 format of date and times shown to users can be configured under Plugins → Calendar → Language → Format. The entries for Month year, Date, Date time and Time accept arbitrary text, plus placeholders. The following placeholders are supported:
%Y: full numeric representation of a year, 4 digits%F: full textual representation of a month, such asJanuaryorMarch%m: numeric representation of a month, 2 digits%n: numeric representation of a month, without leading zeros%d: day of the month, 2 digits%j: day of the month without leading zeros%a: lowercase ante meridiem and post meridiem, respectively%g: 12-hour format of an hour without leading zeros%H: 24-hour format of an hour, 2 digits%G: 24-hour format of an hour without leading zeros%i: minutes with leading zeros, 2 digits
The administration of the events is done in the back-end (Plugins → Calendar → Edit Events).
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:
{{{editevents()}}}
Embedding the event editor on a page should only be done if access to this page requires authorization via Register_XH or Memberpages.
Besides normal events, it is also possible to define birthdays by
entering ### 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:
<?=calendar()?>
or only on a page:
{{{calendar()}}}
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:
{{{events()}}}
Optionally, you can show the next scheduled event in a marquee like manner, either from the template:
<?=nextevent()?>
or on a page:
{{{nextevent()}}}
To import existing .ics files (iCalendar format), you have to put them
in the 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 only a very minimalistic import is
implemented so far. Also note that no synchronization is being done on import.
Report bugs and ask for support either on Github or in the CMSimple_XH Forum.
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-2023 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.
And last but not least many thanks to Peter Harteg, the father of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.