Asensit teeman, viimeistelit sivuston, säädit värejä ja fontteja, lisäsit pari mukautettua mallipohjaa. Sitten teemapäivitys saapuu ja pyyhkii kaiken pois. Kuulostaako tutulta?

Lapsiteema WordPressissä on mekanismi, joka erottaa omat muokkauksesi kehittäjän koodista. Voit muuttaa mitä haluat, ja pääteema päivittyy ilman seurauksia. Se kuulostaa taialta, mutta taustalla on vain yksi rivi style.css-tiedostossa.

Tässä oppaassa käydään läpi koko matka konseptista toimivaan lapsiteemaan: miksi tarvitset sellaisen, miten luot sen manuaalisesti, miten otat tyylit ja functions.php:n käyttöön ja mitä tehdä, jos jokin menee pieleen. Ei turhaa löpinää, vaan testattuja koodinpätkiä.

💡 Nopea yleiskatsaus:

• Luo lapsiteemakansio hakemistoon /wp-content/themes/, mikä tahansa nimi käy, esimerkiksi mytheme-child
• Lisää style.css, jossa on teeman otsikkotiedot ja Template:-rivi, joka osoittaa pääteeman kansioon
• Ota pääteeman tyylit käyttöön functions.php-tiedoston kautta käyttäen wp_enqueue_style()-funktiota wp_enqueue_scripts-koukussa
• Kopioi mikä tahansa mallitiedosto pääteemasta lapsiteemaan ja muokkaa sitä pelkäämättä päivityksiä
• Kaikkea muuta (functions.php, mukautetut kentät, uudet mallipohjat) voidaan laajentaa koskematta pääteemaan

Mikä on WordPress-lapsiteema

Lapsiteema on WordPress-teema, joka perii kaiken toiminnallisuuden, tyylit ja mallipohjat toiselta teemalta. Sitä teemaa, jolta peritään, kutsutaan pääteemaksi. Lapsiteema itsessään voi koostua vain yhdestä style.css-tiedostosta ja toimia silti täysin.

Perintämekanismi on suoraviivainen. Kun WordPress lataa sivua, se etsii ensin tarvittavaa mallitiedostoa lapsiteemasta. Jos se löytyy, WordPress käyttää sitä tiedostoa. Jos ei löydy, se ottaa tiedoston pääteemasta. Tästä syystä voit korvata vain sen, mitä haluat muuttaa, ja kaikki muu tulee automaattisesti pääteemasta.

Avaintekijä, jota ilman lapsiteemaa ei voi olla olemassa, on Template:-rivi style.css-otsikkotiedoissa. Se osoittaa pääteeman kansion nimeen (esimerkiksi twentytwentyfour) ja luo pääteema-lapsiteema-suhteen. Rivin on vastattava pääteeman kansion nimeä tarkalleen, kirjainkoko mukaan lukien.

Pääteema voi olla MIKÄ TAHANSA asennettu WordPress-teema, oletusarvoisesta Twenty Twenty-Fivesta kaupalliseen teemaan, kuten Total tai Kadence. Lapsiteema "lainaa" sen tiedostoja ja funktioita, mutta ei fyysisesti kopioi niitä.

Miksi tarvitset lapsiteeman: 4 syytä

Voisit ohittaa tämän kaiken ja muokata pääteemaa suoraan. Monet tekevät niin. Mutta tässä on, mitä seuraavaksi tapahtuu.

Turvalliset päivitykset

Pääteeman kehittäjä julkaisee päivityksen, ja sinä asennat sen. Jos muokkasit pääteeman tiedostoja suoraan, kaikki muutokset pyyhkiytyvät pois. Lapsiteema säilyttää omat muokkauksesi erillään: pääteeman päivittäminen ei koske niihin. Saat sekä tuoreen version teemasta (tietoturvakorjauksineen) että säilyneet muokkauksesi.

Eristetty kokeilu

Haluatko kokeilla uutta mallipohjarakennetta tai epätavanomaista CSS-kikkaa? Lapsiteemassa voit kokeilla vapaasti. Jos jokin menee pieleen, poista lapsiteema käytöstä, ja sivusto palaa pääteemaan alkuperäisessä tilassaan.

Puhdas koodipohja

Lapsiteema sisältää vain omat muutoksesi. Pari mallipohjaa, functions.php koukkuineen, style.css korvaavine tyyleineen. Ei sekoitusta alkuperäistä koodia ja omia muokkauksiasi. Kun sinun täytyy korjata jotain puolen vuoden kuluttua, et kaivele jonkun toisen koodia etsien omaasi.

Nopea kehityksen aloitus

Lapsiteema on täydellinen hiekkalaatikko WordPress-teemakehityksen opetteluun. Et kirjoita teemaa tyhjästä (se vie satoja tunteja), vaan teet kohdennettuja muutoksia jo toimivaan teemaan. Virallinen WordPress-lapsiteemadokumentaatio suosittelee juuri tätä lähestymistapaa aloitteleville kehittäjille.

Mitkä ovat lapsiteemojen haittapuolet

On myös haittoja. Ne eivät ole kriittisiä, mutta niiden tietäminen etukäteen auttaa.

Peruskoodaustaidot vaaditaan

Lapsiteeman pystyttäminen edellyttää HTML:n, CSS:n ja jonkin verran PHP:n osaamista. Jos et ole koskaan avannut koodieditoria, sinun on opeteltava perusteet. Hyvä uutinen: tyypillisiin tehtäviin (tyylien käyttöönotto, koukun lisääminen) koodi on jo kirjoitettu; kopioit sen vain ja korvaat omat arvosi.

Mukauttimen asetusten siirto

Jotkin teemat sitovat mukauttimen asetukset (värit, fontit, asettelu) aktiivisen teeman nimeen. Kun vaihdat lapsiteemaan, nämä asetukset "katoavat". Ne eivät ole kadonneet; ne säilyvät tietokannassa sidottuna pääteeman nimeen. Ratkaisu: ennen lapsiteeman aktivointia vie mukauttimen asetukset (monet teemat, kuten Total, tarjoavat sisäänrakennetun tuonti-/vientityökalun) tai siirrä ne manuaalisesti aktivoinnin jälkeen.

Riippuvuus pääteemasta

Lapsiteema ilman pääteemaansa on vain kansio tiedostoineen. Jos päätät vaihtaa teemaa kokonaan, sinun on luotava uusi lapsiteema tyhjästä. Lapsiteeman functions.php-tiedostoon upotetut funktiot voivat olla sidottu tiettyyn pääteemaan liittyviin koukkuihin, ja nekin on mukautettava.

Miten luodaan lapsiteema manuaalisesti

Suorin reitti, ilman lisäosia, vain käsin tekemällä. Tarvitset pääsyn sivustosi tiedostoihin (FTP, palveluntarjoajasi tiedostonhallinta tai cPanel) ja tekstieditorin.

Vaihe 1. Luo lapsiteemakansio

Avaa WordPress-teemahakemisto: /wp-content/themes/. Luo uusi kansio. Mikä tahansa nimi käy, mutta käytäntönä on lisätä -child-pääte pääteeman nimeen: esimerkiksi twentytwentyfive-teemalle lapsikansio olisi twentytwentyfive-child.

Tiedostojen käsittelyyn FTP:n kautta FileZilla toimii hyvin. Palveluntarjoajan kautta käytä cPanelin tai hallintapaneelisi sisäänrakennettua tiedostonhallintaa.

Vaihe 2. Luo style.css teeman otsikkotiedoilla

Luo lapsiteemakansioon tiedosto nimeltä style.css. Tämä on ainoa pakollinen tiedosto. Liitä siihen teeman otsikkotiedot:

1
/*
2
Theme Name:   Twenty Twenty-Five Child
3
Theme URI:    https://example.com/
4
Description:  Child theme for Twenty Twenty-Five
5
Author:       Your Name
6
Template:     twentytwentyfive
7
Version:      1.0.0
8
*/

Template:-rivi on se, joka linkittää lapsiteeman pääteemaan. Arvon on vastattava TARKALLEEN pääteeman kansion nimeä. Twenty Twenty-Fivelle kansion nimi on twentytwentyfive, joten kirjoitat juuri sen. Kirjoitusvirhe tai väärä kirjainkoko tarkoittaa, että teemaa ei tunnisteta lapsiteemaksi.

Vaihe 3. Ota pääteeman tyylit käyttöön

Tässä vaiheessa lapsiteema jo toimii; voit aktivoida sen kohdassa Ulkoasu → Teemat. Mutta sivusto näkyy ilman tyylejä, koska style.css-tiedostosi on vielä tyhjä (lukuun ottamatta otsikkotietoja).

Luo tiedosto nimeltä functions.php lapsiteemakansioon ja lisää koodi pääteeman tyylien käyttöönottoa varten:

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
}

Tämä koodi poimii dynaamisesti pääteeman version ja lisää sen parametrina tyylitiedoston URL-osoitteeseen. Kun teema päivittyy, versio muuttuu, selain tyhjentää välimuistinsa ja käyttäjät näkevät ajantasaiset tyylit ilman CSS-ongelmia.

Korvaa twentytwentyfive pääteemasi nimellä. Käytä wp_get_theme()-funktiota kovakoodatun versionumeron sijaan; tämä suojaa sinua välimuistiongelmilta päivitysten yhteydessä.

Vaihe 4. Aktivoi lapsiteema

WordPress-hallintapaneelissa: Ulkoasu → Teemat → etsi juuri luomasi lapsiteema → Aktivoi. Sivuston ulkoasu ei muutu; tämä on normaalia. Olet nyt lapsiteemassa, ja se toimii.

Miten lapsiteemaa muokataan

Teema on aktivoitu; nyt on muokkauksen aika. Tässä on, mitä voit ja mitä kannattaa tehdä.

Omien tyylien lisääminen

Kirjoita kaikki CSS-sääntösi lapsiteeman style.css-TIEDOSTOON, otsikkotieto-osion jälkeen. Ne ohittavat automaattisesti pääteeman tyylit, joilla on sama spesifisyys. Jos haluat muuttaa otsikon väriä, kirjoita sääntö lapsiteeman style.css-tiedostoon, ja se tulee voimaan.

Mallitiedostojen muokkaaminen

Haluatko muuttaa single.php- tai footer.php-tiedoston rakennetta? Kopioi haluttu tiedosto pääteemasta lapsiteemakansioon säilyttäen saman alikansiorakenteen (esimerkiksi /template-parts/). Muokkaa kopiota lapsiteemassa; kun WordPress latautuu, se käyttää sinun versiotasi pääteeman alkuperäisen sijaan.

Tärkeä yksityiskohta: voit kopioida vain MALLITIEDOSTOJA (ne, jotka sijaitsevat teeman juurikansiossa ja template-parts/-kansiossa). Tiedostoja alikansioista, kuten inc/, functions/ ja classes/, ei kopioida tällä tavalla. Muokataksesi logiikkaa näistä tiedostoista käytä WordPressin koukkuja ja suodattimia.

Laajentaminen functions.php:n kautta

Lapsiteeman functions.php latautuu ENNEN pääteeman vastaavaa. Tämä tarkoittaa, että voit:

• Lisätä uusia funktioita koskematta pääteeman functions.php-tiedostoon;
• Ohittaa pääteeman funktioita vain, jos ne on kääritty if ( ! function_exists() ) -tarkistukseen;
• Lisätä uusia koukkuja ja suodattimia muuttaaksesi pääteeman tai WordPressin itsensä toimintaa.

Esimerkki: SVG-tiedostojen lataamisen salliminen lapsiteeman functions.php-tiedoston kautta:

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' );

Älä koskaan kopioi KOKO functions.php-tiedostoa pääteemasta lapsiteemaan. Tämä aiheuttaa kriittisen virheen uudelleen määriteltyjen funktioiden vuoksi. Lapsiteeman functions.php laajentaa pääteeman vastaavaa; se ei korvaa sitä.

Uusien mallitiedostojen lisääminen

Lapsiteema voi sisältää mallipohjia, joita ei ole pääteemassa. Voit esimerkiksi luoda template-full-width.php-tiedoston sivuille, joissa ei ole sivupalkkia, ja WordPress havaitsee sen lapsiteemassa ja tarjoaa sitä vaihtoehtona sivua muokattaessa.

Työkalut ja tekstieditorit

Mikä tahansa editori käy lapsiteeman koodille, mutta syntaksin korostus helpottaa asioita. Tässä muutamia vaihtoehtoja:

• VS Code: ilmainen, lisäosineen PHP:lle ja WordPressille;
• Notepad++: kevyt editori Windowsille, joka käsittelee CSS/PHP/JS-kielet;
• Sublime Text: nopea ja minimalistinen, maksullinen kokeilujakson jälkeen.

Tiedostojen käyttöön FTP:n kautta käytä FileZilla FTP -asiakasohjelmaa. Palveluntarjoajan käyttäjille sisäänrakennettu cPanelin tiedostonhallinta on täysin riittävä muutaman tiedoston luomiseen.

Yleiset virheet ja miten ne korjataan

Vuosien lapsiteemojen parissa työskentelyn aikana olemme koonneet listan yleisimmistä kompastuskivistä.

"Lapsiteemaa ei tunnisteta." Melkein aina tämä on virhe Template:-rivillä. Tarkista, että pääteeman kansion nimi täsmää merkki merkiltä, mukaan lukien kirjainkoko ja väliviivat. TwentyTwentyFive ja twentytwentyfive ovat eri nimiä.

"Sivusto näyttää pelkkää HTML:ää ilman tyylejä." Lapsiteema on aktivoitu, mutta tyylejä ei ole otettu käyttöön. Lisää wp_enqueue_style() lapsiteeman functions.php-tiedostoon (katso Vaihe 3).

"Kriittinen PHP-virhe aktivoinnin jälkeen." Todennäköisesti kopioit pääteeman functions.php-tiedoston lapsiteemaan, ja nyt funktiot on määritelty kahteen kertaan. Poista duplikaatit lapsiteeman functions.php-tiedostosta; pidä vain OMAT funktiosi.

"Mukauttimen asetukset ovat kadonneet." Ne on sidottu teeman nimeen. Vaihda väliaikaisesti takaisin pääteemaan, vie asetukset (lisäosan tai teeman sisäänrakennetun työkalun kautta), aktivoi sitten lapsiteema ja tuo ne.

"Pääteeman päivittäminen rikkoi asettelun." Kehittäjä muutti HTML-rakennetta mallipohjassa, jonka kopioit lapsiteemaan. Kopiosi on nyt yhteensopimaton uusien tyylien kanssa. Ratkaisu: vertaa uutta pääteeman mallipohjaa kopioosi ja mukauta muutokset.

Vaiheittainen video (EN) lapsiteeman luomisesta: kansion luomisesta lopulliseen aktivointiin ja tyylien asetukseen. WPEstate-kanava, 2025, selkeä ja ilman täytettä.

⁉️🤔 Usein kysytyt kysymykset

Täytyykö minun luoda lapsiteema jokaiselle WordPress-sivustolle?

Ei. Jos et muokkaa teematiedostoja etkä lisää mukautettua koodia, et tarvitse lapsiteemaa. Mutta jos olet koskaan avannut teemaeditorin hallintapaneelissa, lisännyt CSS:ää Lisä-CSS-kenttään ja suunnittelet mallipohjien muokkaamista, luo lapsiteema. Se vie nyt 10 minuuttia ja säästää tunteja seuraavassa päivityksessä.

Mitä tapahtuu, jos poistan pääteeman mutta pidän lapsiteeman?

Sivusto kaatuu kriittisellä virheellä. Lapsiteema ilman pääteemaansa ei toimi; se ei sisällä täyttä tiedostosarjaa ja perii kaiken pääteemalta. Ennen pääteeman poistamista poista (tai poista käytöstä) ensin lapsiteema ja aktivoi eri teema.

Voinko luoda "lapsenlapsiteeman", lapsiteeman lapsen?

Et. WordPress tukee vain yhtä perintätasoa: pääteema → lapsiteema. Monimutkaisiin muokkauksiin, jotka eivät mahdu yhteen lapsiteemaan, oikea lähestymistapa on haarukoida teema ja luoda täysi pääteema tai siirtää logiikka erilliseen lisäosaan.

Toimiiko lapsiteema lohkoteemojen (FSE, Full Site Editing) kanssa?

Kyllä, mutta mekanismi eroaa hieman. Lohkoteemoissa lapsiteeman theme.json yhdistetään pääteeman vastaavaan sen korvaamisen sijaan. Mallipohjat ja mallipohjan osat ohitetaan samalla tavalla: luomalla samanniminen tiedosto lapsiteemaan. Lisätietoja on virallisessa Developer Resources -dokumentaatiossa wordpress.orgissa.

Miten siirrän jo pääteemaan tehdyt muokkaukset lapsiteemaan?

Tunnista, mitä muutit: CSS, mallipohjat vai functions.php. Kopioi CSS-säännöt lapsiteeman style.css-tiedostoon. Muokattujen mallipohjien osalta kopioi tiedostot lapsiteemaan ja säilytä muokkauksesi siellä. Siirrä koodia pääteeman functions.php-tiedostosta valikoiden: vain omat funktiosi, ei koko tiedostoa. Siirron jälkeen poista muokkauksesi pääteemasta; muuten ne katoavat seuraavassa päivityksessä.

Kannattaako lapsiteema luoda juuri nyt

Jos luit tänne asti, vastaus on luultavasti kyllä. Lapsiteema ei monimutkaista sivustoa eikä hidasta sitä. Se erottaa oman koodisi teeman kehittäjän koodista. Se on kuin koodin kommentointi: aluksi se tuntuu tarpeettomalta, mutta kuukauden päästä se pelastaa sinut.

Niille, jotka muokkaavat teemaa ensimmäistä kertaa: aloita hiekkalaatikolla. Paikallinen palvelin (LocalWP, XAMPP) tai staging-sivusto palveluntarjoajallasi. Luo lapsiteema yllä olevien vaiheiden mukaisesti, lisää pari CSS-sääntöä, kopioi yksi mallipohja. Kun näet, että kaikki toimii, toista sama tuotantosivustollasi.

Kysymys ei ole siitä, tarvitsetko lapsiteemaa. Kysymys on siitä, milloin muistat sen: ennen teemapäivitystä vai sen jälkeen, kun muokkauksesi ovat kadonneet.