Strona Black Friday – instrukcja obsługi modułu PrestaShop

1. Do czego służy moduł

Moduł daje sklepowi jedną stronę ze wszystkimi promocjami: każdym produktem, który klient może kupić taniej, od największego rabatu, pod banerem z nazwą Twojej akcji i odliczaniem. Przed akcją strona odlicza czas do startu i zachęca do dodania daty do kalendarza, w trakcie odlicza czas do końca, a po zakończeniu dziękuje klientom i czeka pod tym samym adresem na następną akcję.

Baner na stronie głównej i link w nagłówku prowadzą klientów na stronę w trakcie akcji i kilka dni wcześniej.

Rabaty to te, które już ustawiasz w PrestaShop, więc strona jest zawsze aktualna: zmienisz cenę albo zakończysz promocję — strona zmieni się razem z nimi. Nazwę akcji też wybierasz sam: Black Friday, Cyber Monday, wyprzedaż świąteczna albo letnia. Bez dat strona po prostu pokazuje bieżące promocje przez cały rok.

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_blackfriday_v1.0.1.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Zaraz po instalacji strona promocji działa pod adresem /black-friday w każdym języku sklepu (na przykład twojsklep.pl/pl/black-friday) — bez dat, z Twoimi bieżącymi promocjami.

3. Jak to działa

Utwórz rabaty w PrestaShop. Najszybciej, gdy akcja obejmuje cały sklep, zrobisz to regułą cenową katalogu: otwórz Katalog → Rabaty → Reguły cenowe katalogu, kliknij Dodaj nową regułę cenową katalogu, wpisz nazwę, obniżkę (na przykład 20 %), daty „Od” i „Do” akcji i zapisz. Warunkami (kategoria, marka) ograniczysz rabat do części katalogu, a cenę specyficzną pojedynczego produktu ustawisz w Katalog → Produkty, w zakładce Ceny. Każda obniżka z przekreśloną starą ceną pojawia się na stronie promocji.

Ustaw w module daty akcji. Od nich zależy, co pokazują strona i banery:

• Przed startem — baner odlicza czas do startu („Start za 3 d 04:12:09”), pokazuje Twój tekst i przycisk Dodaj do kalendarza; strona nie pokazuje produktów albo — jeśli tak wybierzesz — bieżące promocje.
• W trakcie akcji — baner odlicza czas do końca, a strona pokazuje promocje.
• Po zakończeniu — strona pokazuje tekst na zakończenie (albo nadal bieżące promocje, jeśli tak wybierzesz); baner na stronie głównej i link w nagłówku znikają.

Gdy odliczanie dojdzie do zera, a klient jest na stronie, strona sama się odświeży (w ciągu kilku sekund) i pokaże kolejny etap. Na stronie głównej baner zmienia „Start za” na „Koniec za” bez odświeżania. Daty wpisujesz w strefie czasowej sklepu (Międzynarodowe → Lokalizacja).

Które produkty są na liście. Strona pokazuje każdy produkt tak, jak widzi go klient — z jego grupą, krajem, walutą i sposobem wyświetlania podatku — więc rabat tylko dla zarejestrowanych klientów zobaczą tylko oni. Produkt trafia na listę, gdy jest aktywny, widoczny w katalogu, ma widoczną cenę, leży w kategorii, którą klient może oglądać, a jego domyślna kombinacja ma obniżkę przy zakupie jednej sztuki. Rabaty ilościowe (od 2 sztuk) i obniżki tylko innej kombinacji nie trafiają na listę, bo produkt nie pokazałby na niej przekreślonej ceny. Nie trafiają na nią też ceny ustawione dla jednego, konkretnego klienta.

Żeby strona działała szybko także w dniu największego ruchu, moduł liczy listę raz dla każdego rodzaju klienta (grupa, kraj, waluta, język) i trzyma ją najwyżej 3 minuty. Zmieniona cena pojawi się więc na stronie w ciągu 3 minut — od razu, jeśli wyczyścisz pamięć podręczną w Zaawansowane → Wydajność albo zapiszesz ustawienia modułu. Strona porównuje najwyżej 5000 przecenionych produktów.

Strona wygląda jak kategoria w Twoim szablonie: te same kafelki produktów, etykiety rabatów, sortowanie i strony. Produkty są ułożone od największego rabatu; klient może je też posortować według „Kończące się wkrótce”, ceny i nazwy.

Moduł nie tworzy i nie zmienia cen, nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem.

4. Funkcje i ustawienia

Otwórz Moduły → Menedżer modułów → Strona Black Friday → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.

Stan

Ramka nad ustawieniami pokazuje etap akcji (zawsze włączona, przed akcją, trwa albo zakończona — z pozostałym czasem) i liczbę produktów, które niezalogowany klient widzi teraz na stronie, razem z największym rabatem. Ostrzega, gdy w trakcie akcji strona jest pusta, gdy ceny w sklepie są ukryte i gdy akcja już się skończyła. Link Zobacz stronę promocji otwiera ją w nowej karcie.

Akcja

• Nazwa akcji — tytuł banera i linku w nagłówku, na przykład „Black Friday”. Wymagana w języku domyślnym.
• Początek i Koniec — czas trwania akcji, na przykład 2026-11-27 00:00 i 2026-11-30 23:59. Koniec wpisany bez godziny oznacza koniec tego dnia. Zostaw obie daty puste, jeśli strona ma działać cały czas.
• Tekst przed startem — wyświetlany z odliczaniem do startu, na przykład „Największa wyprzedaż roku już wkrótce. Zapisz datę!”
• Tekst w trakcie akcji — wyświetlany nad promocjami, na przykład „Oszczędzaj do {max_discount} — największe rabaty na górze.” Znacznik {max_discount} zamienia się w największy rabat na stronie dla danego klienta (na przykład 50%), a {end_date} w datę końca.
• Tekst po zakończeniu — wyświetlany, gdy akcja już się skończyła.

Jeśli tekst używa {max_discount} albo {end_date}, a wartości nie ma (jeszcze brak promocji, brak daty końca), tekst się nie wyświetla — zamiast urwanego zdania. Ze wszystkich tekstów usuwane są znaczniki HTML; podziały wierszy zostają.

Strona promocji

• Adres strony — końcówka adresu strony w każdym języku, na przykład black-friday: małe litery, cyfry i myślniki, na początku litera. Adresu, którego używa już inna strona sklepu, nie da się zapisać. Tę samą stronę znajdziesz w Preferencje → Ruch.
• Tytuł strony (meta title) i Opis meta — to, co pokazują karta przeglądarki i wyniki wyszukiwania.
• Minimalny rabat — tylko produkty przecenione co najmniej o tyle procent, na przykład 10. 0 pokazuje wszystkie przecenione produkty.
• Tylko te kategorie — zaznacz kategorie, aby pokazać tylko ich produkty i produkty ich podkategorii. Bez zaznaczenia — cały katalog.
• Ukryj produkty, których nie można zamówić — pomija produkty niedostępne do zamówienia i produkty bez stanu, które nie przyjmują zamówień (domyślnie włączone).
• Przed akcją pokazuj — tylko baner albo baner i bieżące promocje.
• Po akcji pokazuj — tylko baner (z tekstem po zakończeniu) albo baner i bieżące promocje.
• Maksymalna liczba produktów — od 20 do 1000 (domyślnie 300); zostają produkty z największym rabatem.

Liczba produktów na stronie listy działa jak w kategoriach — według ustawień sklepu i wyboru klienta.

Promocja w sklepie

• Baner na stronie głównej — nazwa akcji, odliczanie, tekst banera i przycisk do strony promocji. Przy instalacji baner trafia na pierwsze miejsce strony głównej; możesz go przesunąć w Wygląd → Pozycje (hook displayHome).
• Pokazuj baner i link przed startem — ile dni przed startem pojawiają się baner na stronie głównej i link w nagłówku, na przykład 7. 0 — dopiero od startu. Oba znikają po zakończeniu akcji.
• Tekst banera na stronie głównej — wyświetlany w trakcie akcji, na przykład „Rabaty do {max_discount}. Wszystkie promocje na jednej stronie.” Przed startem baner pokazuje tekst przed startem.
• Tekst przycisku — na przykład „Zobacz promocje”. Wymagany w języku domyślnym.
• Link w nagłówku — nazwa akcji jako link do strony promocji, u góry każdej strony.
• Kolor tła banera i Kolor tekstu banera — kolory szesnastkowe, na przykład #111111 i #ffffff. Panel ostrzeże, gdy oba kolory będą słabo czytelne razem.
• Kolor akcentu — kolor odliczania, przycisków i linku w nagłówku, na przykład #ff0069. Zostaw puste, aby zachować kolory szablonu. Tekst na przycisku jest czarny albo biały — ten, który lepiej widać na kolorze akcentu.

5. Multistore

Ustawienia zapisują się dla sklepu albo grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, aby akcja była wszędzie taka sama, albo jeden sklep, aby nadać mu własne daty, teksty, adres i kolory. Rabaty są te, które każdy sklep ma ustawione w PrestaShop. Jedna licencja obejmuje wszystkie sklepy instalacji.

6. Odinstalowanie

Menedżer modułów → Strona Black Friday → Odinstaluj usuwa ustawienia modułu i stronę promocji. Twoich rabatów nie zmienia. Jeśli chcesz zachować ustawienia na przyszły rok, użyj Wyłącz.

7. Pytania i rozwiązywanie problemów

Strona promocji jest pusta. Spójrz na ramkę Stan: pokazuje, ile produktów widzi niezalogowany klient. Jeśli żadnego, sprawdź, czy reguła cenowa katalogu albo cena specyficzna działa teraz (daty „Od” i „Do”), obejmuje wszystkich klientów, kraje i waluty (albo te, z którymi testujesz), zaczyna się od 1 sztuki i czy produkt pokazuje przekreśloną starą cenę. Potem sprawdź minimalny rabat i wybrane kategorie.

Produkt jest przeceniony, ale nie ma go na liście. Może nie mieć stanu i nie przyjmować zamówień (wyłącz Ukryj produkty, których nie można zamówić, żeby go pokazać), jego obniżka może dotyczyć tylko innej niż domyślna kombinacji, zaczynać się od 2 sztuk albo być ustawiona dla jednego klienta, albo produkt może być ukryty w katalogu.

Zmieniłem cenę, a strona pokazuje jeszcze starą. Strona trzyma listę najwyżej 3 minuty. Odczekaj chwilę albo wyczyść pamięć podręczną w Zaawansowane → Wydajność.

Klienci widzą inne produkty niż ja. Strona powstaje osobno dla każdej grupy klientów, kraju i waluty: rabat dla jednej grupy, kraju albo waluty widzą tylko ci klienci. Wyloguj się, żeby zobaczyć stronę jak nowy gość.

Strona pokazuje zły etap albo zły czas. Daty są czytane w strefie czasowej sklepu z Międzynarodowe → Lokalizacja. Sprawdź strefę czasową i daty w sekcji Akcja.

Gdzie znajdę adres strony do newslettera? Kliknij Zobacz stronę promocji w ramce Stan; adres jest ten sam przy każdej akcji.

Czy mogę dodać stronę do menu głównego? Tak: w Moduły → Menedżer modułów → Menu główne → Konfiguruj dodaj własny link z adresem strony promocji.

Czy mogę zmienić wygląd banera? Tak. Użyj ustawień kolorów, dodaj do szablonu CSS dla klas .ap-blackfriday albo skopiuj szablony z katalogu views/templates/ modułu do themes/<twój-szablon>/modules/ap_blackfriday/views/templates/ i edytuj kopie.

8. Aktualizacje i wsparcie

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

Wsparcie obejmuje 12 miesięcy od zamówienia: napisz na mail@addonspresta.com albo przez formularz kontaktowy w 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