Moje miejsce w społeczności WordPress
- Konto na wordpress.org mam od 2006 roku.
- Współtworzyłem rdzeń WordPressa w wersjach 7.0 i 7.1.
- Utrzymuję 30 wtyczek na wordpress.org.
- Organizuję WordCampy i występuję na nich jako prelegent.
- Byłem na każdym WordCamp Europe od 2017 do 2026 roku.
- Lokalne spotkania WordPressa: WordUp Kraków
Next.js dla krakowskich firm: co tu naprawdę rozstrzyga o jakości
Piszę frontendy w Next.js 16 dla firm, które sprzedają, rekrutują albo pokazują ofertę w sieci, a ich zaplecze stoi w WordPressie, WooCommerce albo własnym API. Nie opisuję tu każdej funkcji frameworka. Opisuję trzy miejsca, w których projekty w Polsce najczęściej tracą: metadane i mapy witryn w języku polskim, płatności potwierdzane po stronie serwera oraz dostępność komponentów klienckich.
Pracuję sam, zdalnie, od 2006 roku z WordPressem. Układ widoków, makiety i projekt graficzny dostarczasz ty albo twój grafik, ja wdrażam je w działającym, responsywnym interfejsie.
Skąd w Krakowie zapotrzebowanie na dobry frontend
Krakowski Park Technologiczny ma siedzibę przy ul. Podole 60 i drugi budynek w Czyżynach, przy ul. Życzkowskiego 14, a w ofercie biura w Ruczaju i Czyżynach, coworking oraz programy dla firm. Na swojej stronie opisuje hub4industry jako punkt wsparcia dla firm przemysłowych, które wprowadzają rozwiązania przemysłu 4.0, oraz KPT ScaleUp, program akceleracyjny dla firm przemysłowych z konkretnymi zapotrzebowaniami. Dla branży gier KPT działa od 2012 roku, głównie pod marką Digital Dragons, a jej konferencja odbywa się co roku w maju w ICE Kraków Congress Centre.
Dla briefu to wygodny punkt odniesienia: producent z hubu przemysłowego i studio gier mają różnych odbiorców, ale obie firmy potrzebują serwisu, który opisuje ofertę po polsku i po angielsku, nie dźwiga zbędnych skryptów i pokazuje poprawny podgląd po wklejeniu linku.

Zdjęcie: Igor123121, CC BY 4.0, Wikimedia Commons.
Miasto samo przesuwa pierwszy krok nowych firm do sieci. W komunikacie na krakow.pl z 29 października 2026 r. Urząd Miasta informuje, że od 1 listopada 2026 r. wnioski o wpis nowej firmy do CEIDG składa się wyłącznie drogą elektroniczną: przez Biznes.gov.pl, usługę Firma w aplikacji mObywatel albo wybrane bankowości elektroniczne. Zmiany danych i zawieszenie działalności można dalej załatwić w Punkcie Obsługi Przedsiębiorcy przy ul. Zabłocie 22. Nowa firma zakłada więc działalność w sieci, a zaraz potem potrzebuje strony, na której klient znajdzie jej nazwę i ofertę.
Metadane i hreflang w App Routerze, bez niespodzianek
W Next.js 16 metadane definiujesz eksportem metadata albo funkcją generateMetadata, a oba działają tylko w komponentach serwerowych. To ma praktyczny skutek dla stron z interaktywnością: plik page.tsx zostaje serwerowy, a formularz czy konfigurator trafia do osobnego pliku z dyrektywą 'use client'.
Kilka zasad, które stosuję w polskich serwisach:
metadataBasew głównym layoucie. Bez niej względna ścieżka w polu wymagającym pełnego adresu kończy się błędem budowania. Z niąalternates.canonicali obrazy Open Graph mają pełne adresy.alternates.languagesdla wersji językowych. Z tej samej konfiguracji powstają znacznikilink rel="alternate" hreflang. Kody języków składam z jednej listy adresów, a nie wpisuję ręcznie na każdej stronie.- Płytkie scalanie. Dokumentacja podkreśla, że zagnieżdżone pola, jak
openGraphirobots, zdefiniowane w layoucie są w całości zastępowane przez stronę, która ustawi własne. Częsty skutek to strona bez opisu Open Graph, bo ktoś podał tylko tytuł. openGraph.locale. Dokumentacja pokazuje formaten_US, więc dla polskiej wersji podajępl_PL.- Szablon tytułu.
title.templatedziała dla segmentów potomnych, a nie dla segmentu, w którym go zdefiniowano, i wymagatitle.default. Tytuł strony głównej bywa przez to inny niż reszty.
Osobny wątek to podgląd linku w komunikatorach i na portalach społecznościowych. Od wersji 15.2 metadane mogą być doładowane strumieniowo po wysłaniu pierwszego widoku. Dokumentacja pisze, że roboty wykonujące JavaScript, jak Googlebot, interpretują je poprawnie, a dla robotów, które go nie wykonują, jak facebookexternalhit, serwer czeka na generateMetadata i umieszcza metadane w head. Dla każdej ważnej strony sprawdzam na wdrożonej wersji, co zwraca serwer, zanim uznam sprawę za zamkniętą.
Mapa witryny z WordPressa do Next.js
Gdy treść żyje w WordPressie, mapa witryny frontendu musi znać jego wpisy, ale ich adresy mają wyglądać tak, jak adresy w Next.js. Plik sitemap.ts zwraca tablicę adresów z lastModified, a od wersji 14.2 także z alternates.languages, więc hreflang trafia również do mapy.
Z REST API WordPressa potrzebuję trzech rzeczy z dokumentacji:
- Nagłówków
X-WP-TotaliX-WP-TotalPages, które mówią, ile wpisów i stron wyników jest do przejścia. - Parametru
per_page, ograniczonego do 100 rekordów na żądanie. - Parametru
_fields, który ogranicza odpowiedź do wskazanych pól, na przykładslugimodified. Dokumentacja pisze, że WordPress pomija wtedy niepotrzebne pola przy budowaniu odpowiedzi.
Dla dużego katalogu produktów dzielę mapę funkcją generateSitemaps. W przykładzie z dokumentacji Next.js limit Google to 50 000 adresów na mapę, a w wersji 16 parametr id jest obietnicą (promise), na którą trzeba poczekać przez await. Każdy adres w mapie sprawdzam potem względem tego, co frontend naprawdę zwraca, bo mapa z adresami przekierowanymi albo nieistniejącymi jest gorsza niż jej brak.
Płatności: potwierdzenie przychodzi z serwera, nie z przeglądarki
Na przykładzie PayU, którego dokumentacja jest publiczna, widać wzorzec dla każdej polskiej bramki. Po zakończonej płatności klient wraca na adres continueUrl, ale to nie jest dowód zapłaty. Dowodem jest powiadomienie, które PayU wysyła na notifyUrl przy każdej zmianie statusu: PENDING, WAITING_FOR_CONFIRMATION, COMPLETED albo CANCELED.
Z dokumentacji cyklu życia płatności wynikają wymagania, które przekładam na Route Handler w Next.js:
- Odpowiedź 200. Każdy inny kod powoduje ponowną wysyłkę. Dokumentacja podaje 20 prób, od natychmiastowej do wysłanej do 72 godzin po pierwszej.
- Duplikaty. Ten sam status może przyjść kilka razy, więc zapis zamówienia musi być idempotentny.
- Po
COMPLETED. Kolejne powiadomienia dla tej płatności ignoruję. - Podpis. Nagłówek
OpenPayu-Signatureweryfikuję na każdym żądaniu: surowa treść powiadomienia plus drugi klucz, hash według wskazanego algorytmu, porównanie z podpisem. W Route Handlerze oznacza to odczyt treści przezrequest.text()przed jakimkolwiek parsowaniem JSON, bo hash liczy się z surowych bajtów.
Przy BLIK dokumentacja PayU wyróżnia dwa scenariusze. W pierwszym klient przechodzi na stronę płatności BLIK. W drugim wpisuje kod autoryzacyjny na stronie sklepu, a potwierdza w aplikacji banku. Drugi wariant wymaga osobnego punktu płatności (POS) z konfiguracją po stronie PayU i nie łączy się ze scenariuszem przekierowania. Wybór wpływa na układ checkoutu, więc rozstrzygam go w zakresie, zanim powstanie pierwszy komponent.
Dostępność checkoutu i komponentów klienckich
Next.js ma wbudowany komunikat o zmianie trasy dla czytników ekranu. Dokumentacja opisuje, że ogłasza on nazwę strony, szukając najpierw w document.title, potem w elemencie h1, a na końcu w ścieżce adresu. Każda strona potrzebuje więc unikalnego tytułu i jednego sensownego nagłówka. To zależy od metadanych z poprzedniej sekcji, a nie od osobnego narzędzia.
W dokumentacji eslint-config-next dla wersji 16 jako wchodzące w skład zestawu wymienione są wtyczki react, react-hooks i next. Dodaję więc eslint-plugin-jsx-a11y do konfiguracji sam, żeby brakujące teksty alternatywne i błędne role ARIA wychodziły w CI. Polecenie next lint zostało w Next.js 16 usunięte, więc uruchamiam ESLint bezpośrednio.
W komponentach klienckich pilnuję rzeczy, których lint nie złapie:
- pole kodu BLIK i pola adresu mają powiązane etykiety i komunikaty błędów czytane przez czytnik,
- zmiana statusu płatności trafia do regionu
aria-live, a nie tylko zmienia kolor przycisku, - fokus po błędzie walidacji ląduje na pierwszym błędnym polu,
- całą ścieżkę zamówienia da się przejść klawiaturą.
Co mówi prawo
- Ustawa z 26 kwietnia 2024 r. o zapewnianiu spełniania wymagań dostępności niektórych produktów i usług przez podmioty gospodarcze (tekst w API Sejmu, obowiązuje od 28 czerwca 2025 r.) obejmuje usługi handlu elektronicznego (art. 3 ust. 2 pkt 6). Z jej zakresu wyjęte są usługi mikroprzedsiębiorców (art. 4 pkt 1). Art. 18 pkt 2 wymaga w e-commerce zapewnienia postrzegalności, funkcjonalności, zrozumiałości i kompatybilności funkcji służących identyfikacji, bezpieczeństwu i dokonywaniu płatności.
- Ustawa z 18 lipca 2002 r. o świadczeniu usług drogą elektroniczną (tekst jednolity, Dz.U. 2024 poz. 1513) w art. 8 ust. 1 pkt 2 wymaga nieodpłatnego udostępnienia regulaminu przed zawarciem umowy. Zakaz wysyłania informacji handlowej bez uprzedniej zgody jest dziś w art. 398 Prawa komunikacji elektronicznej. W Next.js oznacza to link do regulaminu przy zamówieniu i zgodę na newsletter w osobnym polu, bez domyślnego zaznaczenia.
- Ustawa z 4 kwietnia 2019 r. o dostępności cyfrowej stron internetowych i aplikacji mobilnych podmiotów publicznych (tekst w API Sejmu) dotyczy podmiotów publicznych. Jeśli pracujesz dla jednostki publicznej, jej załącznik opiera się na wytycznych WCAG 2.1.
Nie jestem prawnikiem. Sprawdzenie, czy twoja firma podlega danemu obowiązkowi, zostaje po twojej stronie, a ja wdrażam wynik tej analizy w kodzie.
Gdzie Next.js, a gdzie coś prostszego
Nie każda strona potrzebuje Next.js. Serwis firmowy bez interaktywnych funkcji zwykle lepiej wychodzi na Astro albo na dobrze przygotowanym motywie WordPress. Sklep na WooCommerce opisuję osobno na stronie o WooCommerce w Krakowie. Next.js wybieram, gdy frontend ma żyć własnym życiem: konto klienta, konfigurator, panel dla partnerów, wspólne komponenty z aplikacją. Ogólne podejście do oddzielenia frontendu od WordPressa opisuje strona o headless CMS.
Etapy współpracy od pierwszego maila do odbioru
- Pisemny brief. Wysyłasz adres serwisu, cel, termin i obecny stack. Odpowiadam na piśmie, w dni robocze.
- Pytania i zakres. Zadaję pytania o adresy, które mają zostać, o integracje i o to, kto jest właścicielem treści. Dostajesz zakres z założeniami i wykluczeniami.
- Środowisko testowe. Budowa idzie na stagingu, z danymi testowymi bramki płatności.
- Odbiór. Przechodzisz listę odbioru, w tym ścieżkę zamówienia klawiaturą i weryfikację podpisu powiadomień płatniczych.
- Utrzymanie. Po uruchomieniu możesz zamówić opiekę nad aktualizacjami i monitoringiem. To osobna decyzja.
Lista kontrolna przed zleceniem
| Obszar | Pytanie do siebie |
|---|---|
| Adresy | Czy mam listę adresów, które muszą zostać, i listę przekierowań? |
| Metadane | Czy każda strona ma unikalny tytuł i opis po polsku? |
| Języki | Czy wersje językowe mają wzajemne hreflang i kanoniczne adresy? |
| Płatności | Czy status zamówienia zmienia się po zweryfikowanym powiadomieniu? |
| Dostępność | Czy da się złożyć zamówienie bez myszy? |
| Regulamin | Czy link do regulaminu jest widoczny przed zawarciem umowy? |
| Wydajność | Czy znam progi z web.dev: LCP do 2,5 s, INP do 200 ms, CLS do 0,1? |
Pytania i odpowiedzi
Czy strona w Next.js musi mieć osobną mapę witryny, skoro treść jest w WordPressie?
Tak, frontend w Next.js sam odpowiada za swoje adresy. Plik sitemap.ts pobiera listę wpisów z REST API WordPressa, przechodzi po stronach wyników według nagłówka X-WP-TotalPages i zwraca adresy już w kształcie, jaki ma frontend, a nie WordPress. Jeden plik przekroczy sensowny rozmiar przy dużym katalogu, wtedy dzielę go przez generateSitemaps.
Dlaczego potwierdzenie płatności nie może zależeć od powrotu klienta na stronę?
Klient może zamknąć kartę po płatności w aplikacji banku. PayU wraca do twojej strony przez continueUrl, ale status zamówienia ogłasza osobno, powiadomieniem na notifyUrl. Dlatego zamówienie oznaczam jako opłacone dopiero po zweryfikowanym powiadomieniu o statusie COMPLETED.
Czy mój sklep musi spełniać wymagania ustawy o dostępności produktów i usług?
Przepisy o dostępności produktów i usług z 2024 roku obejmują handel elektroniczny (art. 3 ust. 2 pkt 6) i obowiązują od 28 czerwca 2025 r. Usług świadczonych przez mikroprzedsiębiorców ustawa nie dotyczy (art. 4 pkt 1). Czy twoja firma jest mikroprzedsiębiorcą, ustalasz na podstawie własnych danych, najlepiej z księgową. Dostępny checkout zakładam niezależnie od progu, bo to część porządnie zrobionego formularza.
Co z podglądem linku w komunikatorach, skoro metadane w Next.js mogą się doładować później?
Dokumentacja Next.js opisuje to wprost: roboty, które nie wykonują JavaScriptu, jak facebookexternalhit, dostają metadane w znaczniku head, bo serwer czeka na generateMetadata. Googlebot interpretuje metadane doładowane strumieniowo. Na ważnych stronach sprawdzam to jednak na gotowej stronie, a nie tylko w kodzie.
Kiedy headless WordPress z Next.js ma sens, a kiedy wystarczy motyw klasyczny?
Headless ma sens, gdy redakcja zostaje w WordPressie, a frontend potrzebuje własnej interaktywności albo wspólnego systemu komponentów z aplikacją. Płacisz za to podglądem w edytorze i drugim wdrożeniem do utrzymania. Zwykły serwis firmowy bez takich wymagań zwykle lepiej zostawić na dobrze przygotowanym motywie, i tak to opiszę w pisemnej odpowiedzi.
Co muszę przygotować przed startem?
Adres obecnego serwisu, dostęp do WordPressa z rolą administratora lub kopię na środowisku testowym, dane testowe bramki płatności, układ widoków od ciebie lub twojego grafika oraz listę adresów, które mają zostać. Wycenę i zakres dostajesz pisemnie, pierwszą wstępną wycenę bez opłat.
Napisz do mnie
Jeśli prowadzisz firmę w Krakowie i planujesz nowy frontend, przebudowę sklepu albo oddzielenie strony od WordPressa, wyślij mi przez formularz kontaktowy adres obecnego serwisu, cel projektu, termin i używany stack. Odpiszę na piśmie, w dni robocze, a pierwsza wstępna wycena jest bezpłatna.
Wybrane projekty
Przykłady mojej pracy.
radio.friko.pl - Projekt WordPress | WPPoland
Radio.friko.pl to internetowa stacja radiowa, która działała w latach 2005-2010 jako część platformy Friko.pl, oferując użytkownikom dostęp do streamingu muz...
Real Estate Platform: DUNE CITY
Projekt strony dla inwestycji Dune City to strona stworzona dla prestiżowego kompleksu apartamentowców usytuowanego na 10-kilometrowej mierz...
Real Estate Platform: sportostroda.pl
Sportostroda.pl to jeden z interesujących projektów w moim portfolio jako programista WordPress, zrealizowany jako lokalny portal sportowy dedykowany mieszka...
Wsparcie techniczne WordPress w Krakowie
Najbliższe wydarzenia WordPress
Spotkaj się z nami na WordCampie
Dołącz do społeczności WordPress w Krakowie. 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 Next.js w Krakowie?
Opisz projekt mailem. Odpowiadam w ciągu 48 godzin.
Opisz projektSprawdź inne usługi WordPress i bazę wiedzy
Migracja do Astro, Next.js i headless WordPress.
Synchronizacja WooCommerce z ERP i hurtownią.
Automatyzacja procesów biznesowych wokół WordPress i systemów firmowych.
Biblioteka konkretnych przypadków automatyzacji.
Headless WordPress, Sanity, Strapi i Contentful z Astro lub Next.js.
Astro, MDX, edge i Core Web Vitals mierzone na realnym ruchu.
Dedykowany development i architektura WordPress.
Skalowalna architektura headless, ERP i AI dla enterprise.
Powiązane kategorie
Artykuły wspierające temat

Od sześciu do szesnastu tygodni dla typowych projektów, w czterech fazach: rozpoznanie, ustalanie zakresu, budowa i przełączenie, dostrajanie. Zmiennymi są wielkość katalogu, liczba integracji, zachowanie URL-i i gotowość zespołu redakcyjnego, a nie wybór frameworka.

Kompleksowa 4-letnia analiza całkowitego kosztu posiadania (TCO), laboratoryjne i polowe benchmarki Core Web Vitals, architektura Astro 7 GraphQL APQ oraz 10-punktowa matryca decyzyjna dla organizacji enterprise wybierających między headless a monolitem WordPressa.

Decyzja Shopify Plus vs WooCommerce headless w 2026 nie jest już binarnym wyborem "platforma vs custom". Obie platformy działają w trybie headless, obie integrują AI, obie renderują na edge. Realne osie to kontrola, koszt całkowity przez pięć lat oraz strategia wyjścia. Ten artykuł przechodzi przez macierz decyzyjną z potwierdzonymi faktami platformowymi.