M0155 PopMeUp für Gambio
Handbuch
1. WAS DIESES MODUL LEISTET
PopMeUp blendet animierte Hinweisfenster (Popups) im Shop ein. Der Inhalt kommt aus dem Gambio-Content-Manager, ist also in jeder Shopsprache pflegbar und braucht keinerlei Datei-Bearbeitung.
Typische Einsatzfälle: Aktionshinweis auf der Startseite, Versandhinweis vor Feiertagen, Gutscheincode für Erstbesucher, Zusatzangebot auf bestimmten Kategorie- oder Produktseiten, Hinweis im Warenkorb oder nach erfolgreicher Bestellung.
Sie legen beliebig viele Popups an. Mehrere davon dürfen gleichzeitig im Shop aktiv sein; treffen mehrere auf dieselbe Seite zu, erscheinen sie fair nacheinander statt alle auf einmal (siehe Abschnitt 4.7). Nicht aktive Popups bleiben als Vorlage erhalten.
Ein eingeblendetes Popup mit abgedunkeltem Hintergrund, Inhalt aus dem Content-Manager und Schließen-Schaltfläche.
2. ERSTE SCHRITTE IN FÜNF MINUTEN
- Im Modul-Setup den Modulstatus auf Eingeschaltet stellen (Abschnitt 6).
- Im Content-Manager unter Elemente / Sonstige ein Element mit dem gewünschten Popup-Inhalt anlegen (Überschrift und Text; Bilder gerne über den Editor einbinden).
- Menü Xycons-Module → PopMeUp öffnen und Neues Popup anlegen.
- Oben die Content-ID des eben angelegten Elements auswählen.
- Unten Popup aktiv (im Shop ausspielen) ankreuzen und speichern.
- Mit Voransicht das Ergebnis prüfen, danach im Shop kontrollieren.
3. DIE POPUP-VERWALTUNG
Pfad: Xycons-Module → PopMeUp. Die Übersicht listet alle Popups mit technischer ID, zugeordnetem Content, Anzeigeart, Animation und Aktiv-Kennzeichen.
- Neues Popup – legt einen leeren Datensatz an, vorbelegt mit den Vorgaben aus dem Setup.
- Bearbeiten – öffnet die Bearbeitungsmaske.
- Kopieren – dupliziert ein Popup inklusive aller Einstellungen und Sprachtexte. Die Kopie wird zunächst inaktiv angelegt – ideal als Ausgangspunkt für eine Variante.
- Löschen – mit Sicherheitsabfrage in einem modalen Fenster.
Das grüne Aktiv-Kennzeichen zeigt, welche Popups aktuell im Shop ausgespielt werden. Ist das Modul ausgeschaltet oder hat ein aktives Popup keinen Inhalt, erscheint oben ein Warnhinweis; im Shop wird dann bewusst nichts ausgegeben.
4. EIN POPUP BEARBEITEN
Die Bearbeitungsmaske fasst alle Einstellungen eines Popups zusammen. Was Sie hier eintragen, gilt immer für genau dieses Popup und hat Vorrang vor den Vorgaben aus dem Setup. Die folgenden Ausschnitte zeigen die Maske von oben nach unten:
4.1 Allgemein: Inhalt und Zuordnung
Die Popup-ID und die technische DOM-ID vergibt das System; beide sind nur informativ. Über die Content-ID wird der Inhalt aus dem Content-Manager verknüpft. Angezeigt wird immer die Sprachfassung des Besuchers; fehlt sie, greift die erste gepflegte Sprache als Rückfallebene.
4.2 Layout und Größe
| Einstellung | Bedeutung |
|---|---|
| Anzeigeart | Modal (mittig), Banner oben, Leiste unten, seitlich links oder seitlich rechts |
| Größen-Preset | small, medium, large, fullscreen – oder leer lassen |
| Größe in Prozent | 30 bis 100 Prozent des sichtbaren Fensters; ersetzt das Preset |
| Max-Breite / Max-Höhe | Optionale Obergrenze, z. B. 1200px |
| Radius | Eckenrundung des Fensters |
| Panel-Scroll | Zeigt bei langen Inhalten einen Scrollbalken, statt abzuschneiden |
4.3 Farben und Schaltfläche
Titelfarbe, Textfarbe, Hintergrund (Vollfarbe oder Verlauf), Rahmenfarbe, -breite und -stil sowie die Farben der Schaltfläche lassen sich je Popup setzen. Bleibt ein Feld leer, greift der Wert aus dem Modul-Setup.
Die optionale Schaltfläche (CTA) besteht aus Beschriftung und Ziel-Link. Ohne Link wird daraus ein Schließen-Button. Aus Sicherheitsgründen sind nur die Linkarten http, https, mailto, tel sowie shopinterne relative Links zulässig.
4.4 Verhalten und Anzeigehäufigkeit
- Animation inklusive Dauer: einfallen, einschieben, einblenden, aufziehen oder drehend aufziehen.
- Startverzögerung: Wartezeit nach dem Seitenaufbau, bevor das Popup erscheint.
- Interaktionsschutz: kurze Sperre gegen versehentliches Wegklicken direkt nach dem Öffnen.
- Nur Einstiegsseiten: Anzeige nur, wenn der Besucher von außen oder direkt kommt.
- Exit-Popup: Anzeige erst, wenn der Besucher die Seite verlassen will – wahlweise einmalig oder immer, optional mit Obergrenze der Einblendungen.
- Einmal pro Session und Merken für X Minuten: begrenzen die Wiedervorlage nach dem Schließen. Das Modul merkt sich den Schließ-Zustand so, dass das Popup auch beim Weiterklicken durch den Shop nicht erneut aufspringt.
- Schließen per ESC und Schließen bei Klick außerhalb: einzeln schaltbar.
- Debug: Immer zeigen: nur für Tests; hebt die Einstiegs- und Merklogik auf und schreibt zusätzlich ein Protokoll in die Browser-Konsole. Vor dem Livegang wieder abschalten.
4.5 Zeitfenster von/bis
Optionale Gültigkeit mit Datum und Uhrzeit. Außerhalb des Fensters bleibt das Popup stumm, auch wenn es aktiv geschaltet ist. Maßgeblich ist die im Shop eingestellte Zeitzone.
4.6 Zielseiten und Schlüsselwörter
Ohne Zielregel erscheint das Popup überall. Sobald mindestens eine Regel gesetzt ist, wird nur noch dort ausgespielt, wo eine Regel zutrifft:
- Kategorieseiten – alle oder nur ausgewählte Kategorien.
- Produktseiten – alle oder nur ausgewählte Artikel.
- Warenkorb-/Checkout-Schritte – Übersicht (Warenkorb), Versand, Zahlungsweise, Zusammenfassung.
- Bestellabschluss – die Erfolgsseite nach der Bestellung.
- Schlüsselwörter – Treffer im Seitentext der aktuellen Seite. Wahlweise mindestens ein Treffer (ODER) oder alle Treffer (UND).
4.7 Mehrere Popups gleichzeitig
Mehrere Popups dürfen gleichzeitig aktiv sein. Treffen mehrere auf dieselbe Seite zu, drängen sie sich nicht alle auf einmal auf: Pro Seitenaufruf erscheint eines, das nächste kommt erst nach einer im Setup eingestellten Pause (Rotations-Mindestabstand) an die Reihe. So bekommt jede Botschaft ihren Auftritt, ohne den Besucher zu überfallen.
Die Reihenfolge wechselt fair durch; den Mindestabstand in Sekunden legen Sie zentral im Setup fest (0 = kein Abstand).
4.8 Voransicht
Die Schaltfläche Voransicht rendert das Popup mit den aktuell im Formular stehenden Werten, ohne zu speichern. Bilder und Links aus dem Content werden dabei auf die Shop-Adresse umgeschrieben, damit die Vorschau im Adminbereich dasselbe zeigt wie später der Shop.
5. INHALTE PFLEGEN: CONTENT ANLEGEN UND KOPIEREN
Direkt neben der Content-Auswahl stehen drei Schaltflächen:
- Content-Manager öffnen – öffnet den gerade zugeordneten Inhalt in einem neuen Tab.
- Neuen Content anlegen – öffnet den Content-Manager für ein neues Element in einem neuen Tab.
- Content kopieren – dupliziert den oben gewählten Inhalt unter einer neuen Nummer, ordnet die Kopie sofort diesem Popup zu und öffnet sie zum Bearbeiten.
Kopiert werden alle Sprachfassungen des Elements; die Titel bekommen den Zusatz (Kopie). Das ist der schnellste Weg, wenn ein kopiertes Popup einen abweichenden, aber ähnlichen Text bekommen soll.
6. DAS MODUL-SETUP
Das Setup erreichen Sie über das Menü Xycons-Module → Kundenkonto / Setups und dort über den TAB PopMeUp. Hier stehen der Modulstatus, der Lizenzschlüssel und die Vorgabewerte, die greifen, wenn ein Popup das jeweilige Feld leer lässt.
| Bereich | Bedeutung |
|---|---|
| Modulstatus | Modul ein- oder ausschalten. Bei Ausgeschaltet gibt der Shop kein Popup aus. |
| Rotations-Mindestabstand | Sekunden-Pause, bevor bei mehreren zutreffenden Popups das nächste an die Reihe kommt (siehe 4.7). |
| Default Anzeige/Animation/Größe | Vorgaben für Anzeigeart, Animation, Dauer, Größe, Verzögerung und Schließverhalten. |
| Default Farben | Vorgabefarben für Titel, Text, Hintergrund, Rahmen und Schaltfläche. |
| Default Verhalten | Vorgaben für Einstiegsseiten, „Einmal pro Session“, Merkdauer und ESC-/Klick-Schließen. |
Alle „Default“-Werte sind nur die Vorlage: Sobald ein Popup im eigenen Datensatz einen Wert trägt, gewinnt dieser. Leere Felder im Popup übernehmen die Vorgabe aus dem Setup.
7. 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. So lässt sich etwa die Beschriftung der Schließen-Schaltfläche oder ein Hinweis in der Verwaltung umformulieren, ohne eine Datei zu bearbeiten.
Die eigentlichen Popup-Inhalte (Überschrift, Text, Bilder) pflegen Sie dagegen nicht hier, sondern im Content-Manager – dort sind sie je Shopsprache getrennt.
8. SHOPUPDATE UND MODULPFLEGE
Vor einem Shopupdate bitte auf der Xycons-Seite prüfen, ob das Modul für die neue Shopversion freigegeben ist.
Beim Shopupdate immer beide aktuellen Stände installieren: die neueste Version des Moduls und die neueste Version der Xycons-Modulumgebung. Es genügt nicht, nur den Shop zu aktualisieren – ein altes Modul passt sich einer neuen Shopversion nicht von selbst an.
9. BETRIEB, TESTS UND HÄUFIGE FRAGEN
Nach einer Modulaktualisierung einmal den Shop-Cache leeren. Die Sitzungen (Sessions) müssen dafür nicht gelöscht werden.
| Symptom | Zu prüfen |
|---|---|
| Es erscheint kein Popup | Modulstatus eingeschaltet? Mindestens ein Popup aktiv geschaltet? Content-ID gesetzt und das Content-Element aktiv? Zeitfenster gültig? Zielregeln nicht zu eng? |
| Popup nur für mich sichtbar | Die Option Admin-Test ist noch aktiv. |
| Popup erscheint nur einmal | Einmal pro Session bzw. Merken für X Minuten greift. Zum Testen Debug: Immer zeigen nutzen. |
| Zwei Popups überlagern sich nicht | So ist es gewollt: Pro Seitenaufruf erscheint eines, das nächste nach dem Rotations-Mindestabstand (Abschnitt 4.7). |
| Schlüsselwort greift nicht | Schreibweise und Plural prüfen; bei mehreren Begriffen den Modus von Alle auf Mindestens ein stellen. |
| Bilder fehlen im Popup | Im Content-Manager eingebundene Bilder müssen im Shop erreichbar sein; die Voransicht zeigt denselben Stand wie der Shop. |

