Adventcalendar_XH - ein CMSimple_XH-Plugin

Plugin-Icon

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!

Wichtiger Hinweis

Adventcalendar_XH konnte bisher nicht in diversen Umgebungen getestet werden. Es ist eine so genannte BETA-Version. Vorsicht bei der Verwendung!

Requirements

Adventcalendar_XH ist ein Plugin für CMSimple_XH. Es benötigt eine UTF-8 kodierte Version und das jQuery4CMSimple Plugin.

Installation

Die Installation erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch. Im CMSimple_XH-Wiki finden Sie weitere Details.

  1. Sichern Sie die Daten auf Ihrem Server.
  2. Entpacken Sie die ZIP-Datei auf Ihrem Rechner.
  3. Laden Sie das ganze Verzeichnis adventcalendar/ auf Ihren Server in CMSimple_XHs Plugin-Verzeichnis hoch.
  4. Machen Sie die Unterverzeichnisse config/, css/, languages/ und den Daten-Ordner des Plugins beschreibbar.
  5. Gehen Sie zu "Adventcalendar" im Administrationsbereich, um zu prüfen, ob alle Voraussetzungen erfüllt sind.

Einstellungen

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.

Verwendung

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.

Schnellstartanleitung

Um schnell eine funktionierende Demo aufzusetzen, führen Sie einfach folgende Schritte durch:

  1. Navigieren Sie zu "Plugins" → "Adventcalendar" → "Einstellungen" und klicken Sie "Umschlag vorbereiten".
  2. Erzeugen Sie eine neue versteckte CMSimple_XH Seite mit der Überschrift "winter" (Groß-/Kleinschreibung ist wichtig) und ohne weiteren Inhalt.
  3. Erzeugen Sie einige versteckte Unterseiten dieser Seite mit beliebigen Überschriften und Inhalt.
  4. Geben Sie folgenden Pluginaufruf auf einer anderen Seite ein:
    {{{PLUGIN:adventcalendar('winter');}}}
  5. Wechseln Sie in den Ansichtsmodus – viel Spaß mit dem Adventskalender. Beachten Sie, dass Sie nur so viele Türchen öffnen können, wie Sie Unterseiten der Kalenderseite angelegt haben.

Vorbereiten des Umschlags

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.

Vorbereiten der Geheimnisse

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.

Anzeigen des Kalenders

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.

Einschränkungen

Lizenz

Adventcalendar_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2012-2013 Christoph M. Becker

Russische Übersetzung © 2012 Любомир Кудрай.

Danksagung

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.