Migracja z WordPress do Astro we Wrocławiu
Wiele firm we Wrocławiu korzysta z WordPressa, ale napotyka ograniczenia wydajności, bezpieczeństwa i kosztów hostingu. Astro rozwiązuje te problemy dzięki statycznemu HTML, zerowej ilości JavaScriptu i wdrożeniu na edge. Migruję istniejące strony WordPress do Astro z pełnym zachowaniem SEO, mapowaniem URL i przekierowaniami 301.
- PageSpeed 95-100
Statyczny HTML bez JavaScriptu. Szybsze niż jakiekolwiek rozwiązanie WordPress.
- Bezpieczna migracja SEO
Mapowanie URL, przekierowania 301, zachowanie pozycji w Google.
- Hosting na Cloudflare Pages
Globalny CDN, darmowy SSL, natychmiastowe wdrożenia. Koszty hostingu bliskie zeru.
Dostępna strona w Astro zaczyna się od HTML-a, a psuje się w wyspach
W Astro komponent bez dyrektywy client:* trafia na stronę jako sam HTML, bez JavaScriptu. Dokumentacja opisuje wyspę jako “enhanced UI component on an otherwise static page of HTML”, czyli ulepszony komponent na statycznej stronie. Dla dostępności to dobra wiadomość: nagłówki, listy, linki, przyciski i formularze są zwykłymi znacznikami, które czytnik ekranu i klawiatura obsługują bez dodatkowej pracy.
Problemy pojawiają się tam, gdzie dochodzi interaktywność: menu mobilne, okno koszyka, kalkulator, wyszukiwarka, baner zgód. To właśnie te elementy buduję jako wyspy i to je sprawdzam najdokładniej. Strony i sklepy dla firm z Wrocławia piszę w Astro, TypeScripcie i Tailwindzie, pracuję zdalnie, a wygląd dostaję od ciebie.

Zdjęcie: Jar.ciurus, CC BY-SA 3.0 pl, Wikimedia Commons.
Co w Astro robię inaczej, żeby strona była dostępna
Semantyka i układ strony
Jedna strona ma jeden h1, znaczniki header, nav, main i footer, a kolejność nagłówków odpowiada treści, nie wyglądowi. Każda podstrona ma własny title. To nie jest kosmetyka: gdy w Astro włączysz przejścia widoków, router dodaje element aria-live ustawiony na assertive, a czytnik ekranu ogłasza po nawigacji tekst z title, a gdy go brak, pierwszy h1, a na końcu ścieżkę adresu. Dokumentacja Astro zaleca, żeby zawsze podawać title.
Dyrektywy client i wybór wyspy
Dyrektywy różnią się chwilą ładowania: client:load ładuje i uwodnia komponent od razu, client:idle po zakończeniu początkowego ładowania, client:visible dopiero po wejściu w widok, a client:media po spełnieniu zapytania CSS. Wyjątkiem jest client:only, która według dokumentacji pomija renderowanie HTML na serwerze. Dla treści, bez której formularz nie ma sensu, taka wyspa oznacza pustą stronę do chwili załadowania skryptu, więc w nawigacji, formularzach i koszyku jej nie używam.
Przejścia widoków, fokus i animacje
Dokumentacja przejść widoków opisuje komponent, który przy ustawieniu prefers-reduced-motion wyłącza animacje, także zastępcze, i po prostu podmienia elementy DOM. Zostawiam to włączone. Moduły skryptów z paczki wykonują się tylko raz, więc kod, który ma działać po każdej nawigacji, podpinam pod zdarzenie astro:page-load. Dokumentacja nie opisuje, gdzie ląduje fokus klawiatury po przejściu, dlatego po każdej nawigacji sprawdzam to ręcznie i w razie potrzeby ustawiam fokus sam.
Co sprawdza narzędzie deweloperskie Astro
Pasek deweloperski ma aplikację Audit, która na bieżącej stronie szuka typowych problemów z dostępnością i wydajnością, a wyniki wyróżnia na stronie. Dokumentacja zaznacza, że to nie zastępuje Pa11y ani Lighthouse, a pasek nie pojawia się na opublikowanej stronie. Traktuję go jako pierwszy filtr przy pisaniu komponentów, nie jako dowód zgodności.
Ustawa o dostępności a sklep internetowy
Ustawa z 26 kwietnia 2024 r. o zapewnianiu spełniania wymagań dostępności niektórych produktów i usług przez podmioty gospodarcze (Dz.U. 2024 poz. 731) weszła w życie 28 czerwca 2025 r. Wdraża dyrektywę (UE) 2019/882. Co z niej wynika dla sklepu:
- usługi handlu elektronicznego to według art. 5 pkt 32 usługi oferowane na odległość przez strony internetowe i urządzenia mobilne, drogą elektroniczną i na indywidualne żądanie konsumenta w celu zawarcia umowy,
- ustawa obejmuje je w art. 3 ust. 2, ale art. 4 pkt 1 wyłącza usługi mikroprzedsiębiorców,
- art. 12 ust. 2 wymaga, żeby informacje o usłudze były podane w sposób zapewniający postrzegalność, funkcjonalność, zrozumiałość i kompatybilność, a strony internetowe i aplikacje mobilne były jednolite pod tymi względami,
- art. 32 nakłada na usługodawcę obowiązek oceny zgodności usługi i podania w regulaminie lub równoważnym dokumencie informacji o tym, jak usługa spełnia wymagania dostępności; informacje trzeba przechowywać przez cały czas, gdy usługa jest w ofercie,
- nadzór nad usługami handlu elektronicznego sprawuje minister właściwy do spraw informatyzacji (art. 38 ust. 3 pkt 2), a zawiadomienie o niespełnianiu wymagań może złożyć każdy do Prezesa Zarządu PFRON (art. 67).
Tekst ustawy nie odsyła do WCAG z nazwy. Art. 20 ust. 1 przewiduje domniemanie zgodności dla usług zgodnych z normami zharmonizowanymi lub specyfikacjami technicznymi. W praktyce przy audycie i przy opisie w regulaminie posługuję się WCAG 2.2 jako listą kontrolną, a ocenę prawną zostawiam twojemu prawnikowi.
WCAG 2.2 i trzy kryteria, które wychodzą na sklepach
WCAG 2.2 jest rekomendacją W3C z 12 grudnia 2024 r. (w3.org). Dodała m.in. kryteria 2.4.11, 2.5.7, 2.5.8, 3.2.6, 3.3.7 i 3.3.8, a usunęła 4.1.1 Parsing. Trzy z nich najczęściej dotykają stron firmowych i sklepów:
| Kryterium | Poziom | Co oznacza na stronie |
|---|---|---|
| 2.4.11 Focus Not Obscured (Minimum) | AA | Element z fokusem nie może być w całości zasłonięty przez treść stworzoną przez autora strony. Dokumentacja W3C podaje jako przykłady przyklejony nagłówek, przyklejoną stopkę i niemodalne okna; baner zgód zasłaniający cały element z fokusem to błąd. |
| 2.5.8 Target Size (Minimum) | AA | Cel dla wskaźnika ma mieć co najmniej 24 na 24 piksele CSS, z wyjątkami: odstęp, odpowiednik, tekst w zdaniu, kontrola przeglądarki i konieczność. |
| 3.3.8 Accessible Authentication (Minimum) | AA | Logowanie nie może wymagać testu poznawczego, jak zapamiętanie hasła, bez alternatywy. Wsparcie dla menedżerów haseł i wklejanie to akceptowane mechanizmy, a blokowanie wklejania hasła jest błędem. |
W koszyku i zamówieniu patrzę też na 3.3.7 Redundant Entry, czyli na to, żeby nie kazać wpisywać tych samych danych dwa razy.
Wrocław: standardy miejskie i deklaracja dostępności aplikacji
Wrocław ma od 2019 roku Wrocławskie standardy dostępności, przygotowane przez Fundację “Polska Bez Barier” na zlecenie miasta, według miejskiego serwisu szóste takie opracowanie w Polsce po Gdyni, Warszawie, Łodzi, Koninie i Poznaniu. Dotyczą przestrzeni fizycznej i są skierowane do architektów, planistów i urzędników, więc ze stroną internetową łączy je tylko to, że miasto samo uznało dostępność za rzecz do uregulowania.
Kiedy lepiej zostać przy WordPressie
Dostępność nie jest powodem do zmiany technologii. Jeśli twój sklep działa na WooCommerce, a usterki siedzą w motywie, wtyczce płatności albo banerze zgód, często wystarczy poprawka w istniejącym motywie, bez nowego frontendu. Jeśli prowadzisz mikroprzedsiębiorstwo, ustawa o dostępności nie obejmuje twoich usług, więc nacisk prawny jest mniejszy, a argument zostaje biznesowy: klient z czytnikiem ekranu albo bez myszy po prostu kupi gdzie indziej. Astro wybieram, gdy i tak budujesz nowy frontend, na przykład przy przebudowie z Next.js albo przy stronie opartej na treści. Sklepy i wtyczki WordPressa opisuję na stronach o programiście WordPress we Wrocławiu i o WooCommerce we Wrocławiu. Gdy projekt wymaga aplikacji w React, zobacz programistę Next.js we Wrocławiu.
Od briefu do odbioru
- Piszesz do mnie krótki brief: adres strony, cel, termin i obecny stack.
- Odpowiadam na piśmie pytaniami i wskazuję, co musisz mi przekazać: dostęp do repozytorium albo hostingu, projekt graficzny (arkusz układu, makiety), treści.
- Dostajesz pisemny zakres i założenia. Zmiany poza zakresem wyceniam osobno i zaczynam je po twojej akceptacji.
- Pracuję na stagingu, a wyniki audytu dostępności dostajesz jako listę: kryterium WCAG, miejsce na stronie, zalecana poprawka.
- Po odbiorze możesz zamówić opiekę, w której pilnuję aktualizacji zależności i powtarzam przegląd po większych zmianach.
Co przygotować przed startem:
- adres strony i dostęp do kodu,
- projekt graficzny od ciebie albo twojego projektanta,
- informację, czy jesteś mikroprzedsiębiorcą, bo od tego zależy, czy ustawa cię obejmuje,
- dotychczasowy regulamin sklepu, do którego dopiszę informację o dostępności.
Wydajność oceniam według progów Google z web.dev: LCP do 2,5 s, INP do 200 ms, CLS do 0,1.
Najczęstsze pytania
Czy ustawa o dostępności dotyczy mojego sklepu internetowego?
Obejmuje usługi handlu elektronicznego, czyli oferowane na odległość przez strony internetowe i urządzenia mobilne (art. 3 ust. 2 i art. 5 pkt 32 ustawy, Dz.U. 2024 poz. 731). Wyłączone są z niej usługi oferowane przez mikroprzedsiębiorców (art. 4 pkt 1). Czy jesteś mikroprzedsiębiorcą, sprawdzisz w przepisach o swobodzie działalności gospodarczej. Sklep większej firmy powinien zakładać, że ustawa go dotyczy.
Czy Astro samo gwarantuje dostępność?
Nie. Astro domyślnie wysyła HTML bez JavaScriptu, co pomaga, ale znaczniki, kontrast, etykiety pól i obsługa klawiatury zależą od kodu komponentów i od projektu graficznego. Narzędzie deweloperskie Astro sprawdza tylko podstawowe rzeczy i nie zastępuje Pa11y ani Lighthouse.
Czy strona w Astro musi być w całości statyczna, żeby była dostępna?
Nie. Wyspa z dyrektywą client:load, client:idle albo client:visible jest najpierw renderowana do HTML na serwerze. Tylko client:only pomija renderowanie po stronie serwera, więc nie używam jej dla nawigacji ani formularzy.
Jak sprawdzasz dostępność przed odbiorem?
Przechodzę kluczowe ścieżki (formularz, koszyk, zamówienie) samą klawiaturą i czytnikiem ekranu, uruchamiam automatyczne audyty i spisuję wyniki na piśmie, z odniesieniem do kryteriów WCAG 2.2. Automat nie znajdzie wszystkiego, dlatego ręczny przegląd jest częścią zakresu.
Kto dostarcza projekt graficzny?
Projekt graficzny i makiety dostarczasz ty albo twój projektant, a ja je wdrażam. Jeśli kontrast, rozmiar przycisków albo kolejność elementów kłóci się z WCAG, opisuję to na piśmie i proponuję poprawkę, zanim zacznie się kodowanie.
Czy lepiej zostać przy WordPressie?
Często tak. Jeśli sklep działa na WooCommerce, a problemy dotyczą motywu i kilku wtyczek, poprawki w istniejącym motywie często wystarczą bez przebudowy na nowy stack. Astro ma sens, gdy i tak planujesz nowy frontend.
Napisz do mnie
Wyślij mi adres strony, to, co ma osiągnąć, termin i obecny stack, a przygotuję pisemną odpowiedź z propozycją pierwszych kroków. Pierwsza wstępna wycena jest bezpłatna. Całość załatwiamy na piśmie przez formularz kontaktowy.
Wybrane projekty
Przykłady mojej pracy.
E-commerce Development: KTS IOS/ANDROID APP
Projekt aplikacji eventowej dedykowanej 15. Konferencji Technik Szerokopasmowych to aplikacja oparta na WordPressie, które umożliwia łatwą edyc...
E-commerce Development: led-lumina.pl
led-lumina.pl to profesjonalny serwis internetowy, który prezentuje kompleksową ofertę innowacyjnych rozwiązań LED dla klientów indywidualnych i biznesowych....
E-commerce Development: mochola.com
Mochola.com to sklep WooCommerce z częściami samochodowymi, integracją stanów magazynowych, płatności, kurierów i WFmag. Projekt skupiał się na danych produktowych, dostępności towaru i stabilnej obsłudze zamówień.
Wsparcie techniczne WordPress we Wrocławiu
Najbliższe wydarzenia WordPress
Spotkaj się z nami na WordCampie
Dołącz do społeczności WordPress we Wrocławiu. Regularnie bywam na meetupach i WordCampach w całej Polsce - WordUp Trójmiasto, WordCamp Polska i WordCamp Europe. Podejdź i porozmawiajmy.
Dodaj kalendarz WPPotrzebujesz usługi: Programista Astro we Wrocławiu?
Opisz projekt mailem. Odpowiadam w ciągu 48 godzin.
Opisz projektSprawdź inne usługi WordPress i bazę wiedzy
WCAG 2.2, BFSG, EAA - raport zgodności z ścieżką naprawy.
Audyt CrUX i atrybucja LCP, INP, CLS per template.
Dedykowany development i architektura WordPress.
Porządek w strukturze, treści i ścieżce konwersji.
Core Web Vitals, cache i szybki frontend.
Mapowanie NIS2 i DORA, rejestr dostawców, runbook incydentów.
Powiązane kategorie
Artykuły wspierające temat

Polski Akt o Dostępności i EAA wymagają opublikowanej deklaracji dostępności z działającym mechanizmem zgłaszania skarg, nie tylko zgodnego front-endu. To gotowa do skopiowania struktura szablonu, zmapowana na klauzule EN 301 549 i konkretne działania na WordPressie.

WCAG 2.2 stało się rekomendacją W3C 2023-10-05. Europejski akt o dostępności (dyrektywa 2019/882) obowiązuje od 2025-06-28. Niemiecka Barrierefreiheitsstärkungsgesetz transponuje go do prawa federalnego w tym samym dniu. Ten artykuł to mapa wdrożenia dla witryny WordPress w 2026.

Niemiecki Barrierefreiheitsstärkungsgesetz obowiązuje od 28 czerwca 2025. Transponuje dyrektywę EAA 2019/882 do prawa krajowego. Wyjaśniam, jak dotyka sklepy WooCommerce w Niemczech, i pokazuję cztery wzorce wtyczek, które najczęściej oblewają audyt.