1. Do czego służy moduł
Moduł dodaje do produktów Twoje własne etykiety — „Bestseller”, „Ostatnie sztuki”, „Darmowa dostawa”, „Polski produkt” — tuż obok etykiet „Nowy” i „Wyprzedaż” z szablonu. Każda etykieta ma tekst w każdym języku i własne kolory, a reguła decyduje, które produkty ją dostaną: wszystkie, z wybranych kategorii, wybranych marek, z przedziału cenowego, z niskim stanem magazynowym albo z listy ID. Etykieta może zaczynać się i kończyć w podanym terminie, a kolejność ustalasz sam.
Etykiety pojawiają się wszędzie tam, gdzie szablon pokazuje swoje: na listach produktów, w wynikach wyszukiwania, na karcie produktu i w szybkim podglądzie.
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_productlabels_v1.0.1.zipi poczekaj na potwierdzenie. - Kliknij Konfiguruj na karcie modułu.
3. Jak to działa
PrestaShop przygotowuje dla każdego produktu listę oznaczeń, które szablon wyświetla na zdjęciu: „Nowy”, „Wyprzedaż!”, rabat, „Pakiet” i inne. Moduł dopisuje Twoje etykiety na końcu tej listy, w kolejności z listy etykiet. Szablon pokazuje je dokładnie tak jak swoje — w tym samym miejscu, tą samą czcionką i w tym samym kształcie — a moduł ustawia tylko wybrane przez Ciebie kolory. Jeśli zostawisz kolory puste, etykieta wygląda jak pozostałe etykiety szablonu.
Produkt dostaje każdą aktywną etykietę, której regułę spełnia i której daty obejmują bieżącą chwilę:
- Wszystkie produkty — każdy produkt.
- Produkty z kategorii — produkty przypisane do co najmniej jednej z zaznaczonych kategorii. Liczy się każda kategoria zaznaczona na karcie produktu, nie tylko kategoria główna.
- Produkty marek — produkty zaznaczonych marek.
- Produkty w przedziale cenowym — cena, którą widzi klient, z podatkiem i rabatami, porównywana w walucie domyślnej sklepu i zaokrąglona tak jak wyświetlana cena (do grosza). Klienci płacący w innej walucie widzą etykiety na tych samych produktach.
- Produkty z niskim stanem magazynowym — produkty, których zostało od 1 do podanej liczby sztuk. Produkty niedostępne nie dostają etykiety. Reguła wymaga włączonego zarządzania stanami w Preferencje → Produkty; gdy jest wyłączone, etykieta nie pojawi się na żadnym produkcie. Na listach produktów liczy się stan kombinacji pokazanej na liście (domyślnej), a na karcie produktu — stan wybranej kombinacji.
- Wybrane produkty — produkty o podanych ID.
Daty są liczone według czasu sklepu (strefa czasowa z Międzynarodowe → Lokalizacja). Niektóre moduły, np. polecane produkty albo bestsellery na stronie głównej, trzymają swoje bloki produktów w pamięci podręcznej PrestaShop. Moduł czyści ją przy każdym zapisaniu, włączeniu, wyłączeniu, przesunięciu i usunięciu etykiety, w chwili, gdy etykieta zaczyna albo przestaje się wyświetlać, a także przy włączeniu, wyłączeniu i odinstalowaniu modułu, więc te bloki też pokazują zmianę. Moduł nie zmienia tabel PrestaShop i nie łączy się z addonspresta.com ani z żadnym innym serwerem.
Wymagania. Moduł działa z każdym szablonem, który wyświetla oznaczenia produktów PrestaShop, tak jak Classic i Hummingbird. Jeśli szablon nie pokazuje etykiet „Nowy” i „Wyprzedaż”, nie pokaże też tych etykiet.
4. Funkcje i ustawienia
Otwórz Moduły → Menedżer modułów → Etykiety i plakietki produktów → Konfiguruj. Ramka Pomoc na górze prowadzi do tej instrukcji i do strony modułu w addonspresta.com, w języku Twojego panelu.
Lista etykiet
Każdy wiersz pokazuje etykietę w jej kolorach, regułę, daty i status. Kliknięcie statusu włącza albo wyłącza etykietę. Strzałki w kolumnie Pozycja przesuwają etykietę w górę lub w dół — w tej kolejności etykiety pojawiają się na produktach. Edytuj otwiera etykietę, Usuń kasuje ją po potwierdzeniu. Dodaj etykietę otwiera pusty formularz.
Tekst
Najwyżej 32 znaki w każdym języku. Wystarczy wypełnić język domyślny — puste języki dostaną ten sam tekst. Znaki
< i > nie są dozwolone.
Kolor tła i kolor tekstu
Kolory szesnastkowe, np. #e4002b i #ffffff. Puste pole zachowuje kolor etykiet szablonu.
Pokazuj na
Reguła etykiety. Pod nią pojawiają się pola wybranej reguły:
- Kategorie — zaznacz kategorie w drzewie.
- Marki — zaznacz marki. Marki dodasz w Katalog → Marki i dostawcy.
- Cena od / Cena do — w walucie domyślnej, z podatkiem. Wypełnij jedno pole albo oba; puste pole oznacza brak ograniczenia z tej strony.
- Najwyżej sztuk w magazynie — np. 3 pokazuje „Ostatnie sztuki”, gdy zostały 1, 2 albo 3 sztuki.
- ID produktów — ID z Katalog → Produkty, oddzielone przecinkami:
12, 15, 18.
Pokazuj od / Pokazuj do
Opcjonalna data i godzina rozpoczęcia i zakończenia. Etykieta na Black Friday może zacząć się w piątek o północy i skończyć w poniedziałek wieczorem. Godziny ustawiasz z dokładnością do minuty. Przy etykietach po terminie lista pokazuje „Zakończona …”.
Aktywna
Wyłącza etykietę bez jej usuwania.
Ukryj etykiety szablonu: Nowy, Wyprzedaż i rabat
W sekcji Opcje pod listą. Po włączeniu na produktach widać tylko Twoje etykiety oraz etykiety szablonu Pakiet, Tylko online i braku w magazynie. Domyślnie wyłączone.
5. Multistore
Każda etykieta ma pole Sklepy — zaznacz sklepy, w których ma się wyświetlać. Lista pokazuje etykiety sklepu albo grupy sklepów wybranej w nagłówku panelu; wybierz Wszystkie sklepy, żeby zobaczyć wszystkie. Kolejność etykiet jest wspólna dla wszystkich sklepów: strzałka stawia etykietę obok sąsiadki w wybranym sklepie, a pozostałe etykiety zachowują swoją kolejność wszędzie. Opcja ukrywania etykiet szablonu zapisuje się dla wybranego sklepu lub grupy, więc każdy sklep może mieć własne ustawienie. 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.
Pracownik z dostępem tylko do części sklepów widzi etykiety swoich sklepów i może zaznaczyć wyłącznie swoje sklepy. Etykiety, której używa też sklep spoza jego dostępu, nie zmieni ani nie usunie — zmiana objęłaby również tamten sklep, więc może to zrobić tylko pracownik z dostępem do wszystkich sklepów etykiety.
6. Odinstalowanie
Menedżer modułów → Etykiety i plakietki produktów → Odinstaluj usuwa wszystkie etykiety i ustawienia modułu. Żeby zachować etykiety, użyj Wyłącz.
7. Najczęstsze pytania i problemy
Etykieta się nie pojawia. Sprawdź, czy etykieta jest aktywna, czy jej daty obejmują bieżący czas sklepu i czy produkt spełnia regułę. Przy regule niskiego stanu zarządzanie stanami musi być włączone. Potem wyczyść pamięć podręczną w Zaawansowane → Wydajność.
Etykieta się pojawia, ale bez moich kolorów.
Sprawdź, czy kolory mają postać szesnastkową, np. #e4002b. Szablon z bardzo szczegółowymi stylami etykiet może
wymagać dopisania kolorów w jego arkuszu stylów: użyj klasy ap-productlabels- z ID etykiety na końcu.
Mój szablon w ogóle nie pokazuje etykiety.
Szablon nie wyświetla oznaczeń produktów PrestaShop. Poproś jego autora o dodanie standardowego pliku
catalog/_partials/product-flags.tpl do miniatur produktów i karty produktu.
Czy mogę zmienić wygląd etykiet?
Tak. Każda etykieta ma własną klasę ap-productlabels-<ID>; dopisz do niej style w szablonie, np. zaokrąglone
rogi.
Reguła cenowa oznacza produkt o innej cenie, niż się spodziewam. Reguła używa ceny z podatkiem i rabatami, przeliczonej na walutę domyślną, nawet jeśli sklep pokazuje ceny netto. Podatek zależy od klienta: PrestaShop bierze kraj z adresu dostawy, a zanim klient poda adres — kraj domyślny albo kraj odgadnięty z języka przeglądarki (Międzynarodowe → Lokalizacja). Gość z kraju bez podatku jest więc porównywany z ceną bez podatku, czyli z tą, którą widzi.
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ł. Etykiety i 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.