W\u0142asny motyw WordPress oznacza zbudowanie warstwy prezentacji samodzielnie, zamiast dostosowywania cudzej. W 2026 roku ta decyzja zaczyna si\u0119 od drugiej: czy budujesz motyw blokowy, klasyczny, czy hybryd\u0119 obu. Odpowied\u017a zmienia to, jakich plik\u00f3w potrzebujesz, gdzie mieszka warstwa styl\u00f3w i jak\u0105 kontrol\u0119 dostaj\u0105 redaktorzy. Ten przewodnik opisuje obie \u015bcie\u017cki, wymagane pliki, hierarchi\u0119 szablon\u00f3w oraz praktyki bezpiecze\u0144stwa i testowania, kt\u00f3re odr\u00f3\u017cniaj\u0105 motyw do utrzymania od takiego, kt\u00f3ry za rok napiszesz od nowa.<\/p>\n\n\n\n
WordPress obs\u0142uguje dwie architektury motyw\u00f3w i nie s\u0105 one wymienne.<\/p>\n\n\n\n
Motywy blokowe<\/strong> definiuj\u0105 szablony jako pliki HTML z\u0142o\u017cone z blok\u00f3w, ze stylami scentralizowanymi w pliku Motywy klasyczne<\/strong> definiuj\u0105 szablony jako pliki PHP i styluj\u0105 je zwyk\u0142ym CSS-em. Daj\u0105 precyzyjn\u0105 kontrol\u0119 nad tym, co si\u0119 \u0142aduje, i opieraj\u0105 si\u0119 na hierarchii, kt\u00f3r\u0105 wi\u0119kszo\u015b\u0107 programist\u00f3w WordPressa ju\u017c zna. Pozostaj\u0105 uzasadnionym wyborem, zw\u0142aszcza gdy chcesz ograniczy\u0107 zakres zmian dost\u0119pny dla redakcji.<\/p>\n\n\n\n Motywy hybrydowe<\/strong> to motywy klasyczne korzystaj\u0105ce z Wybierz motyw blokowy, gdy redakcja potrzebuje realnej kontroli nad uk\u0142adem, a projekt da si\u0119 wyrazi\u0107 blokami. Wybierz klasyczny lub hybrydowy, gdy szablony zawieraj\u0105 rozbudowan\u0105 logik\u0119, gdy potrzebujesz \u015bcis\u0142ej kontroli nad tym, co si\u0119 \u0142aduje, albo gdy klient wprost oczekuje ograniczonego zakresu edycji.<\/p>\n\n\n\n Minimum zale\u017cy od wybranej architektury.<\/p>\n\n\n\n css<\/p>\n\n\n\n Bez tego nag\u0142\u00f3wka WordPress nie poka\u017ce katalogu na li\u015bcie motyw\u00f3w.<\/p>\n\n\n\n Struktura motywu blokowego wygl\u0105da zwykle tak:<\/p>\n\n\n\n Motyw klasyczny trzyma szablony jako pliki PHP w katalogu g\u0142\u00f3wnym: Otwieraj\u0105cy znacznik php<\/p>\n\n\n\n Dwie rzeczy warte zapami\u0119tania. Poprzedzaj nazwy funkcji prefiksem, bo przestrze\u0144 nazw jest wsp\u00f3lna z wtyczkami i rdzeniem. Wersjonuj zasoby przez Nigdy nie wpinaj arkuszy styl\u00f3w i skrypt\u00f3w bezpo\u015brednio w kod szablonu. Kolejkowanie pozwala WordPressowi i warstwie cache zarz\u0105dza\u0107 zale\u017cno\u015bciami i kolejno\u015bci\u0105 \u0142adowania.<\/p>\n\n\n\n json<\/p>\n\n\n\n Trzy uwagi.<\/p>\n\n\n\n Klucz Ustawienie Hierarchia szablon\u00f3w decyduje o tym, kt\u00f3ry plik obs\u0142u\u017cy dane \u017c\u0105danie. WordPress sprawdza pliki od najbardziej szczeg\u00f3\u0142owego do najbardziej og\u00f3lnego i u\u017cywa pierwszego dopasowania.<\/p>\n\n\n\n Dla pojedynczego wpisu kolejno\u015b\u0107 wygl\u0105da tak: Hierarchia jest identyczna w obu architekturach. Zmienia si\u0119 tylko rozszerzenie: Dwa praktyczne wnioski. Po pierwsze, W motywie klasycznym tre\u015b\u0107 renderuje p\u0119tla.<\/p>\n\n\n\n php<\/p>\n\n\n\n Znaczniki szablon\u00f3w w rodzaju Dla tre\u015bci spoza zapytania g\u0142\u00f3wnego u\u017cyj php<\/p>\n\n\n\n W motywach blokowych wi\u0119kszo\u015b\u0107 tej pracy wykonuje blok p\u0119tli zapytania, a w\u0142asne wyj\u015bcie nale\u017cy do zarejestrowanego bloku albo powi\u0105zania danych, nie do pliku szablonu.<\/p>\n\n\n\n Haki to spos\u00f3b na rozszerzanie dzia\u0142ania bez modyfikowania rdzenia i bez walki z w\u0142asnymi szablonami w przysz\u0142o\u015bci. Akcje dok\u0142adaj\u0105 zachowanie w zdefiniowanych punktach, filtry modyfikuj\u0105 warto\u015bci w locie. Jedno i drugie przetrwa aktualizacj\u0119, czego nie da si\u0119 powiedzie\u0107 o zmianach wpisanych na sztywno.<\/p>\n\n\n\n Dwie zasady pokrywaj\u0105 wi\u0119kszo\u015b\u0107 tego, co idzie nie tak w motywach.<\/p>\n\n\n\n Zawsze escapuj przy wyj\u015bciu, funkcj\u0105 dopasowan\u0105 do kontekstu.<\/strong><\/p>\n\n\n\n php<\/p>\n\n\n\n Sanityzuj i weryfikuj przy wej\u015bciu.<\/strong> Sprawdzaj to, co przychodzi, weryfikuj nonce przy ka\u017cdym formularzu i \u017c\u0105daniu AJAX, a przed wykonaniem dzia\u0142ania sprawdzaj uprawnienia u\u017cytkownika:<\/p>\n\n\n\n php<\/p>\n\n\n\n Do zapyta\u0144 bezpo\u015brednich u\u017cywaj W\u0142\u0105cz debugowanie w php<\/p>\n\n\n\n Poza tym cztery kontrole wy\u0142apuj\u0105 wi\u0119kszo\u015b\u0107 problem\u00f3w, zanim znajdzie je klient.<\/p>\n\n\n\n Testuj na realistycznej tre\u015bci.<\/strong> Zestaw testowy publikowany przez spo\u0142eczno\u015b\u0107 WordPressa zawiera d\u0142ugie tytu\u0142y, brakuj\u0105ce obrazki wyr\u00f3\u017cniaj\u0105ce, zagnie\u017cd\u017cone listy, nietypowe formaty wpis\u00f3w i niewygodne w\u0105tki komentarzy. Uk\u0142ady wygl\u0105daj\u0105ce dobrze na trzech schludnych wpisach demonstracyjnych rozpadaj\u0105 si\u0119 na prawdziwej tre\u015bci redakcyjnej.<\/p>\n\n\n\n Obserwuj zapytania.<\/strong> Query Monitor pokazuje liczb\u0119 zapyta\u0144, zapytania wolne, wykonanie hak\u00f3w i kolejkowane zasoby przy ka\u017cdym wczytaniu strony. Szablon wykonuj\u0105cy po cichu osiemdziesi\u0105t zapyta\u0144 \u0142atwiej naprawi\u0107 w trakcie prac ni\u017c po wdro\u017ceniu.<\/p>\n\n\n\n Uruchom Theme Check<\/strong> pod k\u0105tem standard\u00f3w kodowania i u\u017cycia funkcji wycofanych, a PHP_CodeSniffer ze standardem WordPressa wpnij w sw\u00f3j proces pracy.<\/p>\n\n\n\n Testuj dost\u0119pno\u015b\u0107 rzetelnie.<\/strong> Narz\u0119dzia automatyczne wy\u0142api\u0105 kontrast i brakuj\u0105ce etykiety. Nawigacja klawiatur\u0105, kolejno\u015b\u0107 fokusu i zachowanie czytnik\u00f3w ekranu wymagaj\u0105 test\u00f3w r\u0119cznych. To dzi\u015b wym\u00f3g funkcjonalny, nie dopracowanie.<\/p>\n\n\n\n Motyw klasyczny wymaga Tak. Otwieraj\u0105cy theme.json<\/code>. Redaktorzy zmieniaj\u0105 uk\u0142ad i szablony przez edytor witryny, bez dotykania kodu. To kierunek rozwoju platformy, a domy\u015blne motywy WordPressa s\u0105 blokowe od wersji Twenty Twenty-Two.<\/p>\n\n\n\ntheme.json<\/code> do zdefiniowania token\u00f3w projektowych, bez przenoszenia szablon\u00f3w do edytora witryny. W praktyce to cz\u0119ste i pragmatyczne rozwi\u0105zanie: dostajesz system projektowy respektowany przez edytor blok\u00f3w, zachowuj\u0105c szablony w PHP.<\/p>\n\n\n\nJakie pliki s\u0105 faktycznie wymagane?<\/h2>\n\n\n\n
Typ motywu<\/th> Wymagane<\/th> Zalecane<\/th><\/tr><\/thead> Blokowy<\/strong><\/td> style.css<\/code>, templates\/index.html<\/code><\/td>theme.json<\/code>, parts\/header.html<\/code>, parts\/footer.html<\/code>, functions.php<\/code><\/td><\/tr>Klasyczny<\/strong><\/td> style.css<\/code>, index.php<\/code><\/td>functions.php<\/code>, header.php<\/code>, footer.php<\/code>, theme.json<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\nstyle.css<\/code> jest wymagany w obu przypadkach, bo to jego nag\u0142\u00f3wek pozwala WordPressowi rozpozna\u0107 motyw:<\/p>\n\n\n\n\/*\nTheme Name: Acme\nTheme URI: https:\/\/example.com\/acme\nAuthor: Acme\nDescription: Motyw dedykowany dla Acme.\nVersion: 1.0.0\nRequires at least: 6.6\nRequires PHP: 8.1\nLicense: GPLv2 or later\nLicense URI: https:\/\/www.gnu.org\/licenses\/gpl-2.0.html\nText Domain: acme\n*\/<\/code><\/pre>\n\n\n\nacme\/\n style.css\n theme.json\n functions.php\n templates\/\n index.html\n single.html\n page.html\n archive.html\n 404.html\n parts\/\n header.html\n footer.html\n patterns\/\n hero.php\n styles\/\n dark.json<\/code><\/pre>\n\n\n\nindex.php<\/code>, single.php<\/code>, page.php<\/code>, archive.php<\/code>, search.php<\/code>, 404.php<\/code>, plus header.php<\/code> i footer.php<\/code> jako cz\u0119\u015bci wsp\u00f3lne.<\/p>\n\n\n\nJak poprawnie przygotowa\u0107 functions.php?<\/h2>\n\n\n\n
functions.php<\/code> zachowuje si\u0119 jak wtyczka do\u0142\u0105czona do motywu. Dwie zasady wywo\u0142uj\u0105 wi\u0119cej nieporozumie\u0144 ni\u017c cokolwiek innego w tworzeniu motyw\u00f3w, wi\u0119c warto je poda\u0107 wprost.<\/p>\n\n\n\n<?php<\/code> jest wymagany.<\/strong> Zamykaj\u0105cego ?><\/code> nie umieszczamy<\/strong>, poniewa\u017c znaki puste po nim mog\u0105 wygenerowa\u0107 wyj\u015bcie przed wys\u0142aniem nag\u0142\u00f3wk\u00f3w i zepsu\u0107 serwis w spos\u00f3b trudny do zdiagnozowania.<\/p>\n\n\n\n<?php\nif ( ! defined( 'ABSPATH' ) ) {\n\texit;\n}\n\nadd_action( 'after_setup_theme', 'acme_setup' );\nfunction acme_setup() {\n\tadd_theme_support( 'post-thumbnails' );\n\tadd_theme_support( 'title-tag' );\n\tadd_theme_support( 'html5', array( 'search-form', 'comment-form', 'gallery', 'caption' ) );\n\tload_theme_textdomain( 'acme', get_template_directory() . '\/languages' );\n}\n\nadd_action( 'wp_enqueue_scripts', 'acme_assets' );\nfunction acme_assets() {\n\t$stylesheet = get_stylesheet_directory() . '\/style.css';\n\n\twp_enqueue_style(\n\t\t'acme-style',\n\t\tget_stylesheet_uri(),\n\t\tarray(),\n\t\tfile_exists( $stylesheet ) ? filemtime( $stylesheet ) : '1.0.0'\n\t);\n}<\/code><\/pre>\n\n\n\nfilemtime()<\/code>, a nie sta\u0142ym ci\u0105giem, \u017ceby przegl\u0105darki pobiera\u0142y zmiany bez r\u0119cznej podbitki wersji.<\/p>\n\n\n\nJak dzia\u0142a theme.json?<\/h2>\n\n\n\n
theme.json<\/code> to miejsce, w kt\u00f3rym wsp\u00f3\u0142czesny motyw deklaruje sw\u00f3j system projektowy. WordPress odczytuje ten plik i generuje w\u0142a\u015bciwo\u015bci niestandardowe CSS, dzi\u0119ki czemu te same warto\u015bci obowi\u0105zuj\u0105 na froncie i w edytorze, bez utrzymywania dw\u00f3ch arkuszy.<\/p>\n\n\n\n{\n\t\"$schema\": \"https:\/\/schemas.wp.org\/wp\/6.6\/theme.json\",\n\t\"version\": 3,\n\t\"settings\": {\n\t\t\"appearanceTools\": true,\n\t\t\"layout\": {\n\t\t\t\"contentSize\": \"720px\",\n\t\t\t\"wideSize\": \"1200px\"\n\t\t},\n\t\t\"color\": {\n\t\t\t\"custom\": false,\n\t\t\t\"palette\": [\n\t\t\t\t{ \"slug\": \"base\", \"color\": \"#ffffff\", \"name\": \"Podstawowy\" },\n\t\t\t\t{ \"slug\": \"contrast\", \"color\": \"#111111\", \"name\": \"Kontrastowy\" },\n\t\t\t\t{ \"slug\": \"accent\", \"color\": \"#0b5cff\", \"name\": \"Akcent\" }\n\t\t\t]\n\t\t},\n\t\t\"typography\": {\n\t\t\t\"fluid\": true,\n\t\t\t\"customFontSize\": false\n\t\t}\n\t},\n\t\"styles\": {\n\t\t\"color\": {\n\t\t\t\"background\": \"var(--wp--preset--color--base)\",\n\t\t\t\"text\": \"var(--wp--preset--color--contrast)\"\n\t\t}\n\t}\n}<\/code><\/pre>\n\n\n\nversion<\/code> nie oznacza wersji WordPressa.<\/strong> Wskazuje schemat, wed\u0142ug kt\u00f3rego WordPress interpretuje plik. Wersja 3 wymaga WordPressa 6.6 lub nowszego, wersja 2 jest domy\u015blna od 5.9. Lini\u0119 $schema<\/code> ustaw na minimaln\u0105 wersj\u0119 WordPressa wspieran\u0105 przez motyw, \u017ceby edytor walidowa\u0142 plik wzgl\u0119dem w\u0142a\u015bciwego zestawu funkcji.<\/p>\n\n\n\ntheme.json<\/code> dzia\u0142a r\u00f3wnie\u017c w motywach klasycznych.<\/strong> Nie musisz przebudowywa\u0107 motywu, \u017ceby z niego skorzysta\u0107. Dodanie pliku daje system projektowy respektowany przez edytor blok\u00f3w, czyli opisane wcze\u015bniej podej\u015bcie hybrydowe.<\/p>\n\n\n\ncustom: false<\/code><\/strong> dla kolor\u00f3w, a analogicznie dla typografii i odst\u0119p\u00f3w, usuwa z edytora dowolne selektory warto\u015bci. To spos\u00f3b na utrzymanie systemu projektowego w ca\u0142o\u015bci, gdy zesp\u00f3\u0142 marketingu zaczyna publikowa\u0107.<\/p>\n\n\n\nCzym jest hierarchia szablon\u00f3w?<\/h2>\n\n\n\n
single-{typ}-{slug}<\/code>, potem single-{typ}<\/code>, single<\/code>, singular<\/code>, na ko\u0144cu index<\/code>. Ta sama logika obowi\u0105zuje dla archiw\u00f3w, taksonomii, autor\u00f3w i wynik\u00f3w wyszukiwania.<\/p>\n\n\n\nsingle.php<\/code> w motywie klasycznym, templates\/single.html<\/code> w blokowym.<\/p>\n\n\n\nindex<\/code> jest zawsze istniej\u0105cym zabezpieczeniem i dlatego to jedyny wymagany szablon. Po drugie, tw\u00f3rz tylko te szablony, w kt\u00f3rych zachowanie faktycznie si\u0119 r\u00f3\u017cni. Dodanie category.php<\/code> identycznego z archive.php<\/code> daje drugi plik do utrzymania i zero korzy\u015bci.<\/p>\n\n\n\nJak wy\u015bwietla\u0107 tre\u015b\u0107 dynamiczn\u0105?<\/h2>\n\n\n\n
<?php if ( have_posts() ) : ?>\n\n\t<?php while ( have_posts() ) : the_post(); ?>\n\t\t<article <?php post_class(); ?>>\n\t\t\t<h2>\n\t\t\t\t<a href=\"<?php the_permalink(); ?>\"><?php the_title(); ?><\/a>\n\t\t\t<\/h2>\n\t\t\t<?php the_excerpt(); ?>\n\t\t<\/article>\n\t<?php endwhile; ?>\n\n\t<?php the_posts_pagination(); ?>\n\n<?php else : ?>\n\n\t<p><?php esc_html_e( 'Nic nie znaleziono.', 'acme' ); ?><\/p>\n\n<?php endif; ?><\/code><\/pre>\n\n\n\nthe_title()<\/code> i the_content()<\/code> wypisuj\u0105 dane bezpo\u015brednio. Ich odpowiedniki z przedrostkiem get_<\/code> zwracaj\u0105 warto\u015b\u0107, co jest potrzebne wtedy, gdy przed wy\u015bwietleniem trzeba j\u0105 przetworzy\u0107.<\/p>\n\n\n\nWP_Query<\/code> i zawsze zresetuj dane po zako\u0144czeniu:<\/p>\n\n\n\n$featured = new WP_Query( array(\n\t'post_type' => 'post',\n\t'posts_per_page' => 3,\n\t'meta_key' => '_acme_featured',\n\t'meta_value' => '1',\n) );\n\nif ( $featured->have_posts() ) {\n\twhile ( $featured->have_posts() ) {\n\t\t$featured->the_post();\n\t\t\/\/ wyj\u015bcie\n\t}\n\twp_reset_postdata();\n}<\/code><\/pre>\n\n\n\nJakie praktyki bezpiecze\u0144stwa maj\u0105 znaczenie?<\/h2>\n\n\n\n
echo esc_html( $title );\necho '<a href=\"' . esc_url( $link ) . '\">';\nprintf( '<img src=\"%s\" alt=\"%s\">', esc_url( $src ), esc_attr( $alt ) );\necho wp_kses_post( $rich_text );<\/code><\/pre>\n\n\n\nif ( ! isset( $_POST['acme_nonce'] ) || ! wp_verify_nonce( sanitize_key( $_POST['acme_nonce'] ), 'acme_action' ) ) {\n\treturn;\n}\n\nif ( ! current_user_can( 'edit_posts' ) ) {\n\treturn;\n}\n\n$value = sanitize_text_field( wp_unslash( $_POST['acme_field'] ) );<\/code><\/pre>\n\n\n\n$wpdb->prepare()<\/code>, a tam gdzie istnieje funkcja z API WordPressa, korzystaj z niej zamiast z w\u0142asnego SQL. Wi\u0119kszo\u015b\u0107 podatno\u015bci w motywach bierze si\u0119 z braku escapowania i pomini\u0119tej kontroli uprawnie\u0144, nie z niczego egzotycznego.<\/p>\n\n\n\nJak testowa\u0107 i debugowa\u0107 motyw?<\/h2>\n\n\n\n
wp-config.php<\/code> na \u015brodowisku deweloperskim i nigdy na produkcji:<\/p>\n\n\n\ndefine( 'WP_DEBUG', true );\ndefine( 'WP_DEBUG_LOG', true );\ndefine( 'WP_DEBUG_DISPLAY', false );\ndefine( 'SCRIPT_DEBUG', true );<\/code><\/pre>\n\n\n\nNajcz\u0119stsze b\u0142\u0119dy<\/h2>\n\n\n\n
\n
?><\/code> w plikach PHP<\/li>\n\n\n\ntheme.json<\/code>, a potem walka z domy\u015blnymi ustawieniami edytora blok\u00f3w w CSS<\/li>\n\n\n\nFAQ<\/h2>\n\n\n\n
Jakie pliki s\u0105 wymagane do stworzenia motywu WordPress?<\/h3>\n\n\n\n
style.css<\/code> i index.php<\/code>. Motyw blokowy wymaga style.css<\/code> i templates\/index.html<\/code>. W obu przypadkach functions.php<\/code> i theme.json<\/code> s\u0105 zdecydowanie zalecane przy czymkolwiek poza demonstracj\u0105.<\/p>\n\n\n\nCzy functions.php wymaga otwieraj\u0105cego znacznika PHP?<\/h3>\n\n\n\n
<?php<\/code> jest wymagany. Konwencja m\u00f3wi natomiast o pomini\u0119ciu zamykaj\u0105cego ?><\/code> na ko\u0144cu pliku, poniewa\u017c znaki puste po nim mog\u0105 wys\u0142a\u0107 wyj\u015bcie przed nag\u0142\u00f3wkami i zepsu\u0107 serwis.<\/p>\n\n\n\nMotyw blokowy czy klasyczny?<\/h3>\n\n\n\n