4.5. Kansiot ja tiedostorakenne

Kansioita ja tiedostoja

Kun olet asentanut WordPressin saatat suunnata tutkimaan asennuksen tiedosto- ja kansiorakennetta. Asennus sisältää suuren määrän tiedostoja ja alkuvaikutelma on todella sekava. Syy sekavuuteen on yksinkertaisesti se, että WordPress on koodattu verkkosovellus, jolla on omat toiminnalliset tiedostonsa. Sovelluksen sisällä toimivat meidän omat sivumme ja myös sivuston tiedostot toki löytyvät asennuksen tiedostoista. WordPress perustuu PHP-ohjelmointikieleen ja MySQL-tietokantaan, joten tiedostot ovat pääosin PHP-tiedostoja. Tutkimme seuraavassa tärkeimpiä juurikansioita ja -tiedostoja.

WordPressin juuri

Kun avaan WordPressin kansion ensimmäinen näkymä on ns. juuri. Juuressa sijaitsevat WordPress sovelluksen tiedostot. Kansioista wp-content on käytetyin ja sen sisältä löytyvät sivuston sisällön hallintaan liittyvät tiedostot, kuten teemat, lisäosien tiedostot yms. Tiedostoista taas ei juurikaan käytetä muita kuin wp-config.php tiedostoa. Tiedostot liittyvät WordPressin perustoimintoihin eivätkä vaikuta sivun ulkomuotoon tai toimintaan. Tiedostoja ei kannata mennä muokkaamaan, kuin välttämättömissä tilanteissa ja jos ymmärtää mitä tekee.

Jos avaan wp-admin kansion, huomaat, että se sisältää todella valtaisan määrän tiedostoja ja alakansioita. Wp-admin -kansion sisältö liittyy käyttäjäprofiilin hallintapaneelin toimintaan ja sen tiedostoihin ei juurikaan tarvitse kajota, sillä oman profiilin toimintoja voi hallita WordPressin hallintapaneelin kautta.

Myös wp-includes kansio sisältää valtavan määrän alakansioita ja tiedostoja. Kansio sisältää suurimman osan WordPressin ytimen (core) toimintaan vaikuttavista tiedostoista. Sanotaan, että tiedostoihin ei koskaan saisi kajota ja käytännössä kansio voisi olla piiloitettu näkyvistä.

Loppuyhteenvetona siis wp-content -kansio ja wp-config.php tiedosto ovat ainoat, joita tulemme tarvitsemaan sivustojen muokkauksessa. Siirrymmekin siis seuraavaksi wp-content -kansion pariin.

WP-content

Kaikki WordPressiin lataamasi sisältö löytyy erinäisistä paikoista wp-content-kansiosta. Kansioon latautuvat teemat, lisäosat, kuvat, tiedostot jne.

Blogs.dir on kansio, joka liittyy WordPressin Multisite -ominaisuuteen ja sitä ei peruskäytössä ole tarpeen huomioida.

Languages -kansio sisältää asennettujen teemojen ja lisäosien kieliversioiden PO– ja MO-tiedostoja. Jokaiselle kielelle on olemassa oma PO- ja MO-tiedosto. Languages-kansio kannattaa muistaa, jos joskus haluaa alkaa kääntämään esimerkiksi jonkin lisäosan käyttöliittymää suomenkieliseksi.

  • Portable Object (PO) -tiedosto sisältää kohdekielen koodin, jota muokataan, jos halutaan kääntää sivusto.
  • Machine Object (MO) -kielitiedosto on koneellisesti luettavissa ja luotu vastaavasta PO-tiedostosta. MO-tiedostoja ei ole tarkoitettu ihmisten muokattavaksi tai luettavaksi vaan ne ovat yksinkertaisesti PO-tiedostojesi versio, jonka tietokoneet, tässä tapauksessa WordPress voivat ymmärtää.
wp-content -kansion sisältö, jossa teemat (themes) ja lisäosat (plugins).
wp-content -kansion sisältö, jossa teemat (themes) ja lisäosat (plugins).
WordPress-asennuksen juuri kansio- ja tiedostorakennetta.
WordPress-asennuksen juuri kansio- ja tiedostorakennetta.

Kääntämiseen on olemassa myös käteviä lisäosia, jos manuaalinen kääntäminen ei tunnu sopivalta vaihtoehdolta. Loco Translate on esimerkiksi yksi vaihtoehto, jota itse olen ajoittain käyttänyt sivustoilla. Lisäosa osaa kääntää automaattisesti PO-tiedoston WordPressin ymmärtämään MO-muotoon.

Loco Translate lisäosan logo.

Themes – Asennetut teemat

Otetaan lähempään tarkasteluun Teemojen kansio (Themes). WordPressissä on aina oltava jokin teema käytössä. Kun valitsit omille sivuille teeman käyttöön ja klikkaat valitsemasi teeman kansion auki, löydät sivustojesi toimintaan ja ulkoasuun olennaisesti vaikuttavat tiedostot.

On ihmetys, että itse sivuston tiedostot ovat näinkin syvällä kansiorakenteen syövereissä WordPressissä. Sivujesi tiedostoissa voit nähdä myös internetsivuista tutun etusivun tiedoston index.php. Jos avaat sen tarkasteltavaksi tekstieditorissa, huomaat sen olevan miltei kokonaisuudessaan PHP-ohjelmointikieltä. HTML-koodia sivulla ei ole muuta kuin luokkamäärittelyt (div class).

Koodin muoto johtuu siitä, että jokainen sivuston osa tuodaan PHP-koodauksella sivulle erillisistä tiedostoista ja HTML-sivu koostuu itseasiassa useasta erillisestä sisältödokumentista (tiedostosta).

Käydään seuraavaksi tavallisimmat kansiot ja tiedostot läpi yksi kerrallaan.

Assets -kansio sisältää teeman CSS-sekä javascript-tiedostot mutta myös käytettävien fonttien kansion sekä muotoilussa käytettävien kuvien kansion. Kansio kannattaa muistaa juurikin CSS-tiedostojen takia. Jos katsot tarkemmin Teeman juurikansion tiedostoja (kuva), huomaat, että myös se sisältää style.css tiedoston. Kyseinen tiedosto sisältää kuitenkin vain käytettävän teeman tiedot vailla muotoilumäärittelyjä.

Asennetun teeman CSS-tiedosto/tiedostot on aina Assets-kansiossa.

Inc-kansio on paikka kaikille teeman PHP-toiminnoille, jotka on yhteydessä functions.php -tiedostoon. Toiminnot on tavallisesti ryhmitelty toimintansa ja tarkoituksensa mukaan eri tiedostoihin.

Tiedostot

404.php -tiedosto on virhesivu, joka aukeaa, kun jokin sivuston linkki ei toimi tai selaaja yrittää navigoida sivuston sivulle, jota ei ole olemassa.

archives.php on artikkelien sivun asetukset sisältävä tiedosto. Artikkelien sivu (arkisto) on sivu, jossa on listattuna kaikki sivuston artikkelit.

comments.php -tiedostoa käytetään artikkelien ja muiden sivusto-objektien kommentoinnin näyttämiseen sivustoilla.

footer.php sisältää alatunnisteeseen liittyviä koodeja.

functions.php on käytännössä sivuston aivot ja se sisältää sivuston kokoavaa PHP-koodia. Sivuston toiminnallisuuteen liittyvä peruskoodi on tässä tiedostossa. Se toimii myös siltana käytettävään MySQL-tietokantaan.

header.php sisältää sivujen ylätunnisteeseen liittyviä koodeja.

index.php toimii varsinaisena etusivuna, johon tuodaan tarvittava sisältö tietokannasta.

page.php sisältää yksittäisen sivun koodin. Muista, että sivu ja artikkeli ovat luonteeltaan erilaisia. Sivu on staattista, muuttumatonta, sisältöä ja artikkeleita tulee uusia ajoittain. page.php hoitaa yksittäiset sivut ja single.php yksittäisen artikkelin.

search.php on sivuston etsintäsivu. Sivu on käytännössä sivu, johon selaajan etsi-toiminnon käyttäminen johtaa.

searchform.php sisältää sivuston hakulomakkeen toiminnallisen koodin.

single.php on yksittäisen artikkelin koodin sisältävä tiedosto.

style.css on tyylitiedosto, johon on kirjoitettu teeman tiedot mutta se ei välttämättä sisällä ainuttakaan muotoilumäärittelyä. Varsinaiset muotoilut sijaitsevat sen sijaan Assets-kansiossa.

style-rtl.css on tarkoitettu muotoilutiedostoksi maailman kielille, joissa teksti kirjoitetaan oikealta vasemmalle (RTL=Right To Left). Jos sivusto on tarkoitus tarjota myös kyseisillä kielillä on tarpeen ottaa tämä CSS-muotoilutiedosto käyttöön.

Erään teeman tiedosto- ja kansiorakenne teeman kansiossa.
Erään teeman tiedosto- ja kansiorakenne teeman kansiossa.

Sivustojen tiedostot vaihtelevat

Kun vertaat omien sivujesi tiedostoja tämän sivun kuvan esimerkkiin, voit huomata, että sivustojen tiedostot saattavat erota toisistaan paljonkin. Olemme tässä keskittyneet vain olennaisimpiin perustiedostoihin, jotka löytyvät kaikilta WordPress-sivustolta.