Магазинний візок
Для чого призначений модуль
- Зимове та святкове оформлення магазину без роботи дизайнера. Ефект падаючого снігу з’являється поверх наявної теми — без змін у файлах теми та без підготовки додаткової графіки.
- Сезон, який вмикається сам. Ви один раз задаєте перший і останній день снігу, а з опцією «Щороку» сніг повертається в наступних сезонах без повторного налаштування.
- Сніг там, де він доречний. Ви обираєте типи сторінок, на яких він падає. Кошик і замовлення за замовчуванням вимкнені, тому анімація не супроводжує клієнта під час оплати, доки ви самі цього не зміните.
- Повага до клієнта. Кнопка в куті сторінки вимикає та вмикає сніг, а модуль враховує системне налаштування «зменшити рух».
- Окреме налаштування для телефонів. На малому екрані ви можете показувати менше сніжинок або повністю вимкнути там сніг.
Коли падає сніг: перемикач, дати та сезон щороку
- Головний перемикач «Показувати сніг». Коли він вимкнений, модуль нічого не додає до сторінок магазину.
- Діапазон дат «Лише між датами». Поля «Перший день» і «Останній день» обираються з календаря; сніг падає також в останній день діапазону. Поза діапазоном модуль нічого не додає до сторінок.
- Сезон «Щороку». Рік у датах ігнорується, а сніг повертається в кожному сезоні, також коли діапазон охоплює межу року — наприклад, з 1 грудня до 6 січня.
- Одноразовий діапазон. Без опції «Щороку» сніг падає лише в зазначений період. Коли дати вже минули, панель повідомляє про це та просить вказати нові дати або вимкнути діапазон.
- Дата магазину. Те, чи сьогодні день зі снігом, визначає поточна дата магазину.
- Дати, описані словами. У заголовку панелі діапазон подано словами, наприклад «Щороку з 1 грудня до 6 січня», а поза сезоном з’являється інформація, коли сніг почне падати.
На яких сторінках магазину падає сніг
- Шість типів сторінок для вибору. Головна сторінка, сторінки категорій, сторінки товарів, сторінки CMS, кошик і замовлення та інші сторінки.
- Інші сторінки. Це все, що не входить до списку, наприклад пошук, контакти, обліковий запис клієнта, виробники та сторінки інших модулів (також сторінка модуля, назва якої нагадує сторінку магазину, наприклад категорія блогу).
- Кошик і замовлення. Охоплюють кошик, процес оформлення замовлення, підтвердження замовлення, сторінки платіжних модулів, а також сторінки оформлення замовлення модулів, у контролері яких у назві є слово «checkout», наприклад односторінкові checkout.
- Налаштування за замовчуванням. Після встановлення сніг падає на всіх типах сторінок, крім кошика та замовлення.
Вигляд сніжинок: форми, крапки, колір і сяйво
- Три стилі снігу. Форми сніжинок, круглі крапки або форми й крапки разом.
- Вісім форм сніжинок. Ви обираєте одну або кілька; кожна сніжинка випадково отримує одну з позначених форм.
- Один колір для всього снігу. Колір у форматі #RRGGBB забарвлює крапки та форми (за замовчуванням світло-блакитний #b9cde4).
- Непрозорість від 10 до 100. Від ледь помітного снігу до повної непрозорості.
- Розмір від 2 до 80 px. Кожна сніжинка отримує випадковий розмір між найменшим і найбільшим.
- Делікатне сяйво. Допомагає білому снігу виділятися на світлій сторінці.
- Обертання форм. Форми сніжинок повільно обертаються під час падіння.
- Ефект глибини. Більші сніжинки падають трохи швидше й виглядають чіткіше, ніби вони ближче.
Кількість сніжинок на комп’ютерах і телефонах
- Комп’ютери та планшети. Від 1 до 400 сніжинок одночасно (за замовчуванням 80).
- Телефони. Окрема кількість від 0 до 400 (за замовчуванням 30); значення 0 вимикає сніг на телефонах і приховує там кнопку для клієнтів.
- Телефони, повернуті горизонтально. За телефон модуль вважає вікно шириною до 767 px або сенсорний екран, коротша сторона якого має до 767 px, тому телефон, повернутий горизонтально, і далі отримує кількість сніжинок для телефонів.
Рух снігу: швидкість, вітер, похитування та тривалість
- Швидкість від 1 до 10. Найповільніші та найшвидші сніжинки визначають діапазон; кожна сніжинка отримує випадкову швидкість із цього діапазону.
- Вітер. Без вітру або слабкий чи сильний вітер ліворуч або праворуч.
- Похитування. Відсутнє, легке, середнє або сильне похитування сніжинок у боки.
- Зупинка через певний час. Значення 0 означає безперервний сніг. Інше значення (до 3600 секунд) означає, що через стільки секунд після відкриття кожної сторінки нові сніжинки більше не з’являються, а сніг закінчується разом з останньою сніжинкою.
Кнопка для клієнтів і доступність
- Кнопка «Вимкнути сніг» / «Увімкнути сніг». Маленька кругла кнопка з іконкою сніжинки, внизу сторінки ліворуч або праворуч. Працює з клавіатури, має чітку рамку фокуса та опис для зчитувачів екрана.
- Регульований відступ знизу. Від 0 до 400 px — корисно, коли кнопка закриває банер cookies, чат або панель кошика.
- Запам’ятаний вибір. Рішення клієнта зберігається в його браузері на 90 днів, тому наступного сезону сніг повертається. Модуль не використовує для цього cookies.
- Зменшення руху. З опцією «Враховувати »зменшити рух«» клієнти, система яких просить обмежити анімацію, не бачать снігу, доки не ввімкнуть його кнопкою.
- Вимога WCAG 2.2.2. Кнопка дає змогу зупинити рух, що триває довше ніж 5 секунд. Якщо ви її вимкнете, заголовок панелі попереджає, що клієнти не можуть зупинити сніг.
- Шар, який не заважає. Сніг не перехоплює кліки, прихований від зчитувачів екрана і не потрапляє на друк сторінки.
Легкий скрипт, який не навантажує магазин
- Без jQuery. Скрипт не потребує jQuery, тому працює також із темою Hummingbird у PrestaShop 9.
- Один шар canvas. Увесь сніг малюється на одному елементі над сторінкою; вміст, адреси та макет магазину не змінюються.
- Файли лише там, де падає сніг. Коли сніг вимкнений, поза датами або на непозначеному типі сторінки, модуль не додає до сторінки скрипт, стиль чи налаштування.
- Пауза у фоні. Анімація зупиняється, коли вкладка браузера невидима, і підлаштовується до зміни розміру вікна.
- Чіткі сніжинки на екранах із високою щільністю пікселів. Шар малюється з урахуванням щільності пікселів екрана (до двократної), тому сніжинки залишаються чіткими.
- Без зовнішніх сервісів. Скрипт, стилі та зображення сніжинок походять із каталогу модуля на сервері магазину.
- Сніг як декорація. Помилка на боці модуля не перериває відображення сторінки магазину.
Панель налаштування з попереднім переглядом у реальному часі
- Три вкладки. «Коли і де», «Вигляд» і «Анімація».
- Заголовок зі станом магазину. Повідомляє, чи сніг зараз падає, а якщо ні — чому: модуль вимкнений у менеджері модулів, не підключений до hook displayHeader, сніг вимкнений, немає позначених сторінок, очікування дат або дати, які вже минули. Також показує кількість сніжинок на комп’ютерах і телефонах та кількість позначених типів сторінок.
- Попередній перегляд у реальному часі. На вкладках «Вигляд» і «Анімація» попередній перегляд відображає форму ще до збереження; його можна зупинити та перемкнути на світле тло. Кількість сніжинок масштабується до розміру поля попереднього перегляду.
- Лише потрібні поля. Поля дат, розташування кнопки та форм приховуються, коли в поточному налаштуванні вони не мають значення.
- Зрозумілі повідомлення. Помилкове поле підсвічується, а повідомлення вказує, який діапазон або формат дозволений. Перед переходом на іншу вкладку з незбереженими змінами панель запитує про це.
- Безпечне збереження. Налаштування може змінити лише працівник із правом на налаштування модуля, а кожне значення перевіряється перед збереженням.
Мультимагазин (multistore)
- Спільні налаштування, групи та магазину. Ви можете редагувати спільні налаштування для всіх магазинів, налаштування групи магазинів або окремого магазину.
- Власним стає лише те, що ви зміните. У магазині або групі власним значенням стає лише змінене поле; решта й далі наслідує батьківські налаштування. Пов’язані налаштування — найменша й найбільша сніжинка, найповільніші й найшвидші сніжинки, а також дати — зберігаються разом.
- Повна інформація про діапазон. Панель показує, який діапазон ви редагуєте, скільки налаштувань мають власне значення і які магазини або групи мають власні налаштування.
- Повернення до батьківських налаштувань. Кнопка «Використати спільні налаштування» або «Використати налаштування групи» видаляє власні значення після підтвердження.
- Права працівників. Працівник із доступом лише до частини магазинів не змінить налаштування магазинів, до яких не має доступу.
- Магазини без снігу. Заголовок показує, у скількох магазинах модуль вимкнений або не підключений, тобто там сніг не падає.
Оновлення з версії 1.0.x
- Перенесення налаштувань. Кількість сніжинок, шар (z-index), розміри, швидкості, непрозорість, колір, тінь (як сяйво), вибір форми або крапок, а також налаштування показу снігу лише на головній сторінці переходять до нової версії — також значення, встановлені для окремих магазинів і груп.
- Порядок після старої версії. Старі підключення до hook header, footer і displayFooter замінюються hook displayHeader, а файли версії 1.0.x, які нова версія не використовує (зокрема плагін jQuery і згенеровані стилі), видаляються з каталогу модуля, якщо це дозволяють права доступу до файлів.
Вимоги та сумісність
- PrestaShop 1.7.0–9.x і PHP 7.0–8.5.
- Теми. Classic і Hummingbird; скрипт не потребує jQuery.
- Без залежностей. Без Composer і без додаткових бібліотек.
- Без власних таблиць. Налаштування зберігаються в конфігурації PrestaShop; деінсталяція їх видаляє, разом із налаштуваннями версії 1.0.x.
- Мови. Панель модуля та кнопка для клієнтів польською й англійською.
Важливі межі роботи
- Увесь сніг має один колір; немає сніжинок у кількох кольорах одночасно.
- На вибір є вісім доданих форм; панель не має завантаження власних зображень сніжинок.
- Сніг вмикається для типів сторінок, а не для вибраних категорій, товарів чи окремих сторінок CMS.
- Інші сторінки — це одна група; не можна окремо ввімкнути сніг, наприклад, лише в пошуку.
- Час «Зупинити через» відраховується заново на кожній відкритій сторінці.
- Вибір клієнта зберігається в його браузері; у приватному режимі або при заблокованій пам’яті браузера він діє лише на поточній сторінці.
- Планшет отримує кількість сніжинок для комп’ютерів, коли вікно має понад 767 px завширшки, а коротша сторона його екрана — понад 767 px.
- Сніг падає над усім, що має нижчий z-index; якщо він закриває спливне вікно теми або падає за меню, потрібно підібрати значення шару (за замовчуванням 9999).