W WooCommerce wstawiasz zharmonizowaną informację blokiem „Własny HTML” do szablonu strony produktu, bezpośrednio pod przyciskiem dodawania do koszyka. W klasycznych motywach zrobisz to małym hookiem w motywie potomnym.
Kod dla WooCommerce
<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 WooCommerce
- Otwórz szablon
W WordPressie przejdź do Wygląd → Edytor → Szablony i otwórz „Pojedynczy produkt”. W klasycznych motywach przejdź od razu do kroku 4. - Wstaw blok
Pod blokiem przycisku „Dodaj do koszyka” wstaw blok „Własny HTML”. - Wklej kod
Wklej kod widżetu i zapisz szablon. Od tej chwili obowiązuje on na wszystkich stronach produktów. - Klasyczny motyw
Bez edytora blokowego wyświetl kod przez hookwoocommerce_single_product_summaryz priorytetem 35 w motywie potomnym albo za pomocą wtyczki do snippetów.
Na co uważać w WooCommerce
- Wtyczki do cache i optymalizacji (np. łączące pliki JavaScript) nie powinny modyfikować
widget.js. W razie potrzeby wyłącz ten plik z optymalizacji. - Skrypt w bloku „Własny HTML” zostaje zachowany tylko wtedy, gdy Twój użytkownik może zapisywać własny HTML (uprawnienie
unfiltered_html, w sieci multisite tylko superadministratorzy). W przeciwnym razie załaduj skrypt przez wtyczkę do snippetów. - Jeśli sklep jest wielojęzyczny, widżet rozpoznaje język z
<html lang>. Atrybutemdata-spracheustawisz go na stałe.
Gdzie umieścić informację w WooCommerce
W motywach blokowych edytujesz szablon „Pojedynczy produkt” w edytorze witryny. W klasycznych motywach WooCommerce buduje stronę produktu z szablonu content-single-product.php i jego hooków:
woocommerce_single_product_summarywypełnia podsumowanie obok zdjęć. Według szablonu są tam tytuł (priorytet 5), ocena i cena (10), krótki opis (20), przycisk dodawania do koszyka (30), metadane (40) i linki do udostępniania (50). Z priorytetem 35 widżet stoi więc bezpośrednio pod przyciskiem dodawania do koszyka.woocommerce_after_single_product_summarynastępuje pod podsumowaniem, przed zakładkami (10), upsellami (15) i podobnymi produktami (20). Tam informacja jest dalej od przycisku zakupu.
Do informacji w stopce użyj w motywach blokowych części szablonu „Footer”. Znajdziesz ją w Wygląd → Edytor → Wzorce, wśród części szablonu. Według WooCommerce części szablonu są zawsze synchronizowane: zmiana działa wszędzie, gdzie stopka jest użyta. Wystarczy tam blok „Własny HTML” z data-darstellung="link".
Warianty, marka i identyfikator modelu
Produkt zmienny składa się z wariantów. Każdy wariant ma własne pola, m.in. SKU oraz „GTIN, UPC, EAN lub ISBN”. Jeśli pozostaną puste, obowiązuje wartość produktu głównego. Marki należą do rdzenia WooCommerce od wersji 9.6. Zarządzasz nimi w Produkty → Marki i wybierasz je w produkcie.
WooCommerce nie ma osobnego pola na identyfikator modelu. SKU to Twój własny numer artykułu, a nie automatycznie identyfikator modelu producenta. Etykieta GARAN podaje markę i identyfikator modelu, więc jedna etykieta przypada na jeden identyfikator modelu. Jeśli wszystkie warianty mają ten sam identyfikator, wystarczy jedna etykieta dla produktu. Widżet pokazuje dokładnie jedną etykietę GARAN na znacznik i nie zmienia się z wybranym wariantem. Jeśli warianty mają różne identyfikatory modelu, utwórz te modele jako osobne produkty, każdy z własną etykietą.
Typowe pułapki w WooCommerce
- Aktualizacje motywu: zmiany w plikach WooCommerce lub motywu nadrzędnego giną przy następnej aktualizacji. Dlatego szablony nadpisujesz w motywie potomnym, w folderze
woocommerce/. - Nieaktualne szablony: WooCommerce nie aktualizuje nadpisanych szablonów. Które są nieaktualne, zobaczysz na dole WooCommerce → Status → Status systemu.
- Hook zamiast szablonu: widżet nie potrzebuje nadpisanego szablonu. Wystarczy hook w
functions.phpmotywu potomnego. WordPress ładuje ten plik dodatkowo do pliku motywu nadrzędnego. - Stopka: zmiana części szablonu obowiązuje na wszystkich stronach z tą stopką. Podglądu tam nie ma, sprawdź stronę na żywo.
Dalsze źródła
- Szablon WooCommerce content-single-product.php (GitHub)
- WooCommerce: Template structure & overriding templates (po angielsku)
- WooCommerce: Fixing outdated WooCommerce templates (po angielsku)
- WooCommerce: Patterns and template parts (po angielsku)
- WooCommerce: Variable products (po angielsku)
- WooCommerce: Brands (po angielsku)
- Blog deweloperów WooCommerce: Brands w WooCommerce 9.6 (po angielsku)
- WordPress Developer: Child themes (po angielsku)
Zharmonizowana informacja w potwierdzeniu zamówienia
Według wytycznych Komisji informacja powinna znaleźć się także w e-mailu z potwierdzeniem. E-maile WooCommerce dostosujesz w WooCommerce → Ustawienia → E-maile. Aby zharmonizowana informacja znalazła się w e-mailu z zamówieniem, wstaw tam urzędową grafikę ze strony pobierania jako obraz, zależnie od motywu przez szablony e-maili lub wtyczkę do e-maili. 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 WooCommerce tak jak powyżej.
Wolisz własne pliki? Wgraj pełną i wbudowaną wersję do biblioteki mediów WooCommerce 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 potrzebuję wtyczki?
Nie. Wystarczy blok „Własny HTML”. Tylko w klasycznych motywach bez edytora blokowego najprostszą drogą jest wtyczka do snippetów lub motyw potomny.
Czy to działa z Elementorem lub Divi?
Tak. Oba mają element HTML lub kodu, który przeciągasz w szablonie produktu pod przycisk dodawania do koszyka. Szablony produktów w Elementorze są dostępne tylko w Elementor Pro (Theme Builder).
Czy mój sklep zwolni?
Praktycznie nie. Skrypt jest mały, ładuje się asynchronicznie i nie blokuje wczytywania strony.
Dlaczego priorytet 35 dla hooka?
Według szablonu WooCommerce przycisk dodawania do koszyka ma priorytet 30, a metadane 40. Z priorytetem 35 widżet stoi dokładnie pomiędzy, bezpośrednio pod przyciskiem zakupu.
Czy każdy wariant potrzebuje własnej etykiety GARAN?
Tylko jeśli warianty mają różne identyfikatory modelu. Widżet pokazuje jedną etykietę na znacznik i nie zmienia się z wariantem. Takie modele lepiej utworzyć jako osobne produkty.
Gdzie ustawić markę do etykiety GARAN?
Od WooCommerce 9.6 w Produkty → Marki. Markę wybierasz w produkcie. Dawna wtyczka Brands nie jest już potrzebna.