Nákupní košík
K čemu modul slouží
- Zimní a sváteční výzdoba obchodu bez práce grafika. Efekt padajícího sněhu se zobrazí nad stávajícím motivem – bez změn v souborech motivu a bez přípravy dalších grafik.
- Sezóna, která se zapíná sama. Nastavíte první a poslední den sněžení jednou a s volbou „Každý rok“ se sníh vrací v dalších sezónách bez opětovné konfigurace.
- Sníh tam, kde se hodí. Vyberete typy stránek, na kterých padá. Košík a objednávka jsou ve výchozím nastavení vypnuté, takže animace zákazníka při placení nedoprovází, dokud to sami nezměníte.
- Respekt k zákazníkovi. Tlačítko v rohu stránky sníh vypíná a zapíná a modul bere v úvahu systémové nastavení „omezit pohyb“.
- Samostatné nastavení pro telefony. Na malé obrazovce můžete zobrazit méně vloček nebo tam sníh úplně vypnout.
Kdy padá sníh: přepínač, data a sezóna každý rok
- Hlavní přepínač „Zobrazovat sníh”. Když je vypnutý, modul na stránky obchodu nic nepřidává.
- Rozsah dat „Pouze mezi daty”. Pole „První den” a „Poslední den” se vybírají z kalendáře; sníh padá i v poslední den rozsahu. Mimo rozsah modul na stránky nic nepřidává.
- Sezóna „Každý rok”. Rok v datech se ignoruje a sníh se vrací v každé sezóně, také když rozsah zahrnuje přelom roku – například od 1. prosince do 6. ledna.
- Jednorázový rozsah. Bez volby „Každý rok” padá sníh jen v zadaném období. Když už data uplynula, panel to oznámí a požádá o nová data nebo vypnutí rozsahu.
- Datum obchodu. O tom, zda je dnes den se sněhem, rozhoduje aktuální datum obchodu.
- Data popsaná slovy. V záhlaví panelu je rozsah uveden slovně, například „Každý rok od 1. prosince do 6. ledna”, a mimo sezónu se zobrazí informace, kdy začne sníh padat.
Na kterých stránkách obchodu padá sníh
- Šest typů stránek k označení. Domovská stránka, stránky kategorií, stránky produktů, stránky CMS, košík a objednávka a ostatní stránky.
- Ostatní stránky. To je vše mimo seznam, například vyhledávání, kontakt, účet zákazníka, výrobci a stránky jiných modulů (také stránka modulu, jejíž název připomíná stránku obchodu, například kategorie blogu).
- Košík a objednávka. Zahrnují košík, proces objednávky, potvrzení objednávky, stránky platebních modulů a pokladny modulů, jejichž kontroler má v názvu slovo „checkout”, například jednostránkové pokladny.
- Výchozí nastavení. Po instalaci padá sníh na všech typech stránek kromě košíku a objednávky.
Vzhled vloček: tvary, tečky, barva a záře
- Tři styly sněhu. Tvary vloček, kulaté tečky nebo tvary a tečky dohromady.
- Osm tvarů vloček. Vyberete jeden nebo několik; každá vločka náhodně dostane jeden z označených tvarů.
- Jedna barva pro celý sníh. Barva ve formátu #RRGGBB obarví tečky i tvary (výchozí světle modrá #b9cde4).
- Krytí od 10 do 100. Od sotva viditelného sněhu po plné krytí.
- Velikost od 2 do 80 px. Každá vločka dostane náhodnou velikost mezi nejmenší a největší.
- Jemná záře. Pomáhá bílému sněhu vyniknout na světlé stránce.
- Otáčení tvarů. Tvary vloček se při padání pomalu otáčejí.
- Efekt hloubky. Větší vločky padají o něco rychleji a jsou výraznější, jako by byly blíž.
Počet vloček na počítačích a telefonech
- Počítače a tablety. Od 1 do 400 vloček současně (výchozí 80).
- Telefony. Samostatný počet od 0 do 400 (výchozí 30); hodnota 0 vypíná sníh na telefonech a skrývá tam tlačítko pro zákazníky.
- Telefony otočené vodorovně. Za telefon modul považuje okno o šířce do 767 px nebo dotykovou obrazovku, jejíž kratší strana má do 767 px, takže telefon otočený vodorovně stále dostane počet vloček pro telefony.
Pohyb sněhu: rychlost, vítr, kolébání a doba trvání
- Rychlost od 1 do 10. Nejpomalejší a nejrychlejší vločky určují rozsah; každá vločka dostane náhodnou rychlost z tohoto rozsahu.
- Vítr. Bez větru nebo slabý či silný vítr doleva nebo doprava.
- Kolébání. Žádné, jemné, střední nebo silné kolébání vloček do stran.
- Zastavení po čase. Hodnota 0 znamená sníh bez přestávky. Jiná hodnota (do 3600 sekund) způsobí, že po tolika sekundách od otevření každé stránky se už neobjevují nové vločky a sněžení skončí s poslední vločkou.
Tlačítko pro zákazníky a přístupnost
- Tlačítko „Vypnout sníh” / „Zapnout sníh”. Malé kulaté tlačítko s ikonou vločky dole na stránce vlevo nebo vpravo. Funguje z klávesnice, má dobře viditelný rámeček fokusu a popis pro čtečky obrazovky.
- Nastavitelný odstup odspodu. Od 0 do 400 px – užitečné, když tlačítko zakrývá cookie banner, chat nebo lištu košíku.
- Zapamatovaná volba. Rozhodnutí zákazníka se uloží v jeho prohlížeči na 90 dní, takže v další sezóně se sníh vrátí. Modul k tomu neukládá cookies.
- Omezení pohybu. S volbou „Zohledňovat »omezit pohyb«” zákazníci, jejichž systém žádá o omezení animací, sníh nevidí, dokud ho nezapnou tlačítkem.
- Požadavek WCAG 2.2.2. Tlačítko umožňuje zastavit pohyb trvající déle než 5 sekund. Když ho vypnete, záhlaví panelu upozorní, že zákazníci nemohou sníh zastavit.
- Vrstva, která nepřekáží. Sníh nezachytává kliknutí, je skrytý před čtečkami obrazovky a neobjevuje se při tisku stránky.
Lehký skript, který nezatěžuje obchod
- Bez jQuery. Skript nepotřebuje jQuery, proto funguje i s motivem Hummingbird z PrestaShop 9.
- Jedna vrstva canvas. Celý sníh se vykresluje na jednom prvku nad stránkou; obsah, adresy a rozložení obchodu se nemění.
- Soubory jen tam, kde padá sníh. Když je sníh vypnutý, mimo data nebo na neoznačeném typu stránky, modul na stránku nepřidává skript, styl ani nastavení.
- Pauza na pozadí. Animace se zastaví, když karta prohlížeče není viditelná, a přizpůsobí se změně velikosti okna.
- Ostré vločky na obrazovkách s vysokou hustotou pixelů. Vrstva se vykresluje s ohledem na hustotu pixelů obrazovky (až dvojnásobnou), takže vločky zůstávají ostré.
- Bez externích služeb. Skript, styly a obrázky vloček pocházejí z adresáře modulu na serveru obchodu.
- Sníh jako dekorace. Chyba na straně modulu nepřeruší zobrazení stránky obchodu.
Konfigurační panel s živým náhledem
- Tři karty. „Kdy a kde”, „Vzhled” a „Animace”.
- Záhlaví se stavem obchodu. Říká, zda právě padá sníh, a pokud ne – proč: modul vypnutý ve správci modulů, nepřipojený k hooku displayHeader, sníh vypnutý, nejsou označené stránky, čekání na data nebo data, která už uplynula. Zobrazuje také počet vloček na počítačích a telefonech a počet označených typů stránek.
- Živý náhled. Na kartách „Vzhled” a „Animace” náhled odráží formulář ještě před uložením; lze ho zastavit a přepnout na světlé pozadí. Počet vloček je přepočítán na velikost pole náhledu.
- Jen potřebná pole. Pole dat, polohy tlačítka a tvarů se skrývají, když v daném nastavení nemají význam.
- Jasná hlášení. Chybné pole je zvýrazněné a hlášení říká, jaký rozsah nebo formát je povolený. Před přechodem na jinou kartu s neuloženými změnami se na ně panel zeptá.
- Bezpečné uložení. Nastavení změní jen pracovník s oprávněním ke konfiguraci modulu a každá hodnota se před uložením kontroluje.
Více obchodů (multistore)
- Společná nastavení, skupiny a obchod. Můžete upravovat společná nastavení pro všechny obchody, nastavení skupiny obchodů nebo jednotlivého obchodu.
- Vlastní jen to, co změníte. V obchodě nebo skupině se vlastní hodnotou stane jen změněné pole; ostatní dál přebírají nadřazená nastavení. Související nastavení – nejmenší a největší vločka, nejpomalejší a nejrychlejší vločky a data – se ukládají společně.
- Úplná informace o rozsahu. Panel uvádí, který rozsah upravujete, kolik nastavení má vlastní hodnotu a které obchody nebo skupiny mají vlastní nastavení.
- Návrat k nadřazeným nastavením. Tlačítko „Použít společná nastavení” nebo „Použít nastavení skupiny” po potvrzení odstraní vlastní hodnoty.
- Oprávnění pracovníků. Pracovník s přístupem jen k části obchodů nezmění nastavení obchodů, ke kterým nemá přístup.
- Obchody bez sněhu. Záhlaví uvádí, v kolika obchodech je modul vypnutý nebo nepřipojený, tedy tam sníh nepadá.
Aktualizace z verze 1.0.x
- Přenos nastavení. Počet vloček, vrstva (z-index), velikosti, rychlosti, krytí, barva, stín (jako záře), výběr tvaru nebo teček a nastavení zobrazování sněhu pouze na domovské stránce přecházejí do nové verze – také hodnoty nastavené pro jednotlivé obchody a skupiny.
- Pořádek po staré verzi. Stará připojení k hookům header, footer a displayFooter jsou nahrazena hookem displayHeader a soubory verze 1.0.x, které nová verze nepoužívá (včetně pluginu jQuery a vygenerovaných stylů), jsou odstraněny z adresáře modulu, pokud to oprávnění souborů dovolují.
Požadavky a kompatibilita
- PrestaShop 1.7.0–9.x a PHP 7.0–8.5.
- Motivy. Classic a Hummingbird; skript nevyžaduje jQuery.
- Bez závislostí. Bez Composeru a bez dalších knihoven.
- Bez vlastních tabulek. Nastavení se ukládají do konfigurace PrestaShopu; odinstalace je odstraní spolu s nastaveními verze 1.0.x.
- Jazyky. Panel modulu a tlačítko pro zákazníky v polštině a angličtině.
Důležité hranice fungování
- Celý sníh má jednu barvu; nejsou k dispozici vločky v několika barvách současně.
- Na výběr je osm přiložených tvarů; panel neumožňuje nahrávání vlastních obrázků vloček.
- Sníh se zapíná pro typy stránek, ne pro vybrané kategorie, produkty nebo jednotlivé stránky CMS.
- Ostatní stránky jsou jedna skupina – nelze samostatně zapnout sníh například jen ve vyhledávání.
- Čas „Zastavit po” se počítá znovu na každé otevřené stránce.
- Volba zákazníka se ukládá v jeho prohlížeči; v soukromém režimu nebo při zablokované paměti prohlížeče platí jen na aktuální stránce.
- Tablet dostane počet vloček pro počítače, když má okno šířku nad 767 px a kratší strana jeho obrazovky má více než 767 px.
- Sníh padá nad vším, co má nižší z-index; pokud zakrývá vyskakovací okno motivu nebo padá za menu, je třeba upravit hodnotu vrstvy (výchozí 9999).