W Shopware 6 umieszczasz znacznik widżetu w układzie strony produktu za pomocą „Erlebniswelten” (ang. Shopping Experiences). Skrypt ładujesz przez motyw lub wtyczkę do własnych skryptów, bo od Shopware 6.5 edytor usuwa skrypty z elementów tekstowych.
Nowość od Shopware 6.7.14 (oraz 6.6.10.24): Shopware ma wbudowaną etykietę GARAN. Okres gwarancji wpisujesz przy produkcie, a marka i identyfikator modelu pochodzą z producenta i numeru produktu producenta. Widżet dodaje informację o zgodności z umową na stronie produktu. Pomiń wtedy data-garan-* w widżecie, aby etykieta GARAN nie pojawiła się dwa razy. Szczegóły poniżej w części „Warianty i identyfikator modelu”.
Kod dla Shopware 6
<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 Shopware 6
- Otwórz „Erlebniswelt”
W panelu administracyjnym w „Inhalte → Erlebniswelten” (ang. Content → Shopping Experiences) otwórz układ stron produktów albo utwórz nowy typu „Produktseite” (ang. Product page). - Wstaw znacznik
Pod obszarem zakupu wstaw blok z elementem tekstowym, przełącz na widok kodu źródłowego i wstaw<div data-garantielabel></div>. - Załaduj skrypt
Linię zwidget.jsdołącz przez motyw (np. wbase.html.twig) lub wtyczkę do własnych skryptów, potem zapisz układ i przypisz go do produktów. - Alternatywa w motywie
Programiści rozszerzają we własnym motywie szablon obszaru zakupu (buy-widget.html.twig) o znacznik i dołączają skrypt w nagłówku szablonu.
Nazwy menu w cudzysłowie pochodzą z niemieckiej wersji panelu; w nawiasie podajemy odpowiednik z wersji angielskiej.
Na co uważać w Shopware 6
- Shopware od wersji 6.5 filtruje skrypty w elemencie tekstowym (HTML sanitizer). Wyłączyć to można tylko w sklepach hostowanych samodzielnie; w Shopware Cloud pozostaje droga przez motyw lub wtyczkę.
- Przy własnej polityce Content Security Policy domena
www.garantielabel.appmusi być dozwolona dla skryptów, obrazów i połączeń.
Gdzie umieścić informację w Shopware 6
W Shopware strona produktu to „Erlebniswelt” (ang. Shopping Experience) typu „Produktseite” (ang. Product page). Domyślnie zawiera Buybox z galerią zdjęć i opis produktu. Dostępne są też elementy takie jak „Produktname & Hersteller-Logo” (nazwa produktu i logo producenta) oraz Cross Selling. Układ przypisujesz w produkcie w zakładce „Layout”. Jako domyślny dla nowych stron produktu ustawisz go na pasku bocznym w „Layout-Zuweisung → Standardlayouts” (ang. Layout assignment → Default layouts).
W motywie Buybox pochodzi z szablonu buy-widget.html.twig, w Shopware 6.7 w storefront/component/buy-widget/. Własne szablony tworzysz we wtyczce lub motywie w Resources/views z tą samą strukturą folderów i rozszerzasz oryginał przez sw_extends.
Do stopki wybierz w ustawieniach kanału sprzedaży „Einstiegspunkt für die Footer-Navigation” (ang. Entry point footer navigation). W standardowym motywie poziom niżej daje nagłówki, a kolejny poziom linki. Programiści zamiast tego rozszerzają szablon layout/footer/footer.html.twig i wstawiają tam widżet z data-darstellung="link".
Warianty, numer produktu producenta i etykieta GARAN
Warianty tworzysz w produkcie w zakładce „Varianten” (ang. Variants) generatorem wariantów. Najpierw potrzebne są właściwości w „Produkte → Eigenschaften” (ang. Products → Properties). Warianty dziedziczą z produktu głównego m.in. nazwę i opis. Ikoną łańcucha wyłączasz dziedziczenie dla wariantu.
Od Shopware 6.7.14 i 6.6.10.24 Shopware sam pokazuje etykietę GARAN. W produkcie jest karta „Garantie (GARAN Label)” z czasem trwania gwarancji producenta w miesiącach (od 30 do 600, co 6) i przełącznikiem „Label in der Storefront anzeigen” (ang. Show label in Storefront). Marka pochodzi z pola „Hersteller” (ang. Manufacturer), identyfikator modelu z „Hersteller-Produktnummer” (ang. Manufacturer product number) w zakładce „Allgemein” (ang. General). Jeśli czegoś brakuje, Shopware nie pokaże etykiety. Według Shopware pola gwarancji uzupełnia się w produkcie głównym i można je nadpisać dla wariantu. Jeśli warianty mają własne identyfikatory modelu, wpisz numer produktu producenta dla każdego wariantu.
Etykieta GARAN pojawia się wtedy pod Buyboxem, w koszyku, na stronie potwierdzenia zamówienia i w e-mailu z potwierdzeniem. Link do zharmonizowanej informacji Shopware umieszcza na stronie potwierdzenia zamówienia, przy tekście regulaminu. Wyświetlania na stronie produktu Shopware nie opisuje: tam i w stopce informację uzupełnia widżet. Jeśli sklep korzysta z wbudowanej etykiety GARAN, pomiń w widżecie data-garan-voll i data-garan-klein, inaczej etykieta pojawi się dwa razy.
Typowe pułapki w Shopware
- Cache: po zmianach w szablonach wyczyść cache, np. poleceniem
bin/console cache:clear. Motyw musi być przypisany do właściwego kanału sprzedaży w zakładce „Theme”. - Zmieniony e-mail zamówienia: aktualizacja uzupełniła szablon potwierdzenia zamówienia tylko wtedy, gdy nigdy go nie edytowano. Według Shopware zmienione szablony nie dostają automatycznie etykiety GARAN ani linku do informacji.
- Nadpisany tekst regulaminu: po aktualizacji link do informacji jest włączony („Gewährleistungshinweis auf Bestellabschlussseite anzeigen”). Jeśli motyw nadpisuje tekst regulaminu na stronie potwierdzenia zamówienia, według Shopware trzeba dostosować to nadpisanie.
- Kilka kanałów sprzedaży: ustawienie informacji można nadpisać dla każdego kanału sprzedaży. Sprawdź każdy kanał osobno.
Dalsze źródła
- Shopware: GARAN label and EU guarantee requirements (po angielsku)
- Changelog Shopware 6.6.10.24: EU harmonised guarantee label (GitHub, po angielsku)
- Wydanie Shopware 6.7.14.0 (GitHub, po angielsku)
- Szablon Shopware buy-widget.html.twig (GitHub)
- Dokumentacja Shopware: Shopping Experiences (po angielsku)
- Dokumentacja Shopware: Products (po angielsku)
- Dokumentacja Shopware: Sales channels (po angielsku)
- Dokumentacja dla programistów Shopware: Customize templates (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 Shopware w „Einstellungen → E-Mail-Templates” (ang. Settings → Email templates). W szablonie potwierdzenia 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 Shopware 6 tak jak powyżej.
Wolisz własne pliki? Wgraj pełną i wbudowaną wersję do biblioteki mediów Shopware 6 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 też w Shopware 5?
Tak, przez element „Einkaufswelt” (ang. Shopping World) lub plik szablonu strony szczegółów produktu. Shopware 5 nie jest jednak wspierany od lipca 2024 r.
Czy muszę to robić dla każdego produktu osobno?
Nie. W układzie strony produktu kod obowiązuje dla wszystkich produktów, którym przypisano ten układ.
Czy to zakłóca obszar zakupu?
Nie. Widżet rysuje tylko w swoim znaczniku i niczego poza nim nie zmienia.
Czy potrzebuję widżetu, jeśli Shopware już pokazuje etykietę GARAN?
Do etykiety GARAN nie: od Shopware 6.7.14 lub 6.6.10.24 Shopware robi to sam. Link do zharmonizowanej informacji Shopware umieszcza na stronie potwierdzenia zamówienia. Na stronie produktu i w stopce widżet nadal się przydaje, wtedy bez data-garan-….
Którego pola Shopware używa jako identyfikatora modelu?
„Hersteller-Produktnummer” (ang. Manufacturer product number) w zakładce „Allgemein” (ang. General). Marka pochodzi z pola „Hersteller” (ang. Manufacturer).
Dlaczego Shopware nie pokazuje etykiety GARAN?
Shopware pokazuje ją tylko wtedy, gdy włączono „Label in der Storefront anzeigen” (ang. Show label in Storefront) i uzupełniono czas gwarancji, producenta oraz numer produktu producenta.