M0030 Advents-Kalender für Gambio
Handbuch
1. Was der Advents-Kalender für Sie tut
Das Modul ergänzt Ihren Shop um einen echten Advents-Kalender: 24 Türchen, die sich vom 1. bis zum 24. Dezember Tag für Tag öffnen. Hinter jedem Türchen liegt genau eine Überraschung, die Sie vorher festlegen – ein besonders günstiges Produkt, ein Rabatt-Kupon oder eine frei gestaltete Seite mit einem Gewinnspiel, einem Rezept oder einer Weihnachtsgeschichte.
Der Nutzen für Sie liegt weniger im einzelnen Angebot als im täglichen Anlass: Ihre Kunden haben im Dezember jeden Tag einen Grund, den Shop erneut zu besuchen. Das Modul übernimmt dabei die gesamte Terminlogik. Sie bereiten alles im November in Ruhe vor, und ab dem 1. Dezember läuft der Kalender ohne weiteres Zutun – jeden Tag öffnet sich genau das Türchen, das an der Reihe ist. Türchen, deren Tag noch nicht gekommen ist, lassen sich nicht öffnen, auch nicht über einen direkt aufgerufenen Link.
2. Der schnelle Einstieg
Wenn Sie zum ersten Mal mit dem Modul arbeiten, ist das die kürzeste sinnvolle Reihenfolge:
- Setup öffnen und Modul einschalten. Das Setup erreichen Sie über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den TAB „Adventskalender“.
- Angebote hinterlegen. Über das Menü „Xycons-Module“ ► „Adventsangebote“ tragen Sie für jeden der 24 Tage einen Eintrag ein. Der Kopfbereich dieser Seite listet Ihnen laufend auf, welche Tage noch offen sind.
- Kalender platzieren. Auf der Startseite geschieht das über den StyleEdit, alternativ auf einer eigenen Content-Seite (Kapitel 5).
- Vorab prüfen. Schalten Sie den Admin-Modus ein und sehen Sie sich den Kalender an, ohne dass Ihre Kunden ihn schon sehen (Kapitel 3.5).
3. Das Setup
Das Setup erreichen Sie über das Menü „Xycons-Module“ ► „Kundenkonto / Setups“ und dort über den TAB „Adventskalender“. Zu jeder Einstellung finden Sie – wie bei unseren Modulen gewohnt – den erklärenden Hinweis direkt daneben. Hier geht es um das Warum hinter den Optionen.
3.1 Anzeige und Zeitpunkt
| Einstellung | Bedeutung |
|---|---|
| Modulstatus | Schaltet das Modul insgesamt ein oder aus (Standard: ausgeschaltet). Ist es ausgeschaltet, erscheint im Shop kein Kalender, es werden keine Adventspreise berechnet und keine Kupons ausgegeben. Sie können die Angebote aber trotzdem in Ruhe vorbereiten – in der Verwaltung weist Sie ein roter Hinweis darauf hin, dass das Modul noch aus ist. |
| Anzeige-Start | Ab welchem Tag der Kalender im Shop sichtbar wird, im Format TT.MM. (Standard: 01.12.). Wenn Sie hier z. B. „25.11.“ eintragen, sehen Ihre Kunden den Kalender schon in der Woche vor dem ersten Advent – als Vorfreude und Ankündigung. Geöffnet wird das erste Türchen trotzdem erst am 1. Dezember. |
3.2 Aussehen des Kalenders
| Einstellung | Bedeutung |
|---|---|
| Hintergrund | Das Motiv, auf dem die 24 Türchen liegen. Mitgeliefert werden zahlreiche Vorlagen; eigene Motive können Sie ergänzen (Kapitel 6). |
| Reihenfolge | In welcher Anordnung die Zahlen 1 bis 24 im Raster stehen – von oben links nach unten rechts, kommagetrennt. So wirkt der Kalender nicht wie eine schlichte Tabelle. |
| Zufallsverteilung | Statt einer festen Anordnung werden die Zahlen bei jedem Seitenaufbau neu gemischt. Ist diese Option aktiv, spielt die eingetragene Reihenfolge keine Rolle mehr. |
| Führende Nullen | Ob die Türchen als „01, 02, 03“ oder als „1, 2, 3“ beschriftet werden (Standard: mit führenden Nullen). |
3.3 Verhalten der Türchen
| Einstellung | Bedeutung |
|---|---|
| Türchen offen lassen | Normalerweise ist immer nur das Türchen des aktuellen Tages anklickbar; vergangene Tage schließen sich wieder. Mit dieser Option bleiben bereits geöffnete Türchen den ganzen Dezember über erreichbar. Das ist freundlicher für Besucher, die einen Tag verpasst haben – bedeutet aber, dass ältere Angebote und Kupons weiter genutzt werden können. |
| Neues Fenster | Ob der Inhalt eines Türchens in einem neuen Browserfenster geöffnet wird (Standard: gleiches Fenster). |
| Content Coupons | Die Seite, auf der ein gewonnener Rabatt-Kupon dargestellt wird. Sie wird bei der Installation angelegt und muss in aller Regel nicht geändert werden. |
| Content Coupon benutzt | Die Seite, die erscheint, wenn ein Kunde den Kupon des Tages bereits eingesetzt hat. |
3.4 Anzeige am Produkt
| Einstellung | Bedeutung |
|---|---|
| Grafik auf Detailseite | Blendet auf der Produktseite eines Adventsangebots ein auffälliges Bild ein, damit sofort erkennbar ist, dass es sich um ein zeitlich begrenztes Angebot handelt. Die Grafik können Sie durch ein eigenes Motiv ersetzen. |
| Adventsinfo auf Detailseite | Ergänzt einen kurzen Hinweis mit dem Datum, an dem das Angebot gilt („Nur am …“). Das nimmt Nachfragen vorweg und erhöht die Dringlichkeit. |
| Coupon-Produkte verlinken | Ist ein Kupon auf bestimmte Artikel beschränkt, werden diese Artikel in der Kupon-Anzeige direkt verlinkt. Der Kunde landet mit einem Klick beim passenden Produkt. |
3.5 Der Admin-Modus
Der Admin-Modus ist Ihr Probelauf. Ist er eingeschaltet, sehen nur Sie als angemeldeter Shop-Administrator den Kalender – reguläre Kunden bekommen ihn weiterhin nicht zu sehen, auch nicht nach dem Anzeige-Start. Über dem Kalender erscheint dann eine schmale Leiste, in der Sie zwei Dinge ausprobieren können:
- Simulations-Datum: Sie wählen einen beliebigen Kalendertag und sehen sofort, wie der Kalender an diesem Tag aussehen wird und was hinter dem Türchen liegt. So prüfen Sie im November, ob wirklich jeder Tag das enthält, was Sie geplant haben.
- Vorlage: Sie blättern durch die Hintergrundmotive und übernehmen das gewünschte Motiv mit der Schaltfläche darunter dauerhaft in Ihre Einstellungen.
Zusätzlich legen Sie mit „Admin Datumssimulation“ fest, welcher Tag beim Öffnen der Seite vorausgewählt ist.
4. Die Adventsangebote pflegen
Die Verwaltung erreichen Sie über das Menü „Xycons-Module“ ► „Adventsangebote“. Ganz oben sehen Sie in einem rot umrandeten Kasten, welche Kalendertage noch nicht versorgt sind. Sobald alle 24 Tage belegt sind, wechselt dieser Kasten in eine Erfolgsmeldung – das ist Ihre Freigabe, dass der Dezember vorbereitet ist.
Für jeden Tag hinterlegen Sie genau einen Eintrag. Zur Auswahl stehen drei Arten, und die Datumsauswahl bietet Ihnen immer nur die Tage an, die noch frei sind. Doppelbelegungen sind so ausgeschlossen.
4.1 Ein Produktangebot hinterlegen
Über „Neues Produkt“ wählen Sie einen Artikel und tragen den Preis ein, der an diesem einen Tag gelten soll. Zwei Eingabearten sind möglich:
- ein fester Betrag, z. B. 49.99 – bitte mit Punkt statt Komma,
- ein Rabatt in Prozent, z. B. 20% – der Preis wird dann aus dem regulären Verkaufspreis errechnet.
Zusätzlich können Sie ankreuzen, dass das Produkt außerhalb seines Kalendertages inaktiv bleiben soll. Damit bauen Sie eine echte Überraschung: Der Artikel taucht im Shop erst an „seinem“ Tag auf und verschwindet danach wieder. Das eignet sich für besondere Einzelstücke oder für Angebote, die Sie bewusst nicht dauerhaft im Sortiment haben möchten.
4.2 Einen Rabatt-Kupon hinterlegen
Über „Neuer Coupon“ wählen Sie einen bereits vorhandenen Rabatt-Kupon aus. Kupons legen Sie also vorher wie gewohnt im Shop an; das Gutscheinsystem muss dafür eingeschaltet sein (Shop-Einstellungen ► Zusatzmodule).
Beim Anlegen des Kupons brauchen Sie sich um das Gültigkeitsdatum nicht zu kümmern: Das Modul setzt es beim Öffnen des Türchens automatisch auf den betreffenden Tag. Ein Kupon darf auch an mehreren Kalendertagen hinterlegt werden.
Öffnet ein Kunde das Türchen, wird der Kupon direkt für seinen Warenkorb vorgemerkt – er muss ihn nicht abtippen. Öffnet er dasselbe Türchen später erneut, nachdem er den Kupon schon eingesetzt hat, erscheint stattdessen die Seite „Coupon bereits benutzt“.
4.3 Eine Content-Seite hinterlegen
Über „Neue Content-Seite“ verbinden Sie einen Kalendertag mit einer Seite, die Sie selbst gestaltet haben. Legen Sie diese Seite zuvor im Shop unter „Elemente“ ► „Sonstige“ an und tragen Sie hier deren Nummer ein.
Das ist die freieste der drei Möglichkeiten. Typische Verwendungen sind ein Gewinnspiel, ein Rezept, ein Blick hinter die Kulissen Ihres Unternehmens oder eine Grußbotschaft – also Inhalte, die nichts kosten und den Kalender trotzdem lebendig machen. Gerade an Tagen, an denen Sie keinen Rabatt geben möchten, ist das die bessere Wahl als ein leeres Türchen.
4.4 Einträge ändern, löschen und ins nächste Jahr übernehmen
In der Liste unterhalb der Eingabemaske sehen Sie alle hinterlegten Tage mit Datum, Art und Inhalt. Über „Bearbeiten“ ändern Sie einen Eintrag, über „Löschen“ entfernen Sie ihn; vor dem Löschen werden Sie noch einmal gefragt.
Sind Einträge aus einem vergangenen Jahr vorhanden, bietet Ihnen die Verwaltung zwei Schaltflächen an:
- Alte Angebote auf das laufende Jahr ändern – übernimmt die Planung des Vorjahres eins zu eins in das aktuelle Jahr. Das ist der schnellste Weg zum neuen Kalender, wenn sich an Ihrem Sortiment wenig geändert hat: Sie passen anschließend nur noch die Tage an, die anders werden sollen.
- Alte Angebote löschen – räumt die Einträge vergangener Jahre auf.
5. Wo der Kalender im Shop erscheint
5.1 Auf der Startseite über den StyleEdit
Die Platzierung auf der Startseite erfolgt über den StyleEdit Ihres Shops:
- StyleEdit öffnen und die Startseite anzeigen lassen
- in den Bereich „Widgets“ wechseln
- in der Liste den Eintrag „Adventskalender“ suchen
- das Widget mit gedrückter Maustaste an die gewünschte Stelle der Startseite ziehen
- Änderung speichern
Der Kalender nimmt die volle Breite des Inhaltsbereichs ein. Fügen Sie das Widget nur einmal ein. Solange das Modul ausgeschaltet ist, bleibt die Stelle im Shop leer.
5.2 Auf einer eigenen Content-Seite
Möchten Sie den Kalender lieber auf einer eigenen Seite zeigen – etwa als „Unser Adventskalender“ mit einer Einleitung darüber –, gehen Sie so vor:
- Legen Sie die Content-Seite im Shop an und fügen Sie im Quelltext an der gewünschten Stelle diesen Platzhalter ein:
<div data-xycons0030-controller="m0030_handler"
data-xycons0030-namespace="GXModules/Xycons/M0030/Shop/Javascripts"
id="advent_calendar_widget">{advent_calendar}</div>
- Tragen Sie anschließend im Setup unter „Content-Seite“ die Nummer dieser Seite ein. Mehrere Seiten geben Sie kommagetrennt an.
6. Eigene Hintergrundmotive
Die mitgelieferten Motive können Sie jederzeit durch eigene ergänzen oder ersetzen. Die Dateien gehören per FTP in dieses Verzeichnis Ihres Shops:
/images/custom/
Damit das Modul ein Motiv erkennt, muss der Dateiname der Namenskonvention folgen:
advent_XX.jpg
XX ist dabei eine zweistellige laufende Nummer. Sie können eine vorhandene Nummer überschreiben oder eine neue Datei ergänzen; die Nummern ab 69 sind noch frei. Für eine verzerrungsfreie Darstellung sollten die Grafiken 1024 × 768 Pixel groß sein.
7. Aussehen anpassen
Die Gestaltungsvorschriften des Kalenders sind für alle Bildschirmgrößen vom Handy bis zum großen Monitor abgestimmt. Wenn Sie Farben, Schriftgrößen oder Abstände ändern möchten, tun Sie das bitte über die Funktion „Eigenes CSS hinzufügen“ in Ihrem Theme beziehungsweise im Thememanager.
8. Modultexte ändern
Modultexte können Sie – wie bei allen Modulen von uns – über die Shopfunktion „Texte ändern“ im Admin-Bereich an eigene Bedürfnisse anpassen. Das betrifft zum Beispiel den Hinweis „Nur am …“ auf der Produktseite, die Meldung für einen nicht mehr gültigen Türchen-Link oder die Texte in der Verwaltung der Adventsangebote.
Die Inhalte der Kupon-Seiten – also das, was der Kunde nach dem Öffnen eines Türchens liest – ändern Sie dagegen dort, wo sie auch angelegt wurden: im Bereich „Elemente“ ► „Sonstige“ Ihres Shops. Dort können Sie den Text frei umschreiben und weihnachtlich gestalten.
9. Shopupdate und Modulpflege
Planen Sie ein Service Pack oder ein Masterupdate Ihres Shops, prüfen Sie bitte vorher auf unserer Seite, ob das Modul für die neue Shopversion freigegeben ist. Ein Modul passt sich nicht von selbst an eine neue Shopversion an.
Führen Sie das Update durch, installieren Sie bitte immer beides in der jeweils neuesten Fassung: das Modul und die Modulumgebung. Nur der Shop allein aktualisiert zu werden, ist der häufigste Grund für ein Modul, das nach einem Update nicht mehr richtig arbeitet.
Wenn wir die Aktualisierung Ihres Shops für Sie durchführen, aktualisieren wir vorhandene Xycons-Module und die Modulumgebung immer mit, sofern sie für die Shopversion verfügbar sind.
10. Häufige Stolpersteine
| Beobachtung | Was zu prüfen ist |
|---|---|
| Der Kalender wird überhaupt nicht angezeigt. | Ist das Modul eingeschaltet? Ist der Anzeige-Start korrekt im Format „TT.MM.“ hinterlegt? Möchten Sie den Kalender vor dem Anzeige-Start sehen, schalten Sie den Admin-Modus ein. |
| Nur ich sehe den Kalender, meine Kunden nicht. | Der Admin-Modus ist noch eingeschaltet. Schalten Sie ihn im Setup aus. |
| Auf meiner Content-Seite steht nur der Platzhalter. | Tragen Sie die Nummer dieser Content-Seite im Setup unter „Content-Seite“ ein. Ohne diese Angabe bereitet das Modul die Darstellung dort nicht auf. |
| Der Kalender ist von der Startseite verschwunden. | Im Setup ist unter „Content-Seite“ eine Nummer eingetragen. Leeren Sie das Feld, wenn der Kalender wieder auf der Startseite erscheinen soll. |
| Beim Klick auf ein Türchen kommt eine Entschuldigung, und Sie erhalten eine Hinweis-Mail. | Für diesen Tag ist kein Eintrag hinterlegt, oder das hinterlegte Produkt, der Kupon oder die Seite existiert nicht mehr. Der Kopfbereich der Adventsangebote zeigt Ihnen die offenen Tage. |
| Ein Kunde meldet, der Rabatt sei nicht angekommen. | Der Kupon wird beim Öffnen des Türchens für den Warenkorb vorgemerkt und erst am Ende des Bestellvorgangs ausgewiesen. Prüfen Sie außerdem, ob der Kupon Mindestbestellwerte oder Beschränkungen auf bestimmte Artikel hat. |
| Ein Adventsprodukt ist im Shop nicht auffindbar. | Beim Eintrag ist „außerhalb des Stichtags inaktiv halten“ angekreuzt. Das ist so gewollt – der Artikel erscheint an seinem Kalendertag. |
| Der Preis stimmt nicht mit dem Adventspreis überein. | Für denselben Artikel besteht zusätzlich ein reguläres Sonderangebot. Entfernen Sie es für den betreffenden Zeitraum. |
| In der Kupon-Auswahl steht, es gebe keine Kupons. | Das Gutscheinsystem ist ausgeschaltet (Shop-Einstellungen ► Zusatzmodule), oder es ist noch kein aktiver Rabatt-Kupon angelegt. |
Kommen Sie mit einem Punkt nicht weiter, melden Sie sich gern bei uns. Wir wünschen Ihnen viel Erfolg und eine umsatzstarke Adventszeit!

