Doprowadził Pan/Pani temat do porządku, skonfigurował/a stronę, kolory, czcionki, kilka niestandardowych szablonów. A potem przychodzi aktualizacja motywu i kasuje wszystko do zera. Brzmi znajomo?

Motyw potomny WordPress to właśnie ten mechanizm, który oddziela Pana/Pani zmiany od kodu dewelopera. Zmienia Pan/Pani cokolwiek, a motyw nadrzędny aktualizuje się bez konsekwencji. Brzmi jak magia, ale stoi za tym tylko jedna linijka w style.css.

W tym poradniku, od pomysłu do działającego motywu potomnego: dlaczego jest potrzebny, jak stworzyć go ręcznie, jak podłączyć style i functions.php oraz co zrobić, gdy coś pójdzie nie tak. Bez lania wody, ze sprawdzonymi snippetami.

💡 Szybki przegląd:

• Proszę utworzyć folder motywu potomnego w /wp-content/themes/, nazwa dowolna, np. mytheme-child
• Proszę dodać style.css z nagłówkiem motywu i linią Template:, wskazującą folder motywu nadrzędnego
• Proszę podłączyć style nadrzędne przez functions.php, funkcja wp_enqueue_style() na hooku wp_enqueue_scripts
• Proszę skopiować dowolny plik szablonu motywu nadrzędnego do potomnego i edytować bez obaw przed aktualizacjami
• Całą resztę (functions.php, pola niestandardowe, nowe szablony) proszę rozszerzać, nie ruszając motywu nadrzędnego

Czym jest motyw potomny WordPress

Motyw potomny to motyw WordPress, który dziedziczy całą funkcjonalność, style i szablony innego motywu. Ten, od którego dziedziczy, nazywany jest nadrzędnym. Sam w sobie motyw potomny może składać się z jednego jedynego pliku style.css i przy tym w pełni działać.

Mechanizm dziedziczenia jest prosty. Gdy WordPress ładuje stronę, najpierw szuka potrzebnego pliku szablonu w motywie potomnym. Jeśli znajdzie, używa go. Jeśli nie znajdzie, bierze z motywu nadrzędnego. Właśnie dlatego może Pan/Pani nadpisać tylko to, co chce zmienić, a cała reszta zostanie „podciągnięta" z motywu nadrzędnego automatycznie.

Kluczowym elementem, bez którego motyw potomny nie istnieje, jest linia Template: w nagłówku style.css. Wskazuje ona nazwę folderu motywu nadrzędnego (np. twentytwentyfour) i tworzy tę właśnie relację „rodzic → dziecko". Linia musi pokrywać się z nazwą folderu motywu nadrzędnego co do joty, z uwzględnieniem wielkości liter.

Motywem nadrzędnym może być DOWOLNY zainstalowany motyw WordPress, od standardowego Twenty Twenty-Five po komercyjny, taki jak Total czy Kadence. Motyw potomny „pożycza" jego pliki i funkcje, ale nie kopiuje ich fizycznie.

Dlaczego motyw potomny jest potrzebny: 4 powody

Można w ogóle się nie przejmować i edytować motyw nadrzędny bezpośrednio. Wielu tak robi. Ale oto, co dzieje się później.

Bezpieczne aktualizacje

Deweloper motywu nadrzędnego wydaje aktualizację, Pan/Pani ją instaluje. Jeśli edytował/a Pan/Pani pliki motywu nadrzędnego bezpośrednio, wszystkie zmiany zostają skasowane. Motyw potomny przechowuje Pana/Pani poprawki osobno: aktualizacja motywu nadrzędnego ich nie rusza. Otrzymuje Pan/Pani zarówno świeżą wersję motywu (z poprawkami bezpieczeństwa), jak i zachowane dostosowania.

Izolacja eksperymentów

Chce Pan/Pani wypróbować nową strukturę szablonu lub niestandardowy hack CSS? W motywie potomnym można eksperymentować swobodnie. Coś poszło nie tak, dezaktywuje Pan/Pani motyw potomny i strona znów działa na nadrzędnym, w stanie początkowym.

Czysta baza kodu

Motyw potomny zawiera tylko Pana/Pani zmiany. Kilka szablonów, functions.php z hookami, style.css z nadpisaniami. Żadnej mieszaniny oryginalnego kodu i Pana/Pani poprawek. Gdy za pół roku trzeba będzie coś poprawić, nie grzebie Pan/Pani w cudzym kodzie w poszukiwaniu swojego.

Szybki start w rozwoju

Motyw potomny to idealny poligon do nauki tworzenia motywów WordPress. Nie pisze Pan/Pani motywu od zera (to setki godzin), a punktowo zmienia zachowanie już działającego motywu. Oficjalny poradnik WordPress o motywach potomnych zaleca właśnie takie podejście dla początkujących deweloperów.

Jakie są minusy motywów potomnych

Wady też istnieją. Nie są krytyczne, ale lepiej wiedzieć o nich zawczasu.

Wymagana podstawowa znajomość kodu

Konfiguracja motywu potomnego to HTML, CSS i trochę PHP. Jeśli nigdy nie otwierał/a Pan/Pani edytora kodu, trzeba będzie opanować podstawy. Dobra wiadomość: dla typowych zadań (podłączenie stylów, dodanie hooka) kod jest już napisany, trzeba go skopiować i podstawić swoje wartości.

Przenoszenie ustawień Kastomizatora

Niektóre motywy wiążą ustawienia Kastomizatora (kolory, czcionki, układ) z nazwą aktywnego motywu. Przy przełączeniu na potomny ustawienia te „znikają". Nie są utracone, leżą w bazie danych, powiązane z nazwą motywu nadrzędnego. Rozwiązanie: przed aktywacją motywu potomnego proszę wyeksportować ustawienia Kastomizatora (wiele motywów, np. Total, daje wbudowane narzędzie importu/eksportu) lub przenieść je ręcznie po aktywacji.

Zależność od motywu nadrzędnego

Motyw potomny bez nadrzędnego to po prostu folder z plikami. Jeśli zdecyduje się Pan/Pani całkowicie zmienić motyw, potomny trzeba będzie stworzyć od nowa. Funkcje zaszyte w functions.php motywu potomnego mogą okazać się powiązane z hookami konkretnego motywu nadrzędnego, je również trzeba będzie zaadaptować.

Jak stworzyć motyw potomny ręcznie

Najprostsza ścieżka, bez wtyczek, gołymi rękami. Będzie Pan/Pani potrzebować dostępu do plików strony (FTP, menedżer plików hostingu lub cPanel) i edytora tekstu.

Krok 1. Proszę utworzyć folder motywu potomnego

Proszę otworzyć katalog motywów WordPress: /wp-content/themes/. Proszę utworzyć nowy folder. Nazwa dowolna, ale przyjęło się dodawać sufiks -child do nazwy motywu nadrzędnego: np. dla twentytwentyfive folder potomny to twentytwentyfive-child.

Do pracy z plikami przez FTP nada się FileZilla. Przez hosting, wbudowany menedżer plików w cPanel lub panelu hostingu.

Krok 2. Proszę utworzyć style.css z nagłówkiem motywu

W folderze motywu potomnego proszę utworzyć plik style.css. To jedyny obowiązkowy plik. Proszę wstawić w niego nagłówek motywu:

1
/*
2
Theme Name:   Twenty Twenty-Five Child
3
Theme URI:    https://example.com/
4
Description:  Дочерняя тема для Twenty Twenty-Five
5
Author:       Ваше имя
6
Template:     twentytwentyfive
7
Version:      1.0.0
8
*/

Linia Template: to ta, która wiąże motyw potomny z nadrzędnym. Wartość musi ŚCIŚLE pokrywać się z nazwą folderu motywu nadrzędnego. Dla Twenty Twenty-Five folder nazywa się twentytwentyfive, właśnie tę wartość wpisujemy. Literówka lub nieprawidłowa wielkość liter i motyw nie zostanie rozpoznany jako potomny.

Krok 3. Proszę podłączyć style motywu nadrzędnego

Na tym etapie motyw potomny już działa, można go aktywować w „Wygląd → Motywy". Ale strona będzie wyglądać bez stylów: przecież Pana/Pani style.css jest na razie pusty (poza nagłówkiem).

Proszę utworzyć w folderze motywu potomnego plik functions.php i dodać kod do podłączenia stylów nadrzędnych:

1
add_action( 'wp_enqueue_scripts', 'my_theme_enqueue_styles' );
2
 
3
function my_theme_enqueue_styles() {
4
    $theme   = wp_get_theme( 'twentytwentyfive' );
5
    $version = $theme->get( 'Version' );
6
 
7
    wp_enqueue_style(
8
        'parent-style',
9
        get_template_directory_uri() . '/style.css',
10
        array(),
11
        $version
12
    );
13
}

Ten kod dynamicznie pobiera wersję motywu nadrzędnego i dodaje ją jako parametr do URL stylów. Przy aktualizacji motywu wersja się zmieni, przeglądarka wyczyści cache, a użytkownicy zobaczą aktualne style bez problemów z CSS.

Proszę zamienić twentytwentyfive na nazwę swojego motywu nadrzędnego. Proszę używać właśnie wp_get_theme(), a nie sztywno zaszytego numeru wersji, w ten sposób zabezpieczy się Pan/Pani przed problemami z cache przy aktualizacjach.

Krok 4. Proszę aktywować motyw potomny

W panelu administracyjnym WordPress: „Wygląd → Motywy" → proszę znaleźć utworzony motyw potomny → „Aktywuj". Z zewnątrz strona się nie zmieni, to normalne. Jest Pan/Pani na motywie potomnym i on działa.

Jak skonfigurować motyw potomny

Motyw jest aktywowany, teraz czas na dostosowanie. Oto co można i trzeba robić.

Dodawanie własnych stylów

Wszystkie swoje reguły CSS proszę pisać DO PLIKU style.css motywu potomnego, po sekcji z nagłówkiem. Automatycznie nadpiszą one style motywu nadrzędnego o tej samej specyficzności. Jeśli chce Pan/Pani zmienić kolor nagłówków, proszę napisać regułę w potomnym style.css, a zostanie zastosowana.

Edytowanie plików szablonów

Chce Pan/Pani zmienić strukturę single.php lub footer.php? Proszę skopiować potrzebny plik z motywu nadrzędnego do folderu potomnego, zachowując tę samą strukturę podfolderów (np. /template-parts/). Proszę edytować kopię w motywie potomnym, WordPress przy ładowaniu weźmie ją, a nie nadrzędny oryginał.

Ważny niuans: kopiować można tylko PLIKI SZABLONÓW (te, które leżą w katalogu głównym motywu i folderze template-parts/). Plików z podfolderów inc/, functions/ i classes/ się nie kopiuje. Do zmiany logiki z tych plików proszę używać hooków i filtrów WordPress.

Rozszerzanie przez functions.php

functions.php motywu potomnego ładuje się PRZED nadrzędnym. Oznacza to, że może Pan/Pani:

• Dodawać nowe funkcje, nie ruszając nadrzędnego functions.php;
• Nadpisywać funkcje nadrzędne, tylko jeśli są opakowane w if ( ! function_exists() );
• Podłączać nowe hooki i filtry do zmiany zachowania motywu nadrzędnego lub samego WordPress.

Przykład: dodajemy obsługę SVG w przesyłaniu przez potomny functions.php:

1
function my_child_allow_svg( $mimes ) {
2
    $mimes['svg'] = 'image/svg+xml';
3
    return $mimes;
4
}
5
add_filter( 'upload_mimes', 'my_child_allow_svg' );

Nigdy nie kopiuj CAŁEGO functions.php motywu nadrzędnego do potomnego. Spowoduje to błąd krytyczny z powodu ponownej deklaracji funkcji. Potomny functions.php rozszerza nadrzędny, a nie zastępuje go.

Dodawanie nowych plików szablonów

Motyw potomny może zawierać szablony, których nie ma w nadrzędnym. Na przykład, może Pan/Pani utworzyć template-full-width.php dla stron bez paska bocznego, WordPress wykryje go w motywie potomnym i zaproponuje wybór przy edycji strony.

Narzędzia i edytory tekstu

Do pracy z kodem motywu potomnego nada się dowolny edytor, ale z podświetlaniem składni jest wygodniej. Oto opcje:

• VS Code, darmowy, z rozszerzeniami dla PHP i WordPress;
• Notepad++, lekki edytor dla Windows, radzi sobie z CSS/PHP/JS;
• Sublime Text, szybki i minimalistyczny, płatny po okresie próbnym.

Do dostępu do plików przez FTP, klient FTP FileZilla. Dla użytkowników hostingu wbudowany menedżer plików cPanel w zupełności wystarczy do stworzenia kilku plików.

Typowe błędy i ich rozwiązania

Przez lata pracy z motywami potomnymi zebraliśmy listę tego, o co potykają się najczęściej.

„Motyw potomny nie jest rozpoznawany". Prawie zawsze błąd w linii Template:. Proszę sprawdzić: nazwa folderu motywu nadrzędnego zgadza się znak po znaku, z uwzględnieniem wielkości liter i myślników. TwentyTwentyFive i twentytwentyfive to różne nazwy.

„Strona pokazuje czysty HTML bez stylów". Motyw potomny jest aktywowany, ale style nie są podłączone. Proszę dodać wp_enqueue_style() w functions.php motywu potomnego (patrz Krok 3).

„Krytyczny błąd PHP po aktywacji". Najprawdopodobniej skopiował/a Pan/Pani functions.php motywu nadrzędnego do potomnego i teraz funkcje są zadeklarowane podwójnie. Proszę usunąć duplikaty z potomnego functions.php, zostawić tylko SWOJE funkcje.

„Ustawienia Kastomizatora zniknęły". Są one powiązane z nazwą motywu. Proszę tymczasowo przełączyć się z powrotem na nadrzędny, wyeksportować ustawienia (przez wtyczkę lub wbudowane narzędzie motywu), następnie aktywować potomny i zaimportować.

„Aktualizacja motywu nadrzędnego popsuła układ". Deweloper zmienił strukturę HTML szablonu, który skopiował/a Pan/Pani do motywu potomnego. Pana/Pani kopia szablonu jest teraz niekompatybilna z nowymi stylami. Rozwiązanie: proszę porównać nowy szablon nadrzędny ze swoją kopią i zaadaptować zmiany.

Wideo krok po kroku (EN) z tworzenia motywu potomnego: od utworzenia folderu do finalnej aktywacji i konfiguracji stylów. Kanał WPEstate, 2025 rok, poglądowo i bez zbędnych treści.

⁉️🤔 Często zadawane pytania

Czy obowiązkowo trzeba tworzyć motyw potomny dla każdej strony na WordPress?

Nie. Jeśli nie edytuje Pan/Pani plików motywu i nie dodaje niestandardowego kodu, motyw potomny nie jest potrzebny. Ale jeśli choć raz otwierał/a Pan/Pani edytor motywu w panelu administracyjnym, dodał/a CSS w Additional CSS i planuje zmieniać szablony, proszę utworzyć motyw potomny. To 10 minut teraz i zaoszczędzone godziny przy następnej aktualizacji.

Co się stanie, jeśli usunę motyw nadrzędny, ale zostawię potomny?

Strona upadnie z błędem krytycznym. Motyw potomny bez nadrzędnego nie działa, nie zawiera pełnego zestawu plików i dziedziczy wszystko od rodzica. Przed usunięciem motywu nadrzędnego proszę najpierw usunąć (lub dezaktywować) potomny i aktywować inny motyw.

Czy można stworzyć motyw „wnuka", potomny od potomnego?

Nie. WordPress obsługuje tylko jeden poziom dziedziczenia: rodzic → dziecko. Dla złożonych dostosowań, które nie mieszczą się w jednym motywie potomnym, właściwsze jest sforkowanie motywu i stworzenie pełnoprawnego nadrzędnego lub wyniesienie logiki do osobnej wtyczki.

Czy motyw potomny działa z motywami blokowymi (FSE, Full Site Editing)?

Tak, ale mechanizm nieco się różni. W motywach blokowych theme.json motywu potomnego jest scalany z nadrzędnym (merge), a nie zastępuje go. Szablony i części szablonów nadpisuje się tak samo, poprzez utworzenie pliku o tej samej nazwie w motywie potomnym. Więcej szczegółów w oficjalnej dokumentacji Developer Resources na wordpress.org.

Jak przenieść już wprowadzone zmiany z motywu nadrzędnego do potomnego?

Proszę określić, co dokładnie Pan/Pani zmieniał/a: CSS, szablony czy functions.php. Reguły CSS proszę skopiować do potomnego style.css. Zmienione szablony, proszę skopiować pliki do motywu potomnego i zostawić tam swoje poprawki. Kod z functions.php motywu nadrzędnego proszę przenosić wybiórczo: tylko swoje funkcje, a nie cały plik. Po przeniesieniu proszę usunąć swoje poprawki z motywu nadrzędnego, w przeciwnym razie przy jego aktualizacji zostaną utracone.

Czy warto stworzyć motyw potomny właśnie teraz

Jeśli doczytał/a Pan/Pani do tego miejsca, odpowiedź brzmi najprawdopodobniej „tak". Motyw potomny nie komplikuje strony i nie spowalnia jej. Oddziela Pana/Pani kod od kodu dewelopera motywu, to jak komentowanie kodu: na początku wydaje się zbędne, a po miesiącu ratuje.

Dla tych, którzy edytują motyw po raz pierwszy: proszę zacząć od piaskownicy. Lokalny serwer (LocalWP, XAMPP) lub strona stagingowa na hostingu. Proszę utworzyć motyw potomny według powyższych kroków, dodać kilka reguł CSS, skopiować jeden szablon. Gdy zobaczy Pan/Pani, że wszystko działa, proszę powtórzyć na stronie produkcyjnej.

Pytanie nie brzmi, czy motyw potomny jest potrzebny. Pytanie brzmi, kiedy Pan/Pani o nim pomyśli: przed aktualizacją motywu czy po tym, jak Pana/Pani zmiany zniknęły.