WordPress Codex to historyczna, oficjalna dokumentacja WordPressa prowadzona w formie wiki na stronie codex.wordpress.org. Przez ponad dekadę był głównym źródłem informacji dla twórców wtyczek, motywów i administratorów stron – od instalacji przez hooki po zarządzanie użytkownikami.
Dziś Codex jest w dużej mierze zastąpiony przez nową dokumentację na developer.wordpress.org, choć nadal można go odwiedzić i korzystać z wielu jego artykułów.
Historia Codexu
Codex WordPress ruszył w 2004 roku – rok po premierze WordPressa 1.0. Działał jako otwarta wiki: każdy zarejestrowany użytkownik mógł tworzyć i edytować artykuły. Przez lata społeczność zgromadziła tam tysiące stron dokumentujących funkcje PHP, haki systemowe, szablony, bezpieczeństwo i administrację.
Ogólna historia WordPressa jako projektu opisana jest w artykule o WordPress – definicja i historia.
Dlaczego Codex przestał być aktualny?
Format wiki ma wadę: wymaga aktywnej moderacji i aktualizacji przez wolontariuszy. Gdy WordPress zaczął się dynamicznie rozwijać (REST API, Gutenberg, block themes), utrzymanie spójności i aktualności Codexu stało się trudne.
W 2013 roku WordPress uruchomił developer.wordpress.org – nową platformę dokumentacyjną z innym podziałem:
- make.wordpress.org – dokumentacja projektów rdzenia, REST API, Gutenberga.
- developer.wordpress.org – dokumentacja dla deweloperów: Code Reference (baza wszystkich funkcji, hooków, klas i metod WP), Block Editor Handbook, REST API handbook, wtyczki, motywy.
Od tego momentu nowe funkcje i API były dokumentowane głównie w developer.wordpress.org, a Codex był stopniowo oznaczany jako “przestarzały” (deprecated) przy starszych artykułach.
Co gdzie szukać dziś?
developer.wordpress.org/reference – to punkt startowy dla deweloperów. Baza Code Reference zawiera wszystkie publiczne funkcje, hooki (hooki w WordPress to mechanizm wpinanienia własnego kodu), klasy i metody rdzenia WordPress. Każda pozycja ma opis parametrów, przykład użycia i notatki od społeczności.
wordpress.org/support – forum wsparcia dla użytkowników WordPressa. Dobre do szukania rozwiązań typowych problemów.
codex.wordpress.org – wciąż dostępny, wciąż użyteczny dla starszych koncepcji (np. funkcje szablonowe, stare hooki, administracja), ale trzeba sprawdzać daty edycji artykułów. Artykuły nieaktualizowane od kilku lat mogą opisywać funkcje, które zmieniły się lub zostały zastąpione.
Jak korzystać z Code Reference?
Szukasz konkretnej funkcji, filtra lub akcji? Wpisz jej nazwę w searchboksie na developer.wordpress.org/reference. Dla każdej pozycji zobaczysz:
- Opis – co robi funkcja lub hook.
- Parametry – jakie argumenty przyjmuje.
- Wartość zwracana – co zwraca.
- Powiązane – linki do powiązanych funkcji i hooków.
- Changelog – od której wersji WordPress jest dostępna.
- User contributed notes – komentarze i przykłady od społeczności.
Codex a licencja GPL
Aktualna oficjalna dokumentacja WordPressa ma osobne zasady licencyjne: treści ogólne są udostępniane jako CC0, a przykłady kodu jako GPLv2 lub nowsza. Przy korzystaniu ze starszych stron Codexu warto sprawdzić konkretną stronę i jej historię, zamiast zakładać jedną wspólną licencję dla całej dokumentacji.
Licencję open source, na której działa sam WordPress, wyjaśnia artykuł o GPL i open source w WordPress.
Alternatywne źródła dokumentacji
Poza oficjalną dokumentacją, WordPress ma rozbudowane zasoby nieoficjalne:
- WPBeginner.com – tutoriale dla początkujących (po angielsku).
- CSS-Tricks i Smashing Magazine – artykuły o WordPressie dla deweloperów.
- StackExchange (WordPress.stackexchange.com) – pytania i odpowiedzi techniczne.
Przy korzystaniu z nieoficjalnych źródeł warto sprawdzać datę publikacji – WordPress zmienia się na tyle szybko, że artykuły sprzed 3-4 lat mogą opisywać przestarzałe podejście.
Podsumowanie
WordPress Codex to historyczna wiki-dokumentacja WordPressa, działająca od 2004 roku. Aktualną dokumentację dla deweloperów znajdziesz na developer.wordpress.org/reference (Code Reference) i w dedykowanych podręcznikach (Block Editor Handbook, REST API Handbook). Codex jest nadal dostępny i użyteczny dla starszych tematów, ale wymaga weryfikacji dat edycji.