W OXID eShop 7 umieszczasz zharmonizowaną informację pod przyciskiem dodawania do koszyka przez rozszerzenie szablonu: w bloku Twig details_productmain_tobasket motywu APEX, za pomocą małego modułu lub motywu potomnego. Strona CMS w panelu administracyjnym nie wystarczy, bo edytor usuwa skrypty, a na stronie artykułu nie ma wolnego miejsca na treści CMS.
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
- Moduł lub motyw potomny
Rozszerzenie należy umieścić w małym module lub motywie potomnym (wtheme.phpz'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. - Rozszerz blok
Rozszerz szablonpage/details/inc/productmain.html.twigi w blokudetails_productmain_tobasketpo{{ parent() }}wstaw kod widżetu. Dziękiparent()przycisk dodawania do koszyka pozostaje bez zmian. - 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 wdata-garan-vollidata-garan-klein. - Wyczyść cache
Poleceniemvendor/bin/oe-console oe:cache:clearwyczyść 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
blockswmetadata.php, szablon topage/details/inc/productmain.tpl.
Gdzie dokładnie umieścić informację w OXID eShop
Na stronie artykułu informacja znajduje się w bloku details_productmain_tobasket, jak opisano wyżej. Gdy klient wybierze inny wariant, APEX ładuje ponownie obszar details_container i zastępuje go świeżo wygenerowanym HTML. Zawarte w nim skrypty motyw uruchamia przy tym ponownie. Twoje rozszerzenie bloku wraca więc na stronę także po zmianie wariantu.
Aby informacja była na wszystkich stronach, rozszerz szablon layout/footer.html.twig. W motywie APEX zawiera on między innymi blok dd_footer_copyright. Wyświetla on treść strony CMS o identyfikatorze oxstdfooter. W module Twój plik leży w views/twig/extensions/themes/apex/layout/footer.html.twig:
{% extends 'layout/footer.html.twig' %}
{% block dd_footer_copyright %}
{{ parent() }}
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}Sam tekst stopki nadal edytujesz na stronie CMS. Znacznik należy jednak do szablonu, z tego samego powodu co wyżej: edytor usuwa skrypty. Szablon działa dla wszystkich języków sklepu. Język informacji widżet dobiera według języka podanego przez stronę, który APEX ustawia na podstawie aktywnego języka sklepu.
Warianty i identyfikator modelu dla etykiety GARAN
W OXID najpierw zakładasz artykuł nadrzędny. Według podręcznika zawiera on wszystkie podstawowe informacje dziedziczone przez warianty. Warianty prowadzisz w zakładce „Varianten” (warianty). Możesz tam wpisać między innymi inny numer artykułu, cenę i stan magazynowy niż w artykule nadrzędnym. Długi opis artykułu nadrzędnego wyświetla się przy wszystkich wariantach, dopóki wariant nie ma własnego.
Producent i numer artykułu producenta (MPN) są w zakładce „Stamm” (dane podstawowe). Producenta wybierasz z listy, którą prowadzisz w danych podstawowych sklepu. Według podręcznika widok edycji wariantu jest niemal identyczny z widokiem zwykłego artykułu.
Etykieta GARAN dotyczy jednego identyfikatora modelu. Jeśli wszystkie warianty mają ten sam, wystarczy etykieta przy artykule nadrzędnym. Jeśli warianty są osobnymi modelami, każdy model potrzebuje własnej etykiety. Po konfiguracji sprawdź w sklepie na żywo, czy przy zmianie wariantu Twój szablon pokazuje etykietę wybranego wariantu, czy artykułu nadrzędnego.
Typowe pułapki w OXID eShop
- Cache szablonów: Według OXID zmiany w szablonach, konfiguracji lub modułach często działają poprawnie dopiero po wyczyszczeniu cache. Oprócz polecenia konsoli z góry cache szablonów czyści moduł OXID Admin Tools w „Service → Tools” (serwis → narzędzia). Zawiera on skompilowane szablony Twig.
- Varnish: Przy reverse proxy Varnish osobny serwer trzyma strony w pamięci podręcznej. OXID dzieli w tym celu strony na sekcje, tzw. widżety. Sprawdzaj zmianę dopiero wtedy, gdy również ta pamięć podręczna dostarcza nową wersję. Zwykle czyści ją Twoja agencja lub hosting.
- Subsklepy: Według dokumentacji dla programistów moduł dla subsklepu aktywujesz z opcją
--shop-id, czylivendor/bin/oe-console oe:module:activate <id-modułu> --shop-id=<id-sklepu>. Potem sprawdź każdy subsklep osobno. - Treści CMS dla każdego języka: Według podręcznika strony CMS prowadzisz osobno dla każdego języka, przez wybór „In Sprache” (w języku). Rozszerzenie szablonu wystarczy natomiast raz.
Dalsze źródła
- Podręcznik OXID: artykuł, zakładka „Varianten”, po niemiecku
- Podręcznik OXID: artykuł, zakładka „Stamm”, po niemiecku
- OXID Admin Tools: czyszczenie cache, po angielsku
- Podręcznik OXID: reverse proxy Varnish, po angielsku
- Dokumentacja dla programistów OXID: aktywacja modułu, także dla subsklepu, po angielsku
- Motyw APEX na GitHubie: szablon stopki
- Motyw APEX na GitHubie: skrypt wyboru wariantu
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, 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 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
Czy mogę po prostu wkleić kod na stronę CMS?
Nie w niezawodny sposób. Edytor usuwa skrypt, a na stronie artykułu nie ma standardowego miejsca, w którym strona CMS pojawiłaby się automatycznie. Małe rozszerzenie szablonu to bezpieczna droga.
Czy muszę zmieniać sam motyw APEX?
Nie. Wystarczy moduł lub motyw potomny z {{ parent() }}. Oryginalny motyw nadal można aktualizować, a przycisk zakupu pozostaje bez zmian.
Gdzie wpisuję etykietę GARAN dla artykułu?
Na przykład jako wartość atrybutu przy artykule w „Auswahl → Attribute zuordnen”. Szablon odczytuje wtedy adresy i przekazuje je do widżetu.
Jak pokazać informację w OXID eShop na wszystkich stronach?
W module lub motywie potomnym rozszerz szablon layout/footer.html.twig, w motywie APEX na przykład blok dd_footer_copyright. Wstaw tam kod widżetu po {{ parent() }}.
Czy informacja zostaje przy zmianie wariantu?
Tak, jeśli jest w bloku details_productmain_tobasket. Przy zmianie wariantu APEX ładuje ponownie cały obszar szczegółów, razem z Twoim rozszerzeniem bloku, i ponownie uruchamia zawarte w nim skrypty.
Czy muszę aktywować moduł w każdym subsklepie?
Według dokumentacji dla programistów dla subsklepu aktywujesz go z opcją --shop-id. Potem sprawdź każdy subsklep w sklepie na żywo.