Dostępność EAA i WCAG 2.1 AA w PrestaShop: analizuj, naprawiaj, deklaruj

Od 28 czerwca 2025 r. Europejski akt o dostępności (European Accessibility Act, EAA) wymaga od sklepów internetowych sprzedających konsumentom w Unii Europejskiej, aby osoby z niepełnosprawnościami mogły z nich korzystać i aby informowały o swojej dostępności. Odniesieniem technicznym jest norma EN 301 549, która przejmuje kryteria WCAG 2.1 na poziomie AA.

Audyt EAA i WCAG 2.1 AA (EAA Accessibility Checker) prowadzi ten proces w panelu PrestaShop w czterech krokach: analiza stron sklepu, naprawa znalezionych problemów, sprawdzenie kryteriów wymagających oceny człowieka i publikacja deklaracji dostępności w każdym języku. Ten przewodnik wyjaśnia, jak zainstalować moduł, przeprowadzić pierwszą analizę i korzystać z niego na co dzień.

Najważniejsze zalety:

• Analiza prawdziwych stron w przeglądarce z axe-core, łącznie z kontrastem, oraz analiza przez serwer dla analiz zaplanowanych
• Uczciwy wynik: kryterium jest liczone jako spełnione dopiero po Twoim sprawdzeniu, bez otwartego problemu
• Wyjaśnione problemy, pogrupowane według elementu, ze sposobem naprawy w PrestaShop
• Sześć bezpiecznych poprawek automatycznych, włączanych pojedynczo
• Deklaracja dostępności według modelu europejskiego, wstępnie wypełniona dla sześciu krajów i publikowana w każdym języku

Poznaj moduł i jego plany

---

Prezentacja

Żadne narzędzie nie może samo uznać sklepu za dostępny: część kryteriów WCAG zależy od treści i sposobu korzystania (trafność tekstu alternatywnego, napisy, kolejność czytania). Dlatego moduł łączy kontrole automatyczne, ręczną listę kontrolną 50 kryteriów WCAG 2.1 A i AA (oraz opcjonalnie 6 kryteriów WCAG 2.2) i deklarację, która odzwierciedla rzeczywistość Twojego sklepu.

Jest przeznaczony dla sprzedawców PrestaShop, którzy chcą wiedzieć, na jakim etapie jest ich sklep, co naprawić i od czego zacząć, oraz zachować ślad swojej pracy dla klientów, agencji lub na wypadek kontroli. Moduł nie zastępuje porady prawnej; wstępnie wypełnione teksty deklaracji są punktem wyjścia do dostosowania.

Twój proces w czterech krokach, z uczciwym wynikiem

Funkcje

Analizuj strony tak, jak widzą je klienci

Ekran 1. Analizuj proponuje strony reprezentatywne dla każdego szablonu sklepu: stronę główną, kategorie, produkty z kombinacjami i bez, stronę CMS, markę, wyniki wyszukiwania, kontakt, logowanie, rejestrację i koszyk. Pierwszy zaznaczony język otrzymuje wszystkie typy stron; pozostałe języki otrzymują stronę główną, kategorię i produkt. Możesz dodać dowolny inny adres sklepu (stronę docelową, stronę modułu).

Dwa tryby analizy:

• W przeglądarce (zalecane): każda strona jest otwierana niewidocznie w Twoim oknie i sprawdzana przez axe-core tak, jak widzą ją odwiedzający. To jedyny tryb, który mierzy kontrast, atrybuty ARIA, treści dodane przez skrypty i efekt poprawek. Nie zamykaj strony w trakcie analizy: około piętnastu stron zajmuje mniej więcej minutę.
• Przez serwer: serwer odczytuje HTML stron i sprawdza reguły modułu (zdjęcia, etykiety, nazwy przycisków i linków, nagłówki, języki, formularze). To tryb analiz zaplanowanych; nie mierzy kontrastu.

Analiza prawdziwych stron, w przeglądarce

Strona, której nie można przeanalizować (na przykład strona logowania zastąpiona przez inny moduł, który przekierowuje na własną stronę), jest oznaczana jako nieprzeanalizowana, z podaniem przyczyny, bez zniekształcania wyników.

Śledź proces na panelu

Przegląd pokazuje liczbę spełnionych kryteriów WCAG 2.1 AA, problemy do naprawienia według wagi (poważny, umiarkowany, drobny), ostatnią analizę i jej przebieg, a następnie cztery kroki z ich stanem: Analizuj, Napraw, Sprawdź, Opublikuj. Kryterium jest liczone jako spełnione, gdy sprawdzisz je na liście kontrolnej, a żaden otwarty problem z analizy mu nie przeczy.

Naprawiaj znalezione problemy

Ekran 2. Napraw wyświetla otwarte problemy pogrupowane według elementu: ta sama usterka powtarzająca się na dziesiątkach stron pojawia się tylko raz, z liczbą stron, których dotyczy. Filtruj według stanu, wagi, miejsca naprawy (szablon, treści, zdjęcia katalogu, moduł) i kryterium WCAG.

Problemy do naprawienia, pogrupowane według elementu

Każdy problem ma swoją kartę: dlaczego jest ważny, jak go naprawić w PrestaShop, kryterium WCAG, element i jego fragment HTML oraz strony, na których występuje, z linkiem do ekranu panelu do edycji, jeśli istnieje (karta produktu, strona CMS, zdjęcia katalogu).

Dlaczego to ważne i jak to naprawić

Dla każdego problemu wybierz decyzję:

• Naprawiono, do potwierdzenia przez następną analizę: problem znów staje się otwarty, jeśli następna analiza nadal go znajduje.
• Znane ograniczenie: nadal liczy się przeciwko swoim kryteriom i jest proponowane w treściach niedostępnych deklaracji.
• Fałszywy alarm: przestaje się liczyć.

Decyzje są zachowywane między analizami. Działanie zbiorcze pozwala obsłużyć kilka wyświetlonych problemów naraz.

Włącz bezpieczne poprawki automatyczne

W Ustawieniach sześć poprawek sklepu włącza się osobno:

• Link pomijania: link „Przejdź do treści głównej”, widoczny po dotarciu do niego klawiaturą, tylko jeśli szablon nie ma już takiego linku.
• Nazwy przycisków i linków: nazwa dla przycisków i linków złożonych z ikony (koszyk, wyszukiwanie, menu, zamknij, ilość, media społecznościowe) na podstawie ich tytułu, ikony lub roli w szablonie.
• Ikony dekoracyjne: czcionki ikon i dekoracyjne SVG są ukrywane przed czytnikami ekranu, gdy element sterujący ma już nazwę.
• Etykiety formularzy: nazwa dla pól, które mają tylko tekst zastępczy (wyszukiwanie, newsletter), oraz naprawa etykiet wskazujących pole po nazwie zamiast po identyfikatorze.
• Autouzupełnianie: deklarowany jest cel pól formularzy konta i adresu (e-mail, imię i nazwisko, adres, telefon), aby przeglądarki mogły je wypełniać.
• Widoczny fokus: wyraźna obwódka wokół elementu osiągniętego klawiaturą, na każdym tle.

Bezpieczne poprawki, włączane pojedynczo

Każda poprawka dodaje tylko brakującą informację i nigdy nie usuwa tego, co deklaruje szablon. Ich efekt mierzy następna analiza w przeglądarce. Nie zastępują poprawki szablonu. W przeglądzie przycisk Włącz zalecane poprawki włącza pierwsze pięć naraz; widoczny fokus, który zmienia wygląd fokusu Twojego szablonu, włącza się osobno.

Uzupełniaj opisy zdjęć

Ekran Opisy zdjęć pokazuje dla każdego języka odsetek opisanych zdjęć produktów, a następnie zdjęcia strona po stronie, nawet w dużym katalogu. Filtruj według języka, stanu (bez opisu, z opisem, wszystkie) oraz nazwy lub referencji produktu. Przycisk Użyj nazwy produktu dla pustych opisów na tej stronie proponuje pierwszy opis; każdy opis zapisuje się od razu po wpisaniu.

Brakujące opisy zdjęć w kilka minut

Dobry tekst alternatywny opisuje w kilku słowach to, co pokazuje zdjęcie (kolor, ujęcie, szczegół), zamiast powtarzać nazwę produktu.

Sprawdzaj kryteria na liście kontrolnej

Ekran 3. Sprawdź przedstawia 50 kryteriów WCAG 2.1 A i AA wymaganych przez normę EN 301 549, pogrupowanych według zasad (postrzegalność, funkcjonalność, zrozumiałość, solidność), oraz 6 kryteriów WCAG 2.2 oznaczonych jako „zalecane”. Dla każdego kryterium:

• czego wymaga i konkretna wskazówka dla PrestaShop;
• co analiza z niego sprawdza (w całości, częściowo lub wcale);
• Twoja ocena: spełnione, niespełnione lub nie dotyczy;
• notatka (co sprawdzono, co zostało), z autorem i datą.

Każde kryterium WCAG ze wskazówką dla PrestaShop

Kryterium pozostaje „niespełnione”, dopóki analiza znajduje dla niego otwarty problem. Filtry według stanu, poziomu i wersji pomagają postępować partiami.

Opublikuj deklarację dostępności

Ekran 4. Opublikuj przygotowuje deklarację według modelu europejskiego (dyrektywa (UE) 2019/882, EN 301 549):

• Kraj odniesienia: ustawa krajowa i organ nadzoru są wstępnie wypełnione dla Francji, Belgii, Hiszpanii, Włoch, Polski i Niemiec i można je edytować; pozostałe kraje korzystają z modelu europejskiego.
• Stan zgodności: w pełni, częściowo lub niezgodny, z podpowiedzią wynikającą z listy kontrolnej.
• Kontakt: e-mail, opcjonalny telefon, link do formularza kontaktowego i czas odpowiedzi.
• Teksty dla każdego języka: podjęte działania, treści niedostępne i ich alternatywy (przycisk Wstaw niespełnione kryteria pobiera je z listy kontrolnej), opis usługi i procedura egzekwowania.

Deklaracja wstępnie wypełniona dla Twojego kraju

Włącz Opublikuj deklarację w sklepie: strona jest dostępna w każdym języku, pod czytelnym adresem, z linkiem w stopce każdej strony, jeśli go włączysz. Dopóki deklaracja nie jest opublikowana, adres odpowiada „nie znaleziono strony”, a jej podgląd jest dostępny w panelu.

Opublikowana deklaracja, w każdym języku

Planuj analizy i otrzymuj raport

W Ustawieniach włącz Analizuj sklep automatycznie, wybierz częstotliwość (codziennie, co tydzień, co miesiąc), dzień i godzinę, a następnie odbiorców raportu e-mailem. Raport pokazuje problemy otwarte, nowe i rozwiązane od poprzedniej analizy.

Analizy zaplanowane i raport e-mailem

Analizy startują, gdy hosting wykonuje jedno z dwóch zadań pokazanych w ustawieniach, co godzinę (zalecane) lub codziennie:

• polecenie do przekazania zadaniu cron hostingu;
• albo adres z sekretem, zgodny z modułem zadań cron PrestaShop („Cron tasks manager”). Przycisk tworzy nowy sekret.

Eksportuj raport

Ekran Raport otwiera datowany raport do druku (analizy, kryteria i problemy), który można zapisać w PDF poleceniem drukowania przeglądarki, oraz eksportuje problemy lub listę kontrolną w formacie CSV (do otwarcia w arkuszu kalkulacyjnym).

---

Instalacja

1. Pobierz archiwum modułu ze swojego konta klienta WePresta.
2. W panelu otwórz Moduły > Menedżer modułów i kliknij Wgraj moduł.
3. Prześlij plik ZIP.
4. Kliknij Konfiguruj, aby aktywować licencję, a następnie otwórz moduł przyciskiem na stronie lub z menu WePresta > Dostępność (EAA) (Moduły > Dostępność (EAA), gdy sklep nie ma menu WePresta).

Instalacja tworzy tabele modułu, czytelny adres deklaracji i pozycję menu. Żadna strona sklepu się nie zmienia, dopóki nie włączysz poprawki lub linku w stopce.

Pierwsza analiza

1. Otwórz 1. Analizuj, pozostaw zaznaczone W przeglądarce i proponowane strony.
2. Kliknij Rozpocznij analizę i nie zamykaj strony: każda strona pokazuje swoją liczbę problemów.
3. Otwórz 2. Napraw: zacznij od poważnych problemów występujących na wielu stronach, często związanych z szablonem.
4. Włącz zalecane poprawki w Ustawieniach, a następnie uruchom nową analizę, aby zmierzyć ich efekt.
5. Przejdź przez 3. Sprawdź, a potem przygotuj i opublikuj deklarację w 4. Opublikuj.

Sklep chroniony hasłem (środowisko testowe): podaj jego dane logowania HTTP w ustawieniach dla analiz przez serwer i analiz zaplanowanych.

Wymagania i zgodność

• PrestaShop 1.7.8, 8.0+ i 9.0+
• PHP 7.4 lub nowszy, rozszerzenie DOM
• Zadanie cron (lub moduł zadań cron PrestaShop) dla analiz zaplanowanych
• Jeden sklep lub multistore: każdy sklep ma własne analizy, listę kontrolną i deklarację
• Interfejs w języku polskim, francuskim, angielskim, hiszpańskim i włoskim

W sklepie axe-core ładuje się tylko na stronach otwieranych przez analizę; tylko włączone przez Ciebie poprawki dodają skrypt o rozmiarze około 5 KB po kompresji.

---

FAQ

Czym dokładnie jest EAA i dlaczego dotyczy Twojego sklepu?

Europejski akt o dostępności (European Accessibility Act, dyrektywa (UE) 2019/882) obowiązuje od 28 czerwca 2025 r. wiele usług cyfrowych, w tym handel elektroniczny skierowany do konsumentów w Unii Europejskiej. Sklep musi być dostępny dla osób z niepełnosprawnościami i informować o swojej dostępności. Odniesieniem technicznym jest norma EN 301 549, która przejmuje kryteria WCAG 2.1 na poziomie AA; mikroprzedsiębiorstwa świadczące usługi są z niej zwolnione. Moduł pomaga mierzyć, naprawiać, sprawdzać i dokumentować tę pracę; nie zastępuje porady prawnej.

WCAG 2.1 AA: co to konkretnie oznacza dla e-commerce?

WCAG 2.1 obejmują 50 kryteriów na poziomach A i AA: teksty alternatywne zdjęć, kontrast, obsługę klawiaturą, zrozumiałe formularze, nagłówki i strukturę, język stron i inne. W sklepie kluczowe są strona główna, listy produktów, karta produktu, koszyk, zamówienie i konto klienta. Moduł analizuje te szablony stron w każdym języku i dla każdego kryterium proponuje sprawdzenie dopasowane do PrestaShop.

Co wykrywa skaner dostępności i jak ustalane są priorytety problemów?

Analiza w przeglądarce opiera się na axe-core: sprawdza dziesiątki reguł WCAG A i AA na stronie w takiej postaci, w jakiej jest wyświetlana, łącznie z kontrastem. Analiza przez serwer, używana przez analizy zaplanowane, sprawdza HTML regułami modułu (zdjęcia, etykiety, nazwy przycisków i linków, nagłówki, języki, formularze). Problemy są klasyfikowane według wagi (poważny, umiarkowany, drobny), grupowane według elementu i przypisane do miejsca naprawy: szablon, treści, zdjęcia katalogu lub moduł.

Auto-Fix: jakie poprawki są wprowadzane automatycznie?

Sześć poprawek, każda włączana osobno: link „Przejdź do treści głównej” (tylko jeśli szablon go nie ma), nazwa dla przycisków i linków złożonych z ikony, ukrycie ikon dekoracyjnych przed czytnikami ekranu, etykiety dla pól, które mają tylko tekst zastępczy (wyszukiwanie, newsletter), autouzupełnianie w formularzach konta i adresu oraz widoczny fokus na każdym tle. Dodają brakującą informację, nie usuwając tego, co deklaruje szablon, a następna analiza w przeglądarce mierzy ich efekt.

Czy Auto-Fix wystarczy, aby osiągnąć 100% zgodności?

Nie, i żadne narzędzie tego nie zapewni. Poprawki automatyczne usuwają typowe usterki techniczne, ale wiele kryteriów zależy od treści i sposobu korzystania: trafnych tekstów alternatywnych, napisów do filmów, kolejności czytania, zrozumiałych komunikatów o błędach. Skuteczny proces to: (1) analiza, (2) poprawienie szablonu i treści z pomocą bezpiecznych poprawek, (3) sprawdzenie kryteriów ręcznych na liście kontrolnej, (4) opublikowanie deklaracji zgodnej z rzeczywistością.

Jak zarządzać tekstami alternatywnymi (ALT) na dużą skalę, bez tygodni pracy?

Edytor opisów wyświetla zdjęcia produktów strona po stronie, dzięki czemu działa szybko także w dużym katalogu. Filtruj według języka, produktu lub referencji oraz zdjęć bez opisu; przycisk proponuje nazwę produktu dla wszystkich pustych opisów na stronie, a każdy opis zapisuje się od razu po wpisaniu. Dobry tekst alternatywny opisuje to, co pokazuje zdjęcie (kolor, ujęcie, szczegół), zamiast powtarzać nazwę produktu.

Dlaczego ręczna lista kontrolna jest niezbędna, nawet z automatycznym skanerem?

Maszyna nie oceni, czy tekst alternatywny jest trafny, czy są napisy, jaka jest kolejność fokusu ani czy komunikat o błędzie jest jasny. Lista kontrolna obejmuje 50 kryteriów WCAG 2.1 A i AA oraz, jako zalecaną opcję, 6 kryteriów WCAG 2.2, pogrupowanych według zasad. Dla każdego kryterium: konkretna wskazówka dla PrestaShop, Twoja ocena (spełnione, niespełnione, nie dotyczy), notatki, autor i data. Kryterium pozostaje „niespełnione”, dopóki analiza znajduje dla niego otwarty problem.

Do czego służy deklaracja dostępności i jak jest tworzona?

Informuje klientów o poziomie dostępności Twojej usługi, o treściach niedostępnych i ich alternatywach oraz o tym, jak się z Tobą skontaktować lub dochodzić swoich praw. Moduł przygotowuje ją według modelu europejskiego, z ustawą krajową i organem nadzoru wypełnionymi dla Francji, Belgii, Hiszpanii, Włoch, Polski i Niemiec (z możliwością edycji lub z modelem europejskim dla innych krajów). Wybierasz stan zgodności, piszesz teksty w każdym języku i publikujesz osobną stronę, z linkiem w stopce, jeśli chcesz.

Czy można zautomatyzować skanowanie (CRON) i otrzymywać alerty w razie regresji?

Tak. Wybierz częstotliwość (codziennie, co tydzień lub co miesiąc), dzień i godzinę: zadanie cron Twojego hostingu albo moduł zadań cron PrestaShop („Cron tasks manager”) z tajnym adresem pokazanym w ustawieniach uruchamia analizę, gdy tylko minie zaplanowany moment. Raport e-mailem pokazuje problemy otwarte, nowe i rozwiązane od poprzedniej analizy.

Wydajność i wymagania: czy moduł spowalnia front-office? jakie są warunki techniczne?

Analizy uruchamia się z panelu: axe-core ładuje się tylko na stronach otwieranych przez analizę. W sklepie tylko włączone przez Ciebie poprawki dodają skrypt o rozmiarze około 5 KB po kompresji i mały arkusz stylów. Wymagania: PrestaShop 1.7.8, 8.0+ lub 9.0+, PHP 7.4 lub nowszy i rozszerzenie DOM; dostęp do cron przydaje się do analiz zaplanowanych.

Dlaczego analizować w przeglądarce, a nie na serwerze?

Przeglądarka widzi stronę tak jak klienci: z zastosowanymi stylami, treściami dodanymi przez JavaScript i prawdziwymi kolorami. Tylko tak można zmierzyć kontrast i efekt poprawek automatycznych. Analiza przez serwer pozostaje przydatna dla analiz zaplanowanych; w przypadku sklepu chronionego hasłem (środowisko testowe) podaj jego dane logowania HTTP w ustawieniach.

Czy moduł działa w trybie multistore i w PrestaShop 1.7?

Tak. Każdy sklep ma własne analizy, listę kontrolną i deklarację; gdy zaznaczonych jest kilka sklepów, moduł prosi o wybranie jednego. Ten sam moduł działa w PrestaShop 1.7.8, 8.0+ i 9.0+ z PHP 7.4 lub nowszym.

Co się stanie, jeśli używałem już wersji 1 modułu?

Aktualizacja zachowuje listę kontrolną, kontakt deklaracji i ustawienia analiz zaplanowanych. Dawne wyniki analiz są zastępowane wynikami nowej analizy. Następnie przejrzyj deklarację i opublikuj ją ponownie z ekranu Opublikuj: nie wraca do sieci automatycznie.

---

Wsparcie

W razie potrzeby skontaktuj się z nami przez konto klienta WePresta lub e-mailem pod adresem mail@wepresta.shop, zgodnie z opcją wsparcia w Twoim planie.

Zanim do nas napiszesz, przygotuj:

• wersje PrestaShop i PHP
• używany szablon
• adres danej strony i zrzut ekranu karty problemu

---

Changelog

Wersja 2.0.0

Nowości

• Analizuj strony w przeglądarce z axe-core: obliczony kontrast, atrybuty ARIA i treści dodane przez skrypty.
• Prowadź proces w czterech krokach: Analizuj, Napraw, Sprawdź, Opublikuj.
• Znajdź każdy problem pogrupowany według elementu, ze sposobem naprawy w PrestaShop i linkiem do ekranu do edycji.
• Oznacz fałszywy alarm lub znane ograniczenie: Twoja decyzja jest zachowywana w kolejnych analizach.
• Sprawdź 50 kryteriów WCAG 2.1 A i AA oraz opcjonalnie 6 kryteriów WCAG 2.2, ze wskazówką dla każdego kryterium.
• Opublikuj deklarację dostępności według modelu europejskiego, z ustawą i organem wypełnionymi dla sześciu krajów.
• Dodaj link do deklaracji w stopce sklepu.
• Eksportuj raport do druku oraz problemy lub listę kontrolną w formacie CSV.
• Uruchamiaj analizy zaplanowane zadaniem cron hostingu lub tajnym adresem.
• Używaj modułu w PrestaShop 1.7.8, 8.0+ i 9.0+ z PHP 7.4 lub nowszym.

Ulepszenia

• Kryterium jest liczone jako spełnione dopiero po Twoim sprawdzeniu i bez otwartego problemu.
• Analizowane strony reprezentują każdy szablon sklepu, w każdym języku.
• Analiza przez serwer sprawdza więcej reguł: nagłówki, języki, formularze, autouzupełnianie, powiększanie.
• Każdą poprawkę automatyczną włącza się osobno, a jej efekt mierzy następna analiza.
• Edytor opisów działa szybko w dużym katalogu i zapisuje każdy opis zaraz po wpisaniu.
• Raport e-mailem pokazuje nowe i rozwiązane problemy.
• Moduł otwiera się z menu WePresta, z interfejsem w pięciu językach.
• Adres dodany ręcznie jest ograniczony do domen Twojego sklepu.

Poprawki

• Publiczna strona deklaracji wyświetla swoją treść.
• Analizy zaplanowane znów są wykonywane.
• Zignorowanie problemu nie liczy go już jako naprawionego.
• Zdjęcia bez tekstu alternatywnego nie otrzymują już tekstu „Image”.
• Link pomijania jest umieszczany na początku strony, bez dublowania linku szablonu.
• Otwarcie modułu nie czyści już pamięci podręcznej sklepu.
• Uprawnienia profili pracowników są przestrzegane w PrestaShop 8.

Po aktualizacji: lista kontrolna, kontakt deklaracji i ustawienia analiz zaplanowanych zostają zachowane; przejrzyj deklarację i opublikuj ją ponownie z ekranu Opublikuj.

Wersja 1.0.0

• Pierwsze wydanie
• Silnik skanowania WCAG 2.1 AA
• Zintegrowany system Auto-Fix
• Edytor tekstów alternatywnych
• Generator wielojęzycznej deklaracji dostępności

Poznaj moduł i jego plany