Przejdź do treści
Nowość: 3 etykiety GARAN za darmo, bez rejestracjiUtwórz
Gwarancja ustawowa UE
i etykieta GARAN
InstrukcjaAktualizacja 9 października 20266 min czytania

Jak dodać zharmonizowaną informację w Magento / Adobe Commerce

Urzędowa informacja UE o prawnym obowiązku zapewnienia zgodności z umową w Twoim sklepie (Magento / Adobe Commerce) w kilka minut, z darmowym widżetem.

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. Osobną etykietę GARAN dla każdego produktu przechowujesz w atrybucie produktu, który wypełniasz importem CSV.

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

  1. 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”.
  2. Utwórz widget
    W Content → Elements → Widgets utwórz widget typu „CMS Static Block” dla swojego motywu.
  3. Umieść
    Jako Layout Update wybierz „All Product Types” i wskaż kontener „Product View Extra Hint”. Znajduje się on pod przyciskiem dodawania do koszyka.
  4. Wyczyść cache
    Zapisz, wyczyść cache i sprawdź na stronie produktu.

Nazwy menu podajemy w wersji angielskiej, tak jak w panelu.

Osobna etykieta GARAN dla każdego produktu: atrybut i import CSV

Blok CMS pokazuje tę samą treść na wszystkich stronach produktów. To wystarcza dla informacji o zgodności z umową i dla etykiety GARAN, która dotyczy wszystkich produktów. Jeśli każdy produkt potrzebuje własnej etykiety GARAN, zapisz adres etykiety w atrybucie produktu. Motyw wyświetla ten atrybut na stronie produktu raz na zawsze, a potem zajmujesz się już tylko danymi.

  1. Utwórz atrybut
    W Stores → Attributes → Product kliknij „Add New Attribute” i utwórz atrybut typu „Text Field” z Attribute Code garan_label_url i Scope „Global”. Dla wersji wbudowanej możesz dodać drugi atrybut garan_label_nested_url. Pozostaw „Visible on Catalog Pages on Storefront” na „No”, w przeciwnym razie adres pojawi się też jako tekst w szczegółach produktu. Następnie przeciągnij oba atrybuty do swojego zestawu atrybutów w Stores → Attributes → Attribute Set i zapisz.
  2. Utwórz etykiety
    W koncie klienta, w „Import CSV”, wgraj plik z marką, modelem i latami oraz kolumną sku z SKU z Magento. Plik wynikowy ma kolumny sku;brand;model;years;label_url;label_nested_url;embed_html, rozdzielone średnikami.
  3. Przygotuj plik importu
    W pliku wynikowym zostaw sku, zmień nazwę label_url na garan_label_url i label_nested_url na garan_label_nested_url, usuń wszystkie pozostałe kolumny i wiersze bez adresu. Zapisz plik jako UTF-8 bez BOM, np. w LibreOffice lub edytorze tekstu. Plik wynikowy ma BOM dla Excela, a według Adobe Magento nie zawsze rozpoznaje pliki z BOM. Excel przy zapisie jako „CSV UTF-8” znów dodaje BOM.
  4. Zaimportuj
    W System → Data Transfer → Import wybierz „Products” jako Entity Type i „Add/Update” jako Import Behavior, w polu „Field separator” wpisz średnik ;, wybierz plik, kliknij „Check Data”, a potem „Import”. Magento przypisuje każdy wiersz do istniejącego produktu po SKU.
  5. Raz w motywie
    Programista lub Twoja agencja dodaje dwa poniższe pliki do Twojego własnego motywu i czyści cache. To jednorazowa zmiana. Potem każdy produkt dostaje etykietę już tylko przez atrybut, importem lub ręcznie w produkcie.

Plik layoutu app/design/frontend/<Vendor>/<theme>/Magento_Catalog/layout/catalog_product_view.xml dodaje blok pod przyciskiem dodawania do koszyka, w kontenerze product.info.extrahint. Jeśli Twój motyw ma już ten plik, dodaj w nim tylko referenceContainer:

<?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <body>
        <referenceContainer name="product.info.extrahint">
            <block class="Magento\Catalog\Block\Product\View" name="garan.label"
                   template="Magento_Catalog::product/view/garan-label.phtml" after="-"/>
        </referenceContainer>
    </body>
</page>

Szablon app/design/frontend/<Vendor>/<theme>/Magento_Catalog/templates/product/view/garan-label.phtml wyświetla coś tylko wtedy, gdy przy produkcie jest wpisany adres. data-nur="garan" pokazuje samą etykietę GARAN, bo blok CMS pokazuje już informację o zgodności z umową. Jeśli wpisana jest wersja wbudowana, pojawia się ona, a kliknięcie otwiera pełną etykietę:

<?php
/** @var \Magento\Catalog\Block\Product\View $block */
/** @var \Magento\Framework\Escaper $escaper */
$full = trim((string) $block->getProduct()->getData('garan_label_url'));
$nested = trim((string) $block->getProduct()->getData('garan_label_nested_url'));
if ($full === '') {
    return;
}
?>
<div data-garantielabel data-nur="garan"
     data-garan-voll="<?= $escaper->escapeUrl($full) ?>"
     data-garan-klein="<?= $escaper->escapeUrl($nested) ?>"></div>
<script src="https://www.garantielabel.app/widget.js" async></script>

Jeśli sam blok CMS zawiera już etykietę GARAN (data-garan-voll), usuń ją stamtąd, inaczej pojawią się dwie. Plik layoutu dla SKU (catalog_product_view_sku_{sku}.xml, niżej) opłaca się teraz już tylko dla kilku produktów, bo każdy plik to zmiana w motywie.

Produkty konfigurowalne

Na stronie produktu konfigurowalnego szablon wyświetla atrybut produktu nadrzędnego. Gdy klient wybierze opcję, strona pozostaje ta sama, a etykieta się nie zmienia. Jeśli wszystkie warianty mają tę samą markę, ten sam identyfikator modelu i ten sam okres gwarancji, po prostu wpisz etykietę przy produkcie nadrzędnym, czyli w wierszu z jego SKU. Osobna etykieta dla każdego wariantu wymaga dodatkowego JavaScriptu, który po wyborze wstawi adresy wybranego wariantu. Często prościej jest prowadzić takie modele jako osobne produkty.

Na co uważać w Magento / Adobe Commerce

Gdzie umieścić informację w Magento

Wszystkie strony produktów korzystają z pliku układu catalog_product_view.xml. Do tego dochodzą pliki dla typu produktu, np. catalog_product_view_type_configurable.xml, i dla pojedynczego produktu, np. catalog_product_view_sku_{sku}.xml. Kolumna z ceną i obszarem zakupu to kontener product.info.main. Zawiera on product.info.extrahint, który w formularzu widgetu nazywa się „Product View Extra Hint”.

W panelu administracyjnym widgety tworzysz w Content → Elements → Widgets. „Display On” określa typ strony, „Container” obszar strony. Dla stron produktów wybierz „All Product Types” albo jeden typ produktu. Dla informacji w stopce dodaj drugą aktualizację układu: „All Pages” z kontenerem „Page Footer”, najlepiej z data-darstellung="link".

Produkty konfigurowalne i identyfikator modelu

Produkt konfigurowalny wyświetla się jako jeden produkt z listami wyboru. Według Adobe każdy wariant to osobny produkt prosty z własnym SKU. Sam produkt konfigurowalny to tylko rama, a jego cena pochodzi z wariantów.

Dokumentacja Adobe nie wymienia osobnego pola na identyfikator modelu. Tworzysz do tego atrybut produktu w Stores → Attributes → Product, a potem dodajesz go do zestawu atrybutów w Stores → Attributes → Attribute Set. Przy „Visible on Catalog Pages on Storefront” ustawionym na „Yes” pojawi się na stronie produktu. Ponieważ każdy wariant jest osobnym produktem, może mieć własny identyfikator modelu.

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ą opcją. Dla etykiety należącej tylko do jednego produktu programiści używają pliku układu tego produktu (catalog_product_view_sku_{sku}.xml). Jeśli warianty mają różne identyfikatory modelu, lepiej prowadzić te modele jako osobne produkty. Przy wielu produktach zobacz wyżej sposób z atrybutem i importem CSV.

Typowe pułapki w Magento

Dalsze źródła

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, 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 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.

Jak dać wielu produktom własną etykietę GARAN?

Przez atrybut produktu, np. garan_label_url, który wypełniasz w System → Data Transfer → Import plikiem wynikowym z importu CSV. Motyw wyświetla atrybut raz, potem wszystko sprowadza się do danych.

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.

Czy mogę dodać etykietę GARAN tylko dla jednego produktu?

Tak. Przy wielu produktach najprościej przez atrybut produktu i import CSV, opisane wyżej w części o atrybucie i imporcie CSV. Dla kilku produktów sprawdzi się też plik układu catalog_product_view_sku_{sku}.xml; obowiązuje on tylko dla produktu z tym SKU.

Czy widżet pojawia się we wszystkich store views?

Tylko w tych, które wybierzesz w Storefront Properties instancji widgetu.

Co zrobić po zmianie motywu?

Instancje widgetu należą do jednego Design Theme. Utwórz widget dla nowego motywu, odśwież cache i sprawdź stronę produktu.

Etykieta GARAN, za darmo.

Pierwsze 3 etykiety są bezpłatne. W Shopify nasza aplikacja dodaje obie unijne etykiety automatycznie.