Adventcalendar_XH ermöglicht es einen Adventskalender auf Ihrer Website anzuzeigen. Die Türchen können von den Besuchern nur bis zum aktuellen Datum geöffnet werden. Die hinter den Türchen versteckten Geheimnisse sind der Inhalt von CMSimple-Seiten, so dass Sie präsentieren können, was immer Sie wünschen (Lyrik, Bilder, Videos, Produkte usw.)
Bitte lesen Sie diese Dokumentation bevor Sie auf Probleme stoßen!
Adventcalendar_XH konnte bisher nicht in diversen Umgebungen getestet werden. Es ist eine so genannte BETA-Version. Vorsicht bei der Verwendung!
Adventcalendar_XH ist ein Plugin für CMSimple_XH. Es benötigt eine UTF-8 kodierte Version und das jQuery4CMSimple Plugin.
Die Installation erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch. Im CMSimple_XH-Wiki finden Sie weitere Details.
Die Plugin-Konfiguration erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch im Administrationsbereich der Website. Wählen Sie "Plugins" → "Adventcalendar".
Sie können die Voreinstellungen von Adventcalendar_XH unter "Konfiguration" ändern. Hinweise zu den Optionen werden beim Überfahren der Hilfe-Icons mit der Maus angezeigt.
Die Lokalisierung wird unter "Sprache" vorgenommen. Sie können die Sprachtexte in Ihre eigene Sprache übersetzen, oder diese Ihren Wünschen gemäß anpassen.
Das Aussehen von Adventcalendar_XH kann unter "Stylesheet" angepasst werden.
Sie können so viele verschiedene Adventskalender in einer CMSimple_XH-Installation haben wie Sie möchten. Diese werden durch ihren Namen unterschieden. Der Name darf nur alphanumerische Zeichen enthalten und er sollte nicht mit der Überschrift irgendeiner Seite übereinstimmen.
Besucher Ihrer Website können keine Türchen von zukünftigen Tagen öffnen, gemäß der Konfigurationsoption "Date" → "Start". Wenn Sie als Administrator eingeloggt sind, können Sie zu Testzwecken alle Türchen öffnen.
Um schnell eine funktionierende Demo aufzusetzen, führen Sie einfach folgende Schritte durch:
{{{PLUGIN:adventcalendar('winter');}}}
Suchen Sie ein geeignetes Hintergrundbild für Ihren Adventskalender, skalieren Sie es auf die gewünschte Größe (normalerweise die Breite des Inhaltsbereichs Ihres Templates), und laden Sie es in den konfigurierten Datenordner des Plugins hoch. Das hoch geladene Bild muss im JPEG Format sein, und hat gemäß dem Kalender benannt zu werden; also muss für den Kalender "winter" die Datei "winter.jpg" heißen. Dann navigieren Sie zu "Plugins" → "Adventcalendar" → "Einstellungen", wo Sie das Bild als Umschlag für Ihren Adventskalender vorbereiten können. "Umschlag vorbereiten" wird die Türchen mit den zugehörigen Tages-Nummern einzeichnen. Bilder im Landschaftsformat haben 4 Zeilen mit je 6 Türchen; Bilder im Portraitformat haben 6 Zeilen mit je 4 Türchen. Die Größe der Türchen und die Farben können in der Pluginkonfiguration angepasst werden. Die Reihenfolge der Türchen wird zufällig gewählt; wenn Ihnen diese nicht gefällt, dann bereiten Sie den Umschlag einfach noch einmal vor.
Erzeugen Sie eine neue CMSimple-Seite mit dem Namen des Adventskalenders als Überschrift (die Menüebene der Seite spielt keine Rolle). Erzeugen für jeden Tag eine Unterseite (die 1. Unterseite ist für den 1. Tag, die 2. für den 2. Tag usw.) Sie können die Seiten beliebig mit Inhalt füllen; auch Plugin-Aufrufe sind möglich. Normalerweise werden Sie alle diese Seiten im Menü verstecken wollen. Wenn Sie eine bereits existierende Seite als Geheimnis hinter einem Türchen anzeigen wollen, dann leiten Sie die entsprechende Unterseite einfach auf die gewünschte Seite weiter und hängen Sie dabei "&print" an die URL an.
Zeigen Sie den Adventskalender auf einer CMSimple_XH-Seite durch folgenden Pluginaufruf an:
{{{PLUGIN:Adventcalendar('name_des_kalenders');}}}
Selbstverständlich müssen sie "name_des_kalenders" mit dem tatsächlichen Namen des Adventskalenders ersetzen.
Adventcalendar_XH kann unter Einhaltung der GPLv3 verwendet werden.
© 2012-2013 Christoph M. Becker
Russische Übersetzung © 2012 Любомир Кудрай.
Adventcalendar_XH verwendet Colorbox. Vielen Dank an Jack Moore für die Veröffentlichung dieses ausgezeichneten Lightbox-Klons unter MIT-Lizenz.
Das Plugin-Icon wurde von Enhanced Labs Design Studio entworfen. Vielen Dank für die Veröffentlichung dieses Icons unter einer liberalen Lizenz.
Dieses Plugin verwendet freie Anwendungs-Icons von Aha-Soft. Vielen Dank, dass diese Icons frei verwendet werden dürfen.
Vielen Dank an die Gemeinschaft im CMSimple_XH Forum für Tipps, Vorschläge und das Testen. Mein besonderer Dank geht an Korvell, der mich angespornt hat 1beta5 gerade noch rechtzeitig vor dem Dezember 2013 zu veröffentlichen.
Und zu guter letzt vielen Dank an Peter Harteg, den "Vater" von CMSimple, und allen Entwicklern von CMSimple_XH ohne die es dieses phantastische CMS nicht gäbe.