W PrestaShop dodajesz zharmonizowaną informację przez szablon strony produktu w motywie potomnym albo przez moduł, który wyświetla HTML w hooku dodatkowych informacji o produkcie.
Kod dla PrestaShop
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Więcej opcji, takich jak forma wyświetlania i język, ustawisz w kreatorze kodu.
Krok po kroku w PrestaShop
- Użyj motywu potomnego
Zmiany w motywie należą do motywu potomnego (child theme), aby aktualizacje ich nie nadpisały. - Wybierz miejsce
Wtemplates/catalog/product.tplznajdź obszar pod przyciskiem dodawania do koszyka. - Wklej kod
Wklej tam kod widżetu. Alternatywnie użyj modułu bloku HTML z marketplace’u Addons w hookudisplayProductAdditionalInfo. - Wyczyść cache
W Parametry zaawansowane → Wydajność wyczyść cache i sprawdź.
Nazwy menu, których polskich odpowiedników nie mogliśmy potwierdzić, podajemy w cudzysłowie w brzmieniu z niemieckiej wersji panelu, z odpowiednikiem angielskim w nawiasie.
Na co uważać w PrestaShop
- Smarty interpretuje nawiasy klamrowe. Kod widżetu ich nie zawiera, więc możesz go wkleić bezpośrednio.
- Przy opcji „Inteligentna pamięć podręczna dla JavaScript” w ustawieniach wydajności zewnętrzny skrypt pozostaje poza łączeniem plików.
Gdzie umieścić informację w PrestaShop
PrestaShop umieszcza treści przez hooki. Według dokumentacji dla programistów te trzy znajdują się w motywach Classic i Hummingbird w następujących miejscach:
displayProductAdditionalInfo(„Product page additional info”) jest wcatalog/_partials/product-additional-info.tpl. W motywie Classicproduct.tpldołącza ten plik bezpośrednio po obszarze dodawania do koszyka. To miejsce na informację na stronie produktu.displayReassurancejest wcatalog/product.tpl, ale też wcheckout/cart.tplicheckout/checkout.tpl. Moduł w tym hooku pojawi się więc na stronie produktu, w koszyku i przy składaniu zamówienia.displayFooterjest w_partials/footer.tpl, więc pojawia się na wszystkich stronach.
Moduł podpinasz do hooka w „Design → Positionen” (ang. Design → Positions) przyciskiem w prawym górnym rogu (ang. „Transplant a module”). Do stopki jest też moduł „Link list” (ang. Design → Link Widget). Linkuje on strony z „Design → Seiten” (ang. Design → Pages) w blokach linków, a w motywie Classic bloki są w stopce. Własna strona z widżetem pojawi się więc jako link w stopce.
Kombinacje, marka i identyfikator modelu
Warianty nazywają się w PrestaShop kombinacjami. Przy tworzeniu wybierasz typ „Product with combinations” (nazwa z angielskiej wersji panelu), a wtedy pojawia się zakładka „Combinations”. Każda kombinacja ma własne referencje: referencję oraz ISBN, EAN i UPC. Według dokumentacji webservice każda kombinacja ma też własne pole MPN.
Marka należy natomiast do produktu. Według PrestaShop produkt ma dokładnie jedną markę, zarządzaną w „Marken & Lieferanten” (ang. Brands & Suppliers). Wszystkie kombinacje mają więc tę samą markę. MPN w zakładce „Details” to jednoznaczna referencja producenta. Czy odpowiada identyfikatorowi modelu na etykiecie GARAN, wynika z informacji producenta.
Etykieta GARAN podaje markę i identyfikator modelu, więc jedna etykieta przypada na jeden identyfikator modelu. Widżet pokazuje jedną etykietę GARAN na znacznik i nie zmienia się z wybraną kombinacją. Jeśli kombinacje mają różne identyfikatory modelu, utwórz te modele jako osobne produkty, każdy z własną etykietą.
Typowe pułapki w PrestaShop
- Cache szablonów: jeśli w Parametry zaawansowane → Wydajność ustawiono, by nigdy nie kompilować szablonów ponownie, sklep pokaże zmiany w motywie dopiero po wyczyszczeniu cache.
- Motyw potomny: w
config/theme.ymlpodparentstoi nazwa folderu motywu nadrzędnego, a nie jego nazwa wyświetlana. Własnenamemusi odpowiadać nazwie własnego folderu. - Inne motywy: powyższe miejsca hooków dotyczą Classic i Hummingbird. Inny motyw może wyświetlać hooki gdzie indziej albo wcale. Sprawdź w „Design → Positionen”, jakie hooki pokazuje Twój motyw.
- Moduł bez metody: według dokumentacji dla programistów moduł w hooku, dla którego nie ma odpowiedniej metody, niczego nie wyświetli.
Dalsze źródła
- Dokumentacja dla programistów PrestaShop: List of hooks (po angielsku)
- Motyw Classic PrestaShop: catalog/product.tpl (GitHub)
- Dokumentacja dla programistów PrestaShop: Displaying content on the front office (po angielsku)
- Dokumentacja PrestaShop: Link Widget (po angielsku)
- Dokumentacja PrestaShop: Managing products (po angielsku)
- Dokumentacja dla programistów PrestaShop: zasób webservice Combinations (po angielsku)
- Dokumentacja PrestaShop: Performance (po angielsku)
- Dokumentacja dla programistów PrestaShop: Creating a child theme (po angielsku)
Zharmonizowana informacja w potwierdzeniu zamówienia
Według wytycznych Komisji informacja powinna znaleźć się także w e-mailu z potwierdzeniem. Szablony e-maili edytujesz w „International → Übersetzungen” lub „Design → E-Mail-Theme” (ang. International → Translations, Design → Email Theme). W potwierdzeniu zamówienia możesz dodać urzędową grafikę jako obraz. Sam link prawdopodobnie nie wystarczy jako trwały nośnik (TSUE, sprawa C-49/11); najbezpieczniej umieścić informację bezpośrednio w wiadomości jako obraz, tekst lub załącznik. Urzędowe pliki znajdziesz na stronie pobierania.
Gwarancja producenta? Wtedy potrzebna jest też etykieta GARAN
Jeśli producent daje bezpłatną gwarancję trwałości na okres dłuższy niż dwa lata, obejmującą cały towar, na stronie produktu musi się znaleźć także etykieta GARAN. W generatorze etykiety GARAN utworzysz ją w kilka sekund z liczby lat, marki i modelu, pierwsze trzy etykiety za darmo i bez rejestracji. Pod każdą gotową etykietą znajdziesz kod do osadzenia ze stałymi adresami obrazów: niczego nie przesyłasz, a kod wstawiasz w PrestaShop tak jak powyżej.
Wolisz własne pliki? Wgraj pełną i wbudowaną wersję do biblioteki mediów PrestaShop i wpisz adresy w kodzie widżetu:
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-wbudowana.svg"></div>Widżet pokaże wtedy wersję wbudowaną pod zharmonizowaną informacją, a kliknięcie otworzy pełną etykietę GARAN.
Najczęstsze pytania
Czy istnieje gotowy moduł?
Własny moduł nie jest potrzebny. Wystarczy szablon w motywie potomnym, alternatywnie moduł bloku HTML z marketplace’u Addons.
Czy to działa w PrestaShop 1.7, 8 i 9?
Tak, we wszystkich trzech wersjach w ten sam sposób.
Czy muszę czyścić cache?
Tak, po zmianach w szablonie.
Który hook pokazuje informację także w koszyku?
displayReassurance. W Classic i Hummingbird jest na stronie produktu, w koszyku i przy składaniu zamówienia.
Czy każda kombinacja ma własny identyfikator modelu?
Każda kombinacja ma własne referencje (referencja, ISBN, EAN, UPC, a według dokumentacji webservice także MPN). Marka obowiązuje natomiast dla całego produktu.
Jak umieścić informację w stopce?
Modułem w hooku displayFooter albo jako link: utwórz w „Design → Seiten” stronę z widżetem i podlinkuj ją w stopce modułem „Link list”.