¶ Rękojmia - zharmonizowana informacja UE w sklepie
Rękojmia w Hummerce to gotowy sposób na pokazanie klientom zharmonizowanej informacji Unii Europejskiej o ustawowej rękojmi (prawnym obowiązku zapewnienia zgodności towaru z umową), wymaganej od 27.09.2026 przed zawarciem umowy. Sklep pokazuje krótki link "Twoje prawa z tytułu rękojmi" na karcie produktu, w koszyku i w zamówieniu, a po kliknięciu - oficjalną grafikę UE w oknie, na osobnej stronie i w mailu z potwierdzeniem zamówienia. Wszystko na istniejących treściach panelu, bez programowania.
Stan na wersję Hummerce 2.35, aktualizacja 2026-10-02.
¶ Korzyści i zastosowania
- Wymóg UE spełniony bez prac programistycznych - konfiguracja na treściach, obszarach i stronach panelu, w każdym sklepie na standardowym szablonie.
- Informacja w każdym kroku zakupu - karta produktu, koszyk, formularz zamówienia, strona po złożeniu zamówienia, stopka i mail.
- Krótka forma, która nie zasłania oferty - jeden link w wierszu "Cena zawiera VAT | koszty dostawy", pełna grafika dopiero po kliknięciu.
- Oficjalne pliki Komisji Europejskiej bez zmian - z kodem QR i linkiem do portalu Your Europe w języku sklepu.
- Gotowe treści do skopiowania w wersji polskiej i angielskiej oraz skill dla asystenta AI, który wprowadza konfigurację sam, z podglądem przed zapisem.
¶ Jak to wygląda
Zrzuty ze sklepu demonstracyjnego Hummerce.
¶ Karta produktu
¶ Okno z informacją UE
¶ Telefon
¶ Koszyk
¶ Formularz zamówienia
¶ Strona po złożeniu zamówienia
¶ Stopka
¶ Zasady działania
¶ Co pokazuje sklep
- Link "Twoje prawa z tytułu rękojmi" (EN: "Your legal guarantee rights") w ścieżce zakupowej:
- karta produktu - w wierszu pod ceną, po "Cena zawiera VAT | koszt dostawy",
- koszyk - pod kwotą łączną,
- formularz zamówienia i podsumowanie przed złożeniem - pod danymi dostawy,
- strona po złożeniu zamówienia - pod treścią potwierdzenia.
- Okno z pełną informacją otwiera się po pierwszym kliknięciu linku: oficjalna grafika UE w języku sklepu, link do portalu Your Europe (ten sam adres co w kodzie QR), link "Otwórz w pełnym rozmiarze". Okno zamyka się przyciskiem, klawiszem Esc i kliknięciem obok; na telefonie zajmuje cały ekran.
- Strona "Rękojmia" - grafika wyświetlona wprost i link do Your Europe. Link w ścieżce zakupowej prowadzi także do tej strony, więc informacja jest dostępna również bez okna.
- Stopka - pozycja "Rękojmia" w bloku informacyjnym (obok regulaminu, dostaw, polityki prywatności).
- Mail z potwierdzeniem zamówienia - blok "Rękojmia" z grafiką i linkiem do Your Europe, w wersji HTML i tekstowej.
¶ Jak to jest zbudowane
- Dwie treści z linkiem i jedna z oknem, w każdym języku sklepu (Obszary i zawartości).
- Okno jest umieszczone raz, w stopce - dzięki temu działa na każdej stronie, także na stronach zamówienia, i nie dubluje się na podsumowaniu, gdzie link występuje dwa razy.
- Link podpina się do obszarów, które są już w szablonie sklepu. Obszar, którego brakuje w panelu (np. podsumowanie koszyka), zakłada się w panelu z tym samym symbolem - bez zmian w szablonie.
- Strona "Rękojmia" to zwykła strona statyczna. Jeśli blok informacyjny stopki to menu stron, nowa strona pojawia się w stopce automatycznie jako jego podstrona.
- Grafiki to oficjalne pliki Komisji Europejskiej, wgrane do sklepu bez zmian. Grafika w oknie ładuje się dopiero po jego otwarciu.
- Każda grafika ma tekst alternatywny z pełną treścią informacji - dla czytników ekranu.
¶ Wersja rozwijana
Krótki link, który przy pierwszym kliknięciu otwiera pełną informację, to przykład podany w wytycznych Komisji Europejskiej (zdanie "Your legal guarantee rights"). Rozporządzenie wprost go nie opisuje - decyzję o sposobie prezentacji podejmuje sklep. Grafikę można też pokazać wprost, bez okna - np. tylko na stronie "Rękojmia" i w mailu, z linkiem w ścieżce zakupowej.
¶ Wersja
Konfiguracja przygotowana i sprawdzona na wersji Hummerce 2.35 z szablonem Bootstrap 5. Dla sklepów na szablonie Bootstrap 4 jest osobny wariant okna (sekcja "Szczegóły konfiguracji").
¶ Zależności
- Szablon sklepu z miejscami na treść w ścieżce zakupowej: wiersz pod ceną na karcie produktu, podsumowanie koszyka, dane dostawy w formularzu zamówienia, strona po złożeniu zamówienia, stopka. Standardowe szablony Bootstrap 5 i Bootstrap 4 je mają.
- Oficjalne pliki informacji o rękojmi ze strony Komisji Europejskiej ("Practical guidelines and high-resolution vector files", 24 języki).
- Szablony maili - szablon potwierdzenia zamówienia dla klienta.
- Do konfiguracji przez asystenta AI - serwer MCP sklepu i konto z uprawnieniami do treści.
¶ Wdrożenie
- Wdrożenie nie wymaga programowania - to konfiguracja treści, obszarów, strony i szablonu maila w panelu albo przez asystenta AI.
- Minimalny szacowany czas: od 2 h (treści w dwóch językach, podpięcia, strona, mail, sprawdzenie w sklepie). Czas konkretnego wdrożenia zależy od jego zakresu - wyceniamy go indywidualnie.
- Od czego zależy czas:
- liczba języków sklepu (każdy język to osobna grafika i treść),
- własne szablony sklepu - brak któregoś z miejsc na treść oznacza dołożenie go w szablonie (osobne zadanie programistyczne),
- szablon sklepu Bootstrap 4 - wariant okna wymaga sprawdzenia przy pierwszym wdrożeniu,
- liczba i wygląd szablonów maili,
- wersja sklepu - starsza wersja wymaga najpierw aktualizacji (wycena osobno).
- Przed wdrożeniem warto potwierdzić z prawnikiem sklepu, że wersja rozwijana (link i okno) jest dla sklepu akceptowalna.
¶ Ograniczenia
- Konfiguracja nie zmienia szablonów sklepu - miejsca, których szablon nie ma (np. szablony konfiguratorów bez wiersza pod ceną), wymagają osobnego zadania.
- Informacja jest wspólna dla całego sklepu - nie zależy od produktu. Etykieta gwarancji handlowej trwałości (GARAN) przypisywana do produktu to osobna funkcja.
- Gotowe treści są w wersji polskiej i angielskiej. Kolejne języki - z oficjalnych plików KE, według tego samego wzoru.
- Konfiguracja obejmuje mail z potwierdzeniem zamówienia. Pozostałe maile, dokumenty sprzedaży (faktura, PDF zamówienia) i kanały poza sklepem (Allegro, aplikacje) nie dostają informacji automatycznie.
- Mail wymaga grafiki PNG - programy pocztowe nie wyświetlają SVG. Sklep na wersji 2.35 przyjmuje grafiki PNG, JPG, GIF, WEBP i AVIF.
- Pasek zgody na cookies może zasłaniać dół okna do czasu akceptacji cookies.
- Wariant okna dla szablonu Bootstrap 4 nie był jeszcze sprawdzony w sklepie na tym szablonie. Jeśli okno nie zadziała, link prowadzi do strony "Rękojmia".
- Nie weryfikujemy zadania pod kątem zgodności z prawem - sposób prezentacji informacji, treść regulaminu i zasady rozpatrywania reklamacji ustala sklep.
¶ Potencjał rozwoju
- Informacja o rękojmi w kolejnych mailach (zmiana statusu, faktura) i w dokumentach sprzedaży.
- Gotowe treści w kolejnych językach UE.
- Etykieta GARAN na karcie produktu - osobna funkcja dla gwarancji handlowej trwałości.
¶ Najczęstsze pytania
Czy Hummerce pozwala spełnić wymóg informacji o rękojmi bez programowania?
Tak. Link, okno, strona "Rękojmia" i blok w mailu to treści i ustawienia panelu - w sklepie na standardowym szablonie nie trzeba zmieniać kodu.
Czy grafikę UE można zmienić, np. dopasować kolory do sklepu?
Nie. Używamy oficjalnych plików Komisji Europejskiej bez zmian - także kolorów.
Czy informacja musi być w oknie?
Nie. Okno otwierane krótkim linkiem to przykład z wytycznych Komisji Europejskiej, a nie wymóg rozporządzenia. Sklep może pokazać grafikę wprost - decyzja należy do sklepu.
Ile trwa wdrożenie informacji o rękojmi?
Od 2 h w sklepie na standardowym szablonie, w wersji polskiej i angielskiej. Własne szablony bez potrzebnych miejsc na treść i dodatkowe języki wydłużają ten czas.
Czy to działa w sklepie z własnym szablonem?
Częściowo. Treści działają w każdym miejscu, które szablon ma; brakujące miejsce trzeba dołożyć w szablonie w osobnym zadaniu.
Czy informacja o rękojmi trafia do maila z potwierdzeniem zamówienia?
Tak. Szablon potwierdzenia zamówienia dostaje blok z grafiką i linkiem do Your Europe, w wersji HTML i tekstowej.
¶ Powiązane
- Reklamacje
- Zwroty - odstąpienie od umowy
- Obszary i zawartości
- Szablony maili i alerty
- Asystent AI - serwer MCP
- Na hummerce.com: Zwroty i reklamacje
Chcesz zobaczyć, jak to działa w Waszym sklepie? Umów bezpłatną prezentację.
¶ Szczegóły konfiguracji
¶ Mapa miejsc
| Miejsce w sklepie | Obszar (symbol) | Treść |
|---|---|---|
| Karta produktu, wiersz pod ceną | plusShippingCost |
rekojmiaLinkCena - jako druga treść obok kosztu dostawy, limit obszaru 2 |
| Koszyk, podsumowanie kwot | cartTextBelowPrice |
rekojmiaLink |
| Formularz zamówienia i podsumowanie przed złożeniem | orderBelowDelivery |
rekojmiaLink |
| Strona po złożeniu zamówienia | orderFinished |
rekojmiaLink |
| Stopka (każda strona) | footerLeft |
rekojmiaModal - okno, jako druga treść, limit obszaru 2 |
| Stopka, blok "Informacje" | footerBox2 |
strona "Rękojmia" jako podstrona menu stron albo link w treści bloku |
Czy dane miejsce jest w szablonie sklepu, sprawdza się w podglądzie rozmieszczenia obszarów (Obszary i zawartości). Sklep z własnymi szablonami bez któregoś miejsca - zgłoś osobne zadanie dołożenia obszaru w szablonie.
¶ Dostęp w panelu
- Grafiki: oficjalne pliki KE w każdym języku sklepu, w PNG (ok. 1200 px szerokości), wgrane bez zmian (Menedżer plików i obrazków). Skopiuj adres każdego pliku.
- Strona "Rękojmia": Treść -> Strony statyczne - nowa strona z grafiką i linkiem do Your Europe, w każdym języku; jeśli blok "Informacje" w stopce to menu stron, ustaw Strona nadrzędna na stronę tego menu.
- Treści: Treść -> Zawartości - trzy treści HTML:
rekojmiaLink,rekojmiaLinkCena,rekojmiaModal(wzór niżej), w każdym języku. - Podpięcia: Treść -> Obszary - podepnij treści według mapy miejsc; w
plusShippingCostifooterLeftustaw limit 2, żeby istniejąca treść została. Brakujący obszar (np.cartTextBelowPrice) dodaj z dokładnie tym symbolem. - Mail: Konfiguracja -> Szablony - szablon potwierdzenia zamówienia dla klienta, wersja HTML i tekstowa, każdy język; blok "Rękojmia" przed stopką maila. Wspólnej stopki wszystkich maili nie zmieniaj.
- Cache: Status -> Cache - wyczyść po zmianach, inaczej karta produktu i stopka pokazują starą wersję (Cache).
- Sprawdzenie: karta produktu, okno (komputer i telefon), koszyk, formularz, strona po złożeniu zamówienia, stopka, mail - w każdym języku.
¶ Treści do skopiowania
W adresach zamień /pl/rekojmia.html i /en/legal-guarantee.html na adres strony "Rękojmia" w Waszym sklepie (przyjazny adres pojawia się po zapisaniu strony i wyczyszczeniu cache), a [GRAFIKA-PL] i [GRAFIKA-EN] - na adresy wgranych grafik. Tekst alternatywny (alt) uzupełnij pełną treścią grafiki w danym języku.
Link - rekojmiaLink (PL):
<span class="rekojmia-link small d-inline-block mt-1 mb-3"><a href="/pl/rekojmia.html" data-bs-toggle="modal" data-bs-target="#rekojmiaModal" data-toggle="modal" data-target="#rekojmiaModal">Twoje prawa z tytułu rękojmi</a></span>
Link w wierszu pod ceną - rekojmiaLinkCena (PL):
| <a href="/pl/rekojmia.html" data-bs-toggle="modal" data-bs-target="#rekojmiaModal" data-toggle="modal" data-target="#rekojmiaModal">Twoje prawa z tytułu rękojmi</a>
Wersja EN obu linków: tekst "Your legal guarantee rights", adres /en/legal-guarantee.html. Link ma atrybuty obu wersji Bootstrap - działa w szablonie Bootstrap 5 i Bootstrap 4.
Okno - rekojmiaModal, Bootstrap 5 (PL):
<div class="modal fade" id="rekojmiaModal" tabindex="-1" aria-labelledby="rekojmiaModalTitle" aria-hidden="true">
<div class="modal-dialog modal-lg modal-dialog-centered modal-dialog-scrollable modal-fullscreen-sm-down">
<div class="modal-content text-dark" style="color:rgb(33,37,41)">
<div class="modal-header">
<h2 class="modal-title fs-5 text-dark" id="rekojmiaModalTitle" style="color:rgb(33,37,41)">Twoje prawa z tytułu rękojmi</h2>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Zamknij"></button>
</div>
<div class="modal-body text-center">
<img src="[GRAFIKA-PL]" loading="lazy" class="img-fluid" width="1200" height="1697" alt="PRAWNY OBOWIĄZEK ZAPEWNIENIA ZGODNOŚCI TOWARU Z UMOWĄ. Towary sprzedawane w Unii Europejskiej objęte są prawnym obowiązkiem zapewnienia ich zgodności z umową przez okres co najmniej dwóch lat. ...">
<p class="mt-3 mb-1"><a href="https://europa.eu/youreurope/gwarancje" target="_blank" rel="noopener">europa.eu/youreurope/gwarancje</a></p>
<p class="mb-0"><a href="[GRAFIKA-PL]" target="_blank" rel="noopener">Otwórz w pełnym rozmiarze</a></p>
</div>
</div>
</div>
</div>
Wersja EN: tytuł "Your legal guarantee rights", przycisk aria-label="Close", grafika EN, link https://europa.eu/youreurope/guarantees, "Open full size". Okno ma własny kolor tekstu, bo stopka sklepu bywa ciemna z jasnym tekstem - bez tego tytuł okna jest niewidoczny.
Okno - rekojmiaModal, Bootstrap 4 (PL):
<div class="modal fade" id="rekojmiaModal" tabindex="-1" role="dialog" aria-labelledby="rekojmiaModalTitle" aria-hidden="true">
<div class="modal-dialog modal-lg modal-dialog-centered" role="document">
<div class="modal-content text-dark" style="color:rgb(33,37,41)">
<div class="modal-header">
<h2 class="modal-title h5 text-dark" id="rekojmiaModalTitle" style="color:rgb(33,37,41)">Twoje prawa z tytułu rękojmi</h2>
<button type="button" class="close" data-dismiss="modal" aria-label="Zamknij"><span aria-hidden="true">×</span></button>
</div>
<div class="modal-body text-center">
<img src="[GRAFIKA-PL]" loading="lazy" class="img-fluid" width="1200" height="1697" alt="PRAWNY OBOWIĄZEK ZAPEWNIENIA ZGODNOŚCI TOWARU Z UMOWĄ. ...">
<p class="mt-3 mb-1"><a href="https://europa.eu/youreurope/gwarancje" target="_blank" rel="noopener">europa.eu/youreurope/gwarancje</a></p>
<p class="mb-0"><a href="[GRAFIKA-PL]" target="_blank" rel="noopener">Otwórz w pełnym rozmiarze</a></p>
</div>
</div>
</div>
</div>
Blok do maila - HTML (PL):
<hr style="border: 0; border-top: 1px solid #e1e1e1; "/>
<h2 style="font-size: 20px; font-weight: bold; margin: 20px 0 10px 0; font-family: Arial, sans-serif; ">Rękojmia</h2>
<p style="margin: 0 0 10px 0;">Twoje prawa z tytułu rękojmi (prawnego obowiązku zapewnienia zgodności towaru z umową):</p>
<p style="margin: 0 0 10px 0; text-align: center;"><a href="$!{ctx.shop.configuration.url_Shop}/pl/rekojmia.html"><img src="$!{ctx.shop.configuration.url_Shop}[GRAFIKA-PL]" width="600" style="display: block; margin: 0 auto; max-width: 100%; height: auto; border: 0;" alt="Prawny obowiązek zapewnienia zgodności towaru z umową - zharmonizowana informacja UE. Więcej: europa.eu/youreurope/gwarancje"/></a></p>
<p style="margin: 0 0 10px 0; text-align: center;">Więcej informacji: <a href="https://europa.eu/youreurope/gwarancje">europa.eu/youreurope/gwarancje</a></p>
Blok do maila - tekst (PL):
Rękojmia
Towary sprzedawane w Unii Europejskiej objęte są prawnym obowiązkiem zapewnienia ich zgodności z umową przez okres co najmniej dwóch lat (rękojmia).
Informacja o Twoich prawach: $!{ctx.shop.configuration.url_Shop}/pl/rekojmia.html
Więcej informacji: https://europa.eu/youreurope/gwarancje
Wersja EN maila: nagłówek "Legal guarantee", grafika EN, adres strony EN i https://europa.eu/youreurope/guarantees. W mailu zawsze grafika PNG.
¶ REST API i MCP
Całą konfigurację poza szablonem maila można wprowadzić przez asystenta AI (serwer MCP sklepu): wgranie grafik, treści, strona i podpięcia do obszarów jednym importem XML z podglądem przed zapisem.
Gotowy skill dla Claude Code - zapisz poniższy plik jako .claude/skills/rekojmia-ue/SKILL.md w katalogu roboczym i poproś asystenta: "Wdróż informację o rękojmi w sklepie". Skill:
- sprawdza stan obszarów i zachowuje istniejące treści (import podpięć do obszaru zastępuje wszystkie podpięcia, dlatego skill powtarza istniejące),
- pyta o wygląd frontu (Bootstrap 5 / 4) i wybiera wariant okna,
- przed każdym zapisem pokazuje podgląd i czeka na zatwierdzenie,
- czyści cache przez MCP, a jeśli serwer nie potwierdza wyczyszczenia cache stron - prosi o wyczyszczenie w panelu,
- podaje blok do wklejenia w szablonie maila i listę miejsc do sprawdzenia.
---
name: rekojmia-ue
description: Konfiguruje w sklepie Hummerce zharmonizowaną informację UE o rękojmi (legal guarantee notice, rozporządzenie 2025/1960) bez programowania - przez serwer MCP sklepu - grafiki, link "Twoje prawa z tytułu rękojmi" w ścieżce zakupowej, okno z pełną grafiką, strona "Rękojmia", podpięcia do obszarów, z podglądem przed zapisem. Użyj, gdy użytkownik prosi o wdrożenie informacji o rękojmi, legal guarantee notice albo "Twoje prawa z tytułu rękojmi" w sklepie Hummerce.
---
# Rękojmia - zharmonizowana informacja UE w sklepie Hummerce
Wprowadzasz konfigurację opisaną na stronie dokumentacji "Rękojmia - zharmonizowana informacja UE" (docs.hummerce.com, obszar Obsługa zamówień). Pracujesz wyłącznie narzędziami serwera MCP sklepu. Nie zmieniasz szablonów stron ani kodu.
## Zasady
- **Przed każdym zapisem pokaż podgląd i poczekaj na zatwierdzenie.** Import XML zawsze najpierw z `apply=false`.
- **Nie usuwaj istniejących treści.** Import podpięć do obszaru (`<contentLink>`) zastępuje wszystkie podpięcia tego obszaru - w XML powtarzasz każde istniejące podpięcie z jego `ord` i widocznością, a nowe dopisujesz za nimi.
- Sklep produkcyjny tylko na wyraźne polecenie użytkownika. Zacznij od sklepu testowego.
- Grafik UE nie zmieniasz (kolory, proporcje, treść). Używasz oficjalnych plików Komisji Europejskiej.
- Klucze i hasła tylko ze zmiennych środowiskowych - nie proś o ich wklejenie.
## Dane wejściowe (zapytaj, jeśli brak)
| Dane | Przykład |
|---|---|
| Serwer MCP sklepu | `sklep-test` |
| Języki sklepu | `pl`, `en` |
| Wygląd frontu | Bootstrap 5 (domyślnie) albo Bootstrap 4 |
| Pliki grafik | PNG z oficjalnych plików KE (PL, EN), np. `rekojmia-ue-pl.png`, `rekojmia-ue-en.png`, szerokość ok. 1200 px |
Wygląd frontu rozpoznasz na stronie sklepu: Bootstrap 5 ma atrybuty `data-bs-toggle`, Bootstrap 4 - `data-toggle` i jQuery.
## Kroki
### 1. Sklep
`ec2_system_info` - nazwa, wersja. Potwierdź z użytkownikiem, że to właściwy sklep.
### 2. Stan obszarów i stopki
- `ec2_canvas_list` - czy są obszary `plusShippingCost`, `cartTextBelowPrice`, `orderBelowDelivery`, `orderFinished`, `footerLeft`.
- `ec2_canvas_details` dla każdego z nich - zapisz podpięte treści (symbol, `ord`, widoczność) i limit (`shows at most`).
- `footerBox2` (blok "Informacje" w stopce): `ec2_content_details` podpiętej treści. Jeśli to menu stron (`_contentMenuStaticPage`, np. `informations_menu;...`), nową stronę "Rękojmia" dodasz jako podstronę tej strony - link w stopce pojawi się sam.
- Brak obszaru w liście nie oznacza braku miejsca w szablonie - import go założy. Jeśli po imporcie link się nie wyświetla, szablon sklepu nie ma tego miejsca: zgłoś to użytkownikowi (to osobne zadanie dla programisty).
### 3. Grafiki
- `ec2_config_search` z zapytaniem `rozszerz` - sprawdź dozwolone rozszerzenia zdjęć. PNG jest zawsze potrzebny (maile nie wyświetlają SVG); SVG tylko, jeśli sklep go dopuszcza.
- `ec2_image_upload`: `property="_contentImage"`, `locale` = język, `resize=false`, `fileName` = nazwa pliku. Adres grafiki w sklepie: `/images/_contentImage/<plik>`.
- Plik w base64 może być za duży na argument narzędzia. Wtedy wyślij go krótkim skryptem przez ten sam endpoint MCP (JSON-RPC: `initialize`, potem `tools/call` z nazwą `ec2_image_upload`), z kluczem ze zmiennej środowiskowej, której używa konfiguracja MCP.
- Sprawdź, że grafika otwiera się pod pełnym adresem sklepu (HTTP 200).
### 4. XML
Zbuduj plik według wzoru niżej:
- treści `rekojmiaLink`, `rekojmiaLinkCena`, `rekojmiaModal` dla każdego języka (`locale`),
- strona `rekojmia` (z `parent`, jeśli stopka to menu stron),
- obszary: istniejące podpięcia z kroku 2 + nowe, limity (`plusShippingCost` i `footerLeft` muszą pokazać co najmniej 2 treści),
- wariant okna Bootstrap 5 albo Bootstrap 4.
Adres strony "Rękojmia" w linkach: przyjazny adres (np. `/pl/rekojmia.html`) pojawia się dopiero po zapisaniu strony i wyczyszczeniu cache. Na pierwszy import użyj standardowego adresu strony statycznej sklepu; po kroku 6 możesz zamienić go na przyjazny i powtórzyć import samych treści.
### 5. Podgląd i zapis
- `ec2_extension_xml_import` z `apply=false` - pokaż wynik i XML użytkownikowi. Ostrzeżenie o "numerycznych id" przy limicie obszaru to fałszywy alarm.
- Po zatwierdzeniu: `apply=true`, `saveAs` = nazwa kopii pliku.
- Sprawdź: `ec2_canvas_details` (każdy obszar - stare i nowe podpięcia), `ec2_content_details` (treści), `ec2_pages_get` (strona, oba języki).
- Import obcina spację na początku wartości - separator w `rekojmiaLinkCena` to `| ` bez spacji przed nim (szablon rozdziela treści obszaru sam).
### 6. Pamięć podręczna (cache)
- Wywołaj `ec2_cache_clear` i przeczytaj odpowiedź. Sprawdź też opis narzędzia na liście narzędzi serwera.
- Jeśli odpowiedź potwierdza wyczyszczenie cache stron sklepu (obszarów, fragmentów stron) - przejdź dalej.
- Jeśli nie potwierdza albo wymienia cache, których nie wyczyściła (np. "Not cleared: module caches ... use the admin panel's clear-cache button") - poproś użytkownika: "Wyczyść cache w panelu: Status -> Cache" i poczekaj na potwierdzenie. Bez tego karta produktu i stopka mogą pokazywać starą wersję.
### 7. Mail z potwierdzeniem zamówienia
MCP nie zmienia szablonów maili. Podaj użytkownikowi blok do wklejenia (wzór niżej) i miejsce: **Konfiguracja -> Szablony**, szablon potwierdzenia zamówienia dla klienta (`orderForCustomer`), wersja HTML przed stopką maila i wersja tekstowa, w każdym języku. Wspólnej stopki maili nie zmieniaj.
### 8. Sprawdzenie
Podaj listę do sprawdzenia w sklepie (komputer i telefon, każdy język):
1. karta zwykłego produktu - link w wierszu pod ceną, okno po pierwszym kliknięciu,
2. okno - grafika czytelna, link Your Europe, "Otwórz w pełnym rozmiarze", zamykanie przyciskiem, Esc i kliknięciem obok,
3. koszyk - link pod kwotą łączną, odstęp od przycisku zamówienia,
4. formularz zamówienia - link pod danymi dostawy,
5. podsumowanie przed złożeniem (jeśli sklep ma ten krok) - jedno okno,
6. strona po złożeniu zamówienia,
7. stopka - link "Rękojmia", strona z grafiką,
8. mail z potwierdzeniem zamówienia.
Jeśli okno ma niewidoczny tytuł albo tekst - obszar w stopce ma jasny tekst na ciemnym tle; okno ustawia własny kolor tekstu (`text-dark` i `color:rgb(33,37,41)` we wzorze).
## Wzór XML (Bootstrap 5, PL i EN)
Zamień: `[ADRES-STRONY-PL]`, `[ADRES-STRONY-EN]`, `[GRAFIKA-PL]`, `[GRAFIKA-EN]` (np. `/images/_contentImage/rekojmia-ue-pl.png`), `[ALT-PL]`, `[ALT-EN]` (pełny tekst grafiki - przepisz go z pliku KE), `[RODZIC-STOPKI]` (strona menu stopki albo usuń atrybut `parent`), istniejące podpięcia obszarów.
```xml
<?xml version="1.0" encoding="UTF-8"?>
<extension>
<object target="content" symbol="rekojmiaLink">
<attribute name="visible" value="true" />
<property symbol="_contentType">static</property>
<property symbol="_contentHTML" locale="pl"><![CDATA[<span class="rekojmia-link small d-inline-block mt-1 mb-3"><a href="[ADRES-STRONY-PL]" data-bs-toggle="modal" data-bs-target="#rekojmiaModal" data-toggle="modal" data-target="#rekojmiaModal">Twoje prawa z tytułu rękojmi</a></span>]]></property>
<property symbol="_contentHTML" locale="en"><![CDATA[<span class="rekojmia-link small d-inline-block mt-1 mb-3"><a href="[ADRES-STRONY-EN]" data-bs-toggle="modal" data-bs-target="#rekojmiaModal" data-toggle="modal" data-target="#rekojmiaModal">Your legal guarantee rights</a></span>]]></property>
</object>
<object target="content" symbol="rekojmiaLinkCena">
<attribute name="visible" value="true" />
<property symbol="_contentType">static</property>
<property symbol="_contentHTML" locale="pl"><![CDATA[| <a href="[ADRES-STRONY-PL]" data-bs-toggle="modal" data-bs-target="#rekojmiaModal" data-toggle="modal" data-target="#rekojmiaModal">Twoje prawa z tytułu rękojmi</a>]]></property>
<property symbol="_contentHTML" locale="en"><![CDATA[| <a href="[ADRES-STRONY-EN]" data-bs-toggle="modal" data-bs-target="#rekojmiaModal" data-toggle="modal" data-target="#rekojmiaModal">Your legal guarantee rights</a>]]></property>
</object>
<object target="content" symbol="rekojmiaModal">
<attribute name="visible" value="true" />
<property symbol="_contentType">static</property>
<property symbol="_contentHTML" locale="pl"><![CDATA[<div class="modal fade" id="rekojmiaModal" tabindex="-1" aria-labelledby="rekojmiaModalTitle" aria-hidden="true">
<div class="modal-dialog modal-lg modal-dialog-centered modal-dialog-scrollable modal-fullscreen-sm-down">
<div class="modal-content text-dark" style="color:rgb(33,37,41)">
<div class="modal-header">
<h2 class="modal-title fs-5 text-dark" id="rekojmiaModalTitle" style="color:rgb(33,37,41)">Twoje prawa z tytułu rękojmi</h2>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Zamknij"></button>
</div>
<div class="modal-body text-center">
<img src="[GRAFIKA-PL]" loading="lazy" class="img-fluid" width="1200" height="1697" alt="[ALT-PL]">
<p class="mt-3 mb-1"><a href="https://europa.eu/youreurope/gwarancje" target="_blank" rel="noopener">europa.eu/youreurope/gwarancje</a></p>
<p class="mb-0"><a href="[GRAFIKA-PL]" target="_blank" rel="noopener">Otwórz w pełnym rozmiarze</a></p>
</div>
</div>
</div>
</div>]]></property>
<property symbol="_contentHTML" locale="en"><![CDATA[<div class="modal fade" id="rekojmiaModal" tabindex="-1" aria-labelledby="rekojmiaModalTitle" aria-hidden="true">
<div class="modal-dialog modal-lg modal-dialog-centered modal-dialog-scrollable modal-fullscreen-sm-down">
<div class="modal-content text-dark" style="color:rgb(33,37,41)">
<div class="modal-header">
<h2 class="modal-title fs-5 text-dark" id="rekojmiaModalTitle" style="color:rgb(33,37,41)">Your legal guarantee rights</h2>
<button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
</div>
<div class="modal-body text-center">
<img src="[GRAFIKA-EN]" loading="lazy" class="img-fluid" width="1200" height="1697" alt="[ALT-EN]">
<p class="mt-3 mb-1"><a href="https://europa.eu/youreurope/guarantees" target="_blank" rel="noopener">europa.eu/youreurope/guarantees</a></p>
<p class="mb-0"><a href="[GRAFIKA-EN]" target="_blank" rel="noopener">Open full size</a></p>
</div>
</div>
</div>
</div>]]></property>
</object>
<object target="page" symbol="rekojmia" parent="[RODZIC-STOPKI]">
<attribute name="type" value="html" />
<attribute name="visible" value="true" />
<property symbol="_title" locale="pl">Rękojmia</property>
<property symbol="_title" locale="en">Legal guarantee</property>
<property symbol="_contents" locale="pl"><![CDATA[<p>Kupując w naszym sklepie, korzystasz z ustawowej rękojmi (prawnego obowiązku zapewnienia zgodności towaru z umową). Poniżej zharmonizowana informacja Unii Europejskiej o Twoich prawach.</p>
<p class="text-center"><img src="[GRAFIKA-PL]" class="img-fluid" width="1200" height="1697" style="max-width:640px;width:100%;height:auto" alt="[ALT-PL]"></p>
<p class="text-center">Więcej informacji: <a href="https://europa.eu/youreurope/gwarancje" target="_blank" rel="noopener">europa.eu/youreurope/gwarancje</a></p>]]></property>
<property symbol="_contents" locale="en"><![CDATA[<p>When you buy in our shop, you are protected by the legal guarantee of conformity. Below is the harmonised European Union notice about your rights.</p>
<p class="text-center"><img src="[GRAFIKA-EN]" class="img-fluid" width="1200" height="1697" style="max-width:640px;width:100%;height:auto" alt="[ALT-EN]"></p>
<p class="text-center">More information: <a href="https://europa.eu/youreurope/guarantees" target="_blank" rel="noopener">europa.eu/youreurope/guarantees</a></p>]]></property>
</object>
<object target="canvas" symbol="plusShippingCost">
<property symbol="_contentDisplayLimit">2</property>
<contentLink symbol="[ISTNIEJĄCA-TREŚĆ]"><attribute name="ord" value="1" /><attribute name="visible" value="true" /></contentLink>
<contentLink symbol="rekojmiaLinkCena"><attribute name="ord" value="2" /><attribute name="visible" value="true" /></contentLink>
</object>
<object target="canvas" symbol="cartTextBelowPrice">
<attribute name="visible" value="true" />
<contentLink symbol="rekojmiaLink"><attribute name="ord" value="1" /><attribute name="visible" value="true" /></contentLink>
</object>
<object target="canvas" symbol="orderBelowDelivery">
<contentLink symbol="rekojmiaLink"><attribute name="ord" value="1" /><attribute name="visible" value="true" /></contentLink>
</object>
<object target="canvas" symbol="orderFinished">
<contentLink symbol="rekojmiaLink"><attribute name="ord" value="1" /><attribute name="visible" value="true" /></contentLink>
</object>
<object target="canvas" symbol="footerLeft">
<contentLink symbol="[ISTNIEJĄCA-TREŚĆ]"><attribute name="ord" value="0" /><attribute name="visible" value="true" /></contentLink>
<contentLink symbol="rekojmiaModal"><attribute name="ord" value="1" /><attribute name="visible" value="true" /></contentLink>
</object>
</extension>
```
W obszarach najpierw istniejące podpięcia (z `ec2_canvas_details`), potem nowe. Obszar, który ma już inną treść z `ord`, dostaje nową treść z wyższym `ord`. Obszar bez podpięć - tylko nowa treść. Gdy `footerLeft` ma limit 1, ustaw `_contentDisplayLimit` na 2.
## Okno - wariant Bootstrap 4
Ten sam link (`rekojmiaLink`, `rekojmiaLinkCena` - mają oba zestawy atrybutów). Zamiast okna Bootstrap 5 w `rekojmiaModal`:
```html
<div class="modal fade" id="rekojmiaModal" tabindex="-1" role="dialog" aria-labelledby="rekojmiaModalTitle" aria-hidden="true">
<div class="modal-dialog modal-lg modal-dialog-centered" role="document">
<div class="modal-content text-dark" style="color:rgb(33,37,41)">
<div class="modal-header">
<h2 class="modal-title h5 text-dark" id="rekojmiaModalTitle" style="color:rgb(33,37,41)">Twoje prawa z tytułu rękojmi</h2>
<button type="button" class="close" data-dismiss="modal" aria-label="Zamknij"><span aria-hidden="true">×</span></button>
</div>
<div class="modal-body text-center">
<img src="[GRAFIKA-PL]" loading="lazy" class="img-fluid" width="1200" height="1697" alt="[ALT-PL]">
<p class="mt-3 mb-1"><a href="https://europa.eu/youreurope/gwarancje" target="_blank" rel="noopener">europa.eu/youreurope/gwarancje</a></p>
<p class="mb-0"><a href="[GRAFIKA-PL]" target="_blank" rel="noopener">Otwórz w pełnym rozmiarze</a></p>
</div>
</div>
</div>
</div>
```
Wariant Bootstrap 4 nie był sprawdzony na sklepie - przy pierwszym wdrożeniu przejdź całą listę z kroku 8 i powiedz o tym użytkownikowi.
## Blok do maila (orderForCustomer)
HTML (PL; EN analogicznie: "Legal guarantee", grafika EN, europa.eu/youreurope/guarantees):
```html
<hr style="border: 0; border-top: 1px solid #e1e1e1; "/>
<h2 style="font-size: 20px; font-weight: bold; margin: 20px 0 10px 0; font-family: Arial, sans-serif; ">Rękojmia</h2>
<p style="margin: 0 0 10px 0;">Twoje prawa z tytułu rękojmi (prawnego obowiązku zapewnienia zgodności towaru z umową):</p>
<p style="margin: 0 0 10px 0; text-align: center;"><a href="$!{ctx.shop.configuration.url_Shop}[ADRES-STRONY-PL]"><img src="$!{ctx.shop.configuration.url_Shop}[GRAFIKA-PL]" width="600" style="display: block; margin: 0 auto; max-width: 100%; height: auto; border: 0;" alt="[ALT-PL]"/></a></p>
<p style="margin: 0 0 10px 0; text-align: center;">Więcej informacji: <a href="https://europa.eu/youreurope/gwarancje">europa.eu/youreurope/gwarancje</a></p>
```
Tekst (PL):
```
Rękojmia
Towary sprzedawane w Unii Europejskiej objęte są prawnym obowiązkiem zapewnienia ich zgodności z umową przez okres co najmniej dwóch lat (rękojmia).
Informacja o Twoich prawach: $!{ctx.shop.configuration.url_Shop}[ADRES-STRONY-PL]
Więcej informacji: https://europa.eu/youreurope/gwarancje
```
W mailu tylko PNG.