W Magento 2 lub Adobe Commerce tworzysz blok CMS z kodem widżetu i umieszczasz go przez instancję widgetu Magento na wszystkich stronach produktów.
Kod dla Magento / Adobe Commerce
<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 Magento / Adobe Commerce
- Utwórz blok CMS
W Content → Blocks utwórz nowy blok i wklej kod widżetu. Od wersji 2.4.3 otwiera się Page Builder, użyj tam elementu „HTML Code”. - Utwórz widget
W Content → Widgets utwórz widget typu „CMS Static Block” dla swojego motywu. - Umieść
Jako Layout Update wybierz „All Product Types” i wskaż kontener „Product View Extra Hint”. Znajduje się on pod przyciskiem dodawania do koszyka. - Wyczyść cache
Zapisz, wyczyść cache i sprawdź na stronie produktu.
Nazwy menu podajemy w wersji angielskiej, tak jak w panelu.
Na co uważać w Magento / Adobe Commerce
- Przy aktywnej Content Security Policy (moduł Magento_Csp) domena
www.garantielabel.appmusi trafić na białą listę dla skryptów, obrazów i połączeń. - Łączenie (bundling) i minifikacja JavaScriptu nie powinny obejmować zewnętrznego skryptu.
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 Marketing → Email Templates. W szablonie „New Order” 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, za darmo i bez rejestracji. Pod gotową etykietą znajdziesz kod do osadzenia ze stałymi adresami obrazów: niczego nie przesyłasz, a kod wstawiasz w Magento / Adobe Commerce tak jak powyżej.
Wolisz własne pliki? Wgraj pełną i wbudowaną wersję do biblioteki mediów Magento / Adobe Commerce 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 można to zrobić przez Layout XML?
Tak. Programiści dołączają blok przez Layout XML w catalog_product_view.xml.
Czy to działa z Hyvä?
Tak. Widżet nie zależy od RequireJS ani Knockout i działa też w motywach Hyvä.
Czy muszę czyścić cache?
Tak, po utworzeniu widgetu, w przeciwnym razie blok pojawi się dopiero później.