Jak dodać zharmonizowaną informację w OXID eShop

Kod dla OXID eShop

<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 OXID eShop

1. Moduł lub motyw potomny
   Rozszerzenie należy umieścić w małym module lub motywie potomnym (w theme.php z 'parentTheme' => 'apex'), aby aktualizacje motywu APEX go nie nadpisały. Aktywujesz je w „Erweiterungen → Module” lub „Erweiterungen → Themes” (rozszerzenia → moduły lub motywy). Potrzebny jest dostęp do plików, zwykle zajmuje się tym Twoja agencja.
2. Rozszerz blok
   Rozszerz szablon page/details/inc/productmain.html.twig i w bloku details_productmain_tobasket po {{ parent() }} wstaw kod widżetu. Dzięki parent() przycisk dodawania do koszyka pozostaje bez zmian.
3. Etykieta GARAN dla artykułu
   Dla własnych etykiet GARAN utwórz w „Artikel verwalten → Attribute” (zarządzanie artykułami → atrybuty) dwa atrybuty, np. „GARAN voll” i „GARAN klein”, a przy artykule w „Auswahl → Attribute zuordnen” (wybór → przypisz atrybuty) wpisz adresy obu plików. W szablonie wyświetlasz wartości w data-garan-voll i data-garan-klein.
4. Wyczyść cache
   Poleceniem vendor/bin/oe-console oe:cache:clear wyczyść cache szablonów i sprawdź stronę artykułu, także z wariantami.

Nazwy menu w cudzysłowie pochodzą z niemieckiej wersji panelu; w nawiasie podajemy polskie tłumaczenie.

W module plik znajduje się w views/twig/extensions/themes/apex/page/details/inc/productmain.html.twig i wygląda tak:

{% extends 'page/details/inc/productmain.html.twig' %}

{% block details_productmain_tobasket %}
  {{ parent() }}
  <div data-garantielabel></div>
  <script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}

Na co uważać w OXID eShop

• Edytor stron CMS usuwa <script>. Od OXID 7.5 jest dodatkowo HTML sanitizer, który usuwa skrypty, jeśli jest włączony. Dlatego kod należy umieścić w szablonie.
• Przypisane atrybuty pojawiają się domyślnie także na liście właściwości produktu na stronie szczegółów. W razie potrzeby ukryj tam oba atrybuty GARAN w szablonie.
• OXID 6 z motywami Smarty Flow i Wave: blok nazywa się tak samo. Moduły podpinają go przez blocks w metadata.php, szablon to page/details/inc/productmain.tpl.

Zharmonizowana informacja w potwierdzeniu zamówienia

Według wytycznych Komisji informacja powinna znaleźć się także w e-mailu z potwierdzeniem. Potwierdzenie zamówienia korzysta ze strony CMS o identyfikatorze oxuserorderemail, którą edytujesz w „Kundeninformationen → CMS-Seiten” (informacje dla klientów → strony CMS). JavaScript nie działa w e-mailach, dodaj tam 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.

Źródła

• Dokumentacja dla programistów OXID: rozszerzanie bloku aktywnego motywu, po angielsku
• Dokumentacja dla programistów OXID: tworzenie motywu potomnego, po angielsku
• Dokumentacja dla programistów OXID: HTML sanitizer (7.5), po angielsku
• Podręcznik OXID: artykuł, zakładka „Auswahl”, po niemiecku
• Podręcznik OXID: strony CMS, po niemiecku
• Motyw APEX na GitHubie (szablon strony artykułu)

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 OXID eShop tak jak powyżej.

Wolisz własne pliki? Wgraj pełną i wbudowaną wersję do biblioteki mediów OXID eShop 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