Pasek ogłoszeń – instrukcja obsługi modułu PrestaShop

1. Do czego służy moduł

Moduł dodaje nad nagłówkiem sklepu wąski pasek na promocje i ważne informacje: „Darmowa dostawa w ten weekend”, „Zamówienia złożone dziś wyślemy w poniedziałek”, „Black Friday −20% — Zobacz ofertę”. Możesz prowadzić do trzech komunikatów naraz, każdy we wszystkich językach sklepu, z własnymi kolorami, opcjonalnym linkiem oraz własną datą początku i końca. Gdy aktywnych jest kilka komunikatów, pasek pokazuje je po kolei. Klient może zamknąć pasek, a ten pozostaje ukryty przez wybraną przez Ciebie liczbę dni.

Działa z PrestaShop 1.7.8, 8.x i 9.x (PHP 7.2.5 lub nowszy), z szablonami Classic i Hummingbird oraz z trybem multistore.

2. Instalacja

1. Pobierz moduł z Moje konto → Historia zamówień w sklepie addonspresta.com.
2. W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
3. Upuść plik ap_announcementbar_v1.0.1.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Zaraz po instalacji paska jeszcze nie widać: wszystkie trzy komunikaty są wyłączone, dopóki nie wpiszesz i nie włączysz pierwszego z nich.

3. Jak to działa

Pasek trafia do haka displayBanner, który szablon Classic (PrestaShop 1.7.8, 8 i 9) i szablon Hummingbird (PrestaShop 9) wyświetlają na samej górze każdej strony, nad nagłówkiem. Classic pomija ten hak w uproszczonym nagłówku zamówienia, więc na stronie składania zamówienia w Classic paska nie ma. Pasek korzysta z czcionek Twojego szablonu, a kolory bierze z ustawień komunikatu.

Przy każdym wyświetleniu strony sklep sprawdza, które komunikaty są włączone i mieszczą się w swoich datach. Daty są liczone w strefie czasowej sklepu ustawionej w Międzynarodowy → Lokalizacja. Komunikat bez treści w języku klienta jest w tym języku pomijany. Jeśli żaden komunikat nie jest aktywny, paska w ogóle nie ma na stronie.

Gdy aktywny jest jeden komunikat, pasek po prostu go pokazuje. Przy dwóch lub trzech pokazuje każdy przez ustawioną liczbę sekund, bez żadnej animacji. Zmiana zatrzymuje się, gdy na pasku jest kursor myszy albo fokus klawiatury. Małe strzałki pozwalają przechodzić między komunikatami; klienci, którzy w systemie ograniczyli ruch na ekranie, nie mają automatycznej zmiany i korzystają ze strzałek.

Gdy klient zamknie pasek, jego przeglądarka zapamiętuje to (w pamięci lokalnej, bez plików cookie) na ustawioną liczbę dni. Zapamiętanie dotyczy bieżących komunikatów: po zmianie komunikatu pasek wraca u wszystkich klientów.

Moduł nie zmienia tabel PrestaShop, nie zapisuje plików cookie i nie łączy się z addonspresta.com ani z żadnym innym serwerem.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Pasek ogłoszeń → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu. Pod nią komunikaty podpowiadają, kiedy pasek jest ukryty, kiedy komunikat czeka na swój start albo już się zakończył i kiedy kolor tekstu słabo odcina się od tła.

Komunikat 1, 2 i 3

• Pokazuj ten komunikat — włącza lub wyłącza komunikat bez utraty jego treści.
• Treść — zwykły tekst, do 200 znaków, w każdym języku. Gdy komunikat jest włączony, treść w języku domyślnym jest wymagana. Jeśli zostawisz pole puste w innym języku, w tej wersji językowej komunikat się nie pojawi.
• Adres linku — opcjonalny. Pełny adres zaczynający się od https:// albo strona Twojego sklepu zaczynająca się od /, np. /pl/content/1-dostawa. Inne rodzaje linków są odrzucane.
• Tekst linku — opcjonalny, np. „Zobacz ofertę”. Gdy go wpiszesz, link pojawia się za treścią. Bez niego linkiem staje się cały komunikat.
• Kolor tła i Kolor tekstu — kolory szesnastkowe, np. #111111 i #ffffff (wartości domyślne). Panel ostrzeże Cię, gdy kontrast spadnie poniżej 4,5:1, czyli minimum wygodnego czytania.
• Początek i Koniec — opcjonalna data i godzina w strefie czasowej sklepu, np. 2026-11-27 08:00. Data końca bez godziny oznacza koniec tego dnia. Puste pola oznaczają, że komunikat jest widoczny, dopóki jest włączony.

Działanie paska

• Zmiana komunikatu co — jak długo każdy komunikat jest widoczny przed następnym, od 2 do 60 sekund (domyślnie 5).
• Klient może zamknąć pasek — dodaje przycisk zamykania.
• Po zamknięciu ukryty przez — liczba dni, przez które pasek pozostaje ukryty w tej przeglądarce (domyślnie 7). Wartość 0 ukrywa go tylko do zamknięcia przeglądarki.
• Gdzie pokazywać — wszystkie strony albo tylko strona główna.

5. Multistore

Ustawienia zapisują się dla sklepu lub grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, żeby ustawić te same komunikaty wszędzie, albo jeden sklep, żeby dać mu własne komunikaty, kolory i daty. Klient, który zamknie pasek w jednym sklepie, nadal widzi go w pozostałych. W kontekście wszystkich sklepów albo grupy zapisać może tylko pracownik, który zarządza każdym jej sklepem. Jedna licencja obejmuje wszystkie sklepy instalacji.

6. Odinstalowanie

Menedżer modułów → Pasek ogłoszeń → Odinstaluj usuwa pasek i wszystkie jego ustawienia oraz komunikaty. Żeby je zachować, użyj opcji Wyłącz.

7. Najczęstsze pytania i problemy

Pasek się nie wyświetla. Sprawdź podpowiedzi na górze strony konfiguracji: przynajmniej jeden komunikat musi być włączony, mieć treść w języku klienta i mieścić się w swoich datach. Jeśli wybrałeś Tylko strona główna, zajrzyj na stronę główną. Jeśli sam zamknąłeś pasek, otwórz sklep w oknie prywatnym. Potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.

Komunikat pojawia się za wcześnie albo za późno. Daty są liczone według strefy czasowej sklepu z Międzynarodowy → Lokalizacja → Konfiguracja, a nie według zegara Twojego komputera. Jeśli sklep korzysta z pamięci podręcznej całych stron (np. Varnish albo moduł cache), pasek zmienia się dopiero po jej odświeżeniu.

Zmieniłem treść, a klient, który zamknął pasek, nadal go nie widzi. Pasek wraca, gdy strona pokaże nową treść. Jeśli używasz pamięci podręcznej całych stron, wyczyść ją.

W moim szablonie pasek nie jest na górze strony. Pasek korzysta z haka displayBanner. Niektóre szablony go nie wyświetlają albo umieszczają w innym miejscu; wtedy twórca szablonu może dodać {hook h='displayBanner'} na początku szablonu nagłówka.

Czy mogę zmienić wygląd paska? Tak. Skopiuj views/templates/hook/bar.tpl do themes/<twój-szablon>/modules/ap_announcementbar/views/templates/hook/ i zmień kopię, a potem wyczyść pamięć podręczną (Zaawansowane > Wydajność > Wyczyść pamięć podręczną). Możesz też dodać w szablonie style dla klas .ap-announcementbar.

8. Aktualizacje i wsparcie

Aktualizacje są bezpłatne dożywotnio: nowe wersje pobierasz z Moje konto → Historia zamówień w addonspresta.com i wgrywasz tak samo jak nowy moduł. Ustawienia zostają zachowane.

Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy na addonspresta.com (od poniedziałku do piątku, 10:00–16:00; odpowiadamy zwykle w ciągu 2 dni roboczych). Podaj wersję PrestaShop, wersję modułu i kroki, które prowadzą do problemu.

Wróć do: Instrukcje modułów