W JTL-Shop 5 dodajesz zharmonizowaną informację dla wszystkich artykułów przez szablon potomny (Child-Template) strony szczegółów artykułu. Dla pojedynczych artykułów możesz też użyć OnPage Composera z portletem tekstowym w widoku kodu źródłowego.
Nowość od JTL-Shop 5.8: JTL-Shop ma wbudowane obie etykiety. Włączasz je w „Darstellung → Einstellungen → Global” (wygląd → ustawienia → globalne), w sekcji „Gewährleistungs- und Garantielabel”. Informację o zgodności z umową JTL pokazuje w podsumowaniu zamówienia, na stronie „Gesetzliche Gewährleistung” w stopce i jako PDF dołączony do potwierdzenia zamówienia, ale według JTL nie na stronie produktu. Do tego służy widżet. Etykietę GARAN JTL odczytuje z atrybutów funkcyjnych Wawi jtl_guarantee_manufacturer, jtl_guarantee_model_identifier i jtl_guarantee_years.
Kod dla JTL-Shop
<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 JTL-Shop
- Użyj szablonu potomnego
Zmiany należą do szablonu potomnego (w NOVA: NOVAChild), aby aktualizacje ich nie nadpisały. - Rozszerz szablon
W szablonie potomnym rozszerz szablon strony szczegółów artykułu i wstaw kod widżetu pod przyciskiem dodawania do koszyka. Obowiązuje to wtedy dla wszystkich artykułów. - Pojedynczy artykuł
Tylko dla jednego artykułu: w OnPage Composerze przeciągnij portlet tekstowy pod przycisk dodawania do koszyka i wklej kod w widoku kodu źródłowego. OnPage Composer edytuje każdą stronę osobno. - Sprawdź
Wyczyść cache lub opublikuj wersję roboczą i sprawdź na stronie artykułu.
Nazwy menu w cudzysłowie pochodzą z niemieckiej wersji panelu; w nawiasie podajemy polskie tłumaczenie.
Na co uważać w JTL-Shop
- Bez OnPage Composera (JTL-Shop 4) wstawiasz kod w szablonie strony szczegółów artykułu.
- Przy włączonej minifikacji w szablonie plik
widget.jsnie może być przetwarzany, ładuje się bezpośrednio z garantielabel.app.
Gdzie umieścić informację w JTL-Shop
Szablon NOVA buduje stronę szczegółów artykułu z productdetails/details.tpl. Blok productdetails-details-include-basket dołącza tam obszar zakupu. Sam przycisk dodawania do koszyka jest w productdetails/basket.tpl, w bloku productdetails-basket-add-to-cart. W szablonie potomnym tworzysz plik o tej samej ścieżce i uzupełniasz blok przez append lub prepend. Oryginalna treść zostaje, a obszar zakupu się nie zmienia.
Od JTL-Shop 5.8 sklep ma obie etykiety wbudowane. Włączasz je w „Darstellung → Einstellungen → Global” (wygląd → ustawienia → globalne), w sekcji „Gewährleistungs- und Garantielabel”. JTL pokazuje wtedy zharmonizowaną informację w podsumowaniu zamówienia i na stronie „Gesetzliche Gewährleistung” (rękojmia ustawowa). Tę stronę JTL automatycznie dodaje do obszaru stopki „Gesetzliche Informationen” (informacje prawne), czyli grupy linków o nazwie szablonu „Fuss”. Strony szczegółów artykułu JTL przy tej informacji nie wymienia. Tam informację uzupełnia widżet.
Artykuły podrzędne, atrybuty funkcyjne i etykieta GARAN
JTL-Wawi rozróżnia artykuły z wariacjami i artykuły podrzędne (Kindartikel, dawniej kombinacje wariacji). Wariacje bez artykułów podrzędnych nie są samodzielnymi artykułami, więc wielu ustawień nie da się zrobić dla każdej wariacji osobno. Artykuły podrzędne są natomiast osobnymi artykułami. Dziedziczą z artykułu nadrzędnego m.in. atrybuty i cechy, ale można je prowadzić jak zwykłe artykuły.
Wbudowana etykieta gwarancyjna (etykieta GARAN) odczytuje z JTL-Wawi trzy atrybuty funkcyjne: jtl_guarantee_manufacturer dla producenta, jtl_guarantee_model_identifier dla identyfikatora modelu i jtl_guarantee_years dla okresu w latach. Od JTL-Wawi 2.1 już istnieją, ale muszą być aktywne dla sklepu internetowego. Jeśli brakuje którejś z trzech wartości, sklep nie pokaże etykiety dla tego artykułu. Jeśli artykuły podrzędne mają własne identyfikatory modelu, wpisz jtl_guarantee_model_identifier przy każdym z nich.
Gdzie etykieta się pojawia, ustawiasz osobno: lista artykułów, strona szczegółów, koszyk, podsumowanie zamówienia i potwierdzenie zamówienia. Na stronie szczegółów stoi pod numerem artykułu, GTIN, kategorią i producentem. Jeśli korzystasz z wbudowanej etykiety, pomiń w widżecie data-garan-voll i data-garan-klein, inaczej etykieta pojawi się dwa razy.
Typowe pułapki w JTL-Shop
- Domyślnie wyłączone: według JTL obie etykiety są początkowo wyłączone. Po aktualizacji do 5.8 musisz je włączyć sam.
- Synchronizacja: nowe dane gwarancji pojawią się w sklepie dopiero po synchronizacji sklepu internetowego z JTL-Wawi.
- Okres gwarancji: według JTL
jtl_guarantee_yearsoznacza łączny okres od zakupu. Przy 3 latach to łącznie 3 lata, a nie 5. - Szablon potomny: nazwa folderu musi odpowiadać nazwie w
template.xml, a jako szablon nadrzędny jest tamNOVA. W szablonie potomnym są tylko zmienione pliki. Po aktywacji wyczyść cache szablonów.
Dalsze źródła
- JTL-Guide: konfiguracja etykiet w JTL-Shop (po niemiecku)
- JTL-Guide: ustawienia globalne, szczegóły (po niemiecku)
- JTL-Guide: słownik artykułów (po niemiecku)
- JTL-Guide: dane podstawowe, artykuły podrzędne (po niemiecku)
- Podręcznik programisty JTL: szablon potomny (po niemiecku)
- JTL-Shop 5.8.1: szablon NOVA productdetails/details.tpl (GitLab)
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 panelu JTL-Shop w „E-Mail-Vorlagen” (szablony e-maili). 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 JTL-Shop tak jak powyżej.
Wolisz własne pliki? Wgraj pełną i wbudowaną wersję do biblioteki mediów JTL-Shop 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 to działa z danymi z JTL-Wawi?
Tak. Jeśli przechowujesz adresy etykiet GARAN jako atrybut artykułu i w szablonie wyświetlasz je w data-garan-voll i data-garan-klein, przy każdym artykule pojawi się właściwa etykieta.
Czy potrzebuję wtyczki?
Nie. Wystarczy szablon potomny. Portlet HTML jest dostępny tylko jako wtyczka z Extension Store, ale nie jest potrzebny.
Czy aktualizacje to nadpiszą?
Nie, jeśli zmiana jest w szablonie potomnym. Treści z OnPage Composera również pozostają.
Czy JTL-Shop 5.8 sam pokazuje etykiety?
Tak, po włączeniu w „Darstellung → Einstellungen → Global”. Domyślnie obie są wyłączone. Zharmonizowana informacja pojawia się wtedy w podsumowaniu zamówienia i na stronie „Gesetzliche Gewährleistung”, a etykieta gwarancyjna w wybranych przez Ciebie miejscach.
Dlaczego przy artykule brakuje etykiety gwarancyjnej?
Najczęściej brakuje którejś z wartości jtl_guarantee_manufacturer, jtl_guarantee_model_identifier lub jtl_guarantee_years albo synchronizacja sklepu jeszcze się nie odbyła. Sprawdź też, czy atrybuty funkcyjne są aktywne dla sklepu internetowego.
Do którego bloku wstawić widżet?
Na przykład przez append do bloku productdetails-details-include-basket w productdetails/details.tpl szablonu potomnego. Stoi wtedy bezpośrednio za obszarem zakupu.