V minulém díle jsme si představili základní strukturu a silné stránky WordPressu. Dnes na to navážeme a ukážeme si základní soubory, které musí šablona obsahovat.
Jaké soubory musí šablona obsahovat?
WordPress je při rozpoznávání šablon velmi benevolentní – technicky stačí pouhé dva soubory, aby šablonu uznal jako platnou. V praxi ale každá funkční šablona obsahuje více souborů. Pojďme si projít ty nejdůležitější.
Povinné soubory
style.css je jediný skutečně povinný soubor. Nejen že obsahuje CSS styly vaší šablony, ale hlavně musí obsahovat tzv. file header – blok komentářů na začátku souboru, podle kterého WordPress šablonu identifikuje:
/*
Theme Name: Moje šablona
Theme URI: https://example.com
Author: Vaše jméno
Author URI: https://example.com
Description: Popis mé vlastní šablony
Version: 1.0.0
License: GNU General Public License v2 or later
Text Domain: moje-sablona
*/
Z těchto informací WordPress sestaví popis šablony v administraci. Bez tohoto hlavičkového komentáře šablonu vůbec nerozpozná.
index.php je záložní šablona pro všechny typy obsahu. Pokud WordPress nenajde specifičtější šablonový soubor (například pro výpis kategorie nebo detail článku), sáhne právě po index.php. Bez tohoto souboru šablona sice existuje, ale web nebude zobrazovat obsah správně.
Doporučené soubory
I když technicky nejsou nutné, bez následujících souborů se v praxi neobejdete.
functions.php je srdce vaší šablony. Funguje jako plugin specifický pro dané téma – registrují se zde navigační menu, widget areas, podporované funkce WordPressu (miniatury článků, vlastní logo apod.) a načítají se CSS a JS soubory. Je to místo, kde šablona „mluví“ s WordPressem.
header.php obsahuje kód společné hlavičky stránky – typicky DOCTYPE, <head> s meta tagy, načtení stylů a úvodní <header> s logem a navigací. Vkládá se do ostatních šablon pomocí funkce get_header().
footer.php je pendant k předchozímu – obsahuje závěrečnou část stránky, patičku a uzavírací HTML tagy. Vkládá se funkcí get_footer().
sidebar.php obstarává postranní panel (sidebar) a načítá se přes get_sidebar(). V moderních šablonách se používá méně, ale stále má své místo.
single.php zobrazuje detail jednoho článku (post).
page.php zobrazuje statickou stránku.
archive.php obstarává výpisy – archiv kategorií, tagů, autorů nebo dat.
404.php se zobrazí při zadání neexistující URL.
Minimální struktura pro start
Pro začátek naší série budeme pracovat s touto strukturou:
wp-content/themes/moje-sablona/
├── style.css # Povinný – identifikace + styly
├── index.php # Povinný – záložní šablona
├── functions.php # Registrace funkcí a enqueue skriptů
├── header.php # Hlavička stránky
├── footer.php # Patička stránky
├── single.php # Detail článku
├── page.php # Statická stránka
└── archive.php # Výpisy článků
Tato struktura je dostatečný základ, ze kterého budeme v dalších dílech vycházet a postupně ji rozšiřovat.
Co nás čeká dál?
V příštím díle si vytvoříme skutečný základ šablony – napíšeme style.css s hlavičkovým komentářem, připravíme functions.php se základní registrací funkcí a dáme dohromady header.php a footer.php tak, aby šablona poprvé zobrazila funkční stránku v prohlížeči.


