WordPressin template hierarchy käytännön esimerkeillä

WordPressin template hierarchy on yksi järjestelmän voimakkaimmista mutta usein väärinymmärretyistä mekanismeista. Se määrittää, mikä PHP-tiedosto vastaa minkäkin URLin renderöinnistä, ja tekee sen ennalta määrätyn päätöspuun mukaan. Kun tämän logiikan ymmärtää, teeman rakentaminen muuttuu arvaamisesta hallituksi suunnitteluksi.

Template hierarchy ei ole mielipide. Se on sääntöjärjestelmä, jota WordPress noudattaa täsmällisesti jokaisella pyynnöllä.

Mikä template hierarchy oikeasti on

Template hierarchy on prioriteettilista. Kun WordPress käsittelee pyynnön, se:

• tunnistaa pyynnön tyypin

• muodostaa listan mahdollisista template-tiedostoista

• käyttää listan ensimmäistä olemassa olevaa tiedostoa

Jos tiedostoa ei löydy, WordPress siirtyy seuraavaan vaihtoehtoon. Lopulta päädytään aina

:hen, jos mikään muu ei täsmää.

Peruslähtökohta: index.php

on pakollinen tiedosto. Ilman sitä teema ei toimi. Se on:

• viimeinen fallback

• turvaverkko

• usein liian yleinen

Hyvin rakennettu teema käyttää

:tä vain poikkeustapauksissa. Mitä enemmän spesifejä templateja, sitä hallitumpi lopputulos.

Etusivu käytännön esimerkillä

Staattinen etusivu

Jos asetuksissa on määritelty staattinen etusivu, WordPress etsii templateja tässä järjestyksessä:

1. Copyfront-page.php

2. Copypage-{slug}.php

3. Copypage-{id}.php

4. Copypage.php

5. Copyindex.php

Käytännön esimerkki:

• haluat täysin räätälöidyn etusivun

• luot

  Copyfront-page.php

• muu sivuston rakenne ei vaikuta tähän lainkaan

ohittaa kaiken muun.

Blogietusivu

Jos blogi on etusivu, järjestys on:

1. Copyhome.php

2. Copyindex.php

Tämä on yleinen kompastuskivi.

ei ole sama asia kuin . Ne palvelevat eri käyttötapauksia.

Yksittäinen artikkeli (single post)

Kun avaat yksittäisen artikkelin, WordPress etsii:

1. Copysingle-{posttype}.php

2. Copysingle.php

3. Copysingular.php

4. Copyindex.php

Käytännön esimerkki:

• sinulla on custom post type

  Copyproject

• luot tiedoston

  Copysingle-project.php

• vain projektit käyttävät tätä templatea

Blogiartikkelit jatkavat käyttämään

.

Sivut (pages) ja kohdennus

Sivut ovat template hierarchyssa poikkeuksellisen joustavia.

WordPress etsii:

1. Copypage-{slug}.php

2. Copypage-{id}.php

3. Copypage.php

4. Copysingular.php

5. Copyindex.php

Käytännön esimerkki:

• sivu:

  Copy/yhteystiedot

• luot

  Copypage-yhteystiedot.php

• vain tämä sivu käyttää tiedostoa

Tämä mahdollistaa erittäin kohdennetut ratkaisut ilman ehtolauseita.

Arkistosivut käytännössä

Kategoriat

Kategoriasivulle WordPress etsii:

1. Copycategory-{slug}.php

2. Copycategory-{id}.php

3. Copycategory.php

4. Copyarchive.php

5. Copyindex.php

Esimerkki:

• kategoria: “uutiset”

• Copycategory-uutiset.php

• vain tämä kategoria saa oman rakenteen

Tagit

Tagit noudattavat samaa mallia:

1. Copytag-{slug}.php

2. Copytag-{id}.php

3. Copytag.php

4. Copyarchive.php

5. Copyindex.php

Custom post type -arkistot

Custom post type -arkisto käyttää:

1. Copyarchive-{posttype}.php

2. Copyarchive.php

3. Copyindex.php

Esimerkki:

• post type:

  Copyproject

• URL:

  Copy/project/

• template:

  Copyarchive-project.php

Tämä on usein parempi ratkaisu kuin yksi yleinen

.

Hakutulokset ja virhesivut

Haku

Hakusivu:

1. Copysearch.php

2. Copyindex.php

Hakutulokset kannattaa lähes aina erottaa omaksi templateksi, koska:

• rakenne poikkeaa arkistoista

• UX-vaatimukset ovat erilaiset

404-sivu

404 käyttää:

1. Copy404.php

2. Copyindex.php

Hyvin tehty

on käyttäjäkokemuksen, ei vain virheenkäsittelyn osa.

singular.php ja archive.php – väliportaat

ja ovat:

• yleisiä välietappeja

• hyödyllisiä fallbackeja

• usein alihyödynnettyjä

Esimerkki:

• kaikki yksittäiset sisällöt käyttävät samaa rakennetta

• erot tehdään osissa, ei koko templatessa

Tämä vähentää koodin toistoa.

Template hierarchy vs ehdolliset tagit

Yleinen virhe on tehdä näin:

• yksi

  Copypage.php

• kymmeniä

  Copyif ( is_page() )
  -ehtoja

Template hierarchy on puhtaampi ratkaisu:

• vähemmän ehtoja

• selkeämpi rakenne

• helpompi ylläpito

Jos joudut jatkuvasti tarkistamaan kontekstia PHP:ssä, olet todennäköisesti ohittanut hierarkian mahdollisuudet.

Block-teemat ja hierarchy

Block-teemat eivät poista template hierarchya. Ne:

• siirtävät osan logiikasta HTML- ja block-templatetiedostoihin

• noudattavat silti samaa päätöspuuta

Ajatusmalli ei muutu, vain toteutustapa.

Yleisimmät virheet

Tyypillisiä virheitä ovat:

• väärän tiedoston nimeäminen

• Copyhome.php
  ja
  Copyfront-page.php
  sekoittaminen

• liian yleinen

  Copyarchive.php

• monimutkainen logiikka yhdessä templatessa

Template hierarchy toimii parhaiten, kun sitä käytetään ennalta, ei jälkikäteen korjaamaan rakennetta.

Milloin template hierarchy on onnistunut

Hyvin käytetty template hierarchy tarkoittaa, että:

• tiedoston nimestä näkee heti sen tarkoituksen

• uusia sivutyyppejä voi lisätä ilman refaktorointia

• teema skaalautuu ilman ehtosotkua

Se tekee WordPress-teemasta järjestelmän, ei vain kokoelman PHP-tiedostoja.

Lopuksi: hierarchy on kartta, ei rajoite

WordPressin template hierarchy ei rajoita luovuutta. Se antaa kartan, jonka avulla monimutkainen sivustorakenne pysyy hallittavana.

Kun rakennat teeman hierarkian ehdoilla etkä sitä vastaan, koodi kevenee, virheet vähenevät ja WordPress alkaa tuntua siltä miltä sen on tarkoitus tuntua: ennustettavalta.

Aiheeseen sopivia artikkeleita

Lataa lisää