Adventcalendar_XH facilitates to display an advent calendar on your site. The little doors can only be opened by visitors up to the current date. The secrets behind the doors are the contents of CMSimple pages, so it's possible to present whatever you like (poetry, images, videos, products etc.)
Please do read this documentation before you encounter any problems!
Adventcalendar_XH couldn't be tested so far in various environments. It is a so called BETA version. Use with caution!
Adventcalendar_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version and the jQuery4CMSimple plugin.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Adventcalendar" from "Plugins".
You can change the default settings of Adventcalendar_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icons with your mouse.
Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs.
The look of the Adventcalendar_XH can be customized in "Plugin Stylesheet".
You can have as much separate advent calendars in a CMSimple_XH installation as you like. These are distinguished by a name. The name should contain alphanumeric characters only and it should not be the same as the heading of any page.
Find an appropriate background image for your advent calendar, resize it to the desired size (typically the width of the contents area of your template) and upload it to the plugin's data folder (data/). Then browse to "Plugins"→"Adventcalendar"→"Main Settings", where you can prepare the image to be the cover of your advent calendar. Pressing "Prepare Cover" will draw the little doors with the according day numbers. For images in landscape format there will be 4 rows with 6 doors each; for images in portrait format there will be 6 rows with 4 doors each. The size of the doors and the colors can be customized in the plugin's configuration. The order of the doors is chosen randomly; if you don't like the chosen order, just prepare the image again.
Create a new CMSimple page with the name of the advent calendar as heading (the menu level of the page doesn't matter). Create a sub page for each day (the 1st sub page is for day 1, the 2nd for day 2 etc.) You can fill the pages with any contents you like, even plugin calls are possible. Typically you will want to hide all these pages from the menu. If you want to use an already existing page as secret behind a door, just redirect the respective sub page to the existing one and append "&print" to the URL.
Display the advent calendar on any CMSimple_XH page by calling the plugin:
{{{PLUGIN:Adventcalendar('name_of_the_calendar');}}}
Of course "name_of_the_calendar" must be replaced with the actual name of your advent calendar.
Adventcalendar_XH is licensed under GPLv3.
© 2012 Christoph M. Becker
Russian translation and user manual © 2012 Любомир Кудрай.
Adventcalendar_XH uses Colorbox. Many thanks to Jack Moore for publishing this fine lightbox clone under MIT license.
The plugin icon is designed by Enhanced Labs Design Studio. Many thanks for publishing this icon under a liberal license.
This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.
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.