Pasek Ogłoszeń i Odliczanie (dfannouncebar)

Prezentacja

Moduł dfannouncebar dodaje inteligentny pasek ogłoszeń do sklepu PrestaShop 8 lub 9: kilka rotujących komunikatów w jednym pasku, odliczanie na żywo, kierowanie po języku, kraju i grupie klientów, planowanie po datach oraz przycisk zamknięcia zapamiętywany w cookie. Dostępne są trzy umiejscowienia: góra strony, góra przyklejona (sticky) i dół przyklejony.

Instalacja

1. W panelu administracyjnym otwórz Moduły → Menedżer modułów → Zainstaluj moduł.
2. Wgraj plik dfannouncebar.zip i kliknij Zainstaluj.
3. Kliknij Konfiguruj, aby otworzyć stronę modułu.

Przy instalacji moduł tworzy nieaktywny pasek przykładowy z wielojęzycznym komunikatem (kod HELLO10 i odliczanie na D+7): włącz go, aby od razu zobaczyć rendering, a potem dostosuj lub usuń.

Konfiguracja ogólna

Strona konfiguracji zawiera jedno ustawienie globalne: hook zaczepienia umiejscowienia „góra strony”.

• displayBanner (domyślnie): standardowa pozycja nad nagłówkiem w motywie Classic.
• displayTop: rozwiązanie zapasowe, jeśli Twój motyw nie deklaruje displayBanner.

Wewnętrzne zabezpieczenie zapobiega podwójnemu wyświetlaniu, gdy motyw wykonuje oba hooki. Umiejscowienia przyklejone (góra i dół) nie zależą od tego ustawienia.

Tworzenie paska

Ze strony konfiguracji kliknij Zarządzaj paskami. Każdy pasek posiada:

• Umiejscowienie: góra strony, góra przyklejona (podąża za przewijaniem) lub dół przyklejony. Moduł automatycznie kompensuje padding strony dla pozycji przyklejonych.
• Priorytet: jeśli kilka pasków celuje w to samo umiejscowienie, wyświetla się tylko ten z najniższym priorytetem.
• Kolory: tło i tekst, stosowane przez zmienne CSS.
• Rotacja: odstęp w sekundach między dwoma komunikatami. Rotacja pauzuje przy najechaniu.
• Zamykanie: opcjonalny przycisk zamknięcia; czas życia cookie (w godzinach) określa, kiedy pasek pojawi się ponownie.
• Planowanie: data początku i data końca w formacie RRRR-MM-DD, automatycznie uzupełniane do 00:00:00 i 23:59:59.
• Sklep: w multisklepie pasek może być globalny lub ograniczony do jednego sklepu.

Komunikaty i odliczanie

Z listy pasków akcja Komunikaty otwiera komunikaty paska. Każdy komunikat jest wielojęzyczny i zawiera:

• Tekst: wyświetlana treść. Wstaw placeholder {countdown} w miejscu, gdzie ma pojawić się zegar.
• Data docelowa: cel odliczania, wyświetlanego w formacie Xd GG:MM:SS i aktualizowanego co sekundę (etykieta dni jest tłumaczona).
• Ukryj po wygaśnięciu: komunikat znika automatycznie po terminie, po stronie przeglądarki i po stronie serwera (żaden martwy HTML nie jest serwowany).
• Przycisk akcji: opcjonalna etykieta i URL, wyświetlany w stylu pigułki.
• Kolejność: pozycja komunikatu w rotacji.

Kierowanie

Każdy pasek można ograniczyć po:

• Językach: pasek wyświetla się tylko dla wybranych języków.
• Krajach: na podstawie kraju kontekstu PrestaShop; precyzja rośnie, gdy geolokalizacja IP jest włączona w Ustawienia międzynarodowe → Lokalizacja.
• Grupach klientów: odwiedzający, goście, klienci lub dowolna grupa niestandardowa (VIP, B2B itd.).

Puste pole oznacza „wszyscy”. Trzy kryteria się kumulują.

Rozwiązywanie problemów

• Pasek nie wyświetla się na górze strony: Twój motyw prawdopodobnie nie deklaruje displayBanner; przełącz hook zaczepienia na displayTop w konfiguracji.
• Pasek w ogóle się nie wyświetla: sprawdź, czy jest aktywny, czy planowanie obejmuje dzisiejszą datę, czy kierowanie pasuje do Twojego profilu testowego i czy żaden pasek z niższym priorytetem nie zajmuje tego samego umiejscowienia. Pamiętaj też o cookie zamknięcia: otwórz okno przeglądania prywatnego.
• Odliczanie się nie pojawia: upewnij się, że komunikat zawiera {countdown} i że wpisano przyszłą datę docelową.
• Na górze pojawiają się dwa paski: hook zaczepienia mógł zostać zmieniony, gdy cache strony serwował starą wersję; wyczyść cache PrestaShop.