Struktura šablony
V souborech je třeba mít pořádek, a proto se snažíme dodržovat jednotnou adresářovou strukturu. Myšlenka je jednoduchá: stejné typy souborů vždy zařadit do vlastního adresáře a udržovat je tak na jednom snadno dostupném místě… Nicméně nic se nemá přehánět, a tak obecné soubory jako je index.php, functions.php, style.css atd. není třeba adresářově strukturovat a naopak je vhodné nechat je na základní úrovni šablony.
Obecná struktura šablony
V hlavním adresáři šablony by tedy struktura mohla vypadat nějak následovně:
- images (obrázky pro layout šablony)
- contents (soubory s částmi kódu pro použití ve WP Loops – pro single části s jednou iterací)
- loops (soubory s částí kódu pro použití ve WP Loops)
- pages (soubory pro stránky – Templates)
- partials (části, resp. komponenty šablony)
- sidebars
- singles (soubory pro detaily post_type)
- formats (soubory pro příslušný format post_type)
- taxonomies (soubory pro výpis taxonomy)
- categories (soubory pro výpis kategorií)
- archives (soubory pro zobrazení archivů)
- kt (= projekt, viz Rozložení projektu)
- index.php
- functions.php
- style.css
Přičemž není třeba definovat všechny tyto adresáře, ale pouze ty, které jsou zrovna skutečně potřeba. Framework s tímto rozložením adresářů a souborů počítá a umí ho dále zpracovávat.
Pozn.: nepřehlédněte nastavené standardy kódování, především obecné tipy k pojmenovávání adresářů i souborů…
Nazývání souborů
Zde obecně platí, že jednotlivé soubory šablony začínají prefixem, který určuje o jaký typ souboru jde, takže např. pro jednotlivé různé stránky (rozuměj page templaty) budou začínat jejich soubory vždy „page-“ atd., viz:
- content-{post_type}-{location}.php
- loop-{post_type}-{location}.php
- page-{template_name}.php
- sidebar-{type/location}.php
- single-{post_type}.php
- format-{post_format}.php
- archive-{post_type}.php