Kalendarz adwentowy – instrukcja obsługi modułu PrestaShop

1. Co robi ten moduł

Moduł dodaje do sklepu stronę kalendarza z ponumerowanymi okienkami — po jednym na każdy dzień akcji. Za każdym okienkiem umieszczasz ofertę, która już istnieje w sklepie: kod kuponu, produkt z rabatem albo własną wiadomość z linkiem. Okienko otwiera się w swoim dniu; przyszłe okienka pozostają zamknięte; wcześniejsze zostają otwarte albo wygasają — jak zdecydujesz. Odliczanie podpowiada klientom, kiedy otworzy się kolejne okienko, a baner na stronie głównej prowadzi ich do kalendarza w czasie akcji i kilka dni wcześniej.

Oferty to Twoje własne reguły koszyka i produkty, więc kalendarz zawsze mówi prawdę: wyłącz regułę koszyka, a okienko poinformuje, że oferta jest niedostępna; zmień cenę, a okienko z produktem pokaże nową. Moduł nie tworzy kuponów ani cen i niczego nie zmienia w koszyku.

Klasyczny kalendarz adwentowy trwa od 1 do 24 grudnia, ale pierwszy dzień i liczbę dni ustalasz sam: dwanaście dni do świąt, tydzień styczniowych okazji, odliczanie do urodzin sklepu.

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

2. Instalacja

1. Pobierz moduł z Moje konto → Historia zamówień w addonspresta.com.
2. W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
3. Przeciągnij plik ap_adventcalendar_v1.0.0.zip i poczekaj na potwierdzenie.
4. Kliknij Konfiguruj na karcie modułu.

Zaraz po instalacji strona kalendarza działa pod adresem /advent-calendar w każdym języku sklepu (na przykład twojsklep.pl/pl/advent-calendar), z 24 okienkami od 1 grudnia i bez ofert.

3. Jak to działa

Przygotuj oferty w PrestaShop. Kupon tworzysz w Katalog → Rabaty → Reguły koszyka: kliknij Dodaj nową regułę koszyka, wpisz nazwę, kod, który klienci wpiszą w koszyku (na przykład DZIEN5), daty ważności, warunki i działanie (procent, kwota, darmowa dostawa albo prezent), i zapisz. Promocję na produkt ustawiasz jako cenę specyficzną w Katalog → Produkty, w zakładce Ceny produktu, z datami promocji. Za okienkiem można umieścić tylko regułę koszyka z kodem — reguły bez kodu klient nie użyje.

Dodaj okienka. Na stronie konfiguracji modułu kliknij przycisk + nad listą okienek, wybierz dzień i rodzaj oferty, wskaż regułę koszyka albo wpisz ID produktu, dodaj tytuł i tekst, jeśli chcesz, i zapisz. Jedno okienko na dzień; dni bez okienka pokazują „Dziś brak oferty”.

Co widzą klienci. Okienko n otwiera się o północy dnia (pierwszy dzień + n − 1) w czasie sklepu (Międzynarodowy → Lokalizacja) i do końca tego dnia jest oznaczone Dziś, a jego oferta jest na stronie rozwinięta. Wcześniejsze okienka otwierają się kliknięciem (albo informują, że oferta się zakończyła, gdy minione dni nie zostają otwarte). Przyszłe okienka mają kłódkę i datę otwarcia; ich treść w ogóle nie trafia do przeglądarki, więc nikt nie podejrzy. Odliczanie pokazuje, kiedy otworzy się następne okienko; gdy dojdzie do zera, strona sama się odświeży w ciągu kilku sekund.

• Okienko z kuponem pokazuje nazwę reguły koszyka, co daje (na przykład „−10% · Darmowa dostawa”), kod z przyciskiem Kopiuj kod, datę końca reguły, Twój tekst i opcjonalny przycisk z linkiem. Gdy reguła jest wyłączona, jeszcze nieważna, przeterminowana albo wyczerpana, okienko informuje, że oferta jest niedostępna, zamiast pokazywać martwy kod.
• Okienko z produktem pokazuje kartę produktu z Twojego motywu — zdjęcie, nazwę, cenę z przekreśloną starą ceną, przycisk dodania do koszyka, jeśli motyw go ma — z Twoim tytułem nad nią i tekstem pod nią.
• Okienko z tekstem pokazuje Twój tytuł, tekst i opcjonalny przycisk z linkiem, na przykład do kategorii albo wpisu na blogu.

Przed i po. Przed pierwszym dniem strona pokazuje nazwę kalendarza, Twój tekst i odliczanie do pierwszego okienka, a wszystkie okienka są zamknięte. Po ostatnim dniu strona pokazuje tekst na zakończenie; okienka zostają takie jak w ostatnim dniu. Strona zachowuje adres przez cały rok, więc linki i pozycja w wyszukiwarce przechodzą na kolejny kalendarz: za rok zmieniasz tylko pierwszy dzień i okienka.

Baner na stronie głównej. Od wybranej liczby dni przed pierwszym dniem do końca ostatniego baner na stronie głównej pokazuje nazwę kalendarza, Twój tekst, tytuł dzisiejszej oferty, odliczanie i przycisk do strony.

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

4. Funkcje i ustawienia

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

Stan

Ramka nad ustawieniami mówi, na jakim etapie jest kalendarz (przed pierwszym dniem, który to dzień i ile zostało do następnego okienka, albo zakończony), ile okienek ma ofertę i jaka jest dzisiejsza oferta. Ostrzega o dniach bez okienka, o ofertach, z których klienci teraz nie skorzystają (wyłączona, przeterminowana lub wyczerpana reguła koszyka, wyłączony lub brakujący produkt), o wyłączonych regułach koszyka w sklepie i o zakończonym kalendarzu. Zobacz stronę kalendarza otwiera ją w nowej karcie, a Reguły koszyka prowadzi do kuponów.

Kalendarz

• Nazwa kalendarza — tytuł strony i banera, na przykład „Kalendarz adwentowy”. Wymagana w domyślnym języku.
• Pierwszy dzień — dzień okienka 1, na przykład 2026-12-01. Okienka otwierają się o północy czasu sklepu.
• Liczba dni — od 1 do 31; 24 dla klasycznego kalendarza adwentowego.
• Minione dni zostają otwarte — tak: klienci mogą otworzyć każde okienko do dziś; nie: ofertę ma tylko dzisiejsze okienko, a wcześniejsze informują, że oferta się zakończyła. O ważności kuponu i tak decyduje jego reguła koszyka.
• Tekst nad okienkami — wyświetlany przed kalendarzem i w jego trakcie, na przykład „Każdego dnia otwiera się nowe okienko. Wróć jutro po kolejną ofertę!”
• Tekst po ostatnim dniu — zastępuje tekst nad okienkami po zakończeniu kalendarza.

Ze wszystkich tekstów usuwane są znaczniki HTML; podziały wierszy zostają.

Strona kalendarza

• Adres strony — końcówka adresu w każdym języku, na przykład kalendarz-adwentowy: małe litery, cyfry i myślniki, na początku litera. Adres zajęty przez inną stronę sklepu jest odrzucany. Tę samą stronę znajdziesz w Preferencje → Ruch i SEO.
• Tytuł strony (meta title) i Meta opis — to, co pokazuje karta przeglądarki i wyniki wyszukiwania.

Promocja w sklepie

• Baner na stronie głównej — nazwa kalendarza, Twój tekst, dzisiejsza oferta, odliczanie i przycisk do strony. Przy instalacji baner trafia na pierwsze miejsce strony głównej; przesuniesz go w Wygląd → Pozycje (hook displayHome).
• Pokaż baner przed pierwszym dniem — ile dni przed pierwszym dniem baner się pojawia, na przykład 7. 0 pokazuje go dopiero od pierwszego dnia. Znika po ostatnim dniu.
• Tekst banera na stronie głównej — na przykład „Nowa oferta każdego dnia aż do świąt. Otwórz dzisiejsze okienko!”
• Etykieta przycisku — na przykład „Otwórz kalendarz”. Wymagana w domyślnym języku.
• Kolor okienek i Kolor tekstu okienek — kolory szesnastkowe, na przykład #1f3a2e i #ffffff. Strona ostrzega, gdy oba kolory są razem słabo czytelne.
• Kolor akcentu — kolor oznaczenia dzisiejszego okienka, odliczania, ramki kodu i przycisków, na przykład #c8102e. Zostaw puste, aby zachować kolory motywu. Tekst przycisku jest czarny albo biały, zależnie od tego, co lepiej czytelne.

Okienka

Lista na dole pokazuje każde okienko z dniem i datą, rodzajem, ofertą (reguła koszyka z kodem, produkt z ID albo tytuł), sklepem w multistore i stanem. Kliknij przycisk +, aby dodać okienko, Edytuj, aby je zmienić, ikonę stanu, aby je wyłączyć lub włączyć, Usuń, aby je usunąć.

W formularzu okienka:

• Dzień — dzień kalendarza z datą; jedno okienko na dzień.
• Rodzaj oferty — Kupon, Produkt albo Własny tekst i link. Pola poniżej zależą od rodzaju.
• Reguła koszyka — jedna z Twoich reguł koszyka z kodem, nieprzypisanych do jednego klienta i dostępnych w sklepie okienka, od najnowszej (wyłączone są oznaczone). Okienko pokaże nazwę reguły, co daje, jej kod i datę końca.
• ID produktu — ID z Katalog → Produkty. Okienko pokaże kartę produktu z aktualną ceną.
• Tytuł — opcjonalny; puste = nazwa reguły koszyka, nazwa produktu albo „Dzień N”.
• Tekst — opcjonalny, kilka linii, na przykład warunki kuponu („Minimalna wartość zamówienia 200 zł”).
• Link i Etykieta przycisku — opcjonalny przycisk pod ofertą (okienka z kuponem i tekstem): pełny adres (https://…) albo ścieżka w sklepie (/pl/12-kategoria); domyślna etykieta to „Kup teraz”.
• Włączone — wyłączone okienko liczy się jak dzień bez oferty.

5. Multistore

Ustawienia zapisują się dla sklepu wybranego w nagłówku panelu. Okienka dodane przy wybranym Wszystkie sklepy należą do każdego sklepu; okienka dodane przy wybranym jednym sklepie należą do niego i mają pierwszeństwo przed okienkiem dla wszystkich sklepów w tym samym dniu. Reguły koszyka i produkty są te, które ma dany sklep. Jedna licencja obejmuje każdy sklep instalacji.

6. Odinstalowanie

Menedżer modułów → Kalendarz adwentowy → Odinstaluj usuwa ustawienia modułu, jego okienka i stronę kalendarza. Reguły koszyka i produkty pozostają nietknięte. Aby zachować okienka na przyszły rok, użyj Wyłącz.

7. FAQ i rozwiązywanie problemów

Okienko pokazuje „Ta oferta jest niedostępna”. Jego reguła koszyka jest wyłączona, poza datami ważności albo wyczerpana, albo produkt jest wyłączony lub niewidoczny w sklepie. Ramka Stan wymienia takie dni. Sprawdź regułę w Katalog → Rabaty → Reguły koszyka (stan, daty, ilość) albo produkt w Katalog → Produkty.

Kod nie działa w koszyku. Sprawdź warunki reguły koszyka (minimalna kwota, grupa klientów, produkty, przewoźnicy, liczba użyć na klienta) i czy reguły koszyka są w sklepie włączone (ramka Stan ostrzega, gdy nie są). Moduł tylko pokazuje kod; stosuje go PrestaShop.

Okienko otwiera się o złej porze. Okienka otwierają się o północy w strefie czasowej sklepu z Międzynarodowy → Lokalizacja. Sprawdź strefę czasową i pierwszy dzień.

Chcę, żeby dzisiejsza oferta była niespodzianką do kliknięcia. Dzisiejsze okienko jest na stronie rozwinięte, żeby oferta była widoczna od razu, także dla wyszukiwarek. Jeśli wolisz zamknięte okienko, nadpisz szablon views/templates/front/calendar.tpl w swoim motywie (patrz niżej).

Czy w każdym sklepie może być inny kalendarz? Tak: wybierz sklep w nagłówku panelu, zanim zapiszesz ustawienia i dodasz okienka.

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 kalendarza (Zobacz stronę kalendarza w ramce Stan).

Czy mogę zmienić wygląd okienek? Tak. Użyj ustawień kolorów, dodaj w motywie CSS dla klas .ap-adventcalendar albo skopiuj szablony z views/templates/ modułu do themes/<twoj-motyw>/modules/ap_adventcalendar/views/templates/ i edytuj kopie.

8. Aktualizacje i wsparcie

Aktualizacje są bezpłatne dożywotnio: pobierz nową wersję z Moje konto → Historia zamówień w addonspresta.com i załaduj ją jak nowy moduł. Ustawienia i okienka zostają.

Wsparcie jest w cenie przez 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 CET; 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