Zobrazení zdroje stránky WebToDate/Referenční/Stránky a předlohy

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
== Postup při vytváření stránek ==
=== Pojem stránka ===

Obecné vysvětlení principu zakládání a vytváření stránek naleznete výše v&nbsp;kapitole [[../Jak pracuje WebToDate#Principy vytváření stránek|Principy vytváření stránek]]. Stránka systému WebToDate je vytvořena přiřazením zpráv či jiných typů objektů do určitých oblastí, rozmístěných v šabloně stránky. Šablona stránky definuje grafickou podobu stránky a umístění oblastí. Relace s databází zpráv určuje, které zprávy se na stránce objeví a ve které oblasti budou umístěny. Při generování stránky je pak vytvořena cílová webová stránka, která vznikne vložením kódu zpráv do odpovídajících částí kódu šablony. Šablonou stránky je jakákoliv jiná stránka, kterou při tomto způsobu použití nazýváme ''šablonou''.

Stránky se podle účelu použití dělí na ''stránky'' nebo ''předlohy''. Stránky jsou určeny pro zobrazení více zpráv v různých oblastech, předlohy slouží k zobrazení podrobností konkrétní zprávy nebo pro použití v modulech. Stránky bývají zpravidla používány pro úvodní stránky serveru a stránky důležitých rubrik, předlohy se zpravidla zobrazují po klepnutí na nadpis zprávy na určité stránce.

=== Postup při implementaci serveru ===

Jedním z&nbsp;hlavních cílů při implementaci WebToDate je vytvoření šablon pro stránky. Šablony slouží jako vzory pro různé typy stránek. Stránka, kterou vidí návštěvník webu, vzniká tak, že při založení takové stránky se specifikují šablona, tím jsou dány oblasti na stránce, které se prostředky WebToDate plní obsahem (hlavně zprávami, ale i seznamy či navigacemi), po vygenerování takové stránky vzniká finální podoba jak ji vidí návštěvník webu. Typů stránek je zpravidla několik, např. úvodní stránka, rubrika, zpráva, vyhledávací stránka atd.

Možný postup je takový, že se pro každý typ stránek vloží do databáze kompletní HTML kód šablony daného typu stránek, který obsahuje pouze několik oblastí pro obsah (tj. klíčových slov typu WTD_A). Z&nbsp;hlediska správy celého řešení je ovšem lepší a doporučený následující postup:

# Vytvoří se HTML kód stránky, který je společný pro všechny typy stránek. Zpravidla obsahuje základní grafické rozvržení používané všemi stránkami apod.
# Tento kód se vloží do databáze stránek jako stránka, která nemá žádnou šablonu – v&nbsp;termínech WebToDate se tomuto typu stránky říká ''primární šablona''.
# Založí se další stránky, které dále specifikují stránky daného typu – přidávají další HTML kódy do stránky, přidávají či mění oblasti apod. Pro tuto techniku se používá databáze fragmentů – do těla fragmentu se vloží přidávaný HTML kód a vloží se na stránku analogickým způsobem jako zpráva s&nbsp;formátováním takovým WebToDate stylem, který do stránky vkládá pouze tělo.
# Předchozí krok lze opakovat v&nbsp;několika úrovních vnoření stromu šablon. Z&nbsp;jedné primární šablony, se tedy vygeneruje několik odvozených šablon, z&nbsp;těchto šablon opět několik odvozených šablon a teprve tyto šablony se použijí jako šablony finálních stránek, které vidí návštěvníci webu.

Primární šablona nemusí být jen jedna, v&nbsp;dané implementaci může být požadováno, aby v&nbsp;zásadě existovalo několik typů diametrálně odlišných stránek, doporučujeme ale počet primárních šablon minimalizovat. Výhodou totiž je, že změna v&nbsp;určité úrovni stromu šablon se automaticky promítne do všech stránek, které jsou následníky dané stránky ve stromu šablon. Práce se stránkami WebToDate podporuje generování stránky včetně celého podstromu ve smyslu stromu šablon, takže změnu na jednom místě lze jednoduše hromadně promítnout do celého webu.

Celou tuto techniku můžeme ilustrovat na následujícím příkladu.

Jako primární šablonu vložíme následující HTML kód.

<code>
 <nowiki><html></nowiki>
 <nowiki><head></nowiki>
 <nowiki>	<!--WTD_A(head_stranky)--></nowiki>
 <nowiki>	<link rel=stylesheet HREF="/styly.css" TYPE="text/css"></nowiki>
 <nowiki></head></nowiki>
 <nowiki><body></nowiki>
 <nowiki><div id="header"><!--WTD_A(hlavicka_stranky)--></div></nowiki>
 <nowiki><div id="main1"><div id="main2"></nowiki>
 <nowiki><!--WTD_A(stred_stranky)--></nowiki>
 <nowiki></div></div></nowiki>
 <nowiki><div class="cleaner">&nbsp;</div></nowiki>
 <nowiki><div id="footer"><!--WTD_A(paticka_stranky)--></div></nowiki>
 <nowiki></body></nowiki>
 <nowiki></html></nowiki>
</code>

Tento kód specifikuje, že všechny stránky mají hlavičku, tělo a patičku, kromě toho zde ještě není specifikován obsah elementu ''<nowiki><head></nowiki>'' stránek. Pro hlavičku, tělo a patičku jsou vyhrazeny WebToDate oblasti (nazvané "hlavicka_stranky" atd.). Pro každé klíčové slovo typu WTD_A je třeba definovat oblast v&nbsp;databázi oblastí WebToDate, aby správa stránky byla funkční.

Dále si připravíme jeden WebToDate styl, který bude formátovat fragmenty vložené na stránky tak, že zde bude vkládat jen tělo fragmentu. Do těla tohoto stylu zapište pouze klíčové slovo reprezentující tělo:

<code>
 <nowiki><!--WTD_F(BODY)--></nowiki>
</code>

V&nbsp;druhém kroku připravíme šablonu, která bude specifičtější, doplní již do stránky nějaké texty a nadefinuje další oblasti na stránce. Založíme nejprve novou stránku, kde jako šablonu zvolíme primární šablonu založenou v&nbsp;předchozím případě. Přejdeme pro tuto novou stránku na záložku Aktuální stránka – k&nbsp;dispozici zde budou všechny čtyři oblasti definované v&nbsp;primární šabloně a lze je plnit obsahem.

Na oblast "hlavicka_stranky" vložíme fragment, který má v&nbsp;těle následující kód:

<code>
 <nowiki><div class="pruh1"></nowiki>
 <nowiki>WebToDate 4.0</nowiki>
 <nowiki></div></nowiki>
 <nowiki><div class="pruh2"></nowiki>
 <nowiki><!--WTD_A(hornipruh2)--></nowiki>
 <nowiki></div></nowiki>
</code>

Tím specifikujeme, že všechny stránky budou mít v&nbsp;hlavičce napsáno "WebToDate 4.0" a že pro další stránky odvozené od této stránky bude v&nbsp;hlavičce k&nbsp;dispozici oblast nazvaná "hornipruh2".

Na oblast "paticka_stranky" vložíme fragment, který má v&nbsp;těle následující kód:

<code>
 <nowiki><div class="paticka">Server je spravován pomocí systému WebToDate, &copy; 2005 Macron Software.</div></nowiki>
</code>

Tím specifikujeme, že patička stránek bude u všech stránek identická a bude obsahovat uvedený text.

Na oblast "stred_stranky" vložíme fragment, který má v&nbsp;těle následující kód:

<code>
 <nowiki><div id="left"></nowiki>
 <nowiki><!--WTD_A(leva_navigace)--></nowiki>
 <nowiki></div></nowiki>
 <nowiki><!--WTD_A(obsah)--></nowiki>
</code>

Tím specifikujeme, že všechny další stránky mají vlevo oblast pro navigaci, vpravo oblast pro vlastní obsah. Všechny oblasti uvedené ve fragmentech ("hornipruh2" apod.) musí mít opět svoji definici v&nbsp;databázi oblastí WebToDate. Stránku vygenerujeme, dostali jsme novou šablonu s&nbsp;následujícím kódem.

<code>
 <nowiki><html></nowiki>
 <nowiki><head></nowiki>
 <nowiki>	<!--WTD_A(head_stranky)--></nowiki>
 <nowiki>	<link rel=stylesheet HREF="/styly.css" TYPE="text/css"></nowiki>
 <nowiki></head></nowiki>
 <nowiki><body></nowiki>
 <nowiki><div id="header"></nowiki>
 <nowiki><div class="pruh1"></nowiki>
 <nowiki>WebToDate 4.0</nowiki>
 <nowiki></div></nowiki>
 <nowiki><div class="pruh2"></nowiki>
 <nowiki><!--WTD_A(hornipruh2)--></nowiki>
 <nowiki></div></nowiki>
 <nowiki></div></nowiki>
 <nowiki><div id="main1"><div id="main2"></nowiki>
 <nowiki><div id="left"></nowiki>
 <nowiki><!--WTD_A(leva_navigace)--></nowiki>
 <nowiki></div></nowiki>
 <nowiki><!--WTD_A(obsah)--></nowiki>
 <nowiki></div></div></nowiki>
 <nowiki><div class="cleaner">&nbsp;</div></nowiki>
 <nowiki><div id="footer"></nowiki>
 <nowiki><div class="paticka"></nowiki>
 <nowiki>Demo server WebToDate 4.0, &copy; 2005 Macron Software</nowiki>
 <nowiki></div></nowiki>
 <nowiki></div></nowiki>
 <nowiki></body></nowiki>
 <nowiki></html></nowiki>
</code>

Touto technikou jsme docílili následujícího:

* Vytvořili jsme novou šablonu, která nějakým způsobem rozšiřuje kód původní primární šablony
* Do stránky jsme již doplnili nějaké texty, které se budou objevovat na všech dalších stránkách
* Některé oblasti zůstaly v&nbsp;šabloně nevyplněné a tudíž přístupné pro další stránky odvozené od vytvořené šablony ("head_stranky")
* Jiné oblasti jsme předefinovali, namísto původní vznikly jiné oblasti, které mají specifičtější geometrii na stránce (vlevo oblast pro navigaci, vpravo pro obsah apod.)

V&nbsp;dalším kroku zakládáme stránky, které jako šablonu používají stránku v&nbsp;předchozím kroku. Mají tedy k&nbsp;dispozici všechny oblasti uvedené v&nbsp;předchozím HTML kódu. Nyní už můžeme vytvořit více typů stránek, např. tím že budeme blíže definovat různé podoby pravé části stránky (reprezentované zde oblastí "obsah") – jeden typ může obsahovat tuto část rozdělenou na dvou sloupce, jiný typ na spodní a horní část atd. Tyto šablony vytvořené ve třetím kroku už pak mohou sloužit jako šablony používané pro finální stránky.

Elementárním příkladem možné změny promítající se na všechny stránky je změna hlavičky. Změníme kód fragmentu z

<code>
 <nowiki><div class="pruh1"></nowiki>
 <nowiki>WebToDate 4.0</nowiki>
 <nowiki></div></nowiki>
 <nowiki><div class="pruh2"></nowiki>
 <nowiki><!--WTD_A(hornipruh2)--></nowiki>
 <nowiki></div></nowiki>
</code>

na

<code>
 <nowiki><div class="pruh1"></nowiki>
 <nowiki>Náš server běží na WebToDate 4.0</nowiki>
 <nowiki></div></nowiki>
 <nowiki><div class="pruh2"></nowiki>
 <nowiki><!--WTD_A(hornipruh2)--></nowiki>
 <nowiki></div></nowiki>
</code>

Vygenerujeme stránku vytvořenou v&nbsp;druhém kroku včetně podstromu, změna se projeví na všech stránkách serveru.

=== Postup při běžné správě obsahu serveru ===

Po prvotní implementaci je stav zpravidla takový, že jsou připraveny šablony používané pro finální stránky (typicky několik typů šablon), nadefinována základní struktura stromu kategorií a v&nbsp;této struktuře založeny přinejmenším jako vzor finální stránky.

Další stránky serveru určené pro návštěvníky webu si již mohou zakládat sami editoři jednotlivých týmů, potřebné dovednosti pro toto jsou v&nbsp;zásadě následující:

* Založení nové kategorie s&nbsp;vyplněním požadovaných vlastností (zda patří do navigace, lokalizované názvy apod.)
* Založení nové stránky v&nbsp;kategorii s&nbsp;výběrem správné šablony pro stránku
* Plnění oblastí na stránce daných zvolenou šablonou obsahem, tj. zejména zprávami.

== Dělení a řazení stránek ==
Stránky se řadí ve WebToDate následujícím způsobem:

* Ve stromu šablon – stránky se zde řadí stromově podle toho, která stránka je šablonou které stránky. Každá stránka může mít maximálně jednu šablonu.
* Ve stromu kategorií – každá stránka patří do právě jedné kategorie ve stromu kategorií
* V&nbsp;seznamu předloh – předlohy se neřadí do stromu kategorií, ale do kategorií předloh.

Každá stránka se vyskytuje vždy ve stromu šablon a buď ve stromu kategorií nebo v&nbsp;seznamu předloh.

=== Stránky ve stromu kategorií ===

Seznam stránek v&nbsp;dané kategorii se zobrazí tak, že se ve stromu kategorií vybere nějaká kategorie a vyvolá se funkce '''Stránky''' (buď z&nbsp;kontextové nabídky, nebo tlačítkem v&nbsp;horní části záložky '''Strom kategorií'''). Vypíše se seznam stránek podle následujícího otisku obrazovky.

[[Image:referencniprirucka-strankyapredlohy-img107.png|center]]

Ve výpisu je seznam stránek v&nbsp;dané kategorii, tučně je vyznačena výchozí stránka pro danou kategorii.

Význam sloupců ve výpisu je následující:

* Náhled – ikona s&nbsp;lupou otevírá v&nbsp;novém okně náhled stránky
* Aktuální podoba stránky – ikona otevírá v&nbsp;novém okně aktuální podobu stránky tak jak ji vidí návštěvníci webu
* Vlastnosti – ikona zobrazí v&nbsp;pravé spodní části stránky formulář pro úpravu vlastností stránky
* Název stránky – klepnutím na název stránky se tato stránka stane vybranou, tj. v&nbsp;pravé záložce '''Vybraná stránka''' se zobrazí oblasti této stránky a jejich obsah.

=== Stránky ve stromu šablon ===

'''Dělení stránek podle stromu šablon''' vychází z&nbsp;myšlenky, že šablony i stránky jsou v&nbsp;zásadě podobné objekty (soubor na disku a záznam o vlastnostech v&nbsp;databázi). Liší se pouze tím, zda daná stránka má či nemá, "předchůdce". V&nbsp;tomto pojetí je vždy v&nbsp;první úrovni nějaká ''primární šablona'', v&nbsp;další úrovni (nebo úrovních) jsou stránky vzniklé generováním tak, že se "předchůdci" přiřadí do daných oblastí nějaké zprávy a stránka se vygeneruje. V&nbsp;poslední úrovni pak jsou stránky použité buď jako výsledný produkt (tj. buď jako kompletní statická stránka nebo stránka, do které se dynamicky pomocí skriptu doplňuje nějaký seznam, apod.), nebo jako předloha použitá pro zobrazení většího počtu stránek s&nbsp;dynamicky vkládanými daty (zprávy, diskusní příspěvky,…). 

Strom šablon stránek zobrazíte pomocí příkazu '''Vzhled – Strom šablon''' v&nbsp;hlavní nabídce.

[[Image:referencniprirucka-strankyapredlohy-img108.png|center]]

Zobrazení stromu šablon funguje následujícím způsobem:

* Klepnutím na název stránky se v&nbsp;pravé spodní části otevírá formulář pro úpravu vlastností stránky
* Klepnutím na název stránky pravým tlačítkem myši vyvolává kontextovou nabídku, ze které lze vyvolat náhled stránky, generování stránky a přechod na úpravu obsahu stránky, kde pak lze dále měnit obsah oblastí, generovat včetně podstromu apod.

== Vytvoření nové stránky ==
Ve stromu kategorií vyberte nějakou kategorii, do které chcete vložit stránku a vyvolejte funkci '''Stránky'''. V&nbsp;pravé horní části okna se zobrazí seznam stránek, zde klepněte na odkaz '''Přidat''' v&nbsp;pravé horní části okna. Zobrazí se formulář dle následujícího otisku obrazovky.

[[Image:referencniprirucka-strankyapredlohy-img109.png|center]]

Postupujte následovně:

# Do pole '''Název''' zadejte název nové stránky (pod ním bude nová stránka v&nbsp;systému WebToDate vystupovat).
# '''Titulek stránky''' nahradí při generování stránky klíčové slovo <nowiki><!--WTD_F(PAGETITLE)--></nowiki>, obsažené v šabloně. Nejběžnější způsob použití je pomocí syntaxe <nowiki><title><!--WTD_F(PAGETITLE)--></title></nowiki>. Klíčové slovo pro titulek stránky se na rozdíl od jiných klíčových slov WebToDate nahrazuje obsahem pouze v&nbsp;případě, že příslušné databázové pole je neprázdné. Důvodem je zachovat toto klíčové slovo v&nbsp;rámci stromu stránek pro stránky, které toto klíčové slovo skutečně používají.
# Pole '''Zařazení''' zobrazuje umístění stránky ve stromu kategorií. Tlačítkem '''Změnit''' můžete vybrat jinou kategorii než tu, která byla nastavena.
# Ve volbě '''Jazyk''' vyberte jazykovou verzi stránky (zobrazuje se  jen, když je v&nbsp;systému definován víc než jeden jazyk). Při změně jazyka se automaticky mění obsah pole '''Fyzické URL''' (reflektuje cestu ke stránce danou názvy složek ve vlastnostech nadřazených kategorií)
# Jako '''Značkovací jazyk''' se standardně nechává HTML, ale je možné toto změnit. 
# Pomocí zaškrtávacího okénka '''Výchozí stránka''' můžete stránku označit jako výchozí pro danou kategorii. Pro kombinaci kategorie – jazyk může být definována maximálně jedna výchozí stránka, proto se může stát, že označení stránky jako výchozí znamená zrušení této volby pro jinou stránku ve stejné kategorii.
# Ve volbě '''Šablona''' vyberte stránku, která bude právě vytvářené stránce šablonou. Tuto stránku je možné zobrazit tlačítkem '''Zobrazit'''.
# Do pole '''Fyzické URL''' zadejte URL souboru, do kterého se bude stránka generovat ve statické podobě. URL musí začínat znakem / (např. ''/mojerubrika/default.htm''). Pole je předvyplněno automaticky podle složek v&nbsp;definici kategorií a podle nastavení v&nbsp;konfiguračním souboru ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate|global.php]]'' (viz kapitola [[../Strom kategorií#Možnosti konfigurace funkčnosti stromu kategorií|Možnosti konfigurace funkčnosti stromu kategorií]]).
# Pole '''Prezentační URL''' se vyplňuje automaticky dle konfigurace WebToDate. Zadejte vlastní URL jen v případě, že chcete URL stránky tak jak bude viditelná v prezentační části opravdu změnit a víte, že toto URL bude funkční (což je zpravidla ošetřeno v potřebné konfiguraci www serveru). V takovém případě je třeba navíc zaškrtnout '''automaticky neměnit''', aby ručně zadané prezentační URL nebylo automaticky přepsáno. Více viz [[#URL stránek|URL stránek]]
# V rozevírací nabídce '''Server''' zvolte, na kterém serveru má být nová stránka umístěna (ve většině případů ponecháte volbu '''--aktuální'''--). Tato funkce souvisí s&nbsp;možností provozovat  prostřednictvím jediného systému WebToDate Enterprise více virtuálních webů. Bližší popis naleznete v&nbsp;kapitole [[../Správa více virtuálních serverů|Správa více virtuálních serverů]].
# V&nbsp;položce '''Umístění''' naleznete přepínač umístění do veřejné či privátní zóny. Tato volba zde nemusí být vůbec nebo může mít různou výchozí hodnotu, vysvětlení fungování zón naleznete v&nbsp;kapitole [[../Strom kategorií#Veřejná a privátní zóna|Veřejná a privátní zóna]].
# Klepnutím na tlačítko '''Přidat''' uložíte novou stránku do databáze.

== Úprava vlastností stránky ==
Definici již vytvořené stránky lze upravovat pomocí stejného formuláře, který zobrazíte ikonou pro vlastnosti stránky v&nbsp;seznamu stránek v kategorii. Zobrazený formulář je podobný formuláři  '''Nová stránka''', obsahuje však navíc několik funkcí.

[[Image:referencniprirucka-strankyapredlohy-img110.png|center]]

Při změnách platí následující:

* Název stránky lze změnit kdykoliv, zobrazuje se jen v&nbsp;administračním rozhraní systému.
* Titulek stránky lze změnit, ve stránce se změní při prvním generování této stránky
* Fyzické URL stránky lze změnit na libovolné validní URL začínající lomítkem. Při změně URL dochází v&nbsp;případě, že stránka je již vygenerovaná, k&nbsp;fyzickému přesunu stránky do jiného adresáře odpovídajícího novému URL.
* Prezentační URL lze měnit na libovolné validní URL začínající lomítkem. Toto URL se ale zpravidla ponechává na automatickém sestavování WebToDate a je záhodno jej měnit jen když jsou k tomu závažné důvody. V tom případě je třeba zároveň zaškrtnou, že se obsah tohoto pole nemá měnit automaticky. Více k významu fyzických a prezentačních URL viz [[#URL stránek|URL stránek]].
* Stránku lze přeřadit do jiné kategorie, URL se tím nijak automaticky nemění.

<div class="note">
Poznámka: Ke změně prezentačního URL může dojít i automaticky mimo práci uživatele s tímto formulářem pro úpravu vlastností stránky. Jde zejména o případ, kdy se vkládají objekty na stránku nebo se odstraňují ze stránky. Pokud jsou např. doposud do stránky vloženy všechny objekty staticky a přidává se nový prvek vložený dynamicky, automaticky dojde ke změně prezentačního URL tak, aby stránka byla správně zobrazována včetně všech vložených objektů.
</div>

V&nbsp;záložce '''Obsah''' můžete zobrazit kompletní HTML kód upravované stránky.

[[Image:referencniprirucka-strankyapredlohy-img111.png|center]]

Obsah pole '''Obsah souboru''' lze upravovat jen v&nbsp;tom případě, že stránka je primární šablonou, tj. nemá žádného předchůdce ve stromu šablon. V&nbsp;tom případě se u popisku pole objeví i ikona pro editaci kódu v&nbsp;celostránkovém editoru. V&nbsp;opačném případě je obsah stránky spravován přes oblasti WebToDate a její kód již nelze přímo editovat.

V&nbsp;záložce '''Práva''' se nastavují explicitní práva k&nbsp;oblastem na dané stránce – bližší vysvětlení viz kapitola [[../Strom kategorií#Strom kategorií a přístupová práva|Strom kategorií a přístupová práva]].

Výhodná je možnost stránky '''Duplikovat'''. Duplikát stránky získá stejné vlastnosti jako původní stránka (ve stejném uzlu stromu kategorií apod.) včetně přístupových práv na oblasti.

Stránku lze '''smazat''' jen v&nbsp;případě, že neexistují další návaznosti, což znamená zejména:

* Neexistuje jiná stránka, která používá tuto stránku jako šablonu
* Na nějakou oblast na stránce nejsou přiřazeny nějaké objekty (zprávy apod.).

== Práce s&nbsp;předlohami ==
=== Vytváření předloh ===

Předlohy jsou zapojeny do stromu šablon identickým způsobem jako jiné typy stránek. Odlišnost spočívá v&nbsp;logickém řazení – předlohy se neřadí do stromu kategorií, ale mají svoje vlastní kategorie předloh. Důvodem je především to, aby bylo jednoduše možné nabízet seznam možných předloh ve formulářích, kde lze tyto předlohy vybírat (např. ve formuláři pro úpravu zprávy či zdroje apod.).

Nejprve v&nbsp;hlavní nabídce vyvolejte funkci '''Vzhled''' – '''Předlohy'''. Zobrazí se seznam kategorií předloh.

[[Image:referencniprirucka-strankyapredlohy-img112.png|center]]

Klepnutím na název kategorie předloh se zobrazí formulář pro úpravu názvu kategorie. Tento název je možné měnit pouze pro uživatelsky založené kategorie předloh, pro zabudované kategorie (které jsou instalovány s&nbsp;WebToDate nebo s&nbsp;dalšími moduly) toto možné měnit není.

Klepnutím na ikonu složky v&nbsp;prvním sloupci seznamu se zobrazí seznam předloh v&nbsp;dané kategorii, který má identický tvar jako seznam stránek v&nbsp;dané kategorii stromu kategorií. Zde můžete pomocí odkazu '''Přidat''' v&nbsp;pravé horní části okna přidat novou předlohu.

Formulář pro vlastnosti předlohy je téměř identický s&nbsp;vlastnostmi stránky ve stromu kategorií, rozdíly jsou následující:

* Chybí zaškrtávací okénko '''Výchozí stránka''' (pro předlohy nemá smysl)
* Místo výběru kategorie ze stromu kategorií je zde nabídka kategorií předloh.
* '''Prezentační URL''' pro předlohy nemá smysl a proto se nenabízí a nevyplňuje

=== Kód předlohy ===

Předlohy odporučujeme vytvářet pomocí stromu šablon stejným způsobem, který je popsán v&nbsp;kapitole [[../Stránky a předlohy#Postup při vytváření stránek|Postup při vytváření stránek]].

Jediné, čím se typicky liší předlohy z&nbsp;tohoto hlediska od jiných typů stránek, je toto:

* Navigace a většina seznamů se do oblastí vkládá dynamicky
* Kódy uložené v&nbsp;tělech fragmentů a řazené na oblasti v&nbsp;předloze vypadají poněkud jinak, obsahují již klíčová slova pro jednotlivé položky databáze zpráv, zdrojů apod.

Jednoduchý kód vkládaný v&nbsp;předloze pro zprávy v&nbsp;oblasti reprezentující vlastní obsah stránky, může vypadat např. následovně.

<code>
 <nowiki><h2><!--WTD_F(TITLE)--></h2></nowiki>
 <nowiki><div style="text-align:justify;"></nowiki>
 <nowiki><em><!--WTD_F(DESCRIPTION)--></em></nowiki>
 <nowiki><p><!--WTD_F(BODY)--></p></nowiki>
 <nowiki></div></nowiki>
 <nowiki><p>vydáno <!--WTD_F(DATE)--> <!--WTD_F(TIME)-->, autor: <!--WTD_F(SOURCE)--></p></nowiki>
</code>

Když se předloha, na které je umístěn fragment s&nbsp;tímto kódem vygeneruje, zobrazují se ve zprávách zobrazovaných pomocí této předlohy pole Nadpis, Popis, Tělo, Datum a čas a jméno autora.

{{Rychlé odkazy na klíčová slova}}

== URL stránek ==
Význam obsahu pole '''Fyzické URL''' ve formuláři pro vlastnosti stránky je takový, že na disku www serveru vzniká soubor na dané cestě. Jedná se o relativní cestu k výchozímu adresáři, kterým je adresář daný konfigurační konstantou WWWROOT v případě, že stránka je vložena do veřejné zóny, resp. konstantami OFFLINEDATA a PRIVATEPAGES v případě, že stránka je umístěna do privátní zóny. Kompletní cesta k souboru na disku www serveru je tedy spojením konstant WTDPATH + WWWROOT + zadané fyzické URL pro veřejnou zónu, resp. WTDPATH + OFFLINEDATA + PRIVATEPAGES + zadané fyzické URL pro privátní zónu.

<div class="note">
Poznámka: konstanta WWWROOT se aplikuje na výchozí virtuální server. Pokud se WebToDate používá pro správu více různých prezentací na různých virtuálních serverech, je toto nahrazeno adresářem daným v konfigurační tabulce virtuálních serverů.
</div>

Pokud se na stránce nenachází žádný seznam přiřazený dynamicky (resp. jiný objekt přiřazený dynamicky jako je zpráva či navigace) a stránka se nachází ve veřejné zóně, veřejně přístupné URL stránky (tj. '''Prezentační URL''') bude shodné s&nbsp;URL, které jste zadali v&nbsp;políčku '''Fyzické URL'''. Výjimkou je zde možnost odstranění názvu souboru z URL v případě, že se jedná o výchozí dokument (nastavuje se v konfiguraci www serveru). V takovém případě se např. jako fyzické URL zadá ''/aktuality/tiskove-zpravy/index.htm'', ale prezentační URL bude ''/aktuality/tiskove-zpravy/''. Takto WebToDate sestavuje prezentační URL v případě, že je toto nastaveno v konfiguračním souboru ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate|global.php]]''. V prvé řadě musí být konfigurační konstantou REMOVE_DEFAULT_DOCUMENTS_FROM_URL toto chování zapnuto a dále musí být v konstantě DEFAULT_DOCUMENTS uveden seznam názvů výchozích dokumentů.

Je-li do stránky vložen nějaký objekt dynamicky, prezentační URL stránky je pak ve tvaru

''/scripts/detail.php?pgid=ID_stránky''.

Pokud se navíc jedná o stránkovaný seznam, jsou další stránky v rámci stránkování ve tvaru

''/scripts/detail.php?pgid=ID_stránky&conn=ID_seznamu&pg=číslo_stránky_ve_stránkování''.

Tento tvar URL lze ale předefinovat na jiný tvar. Vlastní překlad URL pak musí být zajištěn na úrovni konfigurace www serveru (např. přes pravidla modulu ''[http://httpd.apache.org/docs/2.2/rewrite/ mod_rewrite]'' serveru [http://httpd.apache.org Apache]). Pravidlo pro sestavení prezentačního URL dynamických stránek se nastavuje v konfigurační konstantě SPAGEURL. Výsledkem pak může být např. to, že místo nativního URL

''/scripts/detail.php?pgid=271''

má stránka v prezentační části URL

''/zpravy/domaci/nejnovejsi-zpravy-pg271/''

a další stránka v rámci stránkování vloženého dynamického seznamu má místo URL

''/scripts/detail.php?pgid=271&conn=340&pg=2''

v prezentační části URL

''/zpravy/domaci/nejnovejsi-zpravy-pg271/340/2/''.

Podrobný návod pro konfiguraci WebToDate, jejímž cílem je generování tohoto typu prezentačních URL, je v kapitole [[../URL stránek#Způsoby změny URL stránek |Způsoby změny URL stránek]] a [[../Funkce Nastavení#Stránkování|Stránkování]].

WebToDate používá sestavené prezentační URL zejména v následujících funkcích:

* Sestavování [[../Navigace a transformace|navigačních elementů]] (resp. generování XML kódů se strukturou stromu kategorií)
* [[../Klíčová slova WebToDate#Vkládání odkazů na jiné jazykové verze zpráv či stránek|Klíčová slova pro jazykové verze stránek]]
* [[../Klíčová slova WebToDate#Další klíčová slova|Klíčové slovo pro URL aktuální stránky]]

Pokud při správě obsahu vkládáte do HTML kódu URL nějaké stránky ručně (např. hypertextový odkaz v těle nějakého fragmentu či zprávy), je vhodné vložit vygenerované prezentační URL stránky.

Prezentační URL se může změnit automaticky i po založení stránky - např. pokud je stránka doposud definována staticky a nově se vloží nějaký objekt dynamicky, WebToDate automaticky změní prezentační URL této stránky (pokud není toto URL označeno příznakem ''automaticky neměnit'').

== Vybraná stránka ==
V&nbsp;systému WebToDate je možné vytvořit libovolný počet stránek, pouze jedna z&nbsp;nich je však označena jako '''Vybraná'''. Vybranou stránkou je ta, se kterou uživatel právě pracuje – mění její obsah a přidává zprávy do jednotlivých oblastí. Stránku můžete vybrat jedním z&nbsp;následujících způsobů:

* Ve stromu kategorií vyvolejte funkci '''Stránky''' a klepněte na název stránky
* Ve stromu kategorií vyvolejte funkci '''Výchozí stránka'''.

Zobrazí se záložka s&nbsp;názvem vybrané stránky a přehledem oblastí na ní umístěných.

Klepnutím na jednotlivé oblasti se rozbalí přehled zpráv, fragmentů, seznamů a navigací v&nbsp;oblasti umístěných.

[[Image:referencniprirucka-strankyapredlohy-img113.png|center]]

V&nbsp;seznamu, který se zobrazí pod názvem oblasti, platí tato pravidla pro zobrazení zpráv a dalších objektů:

* Každý typ objektu je reprezentován jinou ikonou, která se navíc mění podle toho, zda je objekt na stránku přiřazen staticky nebo dynamicky.
* Pokud je název zprávy jinou barvou než černou, znamená to, že zpráva (nebo fragment) není ve stavu ''Publikováno'' nebo ''Archivováno''.
* Pomocí křížku za názvem zprávy či seznamu lze vyvolat funkci odstranění zprávy resp. jiného typu objektu ze stránky.
* Klepnutím na název zprávy či jiného typu objektu se zobrazí formulář pro úpravu.
* Klepnutím na název s&nbsp;podrženou klávesou '''Alt''' se zobrazí formulář pro úpravy parametrů přiřazení zprávy či jiného typu objektu na stránku.
* Klepnutím pravým tlačítkem myši se zobrazí místní nabídka s&nbsp;funkcemi, které lze na danou zprávu (resp. seznam) použít.

[[Image:referencniprirucka-strankyapredlohy-img114.png|center]]

Význam těchto položek v&nbsp;kontextové nabídce je následující:

* Umístění – otevírá formulář pro úpravy parametrů přiřazení zprávy či jiného typu objektu na stránku
* Upravit – zobrazí formulář pro úpravu dané položky
* Posunout výše - přesune objekt v rámci oblasti o jedno místo výše, interně se jedná o změnu priority umístění na stránce
* Posunout níže - podobně jako Posunout výše
* Odstranit – odstraňuje položku ze stránky.

Objekty zde lze přesunovat i metodou Táhni a pusť, a to v rámci jedné oblasti i mezi oblastmi. Přesun podobně jako posunování pomocí kontextové nabídky mění prioritu umístění položky v oblasti. Ce se týká stylů, v případě, že se přesun provádí v rámci jedné oblasti, styl se nemění, pokud se přesunuje z jedné oblasti do druhé, styl zůstává zachován v případě, že v cílové oblasti je zvolený styl povolen, nebo se nastaví na výchozí pro danou oblast v případě, že styl pod kterým je objekt vložen není v cílové oblasti povolen.

== Úprava a generování aktuální stránky ==
V&nbsp;okně jsou k dispozici následující tlačítka – '''Náhled''', '''Generovat''', '''Podstrom''' a '''VEdit'''.

Tlačítko '''Náhled''' předběžně zobrazí v novém okně konečný vzhled WWW stránky. Pomocí zaškrtávacího políčka '''Pouze publikované''' lze ovlivnit, zda se v&nbsp;náhledu zobrazí všechny zprávy umístěné na stránku nebo pouze ty, které jsou ve stavu ''Publikováno''.

Tlačítko '''Generovat''' vytvoří stránku jako dokument ve formátu HTML a umístí ji na adresu, která je uvedena v poli '''URL stránky'''.

Tlačítko '''Podstrom''' vygeneruje stránku společně se všemi jejími podstránkami (v rámci stromu šablon).

Tlačítko '''VEdit''' otevírá vizuální režim pro správu obsahu stránky. Této funkci je věnována samostatná kapitola [[../Vizuální nástroje|Vizuální nástroje]].

== Generování všech stránek s výskytem zvolené zprávy ==
Pokud v databázi zpráv došlo k aktualizaci nějaké zprávy (např. nadpisu zprávy) a je třeba přegenerovat všechny stránky, na kterých se daná zpráva vyskytuje, nejjednodušší postup je následující:

# Ve formuláři pro úpravu zprávy zobrazte záložku [[../Zprávy#Vlastnosti|Vlastnosti]]. Zde se nachází tlačítko '''Umístěno'''.
# Tlačítko '''Umístěno''' zobrazí seznam všech stránek, na které je zpráva ručně vložena. Pod tímto seznamem se nachází tlačítko '''Přegenerovat stránky'''.
# Funkce '''Přegenerovat stránky''' přegeneruje všechny stránky uvedené v tomto dialogu, ale i všechny stránky, na které je zpráva vygenerována pomocí nějakého seznamu (kromě SQL seznamů) a to včetně odvozených stránek v rámci stromu šablon. Změna ve zprávě se tak promítne do celé webové prezentace.

[[Image:referencniprirucka-zpravy-umisteno.png|center]]

== Doporučení pro řazení objektů na oblasti na stránkách ==
Pokud zpracováváte stránky rubrikového typu, vkládejte všechny objekty na stránku staticky, pakliže není dobrý důvod pro opačnou volbu. Celá stránka se pak vygeneruje jako statická a je nejrychlejším možným způsobem přístupná pro návštěvníky webu.

Jeden dobrý důvod pro vložení objektu dynamicky na takovýto typ stránky existuje – jde o stránkované seznamy. Chcete-li použít stránkovaný výpis zpráv pomocí funkce [[../Seznamy|Seznamy]], přiřaďte definici seznamu na stránky dynamicky, jinak stránkování nebude možné.

Při zpracování předlohy naopak vložte na stránku dynamicky následující typy objektů:

* [[../Seznamy#Seznam typu propojení se zprávou|Seznamy typu Propojení]] – tím zajistíte, že výpisy souvisejících zpráv se budou zobrazovat v&nbsp;závislosti na aktuálně zobrazované zprávě
* [[../Seznamy#Seznamy příloh|Seznamy typu Seznam příloh]] – ze stejného důvodu jako v&nbsp;předchozím případě
* [[../Navigace a transformace|Navigace]] – jedině tak se zajistí, že navigační nabídky se budou kontextově měnit podle toho, jaká zpráva se zobrazuje.

== Proč se zpráva či seznam nezobrazují na stránce? ==
Pokud máte na nějaké oblasti na stránce přiřazen nějaký objekt (zprávu, seznam, navigaci) a tento objekt se nezobrazuje v&nbsp;náhledu nebo v&nbsp;generované stránce, může jít o jednu z&nbsp;následujících možností:

* Zpráva není ve stavu ''Publikováno'' či ''Archivováno''. V&nbsp;režimu náhledu lze před vyvoláním náhledu odškrtnout možnost Pouze publikované a zpráva se v&nbsp;náhledu zobrazí, při generování stránky žádná taková možnost neexistuje a nepublikované zprávy se ignorují.
* Styl zvolený pro objekt není správně nadefinován. Teoreticky lze vytvořit např. styl, který neobsahuje v&nbsp;těle žádná klíčová slova pro položky databáze zpráv, pak se nic nezobrazí. Nemusí jít ani o tak extrémní případ, stačí nevhodně zvolit korektně definovaný styl, který je určený pro formátování jiného typu objektu (např. seznamu položek v&nbsp;nějakém modulu WebToDate).
* Byl předkročen maximální počet položek v&nbsp;definici oblasti. V&nbsp;definici každé oblasti je maximální počet zpráv na oblasti, více zpráv lze vložit, ale nikoliv vygenerovat.
* Objekt byl vložen na stránku dynamicky. Dynamicky vložené objekty se nezobrazují v&nbsp;náhledu stránky (neplést s&nbsp;náhledem zprávy, tam se zobrazuje vše) ani při přímém pohledu na staticky generovaný soubor. Stránka informující o výsledcích generování by vám v&nbsp;takovém případě měla nabídnout korektní URL zobrazující celou stránku včetně dynamicky vložených objektů (ve tvaru ''/scripts/detail.php?pgid=xxx'').