Patrzy Pan/Pani na panel administracyjny WordPress i myśli: „Mogę więcej niż tylko przeciągać bloki". Albo pisze Pan/Pani już w PHP/JavaScript i chce zrozumieć, jak działa najpopularniejszy CMS na świecie. Oba scenariusze prowadzą do jednego pytania: od czego zacząć programowanie na WordPress, żeby nie utonąć w dokumentacji i nie rzucić tego po tygodniu.

Problemem nie jest złożoność WordPressa. Problemem jest to, że większość „poradników dla początkujących" albo tłumaczy, jak zainstalować motyw przez panel administracyjny, albo od razu rzuca na głęboką wodę, każąc tworzyć wtyczkę z hookami i REST API. Złotego środka, mapy drogowej od zera do pierwszego sensownego kodu, prawie nie ma. Przeszliśmy przez to i zebraliśmy ją tutaj: bez lania wody, z konkretnymi narzędziami i odnośnikami do żywych zasobów.

💡 Szybki przegląd:

• PHP, CSS, HTML, trzy języki potrzebne od razu; JavaScript, później, gdy opanuje Pan/Pani podstawy
• Środowisko lokalne: WordPress Studio lub Local, uruchomienie w 5 minut, bez hostingu
• Motywy, najlepsze wejście dla nowicjusza; wtyczki, następny poziom; rdzeń, dla pewnych siebie programistów PHP
• Oficjalne zasoby: Developer Resources, Learn WordPress i WP-CLI odpowiadają na większość typowych pytań
• Społeczność: fora, WordCampy i kanały Slack, to, co zamienia samodzielną naukę w karierę

1. Co leży u podstaw WordPressa

WordPress jest napisany w PHP i przechowuje dane w MySQL. To nie jest bezduszny zestaw „skrypt plus baza danych", przez ponad 20 lat ewolucji wokół rdzenia wyrosła cała ekosystem: setki API, system hooków, REST API, edytor blokowy i własne narzędzie CLI. Ale na starcie programista musi rozumieć tylko trzy warstwy.

PHP odpowiada za logikę. Każda strona witryny jest składana z szablonów PHP, które wywołują funkcje rdzenia i wtyczek, odwołują się do bazy danych przez WP_Query i tworzą odpowiedź HTML. Bez PHP nie napisze Pan/Pani żadnego motywu ani żadnej wtyczki, to must-have od pierwszego dnia.

CSS i HTML, warstwa prezentacji. Motywy WordPressa to przede wszystkim pliki PHP, ale wyglądają tak, jak opisze je Pan/Pani w CSS. Współczesny WordPress używa edytora blokowego (Gutenberg) i zrozumienie CSS Flexbox/Grid jest tu ważniejsze niż pięć lat temu. HTML to spoiwo: znaczniki widżetów, menu, szablonów.

JavaScript, czwarty język. Nie jest obowiązkowy na starcie (motyw można napisać całkowicie bez JS), ale jeśli planuje Pan/Pani pracę z blokami Gutenberga lub elementami interaktywnymi, React i @wordpress/scripts staną się Pana/Pani narzędziami. Proszę zostawić JS na później, gdy opanuje Pan/Pani połączenie PHP + CSS.

2. Środowisko lokalne: gdzie pisać kod

Pierwsza zasada programisty WordPressa: nigdy nie eksperymentować na działającej stronie. Uszkodzony functions.php bez dostępu do FTP to wieczór paniki i przywracania z kopii zapasowej. Na szczęście postawienie lokalnego WordPressa jest teraz prostsze niż kiedykolwiek.

WordPress Studio, bezpłatna aplikacja od oficjalnego zespołu, działa na Windows i macOS. Uruchamia się jednym kliknięciem, używa WebAssembly do izolacji witryn i nie wymaga Dockera ani XAMPP. Idealny wybór na pierwsze spotkanie z kodem.

Local (wcześniej Local by Flywheel), alternatywa z bogatszym interfejsem: przełączanie wersji PHP, podgląd bazy danych przez Adminer, demonstracyjne URL-e do pokazania klientowi. Sprawdza się, jeśli planuje Pan/Pani prowadzić kilka projektów równolegle.

Dla tych, którzy znają już kontenery, oficjalny obraz Dockera wordpress i wp-env (pakiet od zespołu Gutenberga) dają pełną kontrolę nad środowiskiem. Ale na starcie to nadmiar, Studio lub Local zaspokoją potrzeby na najbliższe pół roku do roku.

3. Ścieżka pierwsza: tworzenie motywów

Motywy to najbardziej naturalne wejście w programowanie na WordPressie. Widzi Pan/Pani rezultat natychmiast, pracuje ze wszystkimi trzema głównymi językami (PHP, CSS, HTML) i może podglądać, jak zbudowane są inne motywy, kod jest otwarty.

Proszę zacząć od motywu potomnego. To najbezpieczniejszy sposób: tworzy Pan/Pani folder, dodaje style.css z komentarzem nagłówkowym i functions.php, który podłącza motyw nadrzędny. Następnie nadpisuje Pan/Pani jeden szablon, dodaje jeden plik CSS, podpina jeden hook. Małe zwycięstwa każdego dnia.

Hierarchia szablonów WordPressa to dokument, który warto wydrukować i powiesić nad biurkiem. Pokazuje ona, który plik PHP jest wywoływany dla każdej strony: front-page.php → home.php → index.php i tak dalej. Zrozumienie tego łańcucha to połowa zawodu twórcy motywów.

Gdy motyw potomny jest opanowany, proszę spróbować napisać motyw od zera. Minimalny zestaw: index.php, style.css i functions.php. Proszę dodać obsługę edytora blokowego przez add_theme_support('wp-block-styles') i menu przez register_nav_menus(). WordPress Developer Resources zawiera pełną listę dostępnych add_theme_support z przykładami, proszę trzymać tę zakładkę otwartą.

4. Ścieżka druga: tworzenie wtyczek

Wtyczki to kod, który rozszerza WordPressa niezależnie od motywu. Forum, sklep internetowy, system rezerwacji, niestandardowe typy wpisów, wszystko to są wtyczki. Próg wejścia jest wyższy niż w przypadku motywów: musi Pan/Pani rozumieć hooki (add_action, add_filter), znać $wpdb i umieć czytać cudzy kod.

Minimalny plugin to jeden plik PHP z nagłówkiem /* Plugin Name: ... */. Może on już zawierać hook, który na przykład dodaje tekst do stopki witryny przez add_filter('the_content', ...). Proszę spróbować napisać taki plugin dzisiaj, zajmie to 10 minut i sprawi, że słowo „plugin" przestanie budzić obawy.

Kolejny krok: proszę zapoznać się z Plugin Handbook w Developer Resources. Opisano tam: strukturę pluginu, aktywację/dezaktywację, pracę z bazą danych, tworzenie stron ustawień. Proszę nie próbować czytać wszystkiego, wystarczy otwierać odpowiedni rozdział pod konkretne zadanie.

Główna zasada dla początkujących w pluginach: proszę nie wyważać otwartych drzwi. Na niemal każdy problem istnieje już plugin. Proszę sprawdzić, jak rozwiązano go w popularnym darmowym pluginie z repozytorium, to najlepszy podręcznik. Repozytorium WordPress.org zawiera ponad 60 000 pluginów open source.

5. Trzecia ścieżka: wkład w rdzeń WordPressa

To nie jest opcja dla początkujących, ale warto wiedzieć o takiej możliwości. WordPress to projekt open source i każde wydanie zawiera łatki od setek programistów z całego świata.

Do udziału potrzebna jest pewna znajomość PHP, znajomość Coding Standards i gotowość do przechodzenia code review. Proces odbywa się przez zgłoszenia Trac na core.trac.wordpress.org. Można zacząć od etykiety good-first-bug, są to drobne błędy wybrane specjalnie dla nowych kontrybutorów.

Nawet jeśli nie planują Państwo łatania rdzenia, czytanie zgłoszeń Trac i dyskusji pod nimi to doskonały sposób, by zrozumieć, jak podejmowane są decyzje architektoniczne w projekcie z milionami instalacji.

6. Gdzie się uczyć: żywe zasoby zamiast nieaktualnych linków

Codex umarł, niech żyje Developer Resources. To oficjalny portal, który zastąpił stary Codex: Code Reference dla każdej funkcji i klasy, przewodniki po motywach i pluginach, edytorze blokowym, REST API oraz WP-CLI. Jeśli mają Państwo otworzyć tylko jedną zakładkę, proszę otworzyć właśnie tę.

Learn WordPress to darmowe, ustrukturyzowane kursy od zespołu WordPress.org. Dostępne są wideo, materiały tekstowe i piaskownice do ćwiczeń. Ścieżka „Beginner WordPress Developer" przeprowadzi Państwa od instalacji do pierwszego pluginu w ciągu kilku godzin.

W przypadku konkretnych pytań: forum wsparcia WordPress.org i Stack Overflow. Na Stack Overflow tag wordpress zawiera ponad 60 000 odpowiedzi na pytania, prawie na pewno ktoś już zadał Państwa pytanie. Forum wsparcia jest dobre do problemów z konkretnymi pluginami i motywami.

WP-CLI to narzędzie wiersza poleceń, które zaoszczędzi Państwu wiele godzin. Polecenie wp scaffold plugin tworzy szkielet pluginu, wp search-replace zmienia URL w całej bazie danych, wp cron event list pokazuje zaplanowane zadania. Proszę opanować choćby 10 poleceń, zwróci się to już w pierwszym tygodniu.

7. Społeczność, bez której Pan/Pani utknie

Samotny programista, który nie komunikuje się ze społecznością, nieuchronnie wymyśla koło na nowo i pomija ważne zmiany. Społeczność WordPress to jedna z najbardziej przyjaznych w open source.

Od strony praktycznej: WordPress Slack zawiera kanały ze wszystkich obszarów: #core do dyskusji o jądrze, #themes do tematów, #plugins do wtyczek i #docs do dokumentacji. Można tam zadać pytanie i otrzymać odpowiedź od programistów, którzy piszą to samo jądro. WordCampy, jednodniowe konferencje na całym świecie (również w Ukrainie i regionie WNP), gdzie poznaje Pan/Pani ludzi, których wtyczek Pan/Pani używa.

Są też inne sposoby, by się zaangażować: tłumaczenia dokumentacji i interfejsu na Pana/Pani język, testowanie wersji beta, pomoc na forum wsparcia. Każdy z nich rozwija zrozumienie systemu, a przy okazji buduje reputację. W ekosystemie WordPress reputacja przekłada się bezpośrednio na zlecenia.

🎥 Wideo na temat

Przewodnik tekstowy to szkielet, ale czasem łatwiej raz zobaczyć. Oto szczegółowa mapa drogowa programisty WordPress z omówieniem narzędzi i etapów nauki:

⁉️🤔 Często zadawane pytania

Od jakiego języka zacząć, PHP czy JavaScript?

PHP. WordPress jest zbudowany na PHP i bez niego nie zrozumie Pan/Pani ani hooków, ani szablonów, ani WP_Query. JavaScript jest potrzebny do edytora blokowego i interaktywności na froncie, ale to drugi krok. Schemat: PHP + HTML/CSS → baza → pierwsza wtyczka → JavaScript/React.

Czy trzeba koniecznie uczyć się MySQL?

Na starcie nie. WordPress abstrahuje pracę z bazą danych przez WP_Query i $wpdb. Ale zrozumienie struktury tabel wp_posts, wp_postmeta i wp_options zaoszczędzi Panu/Pani godzin debugowania. Proszę przerobić jeden krótki tutorial z phpMyAdmin lub Adminer, to wystarczy na pierwsze pół roku.

Ile czasu zajmuje droga od zera do pierwszej wtyczki?

Jeśli zna już Pan/Pani PHP na poziomie podstawowym, 2-3 tygodnie przy codziennych zajęciach. Od zera w programowaniu, 2-3 miesiące. Pierwsza wtyczka będzie prosta (na przykład shortcode wyświetlający bieżącą datę z formatowaniem), ale to prawdziwy, działający kod.

Temat czy wtyczka, od czego korzystniej zacząć dla kariery?

Programiści tematów są zawsze poszukiwani, bo każda strona potrzebuje tematu. Programiści wtyczek zarabiają więcej na dystrybucji (model freemium na WordPress.org). Idealna ścieżka: proszę zacząć od tematów, aby opanować ekosystem, a potem napisać wtyczkę, która zaspokaja konkretną potrzebę. Najlepsi specjaliści potrafią jedno i drugie.

Czy GitHub jest potrzebny?

Obowiązkowo. Nawet jeśli pisze Pan/Pani „do szuflady", Git uratuje Pana/Panią, gdy zepsuje Pan/Pani kod i nie będzie mógł/mogła sobie przypomnieć, co Pan/Pani zmieniał/a. Ponadto link do profilu GitHub z aktywnymi repozytoriami tematów i wtyczek WP to najlepszy argument podczas szukania klienta. Proszę zacząć od git init w folderze tematu jeszcze dziś.

Co robić teraz: Pana/Pani pierwszy tydzień

Mapa drogowa nie działa, jeśli się ją tylko przeczyta. Oto plan na najbliższe siedem dni, konkretny i wykonalny.

Proszę zainstalować WordPress Studio lub Local. Proszę stworzyć stronę testową. Proszę otworzyć folder wp-content/themes, stworzyć temat potomny dla twentytwentyfive i sprawić, by załadował się w panelu administracyjnym. To dzień pierwszy i być może najważniejszy, pokonał Pan/Pani barierę „nie wiem, gdzie kliknąć".

Dzień drugi i trzeci: proszę dodać w functions.php jeden hook (na przykład wp_enqueue_scripts do podłączenia własnego pliku CSS) i zmienić kolor nagłówka za pomocą tego pliku. Mały rezultat, ale już wchodzi Pan/Pani w interakcję z hookami WordPress.

Dzień czwarty i piąty: proszę stworzyć osobny folder w wp-content/plugins, napisać minimalną wtyczkę z jednym shortcodem przez add_shortcode(). Proszę wstawić shortcode do dowolnego wpisu i zobaczyć rezultat. To wszystko, jest Pan/Pani programistą wtyczek.

Dzień szósty i siódmy: proszę zarejestrować się w oficjalnym Slacku WordPress, zasubskrybować kanał #core i przeczytać kilka zgłoszeń na systemie Trac WordPress. Nie po to, by brać udział, ale by zobaczyć, jak podejmowane są decyzje w projekcie, z którym Pan/Pani teraz pracuje.

Główna zasada pierwszego tygodnia: kod każdego dnia. 30 minut praktyki jest bardziej przydatne niż trzy godziny czytania dokumentacji. WordPress to ekosystem, w który wjeżdża się rękami.

🔗 Developer Resources, oficjalna dokumentacja WordPress