Einkaufswagen
Wozu dient das Modul
- Winterliche und weihnachtliche Gestaltung des Shops ohne Arbeit eines Grafikers. Der Effekt von fallendem Schnee erscheint über dem bestehenden Theme – ohne Änderungen an den Theme-Dateien und ohne die Vorbereitung zusätzlicher Grafiken.
- Eine Saison, die sich selbst einschaltet. Sie legen den ersten und den letzten Schneetag einmal fest, und mit der Option „Jedes Jahr“ kehrt der Schnee in den nächsten Saisons ohne erneute Konfiguration zurück.
- Schnee dort, wo er passt. Sie wählen die Seitentypen aus, auf denen es schneit. Warenkorb und Bestellung sind standardmäßig ausgeschlossen, daher begleitet die Animation den Kunden beim Bezahlen nicht, solange Sie dies nicht selbst ändern.
- Respekt für den Kunden. Eine Schaltfläche in der Ecke der Seite schaltet den Schnee aus und ein, und das Modul berücksichtigt die Systemeinstellung „Bewegung reduzieren“.
- Separate Einstellung für Smartphones. Auf kleinen Bildschirmen können Sie weniger Flocken anzeigen oder den Schnee dort ganz ausschalten.
Wann es schneit: Schalter, Daten und Saison jedes Jahr
- Hauptschalter „Schnee anzeigen“. Wenn er ausgeschaltet ist, fügt das Modul den Shop-Seiten nichts hinzu.
- Datumsbereich „Nur zwischen den Daten“. Die Felder „Erster Tag“ und „Letzter Tag“ werden im Kalender ausgewählt; der Schnee fällt auch am letzten Tag des Bereichs. Außerhalb des Bereichs fügt das Modul den Seiten nichts hinzu.
- Saison „Jedes Jahr“. Das Jahr in den Daten wird ignoriert, und der Schnee kehrt in jeder Saison zurück, auch wenn der Bereich den Jahreswechsel umfasst – zum Beispiel vom 1. Dezember bis zum 6. Januar.
- Einmaliger Bereich. Ohne die Option „Jedes Jahr“ fällt der Schnee nur im angegebenen Zeitraum. Wenn die Daten bereits vergangen sind, meldet das Panel dies und fordert zu neuen Daten oder zum Deaktivieren des Bereichs auf.
- Shop-Datum. Ob heute ein Schneetag ist, entscheidet das aktuelle Shop-Datum.
- Datumsangaben in Worten. In der Überschrift des Panels wird der Bereich in Worten angegeben, zum Beispiel „Jedes Jahr vom 1. Dezember bis zum 6. Januar“, und außerhalb der Saison erscheint die Information, wann der Schnee zu fallen beginnt.
Auf welchen Shop-Seiten es schneit
- Sechs auswählbare Seitentypen. Startseite, Kategorieseiten, Produktseiten, CMS-Seiten, Warenkorb und Bestellung sowie sonstige Seiten.
- Sonstige Seiten. Das ist alles außerhalb der Liste, zum Beispiel Suche, Kontakt, Kundenkonto, Hersteller und Seiten anderer Module (auch eine Modulseite, deren Name an eine Shop-Seite erinnert, zum Beispiel eine Blog-Kategorie).
- Warenkorb und Bestellung. Dazu gehören Warenkorb, Bestellprozess, Bestellbestätigung, Seiten von Zahlungsmodulen sowie Kassen von Modulen, deren Controller das Wort „checkout“ im Namen trägt, zum Beispiel One-Page-Checkouts.
- Standardeinstellungen. Nach der Installation schneit es auf allen Seitentypen außer Warenkorb und Bestellung.
Aussehen der Flocken: Formen, Punkte, Farbe und Leuchten
- Drei Schneestile. Flockenformen, runde Punkte oder Formen und Punkte zusammen.
- Acht Flockenformen. Sie wählen eine oder mehrere aus; jede Flocke erhält zufällig eine der ausgewählten Formen.
- Eine Farbe für den gesamten Schnee. Die Farbe im Format #RRGGBB färbt Punkte und Formen (standardmäßig hellblau #b9cde4).
- Deckkraft von 10 bis 100. Von kaum sichtbarem Schnee bis zu voller Deckkraft.
- Größe von 2 bis 80 px. Jede Flocke erhält eine zufällige Größe zwischen der kleinsten und der größten.
- Sanftes Leuchten. Hilft weißem Schnee, sich auf einer hellen Seite abzuheben.
- Drehung der Formen. Die Flockenformen drehen sich beim Fallen langsam.
- Tiefeneffekt. Größere Flocken fallen etwas schneller und sind deutlicher sichtbar, als wären sie näher.
Anzahl der Flocken auf Computern und Smartphones
- Computer und Tablets. Von 1 bis 400 Flocken gleichzeitig (standardmäßig 80).
- Smartphones. Separate Anzahl von 0 bis 400 (standardmäßig 30); der Wert 0 schaltet den Schnee auf Smartphones aus und blendet dort die Schaltfläche für Kunden aus.
- Horizontal gedrehte Smartphones. Als Smartphone betrachtet das Modul ein Fenster mit einer Breite bis 767 px oder einen Touchscreen, dessen kürzere Seite bis 767 px misst, daher erhält ein horizontal gedrehtes Smartphone weiterhin die Flockenzahl für Smartphones.
Bewegung des Schnees: Geschwindigkeit, Wind, Schaukeln und Dauer
- Geschwindigkeit von 1 bis 10. Die langsamsten und schnellsten Flocken bestimmen den Bereich; jede Flocke erhält eine zufällige Geschwindigkeit aus diesem Bereich.
- Wind. Kein Wind oder schwacher bzw. starker Wind nach links oder rechts.
- Schaukeln. Kein, sanftes, mittleres oder starkes seitliches Schaukeln der Flocken.
- Stopp nach einer Zeit. Der Wert 0 bedeutet Schnee ohne Unterbrechung. Ein anderer Wert (bis 3600 Sekunden) bewirkt, dass nach so vielen Sekunden seit dem Öffnen jeder Seite keine neuen Flocken mehr erscheinen und der Schnee mit der letzten Flocke endet.
Schaltfläche für Kunden und Barrierefreiheit
- Schaltfläche „Schnee ausschalten“ / „Schnee einschalten“. Eine kleine runde Schaltfläche mit Schneeflocken-Symbol, unten auf der Seite links oder rechts. Sie ist per Tastatur bedienbar, hat einen gut sichtbaren Fokusrahmen und eine Beschreibung für Screenreader.
- Einstellbarer Abstand vom unteren Rand. Von 0 bis 400 px – nützlich, wenn die Schaltfläche ein Cookie-Banner, einen Chat oder eine Warenkorbleiste verdeckt.
- Gespeicherte Auswahl. Die Entscheidung des Kunden wird 90 Tage lang in seinem Browser gespeichert, sodass der Schnee in der nächsten Saison zurückkehrt. Das Modul speichert dafür keine Cookies.
- Bewegung reduzieren. Mit der Option „‚Bewegung reduzieren‘ berücksichtigen“ sehen Kunden, deren System um reduzierte Animationen bittet, keinen Schnee, bis sie ihn mit der Schaltfläche einschalten.
- Anforderung WCAG 2.2.2. Die Schaltfläche ermöglicht es, eine Bewegung zu stoppen, die länger als 5 Sekunden dauert. Wenn Sie sie ausschalten, warnt die Überschrift des Panels, dass Kunden den Schnee nicht stoppen können.
- Eine Ebene, die nicht stört. Der Schnee fängt keine Klicks ab, ist für Screenreader verborgen und erscheint nicht im Seitendruck.
Leichtes Skript, das den Shop nicht belastet
- Ohne jQuery. Das Skript benötigt kein jQuery und funktioniert daher auch mit dem Hummingbird-Theme aus PrestaShop 9.
- Eine einzige Canvas-Ebene. Der gesamte Schnee wird auf einem Element über der Seite gezeichnet; Inhalt, URLs und Layout des Shops ändern sich nicht.
- Dateien nur dort, wo es schneit. Wenn der Schnee ausgeschaltet ist, außerhalb der Daten liegt oder auf einem nicht ausgewählten Seitentyp, fügt das Modul der Seite weder Skript noch Stil noch Einstellungen hinzu.
- Pause im Hintergrund. Die Animation stoppt, wenn der Browser-Tab nicht sichtbar ist, und passt sich an Änderungen der Fenstergröße an.
- Scharfe Flocken auf Bildschirmen mit hoher Pixeldichte. Die Ebene wird unter Berücksichtigung der Pixeldichte des Bildschirms gezeichnet (bis zum Zweifachen), sodass die Flocken scharf bleiben.
- Ohne externe Dienste. Skript, Styles und Bilder der Flocken stammen aus dem Modulverzeichnis auf dem Server des Shops.
- Schnee als Dekoration. Ein Fehler auf Seiten des Moduls unterbricht die Anzeige der Shop-Seite nicht.
Konfigurationspanel mit Live-Vorschau
- Drei Registerkarten. „Wann und wo“, „Aussehen“ und „Animation“.
- Überschrift mit Shop-Status. Sie zeigt an, ob es gerade schneit, und wenn nicht – warum: Modul im Modulmanager deaktiviert, nicht an den Hook displayHeader angehängt, Schnee ausgeschaltet, keine Seiten ausgewählt, Warten auf Daten oder Daten, die bereits vergangen sind. Sie zeigt auch die Anzahl der Flocken auf Computern und Smartphones sowie die Anzahl der ausgewählten Seitentypen.
- Live-Vorschau. Auf den Registerkarten „Aussehen“ und „Animation“ spiegelt die Vorschau das Formular schon vor dem Speichern wider; sie kann angehalten und auf einen hellen Hintergrund umgeschaltet werden. Die Anzahl der Flocken wird an die Größe des Vorschaufelds angepasst.
- Nur die benötigten Felder. Felder für Daten, Schaltflächenposition und Formen werden ausgeblendet, wenn sie in der jeweiligen Einstellung keine Bedeutung haben.
- Klare Meldungen. Ein fehlerhaftes Feld wird hervorgehoben, und die Meldung sagt, welcher Bereich oder welches Format zulässig ist. Vor dem Wechsel zu einer anderen Registerkarte mit ungespeicherten Änderungen fragt das Panel danach.
- Sicheres Speichern. Einstellungen kann nur ein Mitarbeiter mit Berechtigung zur Modulkonfiguration ändern, und jeder Wert wird vor dem Speichern geprüft.
Mehrere Shops (Multistore)
- Gemeinsame Einstellungen, Gruppen- und Shop-Einstellungen. Sie können gemeinsame Einstellungen für alle Shops, Einstellungen einer Shop-Gruppe oder eines einzelnen Shops bearbeiten.
- Eigenständig nur das, was Sie ändern. In einem Shop oder einer Gruppe wird nur das geänderte Feld zu einem eigenen Wert; der Rest folgt weiterhin den übergeordneten Einstellungen. Verknüpfte Einstellungen – kleinste und größte Flocke, langsamste und schnellste Flocken sowie Daten – werden zusammen gespeichert.
- Vollständige Information über den Bereich. Das Panel gibt an, welchen Bereich Sie bearbeiten, wie viele Einstellungen einen eigenen Wert haben und welche Shops oder Gruppen eigene Einstellungen haben.
- Rückkehr zu den übergeordneten Einstellungen. Die Schaltfläche „Gemeinsame Einstellungen verwenden“ oder „Gruppeneinstellungen verwenden“ entfernt eigene Werte nach Bestätigung.
- Mitarbeiterberechtigungen. Ein Mitarbeiter mit Zugriff nur auf einen Teil der Shops kann die Einstellungen von Shops, auf die er keinen Zugriff hat, nicht ändern.
- Shops ohne Schnee. Die Überschrift gibt an, in wie vielen Shops das Modul deaktiviert oder nicht angehängt ist, also dort schneit es nicht.
Aktualisierung von Version 1.0.x
- Übernahme der Einstellungen. Anzahl der Flocken, Ebene (z-index), Größen, Geschwindigkeiten, Deckkraft, Farbe, Schatten (als Leuchten), Auswahl von Form oder Punkten sowie die Einstellung, Schnee nur auf der Startseite anzuzeigen, werden in die neue Version übernommen – ebenso Werte, die für einzelne Shops und Gruppen festgelegt wurden.
- Aufräumen nach der alten Version. Alte Hook-Anbindungen an header, footer und displayFooter werden durch den Hook displayHeader ersetzt, und Dateien der Version 1.0.x, die von der neuen Version nicht verwendet werden (einschließlich des jQuery-Plugins und generierter Styles), werden aus dem Modulverzeichnis entfernt, wenn die Dateiberechtigungen dies zulassen.
Anforderungen und Kompatibilität
- PrestaShop 1.7.0–9.x und PHP 7.0–8.5.
- Themes. Classic und Hummingbird; das Skript erfordert kein jQuery.
- Ohne Abhängigkeiten. Ohne Composer und ohne zusätzliche Bibliotheken.
- Ohne eigene Tabellen. Die Einstellungen werden in der PrestaShop-Konfiguration gespeichert; bei der Deinstallation werden sie entfernt, zusammen mit den Einstellungen der Version 1.0.x.
- Sprachen. Modul-Panel und Schaltfläche für Kunden auf Polnisch und Englisch.
Wichtige Funktionsgrenzen
- Der gesamte Schnee hat eine einzige Farbe; es gibt keine Flocken in mehreren Farben gleichzeitig.
- Zur Auswahl stehen acht mitgelieferte Formen; das Panel bietet kein Hochladen eigener Flockenbilder.
- Der Schnee wird für Seitentypen aktiviert, nicht für ausgewählte Kategorien, Produkte oder einzelne CMS-Seiten.
- Sonstige Seiten sind eine einzige Gruppe – es ist nicht möglich, den Schnee zum Beispiel nur in der Suche separat einzuschalten.
- Die Zeit „Stopp nach“ beginnt auf jeder geöffneten Seite von Neuem zu laufen.
- Die Auswahl des Kunden wird in seinem Browser gespeichert; im privaten Modus oder bei blockiertem Browserspeicher gilt sie nur auf der aktuellen Seite.
- Ein Tablet erhält die Flockenzahl für Computer, wenn das Fenster breiter als 767 px ist und die kürzere Seite seines Bildschirms mehr als 767 px misst.
- Der Schnee fällt über allem, was einen niedrigeren z-index hat; wenn er ein Pop-up des Themes verdeckt oder hinter dem Menü fällt, muss der Ebenenwert angepasst werden (standardmäßig 9999).