Blogg

De viktigste WordPress-filene

Skal du gjøre egne tilpasninger av et WordPress-nettsted, må du kjenne til noen av filene. Her får du en oversikt over de viktigste, hva de gjør, og hvor du bør gjøre endringer.

Hovedregelen er enkel: Ikke endre WordPress-kjernen. Filene i wp-admin og wp-includes overskrives ved hver oppdatering, og endringer der forsvinner. Tilpasninger gjør du i temaet, helst i et barnetema, eller i en egen utvidelse. Det finnes ett viktig unntak.

wp-config.php: konfigurasjonen

wp-config.php ligger i rotmappen til WordPress og inneholder blant annet tilkoblingen til databasen, der alt innhold og alle innstillinger lagres. Fila opprettes vanligvis under installasjonen, og mangler den, fungerer ikke nettstedet. wp-config-sample.php viser hvordan den skal se ut.

Normalt trenger du ikke endre den, men den brukes blant annet når nettstedet flyttes, når du skal slå på feilsøking med WP_DEBUG, eller når minnegrensen må økes. Fila inneholder passord og sikkerhetsnøkler, så den må aldri deles eller ligge åpent tilgjengelig. Les mer i den offisielle dokumentasjonen.

Temafilene

Temaet ligger i wp-content/themes, og det er her det meste av tilpasningen skjer. Skal du endre et tema du ikke har laget selv, bør du bruke et barnetema, ellers mister du endringene ved neste oppdatering av temaet. Se guiden om WordPress-temaer og barnetema.

Filene under gjelder klassiske tema. I blokktema er malene HTML-filer i mappen templates, og header og footer ligger i parts. style.css og functions.php finnes i begge typer.

style.css

style.css er obligatorisk i alle tema. Øverst i fila står en kommentar med temaets navn og versjon, som WordPress bruker for å vise temaet under Utseende → Temaer. Resten av fila er CSS som styrer utseendet, for eksempel:

body {
    background-color: #ffffff;
    color: #222e34;
}

Hold stil i CSS-filene, ikke som inline-stil i PHP- eller HTML-koden. Det gir kode som er lettere å vedlikeholde.

index.php

index.php er den andre obligatoriske fila i et klassisk tema. WordPress har et fast malhierarki for hvilken fil som brukes til å vise en side, et innlegg eller et arkiv, og index.php er siste reserve når ingen annen mal passer. Mer om dette i guiden om sidemaler i WordPress.

functions.php

functions.php kjøres hver gang temaet er aktivt, og brukes til å legge til, endre eller fjerne funksjonalitet. I større tema brukes den ofte til å laste inn andre PHP-filer, slik at koden blir oversiktlig:

require get_theme_file_path( 'inc/meny.php' );

Den brukes også til å laste inn stilark og script på riktig måte, i stedet for å legge dem rett i headeren:

add_action( 'wp_enqueue_scripts', function () {
    // Temaets stilark
    wp_enqueue_style( 'mitt-tema', get_stylesheet_uri() );
    // Et script fra mappen js i temaet
    wp_enqueue_script( 'mitt-tema-script', get_theme_file_uri( 'js/eksempel.js' ), array(), '1.0', true );
} );

Kode som skal fungere uansett hvilket tema som er aktivt, hører heller hjemme i en egen utvidelse (plugin).

header.php

header.php inneholder koden som er lik øverst på alle sider: starten av HTML-dokumentet, head-delen og ofte logo og meny. Den må kalle wp_head() før </head>. Uten den lastes ikke stilark og script, og mange utvidelser slutter å virke. Rett etter <body> bør den kalle wp_body_open(), og body_class() i body-taggen gir nyttige CSS-klasser for hver type side.

footer.php

footer.php inneholder koden som er lik nederst på alle sider, for eksempel kontaktinformasjon og bunnmeny. Den må kalle wp_footer() før </body>, ellers vil mange script og utvidelser ikke fungere. Malene henter den inn med get_footer().

sidebar.php

sidebar.php viser en eventuell sidekolonne, ofte med widgets. Mange moderne tema bruker ikke sidekolonne i det hele tatt.

Trenger du hjelp?

En WordPress-installasjon inneholder mange flere filer, men dette er de viktigste å kjenne til hvis du skal tilpasse et tema. Trenger du hjelp med tilpasninger eller feilsøking, se WordPress-hjelp og support, eller ta kontakt.