1. Do czego służy moduł
Moduł zapamiętuje cenę każdego produktu w chwili, gdy klient dodaje go do koszyka. Jeśli klient wraca po jakimś czasie, a cena w międzyczasie jest inna — bo zmieniono ją w panelu albo promocja się skończyła lub zaczęła — koszyk i strona zamówienia mówią o tym na górze strony: „Cena produktu Koszulka Hummingbird (Rozmiar: M) zmieniła się z 24,00 zł na 29,00 zł od czasu dodania go do koszyka.”. Przy produkcie widać przekreśloną poprzednią cenę.
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
- Pobierz moduł z Moje konto → Historia zamówień w sklepie addonspresta.com.
- W panelu sklepu otwórz Moduły → Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik
ap_cartpricealert_v1.0.0.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
Moduł działa od razu po instalacji: pokazuje w koszyku i w zamówieniu każdy wzrost i spadek ceny.
Jeśli masz dostęp do konsoli serwera, możesz też rozpakować plik do katalogu modules/, uruchomić
php bin/console prestashop:module install ap_cartpricealert w katalogu sklepu i wyczyścić pamięć podręczną.
3. Jak to działa
Cena odniesienia. Gdy klient dodaje produkt do koszyka, moduł zapamiętuje jego cenę jednostkową w takiej postaci, w jakiej klient ją wtedy widzi. Gdy klient zmienia ilość produktu albo dodaje lub usuwa inną jego kombinację, moduł zapamiętuje aktualną cenę na nowo dla wszystkich pozycji tego produktu, bo rabat ilościowy może zależeć od liczby sztuk w koszyku. Produkty dodane w czasie, gdy moduł był wyłączony, dostają cenę odniesienia przy najbliższej zmianie koszyka.
Co jest zmianą ceny. Na stronie koszyka i w zamówieniu moduł porównuje aktualną cenę jednostkową każdej pozycji z ceną odniesienia. Liczą się tylko zmiany po stronie sklepu: cena produktu, ceny specyficzne, reguły cenowe katalogu, promocja, która się zaczęła albo skończyła, nowa stawka podatku. Kody rabatowe, reguły koszyka i koszt dostawy nie są porównywane, a darmowe prezenty z reguł koszyka są pomijane.
Co jest pomijane. Cena, która różni się z powodu działania samego klienta, nie wywołuje komunikatu — moduł po cichu przyjmuje aktualną cenę jako nową cenę odniesienia, gdy:
- klient przełączył walutę;
- klient się zalogował (gość staje się klientem i może dostać ceny innej grupy);
- zmienił się kraj adresu, od którego liczony jest podatek (Międzynarodowe → Podatki → Bazuje na: adres dostawy albo adres do faktury; bez adresu — kraj odwiedzającego);
- klient zmienił ilość.
Jak długo widać komunikat. Komunikat pojawia się przy każdej wizycie w koszyku i w zamówieniu, dopóki klient nie zmieni ilości tego produktu (także przez dodanie lub usunięcie innej jego kombinacji), nie usunie go, nie złoży zamówienia albo dopóki cena nie wróci do ceny odniesienia. Moduł nie dodaje przycisku, który zamyka komunikat na stałe; krzyżyk, który pokazują niektóre szablony (Hummingbird), chowa go tylko do następnej strony. Po czasie ustawionym w Zapamiętuj ceny przez pozycja po cichu przyjmuje aktualną cenę jako nową cenę odniesienia.
Gdzie się pojawia. Na górze strony koszyka i strony zamówienia, w miejscu powiadomień Twojego szablonu, osobno dla każdego zmienionego produktu (przy kilku zmianach jako lista). Obok ceny jednostkowej produktu, w koszyku i w podsumowaniu zamówienia, słowo „Wcześniej” i przekreślona stara cena. Gdy klient zmienia ilość albo usuwa produkt na stronie koszyka, komunikat tego produktu znika od razu, bez przeładowania strony. Nowy komunikat pojawia się przy następnym wczytaniu strony: ceny zmieniasz w panelu, a nie wtedy, gdy klient ogląda koszyk.
Ustawienia sklepu, z którymi moduł współpracuje.
- Podatki: oba warianty są obsługiwane — podatki włączone albo wyłączone w Międzynarodowe → Podatki oraz ceny brutto albo netto dla grupy klientów (Klienci → Grupy → Metoda wyświetlania cen). Moduł porównuje cenę tak, jak widzi ją klient: brutto w grupie „Brutto”, netto w grupie „Netto”.
- Tryb katalogu (Preferencje → Produkty): gdy jest włączony, moduł nic nie pokazuje.
- Wyświetl ponownie koszyk po zalogowaniu (Preferencje → Klienci): gdy PrestaShop oddaje zalogowanemu klientowi koszyk, który zostawił wcześniej, ten koszyk zachowuje ceny odniesienia, więc zmiana ceny z tego czasu zostanie pokazana. Koszyk zapełniony przez gościa dostaje nowe ceny odniesienia, gdy gość się zaloguje.
- Kombinacje i personalizacje są obsługiwane: każda pozycja (produkt, kombinacja, personalizacja) ma własną cenę odniesienia, a komunikat podaje kombinację, np. „Koszulka (Rozmiar: M - Kolor: Biały)”.
Co moduł zapisuje. Jedną tabelę z ceną odniesienia każdej pozycji koszyka; wpis znika, gdy pozycja zostanie usunięta, po złożeniu zamówienia i po upływie czasu przechowywania. Moduł nigdy nie zmienia ceny, nie zachowuje klientowi starej ceny i nie blokuje zamówienia. 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 → Alert ceny w koszyku → Konfiguruj. Ramka Pomoc na górze strony prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu, podaje nasz adres wsparcia i pokazuje zainstalowaną wersję.
Włączony
Włącza lub wyłącza działanie modułu w sklepie bez odinstalowania. Wyłączony moduł nie zapamiętuje cen i nie pokazuje komunikatów. Domyślnie: włączony.
Pokazywane zmiany
- Wzrosty i spadki cen (domyślnie) — każda zmiana.
- Tylko wzrosty cen — gdy chcesz tylko uprzedzać klientów, że zapłacą więcej.
- Tylko spadki cen — gdy chcesz tylko informować o niższej cenie.
Minimalna zmiana
Najmniejsza zmiana, którą moduł pokazuje, w procentach starej ceny: od 0 do 100, z najwyżej dwoma miejscami po przecinku (przecinek albo kropka). Przy 0 (domyślnie) widać każdą zmianę o co najmniej jeden grosz — najmniejszą jednostkę waluty. Przy 5 koszulka, która podrożała z 20,00 zł na 20,90 zł (4,5%), nie wywoła komunikatu, a z 20,00 zł na 21,00 zł (5%) — tak.
Pokazuj w koszyku / Pokazuj w zamówieniu
Strony, na których pojawiają się komunikat i poprzednia cena: strona koszyka i strona składania zamówienia. Obie opcje są domyślnie włączone.
Komunikat na górze strony
Wstawia komunikaty w miejsce powiadomień Twojego szablonu, na górze strony koszyka i strony zamówienia. Domyślnie:
włączony. Wyłącz go, gdy sam umieszczasz komunikaty widgetem {widget name='ap_cartpricealert'} w pliku szablonu —
inaczej pojawią się dwa razy. Widget wypisuje każdy komunikat bieżącego koszyka w osobnej ramce, tam gdzie go
wstawisz; uwzględnia opcje Włączony, Pokazywane zmiany, Minimalna zmiana i treść komunikatów, ale nie
przełączniki stron opisane wyżej.
Poprzednia cena przy produkcie
Pokazuje słowo „Wcześniej” i przekreśloną starą cenę obok ceny jednostkowej zmienionego produktu, w koszyku i w podsumowaniu zamówienia. Tekst ma styl Twojego szablonu w tym miejscu. Domyślnie: włączona.
Wzrost ceny: rodzaj komunikatu / Spadek ceny: rodzaj komunikatu
Rodzaj powiadomienia dla każdego kierunku zmiany: Ostrzeżenie, Informacja, Sukces albo Błąd. Kolor komunikatu pochodzi z Twojego szablonu (w Classic np. ostrzeżenie jest żółte, a błąd czerwony). Domyślnie: Ostrzeżenie przy wzroście, Informacja przy spadku.
Komunikat przy wzroście ceny / Komunikat przy spadku ceny
Treść komunikatu w każdym języku sklepu. Domyślnie:
- wzrost: „Cena produktu {product} zmieniła się z {old_price} na {new_price} od czasu dodania go do koszyka.”
- spadek: „Dobra wiadomość: cena produktu {product} spadła z {old_price} na {new_price} od czasu dodania go do koszyka.”
W sklepie w miejsce zmiennych pojawiają się:
{product}— nazwa produktu z kombinacją, np. „Koszulka (Rozmiar: M - Kolor: Biały)”;{old_price}— cena z chwili dodania produktu;{new_price}— aktualna cena;{difference}— różnica między nimi, np. 5,00 zł;{percent}— zmiana w procentach starej ceny, zaokrąglona, np. 17%.
Ceny są w walucie klienta, brutto albo netto tak, jak widzi je grupa klienta. Słowo w nawiasach klamrowych spoza tej listy zostaje bez zmian. Komunikat to zwykły tekst: znaczniki HTML są usuwane przy zapisie. Może mieć do 500 znaków. Tekst w języku domyślnym jest wymagany; język pozostawiony pusty korzysta z niego.
Zapamiętuj ceny przez
Liczba dni, przez które moduł przechowuje cenę odniesienia, od 1 do 3650; domyślnie 90. Po tym czasie pozycja bez komunikatu przyjmuje aktualną cenę jako nową cenę odniesienia, a starsze ceny są usuwane. Porządki odbywają się raz dziennie, przy pierwszej zmianie koszyka danego dnia, więc nie trzeba ustawiać zadania cron.
Stan
Ramka pod formularzem pokazuje, ile pozycji koszyków ma zapamiętaną cenę w sklepie wybranym w nagłówku panelu.
5. Multistore
Ustawienia zapisują się dla sklepu lub grupy sklepów wybranej w nagłówku panelu. Wybierz Wszystkie sklepy, żeby ustawić te same wartości wszędzie, albo jeden sklep, żeby nadać mu własne komunikaty, strony i progi. W kontekście wszystkich sklepów albo grupy zapisać może tylko pracownik, który zarządza każdym jej sklepem. Każdy koszyk przechowuje ceny odniesienia w swoim sklepie, a ramka Stan liczy pozycje sklepów wybranych w nagłówku. Jedna licencja obejmuje wszystkie sklepy instalacji.
6. Odinstalowanie
Menedżer modułów → Alert ceny w koszyku → Odinstaluj usuwa ustawienia, komunikaty i tabelę zapamiętanych cen. Żeby je zachować, użyj opcji Wyłącz.
7. Najczęstsze pytania i problemy
Cena została zmieniona, ale w koszyku nie ma komunikatu. Sprawdź po kolei:
- Cena odniesienia powstaje przy dodaniu produktu albo zmianie jego ilości (także przez dodanie lub usunięcie innej kombinacji). Produkt dodany po zmianie ceny albo z ilością zmienioną od tego czasu ma już nową cenę jako cenę odniesienia.
- Opcje Włączony, Pokazuj w koszyku lub Pokazuj w zamówieniu oraz Komunikat na górze strony muszą być włączone.
- Zmiana musi wynosić co najmniej tyle, ile Minimalna zmiana, i mieć kierunek dozwolony w Pokazywane zmiany.
- Zmiana waluty, zalogowanie albo wybór adresu w innym kraju dają nową cenę odniesienia bez komunikatu.
- Tryb katalogu musi być wyłączony.
- Twój szablon musi wyświetlać powiadomienia na górze koszyka. Jeśli tego nie robi, użyj widgetu (niżej).
Komunikat zniknął po zalogowaniu klienta. Koszyk zapełniony przez gościa dostaje przy logowaniu nowe ceny odniesienia, bo zalogowany klient może mieć inne ceny (grupa klientów, kraj). Koszyk, który klient zapełnił jako zalogowany i odzyskuje przy kolejnym logowaniu (Wyświetl ponownie koszyk po zalogowaniu), zachowuje ceny odniesienia i pokazuje komunikat.
Mój szablon nie ma powiadomień na górze koszyka.
Wstaw {widget name='ap_cartpricealert'} w pliku szablonu w miejscu, gdzie mają się pojawiać komunikaty, np. nad
listą produktów w koszyku, i wyłącz Komunikat na górze strony.
Komunikaty pojawiają się dwa razy. Działają jednocześnie widget i Komunikat na górze strony. Wyłącz Komunikat na górze strony albo usuń widget.
Czy moduł zmienia ceny albo blokuje zamówienia? Nie. Moduł tylko informuje klienta. Koszyk liczy aktualną cenę, a klient zawsze może złożyć zamówienie.
Jak klient może pozbyć się komunikatu? Zmieniając ilość produktu, dodając lub usuwając inną jego kombinację, usuwając produkt albo składając zamówienie. Komunikat znika też, gdy przywrócisz poprzednią cenę.
Jakiś tekst w polskim sklepie jest nadal po angielsku. Uzupełnij oba komunikaty dla tego języka w konfiguracji modułu. Słowo „Wcześniej” przy starej cenie tłumaczysz w Międzynarodowe → Tłumaczenia → Tłumaczenie zainstalowanych modułów.
Czy mogę zmienić wygląd komunikatu?
Tak. Skopiuj views/templates/front/notification.tpl, views/templates/hook/was.tpl albo
views/templates/widget/alerts.tpl do themes/<twój-szablon>/modules/ap_cartpricealert/ z zachowaniem podkatalogów
i zmień kopię albo dodaj w szablonie style dla klas .ap-cartpricealert__message i .ap-cartpricealert__was. Moduł
nie dodaje własnych stylów.
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 rok 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.
Moduł możesz zwrócić w ciągu 30 dni od zamówienia, zgodnie z Polityką sprzedaży i licencji w addonspresta.com. Kod modułu przechodzi nasz audyt bezpieczeństwa wspierany przez AI.