WordPress.org (Čeština)

Šablony stránek jsou specifickým typem souboru šablon, který lze použít na konkrétní stránku nebo skupiny stránek.

Jelikož je šablona stránky specifickým typem souboru šablony, je zde několik charakteristických rysů šablon stránek:

• Šablony stránek se používají ke změně vzhledu a vzhledu stránky.
• Šablonu stránky lze použít na jednu stránku, část stránky nebo třídu stránek .
• Šablony stránek mají obecně vysokou úroveň přesnosti a jsou cílené na jednotlivou stránku nebo skupinu stránek. Například šablona stránky s názvem page-about.php je konkrétnější než soubory šablony page.php nebo index.php protože to ovlivní pouze stránku se slimákem „about“.
• Pokud má šablona stránky název šablony, uživatelé WordPress, kteří stránku upravují, mají kontrolu nad tím, jaká šablona bude použita k vykreslení stránky.

Používá se pro šablony stránek # Používá se pro šablony stránek

Šablony stránek zobrazují dynamický obsah vašeho webu na stránce, např. příspěvky, aktualizace zpráv, události kalendáře, mediální soubory atd. Můžete se rozhodnout, že chcete, aby vaše domovská stránka vypadala konkrétním způsobem, který je zcela odlišný od ostatních částí vašeho webu. Nebo můžete chtít zobrazit vybraný obrázek, který odkazuje na příspěvek v jedné části stránky, mít seznam nejnovějších příspěvků kdekoli jinde a používat vlastní navigaci. K dosažení těchto cílů můžete použít šablony stránek.

V této části se dozvíte, jak vytvořit šablony stránek, které mohou uživatelé vybírat prostřednictvím svých obrazovky správce.

Můžete například vytvořit šablony stránek pro:

• plnou šířku, jeden sloupec
• dva sloupce s postranním panelem vpravo
• dva sloupce s postranním panelem vlevo
• tři sloupce

nahoru

šablony stránek v rámci hierarchie šablon #Page Templates in the Template Hierarchy

Když osoba prochází váš web, WordPress vybere, kterou šablonu použije pro vykreslení této stránky. Jak jsme se dříve dozvěděli v hierarchii šablon, WordPress hledá soubory šablon v následujícím pořadí:

1. Šablona stránky – Pokud má stránka přiřazenou vlastní šablonu, WordPress vyhledá tento soubor a pokud je nalezen , používá ji.
2. page-{slug}.php – Pokud nebyla přiřazena žádná vlastní šablona, WordPress vyhledá a použije specializovanou šablonu, která obsahuje popis stránky.
3. page-{id}.php – Pokud specializovaná šablona obsahující slug stránky není nalezena, WordPress vyhledá a použije specializovanou šablonu s ID stránky.
4. page.php – Pokud není nalezena specializovaná šablona, která obsahuje ID stránky, WordPress hledá a použije výchozí šablonu stránky motivu.
5. singular.php – Pokud page.php nebyl nalezen, WordPress vyhledá a použije šablonu motivu použitou pro jeden příspěvek, bez ohledu na typ příspěvku.
6. index.php – Pokud není konkrétní šablony stránek jsou přiřazeny nebo nalezeny, WordPress standardně používá k vykreslení stránek indexový soubor motivu.

Nahoru

Šablony stránek Účel & Uživatelské ovládání # Šablony stránek Účel & Uživatelské ovládání

Pokud plánujete vytvořit vlastní šablonu stránky pro své téma, měli byste se rozhodnout pár věcí před pokračováním:

• Zda bude šablona stránky pro jednu konkrétní stránku nebo pro jakoukoli stránku; a
• Jaký typ uživatelského ovládacího prvku chcete mít pro šablonu k dispozici.

Každou šablonu stránky, která má název šablony, může uživatel při vytváření nebo úpravách vybrat stránka. Seznam dostupných šablon naleznete na stránce > Přidat nové > Atributy > Šablona . Uživatel WordPressu si tedy může vybrat libovolnou šablonu stránky s názvem šablony, což nemusí být vaším záměrem.

Pokud například chcete mít konkrétní šablonu pro svou stránku „O aplikaci“, nemusí vhodné pojmenovat tuto šablonu stránky „O šabloně“, protože by byla globálně dostupná pro všechny stránky (tj. uživatel ji mohl použít na libovolnou stránku). Místo toho vytvořte šablonu na jedno použití a WordPress vykreslí stránku s příslušnou šablonou, kdykoli uživatel navštíví stránku „O aplikaci“.

Naopak mnoho motivů obsahuje možnost zvolit, kolik sloupců stránka bude mít. Každá z těchto možností je šablona stránky, která je k dispozici globálně.Chcete-li uživatelům WordPress poskytnout tuto globální možnost, budete muset pro každou možnost vytvořit šablony stránek a každé z nich pojmenovat.

Diktování, zda je šablona pro globální použití vs. jednotné použití, je dosaženo mimochodem název souboru a to, zda má či nemá konkrétní komentář.

Nahoru

Organizace souborů šablon stránek # Organizace souborů šablon stránek

Jak je popsáno v části Uspořádání souborů motivů, WordPress rozpozná šablony podsložek stránek. Proto je vhodné ukládat vaše globální šablony stránek do této složky, abyste je udrželi uspořádané.

Nahoru

Vytváření vlastních šablon stránek pro globální použití #Creating Custom Page Templates pro globální použití

Někdy budete chtít šablonu, kterou může globálně použít jakákoli stránka nebo více stránek. Někteří vývojáři seskupí své šablony s předponou názvu souboru, například page_two-columns.php

Informace o konvencích pojmenování souborů motivů a názvech souborů, které nemůžete použít, najdete v vyhrazených názvech souborů motivů.

Chcete-li vytvořit globální šablonu, napište úvodní komentář PHP v horní části soubor, který uvádí název šablony.

<?php /* Template Name: Example Template */ ?>

Je to dobrý nápad vyberte název, který popisuje, co šablona dělá, protože název je viditelný pro uživatele WordPressu při úpravách stránky. Například můžete pojmenovat svou šablonu Domovská stránka, Blog nebo Portfolio.

Tento příklad z motivu TwentyFourteen vytvoří šablonu stránky s názvem Stránka s plnou šířkou:

<?php/*** Template Name: Full Width Page** @package WordPress* @subpackage Twenty_Fourteen* @since Twenty Fourteen 1.0*/

Jakmile nahrajete soubor do složky vašeho motivu (např. page- šablony), přejděte na stránku > Upravit obrazovku na hlavním panelu administrátora.

On the right hand side under attributes you"ll see template. This is where users are able to access your global page templates.

Tip: The select list has a maximum width of 250px, so longer names may be cut off.

Nahoru

Vytvoření vlastní šablony stránky pro jednu konkrétní stránku # Vytvoření vlastní šablony stránky pro jednu konkrétní stránku

Jak je uvedeno na stránce Hierarchie šablon, můžete vytvořit šablonu pro konkrétní stránku. Chcete-li vytvořit šablonu pro jednu konkrétní stránku, zkopírujte svůj stávající page.php soubor a přejmenujte jej pomocí slimáku nebo ID vaší stránky:

1. page-{slug}.php
2. page-{ID}.php

Například: Vaše stránka About má štítek„ about “ a ID 6. Pokud má složka vašeho aktivního motivu soubor s názvem page-about.php nebo page-6.php, WordPress tento soubor automaticky vyhledá a použije k vykreslení stránky About.

Chcete-li použít, speciální šablony stránek musí být ve složce vašeho motivu (tj. / wp-content / themes / my-theme-name /).

Na začátek

Vytváření šablon stránek pro konkrétní typy příspěvků # Vytváření šablon stránek pro konkrétní typy příspěvků

Ve výchozím nastavení bude pro typ příspěvku „stránka“ k dispozici vlastní šablona stránky.

Chcete-li vytvořit šablonu stránky pro konkrétní typy příspěvků, přidejte pod název šablony řádek s typy příspěvků, které má šablona podporovat.

Příklad:

<?php/*Template Name: Full-width layoutTemplate Post Type: post, page, event*/// Page code here...

Pokud pro typ příspěvku existuje alespoň jedna šablona, zobrazí se v zadní části meta pole „Post Attributes“, bez nutnosti přidávat podporu typu příspěvku pro „page-attributes“ nebo cokoli jiného. Štítek „Atributy příspěvku“ lze přizpůsobit podle typu příspěvku pomocí štítku „atributy“ při registraci typu příspěvku.

Zpětná kompatibilita:

Řekněme, že chcete veřejné téma zveřejnit s podporou šablon typu příspěvku. Verze WordPress před 4.7 budou ignorovat záhlaví Typ příspěvku šablony a zobrazí šablonu v seznamu šablon stránek, i když to funguje pouze pro běžné příspěvky.Chcete-li tomu zabránit, můžete se připojit k filtru theme_page_templates a vyloučit jej ze seznamu. Zde je příklad:

Rozbalit celý zdrojový kódSbalit celý zdrojový kód

Tímto způsobem můžete podporovat vlastní příspěvek zadejte šablony ve WordPressu 4.7 a novějších při zachování plné zpětné kompatibility.

Upozorňujeme, že motiv_page_templates je ve skutečnosti dynamický filtr motivu _ {$ post_type} _templates. Dynamická část názvu zavěšení, $ post_type, odkazuje na typ příspěvku podporovaný šablonami. Např. můžete se připojit k topic_product_templates a filtrovat seznam šablon pro typ příspěvku produktu.

Nahoru

Použití podmíněných značek v šablonách stránek # Použití podmíněných značek v šablonách stránek

S podmíněnými značkami v souboru page.php motivu můžete provádět menší změny specifické pro stránku. Například níže uvedený ukázkový kód načte soubor header-home.php pro vaši přední stránku, ale načte jiný soubor (header-about.php) pro vaši stránku About, a poté použije výchozí header.php pro všechny ostatní stránky.

if ( is_front_page() ) :get_header( "home" );elseif ( is_page( "About" ) ) :get_header( "about" );else:get_header();endif;

Další informace o podmíněných značkách najdete zde.

Nahoru

Identifikace šablony stránky #Identifikace šablony stránky

Pokud vaše šablona používá funkci body_class(), WordPress vytiskne třídy ve značce body pro název třídy typu příspěvku (page), ID stránky (page-id-{ID}) a použitá šablona stránky. Pro výchozí page.php je generovaný název třídy page-template-default:

<body class="page page-id-6 page-template-default">

Při použití vlastní šablony stránky bude třída page-template tisk spolu s třídou pojmenující konkrétní šablonu. Pokud je například váš soubor šablony vlastní stránky pojmenován takto:

<?php/* Template Name: My Custom Page */?gt;

Poté bude vykreslený generovaný kód HTML vypadat takto:

<body class="page page-id-6 page-template page-template-my-custom-page-php">

Všimněte si page-template-my-custom-page-php třída, která se použije na značku body.

Horní

Funkce šablony stránky #Page Template Functions

Tyto vestavěné funkce a metody WordPress vám mohou pomoci pracovat se šablonami stránek:

• get_page_template() vrátí cesta šablony stránky použité k vykreslení stránky.
• wp_get_theme()->get_page_templates() vrátí všechny vlastní šablony stránek dostupné pro aktuálně aktivní téma (get_page_templates() je metoda třídy WP_Theme).
• is_page_template() vrací true nebo false v závislosti na zda byla k vykreslení stránky použita vlastní šablona stránky.
• get_page_template_slug() r vrátí hodnotu vlastního pole _wp_page_template (null když je hodnota prázdná nebo „výchozí“). Pokud byla stránce přiřazena vlastní Šablona, název souboru této šablony se uloží jako hodnota vlastního pole s názvem "_wp_page_template" (v tabulce databáze wp_postmeta). (Vlastní pole začínající podtržítkem se v modulu vlastních polí úpravy obrazovky nezobrazí.)