# 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…

- Strona: <https://www.datafirefly.com/pl/documentation/dfannouncebar/>
- Język: pl
- Zaktualizowano: 2026-07-30
- Inne języki: [fr](https://www.datafirefly.com/documentation/dfannouncebar/index.md), [en](https://www.datafirefly.com/en/documentation/dfannouncebar/index.md), [es](https://www.datafirefly.com/es/documentation/dfannouncebar/index.md), [de](https://www.datafirefly.com/de/documentation/dfannouncebar/index.md), [it](https://www.datafirefly.com/it/documentation/dfannouncebar/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfannouncebar/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfannouncebar/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

## 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ń.

Żadnych zależności: bez Composera, bez jQuery. Pliki JS i CSS modułu ładują się na froncie tylko wtedy, gdy co najmniej jeden pasek jest aktywny.

## 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.

Przykład: „Letnia wyprzedaż: -20% z kodem HELLO10, koniec za {countdown}". Jeśli wszystkie komunikaty paska wygasną, pasek sam się wycofuje.

## 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.