WebToDate - Příspěvky [cs]

Soubor:Kalendar-uprava-predpisu.jpg

2020-11-24T12:34:54Z

Jakubn: Jakubn načtena nová verze "Soubor:Kalendar-uprava-predpisu.jpg"

[[Category:WebToDate Kalendář akcí]]
Kalendář akcí - úprava názvu předpisu

Soubor:2020-11-23-155235 1437x402 scrot.png

2020-11-24T10:33:35Z

Jakubn:

WebToDate/Referenční/Strom kategorií

2020-05-04T07:29:57Z

Jakubn: /* K čemu SE používá strom kategorií */

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
== K čemu se používá strom kategorií ==
Strom kategorií je základní řídící struktura, která dělí celou webovou prezentaci na jednotlivé sekce a podsekce z hlediska obsahu i přístupových práv. Struktura stromu kategorií a vlastnosti jednotlivých kategorií ovlivňují následující funkce a chování webové prezentace:

* Strukturu ukládání souborů do složek na serveru – pokud např. generujeme stránku nebo ukládáme soubor do databáze zdrojů, výchozí cesta k souboru je daná složkami definovanými ve vlastnostech kategorií.
* Přístupová práva – každý uzel stromu kategorií je ve vlastnictví jednoho týmu, což má vliv na možnosti zakládat vnořené kategorie, ukládat do kategorie zprávy či zdroje apod.
* Automaticky generované navigační nabídky – od stromu kategorií se odvozuje struktura automaticky generovaných navigací, přičemž lze ovlivnit URL stránky, na kterou kategorie ukazuje, to, zda se vůbec daná kategorie do navigací zahrnuje apod.
* Zařazení do stromu kategorií je významná metainformace, se kterou lze dále pracovat jak v administračním rozhraní WebToDate, tak při generování veřejně přístupné prezentace. V redakčním rozhraní lze podle kategorií vyhledávat a filtrovat, v prezentační části lze např. vytvářet seznamy zpráv, které vypisují zprávy dané kategorie (případně v kombinaci s mnoha dalšími kritérii týkajícími se metadat).

== Vlastnosti uzlů stromu ==
Na následujícím obrázku je formulář pro nastavení vlastností kategorie. Formulář je rozdělen na horní část, která obsahuje pole nezávislá na jazyku a spodní část, která obsahuje vlastnosti závislé na konkrétním jazyce.

[[Image:referencniprirucka-stromkategorii-img012.png|center]]

Každá kategorie má následující vlastnosti nezávislé na jazyku:

* '''Systémový název''' – název kategorie tak, jak se zobrazuje v administračním rozhraní
* '''Nadřazená kategorie''' – kategorie, která je ve stromu kategorií přímo nadřazená dané kategorii (musí být právě jedna s výjimkou kategorií, které jsou v nejvyšší úrovni, tyto kategorie žádnou nadřazenou kategorii nemají)
* '''Tým''' – tým uživatelů, který vlastní danou kategorii
* '''Fulltextově prohledávat''' – jedná se o informaci pro modul Fulltext, tímto příznakem se vyznačuje, zda jsou zprávy v dané kategorii pro vyhledávací modul viditelné či nikoliv. Zprávy mohou být umístěny ve více kategoriích, v takovém případě je jedna kategorie označena jako ''výchozí''. V takovém případě o tom, zda je zpráva pro vyhledávání viditelná, rozhoduje právě výchozí kategorie.
* '''Vkládat data''' – příznak udává, zda lze do této kategorie vkládat data jako zprávy či zdroje
* '''Priorita''' – lze volitelně zadat celé číslo, které ovlivňuje pořadí kategorie ve výpisech. Např. při generování navigační nabídky se kategorie umístěné ve stejném uzlu řadí primárně podle této priority, sekundárně podle pořadí, v jakém byly vytvořeny.
* '''Vlastní pole – text''' – textové pole, do kterého lze zadat jakýkoliv text
* '''Vlastní pole - číslo''' – pole, do kterého lze zadat jakékoliv číslo

Pořadí podkategorií zvolené kategorie lze kromě ruční změny priority měnit i nástrojem, který se zobrazí pomocí tlačítka '''Pořadí podkategorií'''. Tato stránka zobrazí seznam podkategorií zvolené kategorie, kde lze metodou Táhni a pusť měnit jejich pořadí, po změně je třeba tlačítkem '''Uložit změny''' provedené změny uložit. Interně se jedná o automatické přečíslování priorit kategorií.

[[Image:referencniprirucka-stromkategorii-poradi.png|center]]

Dále následují vlastnosti kategorie, které jsou na jazyku závislé. Na následujícím otisku obrazovky je vidět, jak se formulář mění v případě, že je v systému definován více než jeden jazyk – rozšíří se nabídka jazyků v odpovídajícím radiopřepínači, změna hodnoty tohoto přepínače okamžitě zobrazí hodnoty pro vybraný jazyk.

[[Image:referencniprirucka-stromkategorii-img013.png|center]]

Jazykově závislé vlastnosti jsou:

* '''Lokalizovaný název''' – název kategorie v daném jazyce, používá se pro navigační nabídky.
* '''Název složky''' – název složky, která se zakládá pro soubory v dané kategorii (generované stránky, soubory v databázi zdrojů). Složky se zakládají automaticky a vnořeně podle struktury stromu kategorií. Název složky je tedy vhodné volit tak, aby vyhovoval konvencím pro použití jako součásti URL adresy.
* '''Popis''' – text opět využitelný v navigačních nabídkách
* '''Součást navigace''' – příznak udává, zda se daná kategorie zahrnuje do funkce generování navigačních nabídek nebo je touto funkcí ignorována. Pokud je nějaká kategorie označena tak, že není součástí navigace a přitom má vytvořeny vnořené kategorie, které do navigace patří, je navigační strom navázán na první nadřazenou kategorii, která do navigace patří. To znamená, že tento případ je možný a je podporován.
* '''Výchozí stránka''' – každá kategorie může mít volitelně pro každý jazyk nejvýše jednu výchozí stránku. Tato stránka je oproti ostatním stránkám vloženým do dané kategorie zvýhodněna v tom, že se na ní vkládá URL do automaticky generovaných navigací a dále v tom, že ze záložky pro strom kategorií je na ni jednoduchý přechod (vybere se kategorie a zavolá funkce Výchozí stránka).
* '''Výchozí zpráva''' - pokud má v URL automaticky generovaných navigací pro danou kategorii figurovat odkaz na nějakou konkrétní zprávu, vybírá se tato zpráva zde.
* '''URL''' – lze zadat jakékoliv platné URL, které se má pro danou kategorii vkládat do automaticky generovaných navigací. Smysl má tedy zadat buď URL nebo zvolit výchozí stránku. Pokud jsou vyplněna dvě nebo tři z těchto polí definujících URL v navigacích, přednost při generování navigací má pole URL, pak výchozí zpráva jako druhá v pořadí a nakonec výchozí stránka.
* '''Výchozí předloha''' – lze nepovinně vybrat výchozí předlohu pro zprávy v dané kategorii. Při zadávání zprávy se vybírá předloha pro zobrazení zprávy. Zde místo výběru konkrétní předlohy můžeme ponechat hodnotu ''výchozí''. Pak se předloha hledá buď v definici kategorie nebo v definici publikace. V globálních předvolbách WebToDate lze nastavit, která z těchto dvou voleb má přednost, pokud jsou definovány obě.

Výchozí zpráva se zadává pomocí jejího ID do textového pole vedle popisku. Zadání tohoto ID je zjednodušeno následujícím způsobem:

* Vedle pole pro ID je rozevírací nabídka obsahující nejnovějších 5 zpráv z dané kategorie. Výběrem jedné z těchto zpráv se příslušné ID vloží do textového pole.
* Poslední položkou rozevírací nabídky je položka ''Jiná'', která zobrazí dialog pro výběr ID jiné zprávy.

[[Image:referencniprirucka-stromkategorii-vyberzpr.png|center]]

V horní části dialogu je formulář pro vyhledávání zpráv, ve spodní části je seznam zpráv odpovídajících vyhledávanému kritériu. Klikem na šipku v prvním sloupci tohoto seznamu se ID vybrané zprávy vloží do textového pole.

Strom kategorií má jeden "virtuální" kořen zobrazovaný v administračním rozhraní jako ''Strom kategorií''. Pod tímto kořenem se pak nacházejí kategorie nejvyšší úrovně. Je povoleno vytvořit více než jednu kategorii v nejvyšší úrovni, vhodnost takového řešení závisí na konkrétních cílech implementace.

<div class="note">'''Poznámka''': Kategorie lze libovolně vnořovat podle potřeby, fyzická omezení zde ovšem jsou: může existovat maximálně 85 úrovní vnoření, může existovat maximálně 999 přímých podkategorií dané kategorie.</div>

== Typy objektů vkládaných do stromu kategorií ==
Do stromu kategorií se ukládají následující typy objektů:

# Zprávy
# Fragmenty
# Zdroje
# Stránky

Na následujícím otisku obrazovky je např. formulářový prvek pro řazení zpráv do kategorií.

[[Image:referencniprirucka-stromkategorii-img014.png|center]]

Pro první tři typy objektů platí, že každou položku lze vložit do alespoň jedné kategorie, to znamená, že např. zpráva se může nacházet i ve více kategoriích. Právě jedna kategorie je pak označena jako ''výchozí''.

[[Image:referencniprirucka-stromkategorii-img015.png|center]]

Pojem výchozí kategorie pak používají následující funkce:

* Vyhledávání předlohy – pokud je u zprávy zvolena ''předloha : výchozí'' a předloha se vyhledává podle kategorie, proběhne vyhledání ve výchozí kategorii, do které zpráva patří.
* Zobrazování navigací – navigační elementy při zobrazení zprávy se zobrazují kontextově podle toho, kde se daná zpráva ve stromu kategorií nachází. Pokud je zpráva ve více kategoriích, opět se jako řídící bere výchozí kategorie, umístění v dalších kategoriích je pro navigace irelevantní a je tímto nástrojem ignorováno.
* Fulltextové hledání – o tom, zda je zpráva viditelná z hlediska fulltextu rozhoduje její zařazení do výchozí kategorie.

Pro stránky platí, že každá stránka patří do právě jedné kategorie ve stromu. Výjimkou je speciální typ stránek, tzv. předlohy. Předlohy mají svoje vlastní kategorie předloh – např. ''Zprávy'', ''Zdroje'' či kategorie předloh pro jednotlivé moduly.

== Strom kategorií a navigace webu ==
Strom kategorií má úzkou vazbu na automatické generování navigačních nabídek. Tato funkčnost je založena na následujícím principu:

[[Image:referencniprirucka-stromkategorii-img016.png|center]]

Strom kategorií se nejprve převádí do XML kódu. Tento kód reflektuje stromovou strukturu kategorií a pro každou kategorii obsahuje následující atributy:

* Lokalizovaný název
* URL (buď URL výchozí stránky kategorie nebo výchozí zprávy nebo URL zadané jako vlastnost kategorie)
* ID kategorie (interní jedinečné číslo)
* Popis
* Úroveň vnoření

Ukázka takového XML kódu je na následujícím obrázku. Pro účely ladění navigací jej lze získat pomocí funkce '''Navigace''' z hlavní nabídky – přejdeme do formuláře pro úpravy definice navigace, poslední položkou formuláře je '''XML kód stromu''' a tlačítko '''Zobrazit'''.

[[Image:referencniprirucka-stromkategorii-img017.png|center]]

Do tohoto kódu se vkládají pouze kategorie, které mají příznak '''Součást navigace'''.

Vlastní HTML kód navigace pak vzniká XSLT transformací XML kódu stromu kategorií, příklady výsledné podoby jsou na následujících obrázcích.

[[Image:referencniprirucka-stromkategorii-img018.png|center]]

[[Image:referencniprirucka-stromkategorii-img019.png|center]]

Příslušné transformace mají k dispozici kromě výše uvedených informací ze stromu kategorií ještě informaci o aktivní kategorii – tou je buď kategorie, ve které se nachází stránka, která se právě generuje, nebo výchozí kategorie, ve které se nachází právě zobrazovaná zpráva. Transformace se vytvářejí v rámci implementace designu. Jedna stránka může používat i více automaticky generovaných navigací – jedná se např. typicky o hlavní svislou navigaci webu, drobečkovou navigaci ale může jít např. i o názvy (element ''<nowiki><title''></nowiki>)'' stránky apod.

== Strom kategorií a přístupová práva ==
Každá kategorie je ve vlastnictví nějakého týmu. Prvotní postup je zpravidla takový, že administrátor založí kategorie v prvních dvou či prvních několika úrovních a následně u zvolených kategorií změní tým na odpovídající tým uživatelů, kteří budou danou kategorii používat.

To, že kategorii vlastní nějaký tým znamená, že uživatelé, kteří jsou v daném týmu v roli editor, mohou měnit vlastnosti této kategorie a vytvářet v ní podkategorie. Týmy tedy touto funkcí dostávají nástroj, jak vytvářet a spravovat vlastní strukturu své části webu.

Práva oblastí na stránkách se primárně odvozují od kategorie, ve které se stránka nachází, neboli od týmu, který tuto kategorii vlastní. Teprve v případě nutných výjimek je třeba nastavit práva pro danou oblast na dané stránce explicitně.

[[Image:referencniprirucka-stromkategorii-img020.png|center]]

Předchozí obrázek zobrazuje právě toto explicitní nastavení práv (záložka '''Práva''' ve vlastnostech stránky). Pokud jsou práva na nějakou oblast na stránce nastavena individuálně, platí pouze toto explicitní nastavení a implicitní práva odvozená od stromu kategorií pozbývají pro tuto oblast na stránce význam.

Dále může ve stromu kategorií platit restrikce na vkládání obsahu do kategorií. Jsou k dispozici následující volby:

* 1 – členové týmů mohou řadit data do libovolných kategorií
* 2 – editoři mohou řadit data do libovolných kategorií, redaktoři jen do těch, do kterých mají přístup
* 3 – členové týmů mohou řadit data jen do těch kategorií, do kterých mají přístup

<div class="note">'''Poznámka''': Toto nastavení se konfiguruje v globálních předvolbách, jedná se o konstantu ''TREE_ACCESS_REGIME''.</div>

== Správa stromu kategorií ==
=== Založení nové kategorie ===

Nová kategorie se zakládá ze stromu kategorií. Vyberte existující kategorii nebo virtuální kořen stromu (nazvaný ''Strom kategorií'') a vyvolejte funkci '''Nová''' (buď pomocí kontextové nabídky volané pravým tlačítkem myši, nebo pomocí tlačítka v horní části záložky '''''Strom kategorií''''').

Zobrazí se formulář pro založení nové kategorie. Povinně se zadává:

* '''Systémový název''' (výchozí hodnota je prázdná)
* '''Nadřazená kategorie''' (výchozí hodnota vyplněná podle předchozí vybrané kategorie, lze ji ale změnit)
* '''Tým''' - zde se nabídka liší podle toho, v jakých je uživatel týmech, administrátor zde má k dispozici všechny týmy, editoři týmů pouze týmy, ve kterých jsou v této roli.

Dále doporučujeme vyplnit tato pole, která nejsou povinná, ale např. kvůli generování navigací či ukládání stránek a souborů je velmi vhodné je pečlivě vyplnit (hned nebo co nejdříve):

* Všechna nastavení, která jsou ve formuláři formou zaškrtávacích okének ('''Fulltextově prohledávat''', '''Součást navigace''', '''Vkládat data''')
* '''Název složky'''
* '''Lokalizovaný název''', resp. lokalizované názvy pro jazyky (je nutné pouze, pokud kategorie patří do navigace, ale je poměrně vhodné jej vyplnit hned, protože toto opomenutí může být zdrojem následných chyb).

Při ukládání formuláře se pak kontroluje jednoznačnost:

* Nelze založit dvě kategorie se stejnou nadřazenou kategorií a stejným systémovým názvem
* Nelze založit dvě kategorie se stejnou nadřazenou kategorií a stejným názvem složky

Pokud kategorie patří do navigace, je třeba buď zvolit výchozí stránku, nebo zadat URL. Formulář toto při zakládání nové kategorie nekontroluje, protože např. stránky v kategorii lze vytvářet, až když kategorie existuje, ale tuto činnost je vhodné provést co nejdříve.

<div class="note">Na webu běžícím v ostrém provozu doporučujeme nejprve založit novou kategorii s nastavením "není součást navigace", pak připravit a vygenerovat výchozí stránku kategorie a teprve v posledním kroku kategorii označit jako patřící do navigace. Jiný postup vede k riziku, že na úplně jiných stránkách webové prezentace dojde k aktualizaci a přegenerování, do automaticky generovaných navigací se zde již může zapojit nově založené kategorie, tato kategorie ale ještě nebude mít funkční odkaz v navigacích a tudíž dojde k vytvoření nefunkčního hypertextového odkazu v nabídce na stránkách.
Tato nežádoucí stavy kromě mnoha dalších vyhledává a vypisuje modul '''Verifikace''' - informujte se v příslušné příručce k modulu.</div>

=== Úprava vlastností existující kategorie ===

Ve stromu kategorií vyberte požadovanou kategorii a vyvolejte funkci '''Vlastnosti''' (buď pomocí kontextové nabídky volané pravým tlačítkem myši, nebo pomocí tlačítka v horní části záložky '''''Strom kategorií'''''). Další postup je stejný jako u založení nové kategorie, změny je třeba potvrdit tlačítkem '''Uložit'''.

=== Smazání kategorie ===

Ve formuláři pro úpravu vlastností kategorie je tlačítko '''Smazat'''. Možnost mazání kategorie je ale omezená, smazat kategorii lze v případě, že na ní nejsou vázané další položky v databázi. Pro mazání tedy platí, že

* Kategorie nesmí mít podkategorie
* Kategorie nesmí obsahovat stránky
* Kategorie nesmí obsahovat zprávy, fragmenty a zdroje
* Neexistují další závislosti (odkazy na kategorii v objektech jako akce, seznamy, moduly apod.)

Přímý datový obsah kategorie naleznete v záložce '''Užití''' formuláře, kde jsou vypsány počty zpráv v kategorii, stránek apod.

=== Přesun kategorie na jiné místo ve stromu ===

Kategorii lze přesunout na jiné místo stromu. Ve formuláři pro úpravy vlastností kategorií použijte tlačítko '''Změnit''' u pole '''Nadřazená kategorie'''. Všechny objekty v přesouvané kategorii (stránky, zprávy apod.) zůstávají, nemění se ani jejich URL. Tato akce je ale umožněna z bezpečnostních důvodů pouze administrátorům WebToDate.

Je zde si třeba uvědomit, že po migraci kategorie na jinou úroveň dojde k tomu, že pro nové objekty (stránky a soubory ve zdrojích) ukládané do migrované kategorie se budou automaticky přidělovat jiná URL, resp. jiná složka. Pokud máme např. kategorii ve třetí úrovni a zakládáme v ní novou stránku, bude výchozí URL ve tvaru

<code>
<nowiki>/složka_první_kategorie/složka_druhé_kategorie/složka_třetí kategorie/stranka.htm</nowiki>
</code>

Pokud tuto kategorii budeme migrovat do jiné části stromu kategorií, tato URL existujících stránek zůstanou beze změny, v případě, že budeme v migrované kategorii zakládat novou stránku, přidělí se jí URL podle toho, jak je aktuálně umístěná, tedy např.

<code>
<nowiki>/složka_jiné_první_kategorie /složka_třetí kategorie/stranka.htm</nowiki>
</code>

Všechna tato URL se automaticky předvyplňují a je možné je ručně měnit, nicméně z hlediska pracnosti je vhodné složky v kategoriích dobře nadefinovat a pak automatické předvyplňování plně využívat.

=== Duplikace kategorie ===

Kategorii lze duplikovat (tlačítko '''Duplikovat''' ve formuláři pro vlastnosti kategorie). Právo duplikovat danou kategorii má buď administrátor, nebo editor týmu, který vlastní kategorii nadřazenou k duplikované kategorii.

Duplikát má následující vlastnosti:

* Systémový název odvozený od systémového názvu duplikované kategorie se stejnou konvencí pojmenovávání duplikátů jako se používá např. u zpráv.
* Stejná nadřazená kategorie jako u duplikované kategorie
* Stejné vlastnosti '''Fulltextově prohledávat''' a '''Vkládat data''' jako duplikovaná kategorie
* Součást navigace nastaveno vždy na ''ne'' (aby se duplikace okamžitě nechtěně neprojevila na veřejných stránkách)
* Stejná priorita jako u duplikované kategorie
* Název složky odvozený od názvu složky duplikované kategorie se stejnou konvencí pojmenovávání duplikátů jako se používá např. u zpráv (v případě, že je prázdný u duplikované kategorie, zůstává prázdný i u duplikátu)
* Z jazykově závislých vlastností stejné lokalizované názvy, popisy, výchozí předlohy a URL jako u duplikované kategorie (doslovně stejné bez přejmenovávání)
* Výchozí stránky vždy prázdné

== Režimy zakládání kategorií ==
=== Zjednodušený režim zakládání výchozích stránek ===

Z výše popsaných funkcí vyplývá, že možný postup je ten, že v případě, že chce uživatel založit na webu novou rubriku, tak

* Založí novou kategorii ve stromu kategorií
* Založí novou stránku v této kategorii a označí ji jako výchozí
* Vybere této stránce nějakou šablonu
* Přiřadí na stránku nějaké objekty (zprávy, seznamy, navigace) a vygeneruje.

Kromě této výše popsané možnosti zakládání stránek ovšem existuje zjednodušená varianta. Funkce je orientovaná především na intranetová nasazení, která mají relativně bohatou hierarchii stromu webu a kde stránky v jednotlivých uzlech stromu kategorií vypadají podobně nebo stejně a mají stejnou strukturu. V maximálně možné zjednodušené variantě jde o následující postup:

* Editor založí novou rubriku (tedy nějaký nový uzel stromu kategorií)
* Do tohoto uzlu se začnou vkládat nějaké zprávy
* Uživatelé nic dalšího nebudou dělat, tedy odkaz na novou rubriku se objeví v navigačním menu, rubrika bude mít svou stránku a na ní se zobrazí zprávy do rubriky vložené.

Funkce logicky musí založit ''výchozí stránku'' pro danou kategorii. Tato stránka má řadu vlastností, které je třeba nastavit. V zjednodušeném režimu zakládání položek stromu kategorií se toto provede automaticky s využitím výchozích nastavení definovaných globálně administrátorem, vždy lze ovšem přejít do pokročilejšího režimu, kde se všechny vlastnosti nastavují manuálně.

Na následujícím obrázku jsou znázorněny automaticky spouštěné funkce při použití zjednodušeného režimu.

[[Image:referencniprirucka-stromkategorii-img021.png|center]]

Zjednodušený režim nastavuje pro zakládané stránky automaticky zejména následující vlastnosti:

* Název stránky
* URL stránky
* Šablonu stránky
* Označení stránky jako výchozí
* Práva na oblasti
* Jazyk a značkovací jazyk
* Přiřazení některých objektů na oblasti (zejména seznamů a navigací, případně fragmentů)

Výsledkem by měla být plně funkční stránka připravená k publikaci – typicky se zvolí připravená univerzální šablona a přiřadí se na ni připravený seznam zobrazující zprávy v dané kategorii, pokud je takto založená stránka navíc zobrazovaná dynamicky, může okamžitě zobrazovat publikované zprávy v dané rubrice.

Celý proces je jednoduché používat, je třeba ale věnovat značnou pozornost konfiguraci pomocí globálních předvoleb, aby bylo dosaženo požadovaného výsledku.

=== Použití zjednodušeného režimu uživatelem ===

Ve formuláři pro založení nové kategorie zvolte jeden ze zjednodušených režimů. Lze spustit zjednodušený režim, který zakládá výchozí stránku pouze pro výchozí jazyk, nebo pro všechny jazyky.

[[Image:referencniprirucka-stromkategorii-img022.png|center]]

Přinejmenším ve druhém případě je třeba provést zpětnou kontrolu výsledku - např. pro lokalizované názvy kategorií se použije zadaný systémový název, což může být v pořádku pro jeden jazyk, ale nikoliv pro více jazyků.

Po volbě některého ze zjednodušených režimů se zobrazí stejný formulář jako v případě pokročilého režimu. Ve formuláři se typicky vyplní následující položky:

* Systémový název
* Lokalizovaný název
* Název složky
* Všechna zaškrtávací okénka se zpravidla ponechají zaškrtnutá

Pro volbu ''Zjednodušený režim – výchozí jazyk'' je toto většinou postačující, v rámci založení kategorie se založí i výchozí stránka a přiřadí se na ní objekty dle nastavení.

Pro volbu ''Zjednodušený režim – všechny jazyky'' je třeba se vrátit zpět do vlastností kategorie a doplnit další lokalizované názvy pro další jazyky. Dále je vhodné pro každý jazyk nastavit pole ''Výchozí předloha'' – pro vícejazyčné prezentace je vhodné výchozí předlohy pro zprávy rozlišovat na úrovni stromu kategorií, nikoliv na úrovni publikací.

Pokud se funkci nepodaří některou stránku založit, zobrazí se informační hlášení o této skutečnosti. Důvodem je zpravidla nevyhovující nastavení v globálních předvolbách. Neobsahuje-li např. ani jedna konstanta, pomocí kterých se definují URL automaticky zakládaných stránek klíčové slovo pro kód jazyka a přitom je použit ''Zjednodušený režim – všechny jazyky'', nepodaří se založit více než jednu stránku, protože by takto více stránkám bylo přiřazeno stejné URL, což ve WebToDate není možné.

=== Proces zjednodušeného režimu založení výchozí stránky ===

Proces zjednodušeného zakládání výchozích stránek se spouští, pokud jsou splněny následující podmínky (názvy konstant jsou z konfiguračního souboru ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate|global.php]]''):

* Uživatel zakládající novou kategorii tuto možnost ve formuláři při zakládání nové kategorie zvolil (pokud je konstanta NEW_CATEGORY_REGIME nastavená na 0, nelze tuto možnost zvolit)
* Kategorie není v nejvyšší úrovni vnoření, tj. má existující nadřazenou kategorii
* Je zvolena vlastnost '''Vkládat data''' pro tuto kategorii

Proces lze spustit jen při zakládání nové kategorie, nikoliv pro existující kategorii.

Na proces automatického zakládání stránek mají vliv následující parametry:

* Konstanta NEW_CATEGORY_REGIME – neovlivňuje vlastní algoritmus, ale to, zda jsou příslušné radiopřepínače pro tuto volbu vůbec ve formuláři přítomny a jaké je jejich výchozí nastavení.
* Konstanta NEW_CATEGORY_PAGE_NAME – slouží k vytvoření cesty k výchozí stránce, konkrétně definuje název souboru (při výchozím nastavení "default.htm")
* Konstanta NEW_CATEGORY_PAGE_PATH – slouží k vytvoření cesty k výchozí stránce, konkrétně definuje tvar celé cesty bez názvu souboru
* Konstanta NEW_CATEGORY_PAGE_PROTOTYPE – definuje, kterou stránku ve stromu nadřazených kategorií si algoritmus vezme jako vzor
* Konstanty NEW_CATEGORY_PAGE_FRAGMENTS, NEW_CATEGORY_PAGE_LISTS a NEW_CATEGORY_PAGE_NAVIGATIONS – definují, co se na výchozí stránku automaticky přiřazuje

Proces probíhá v následujících krocích:

# Zakládá se nová stránka, která bude označena jako výchozí
# Přiřazují se požadované objekty na stránku
# Stránka se generuje

V prvním kroku dochází k zakládání stránky, kde se automaticky stanovuje řada parametrů stránky a vlastností kategorie závislých na jazyku:

{| class="prettytable"
| Název stránky
| Systémový název zakládané kategorie + mezera + zkratka jazyka

|-
| Titulek stránky
| prázdný

|-
| URL stránky
| URL sestavené podle konfiguračních parametrů NEW_CATEGORY_PAGE_PATH a NEW_CATEGORY_PAGE_NAME - oba parametry se spojí a vznikne kompletní URL stránky, např. "/prezentace/ceniky/default.htm".

|-
| Kategorie stránky
| Kategorie, která je právě zakládaná

|-
| Jazyk
| Odpovídající jazyk

|-
| Značkovací jazyk
| První v seznamu značkovacích jazyků (podle výchozí instalace ''HTML'')

|-
| Šablona
| Stejné jako u vzorové stránky

|-
| Umístění
| Stejné jako u vzorové stránky

|-
| Server
| Stejné jako u vzorové stránky

|-
| Lokalizovaný název kategorie
| Systémový název zakládané kategorie

|-
| Výchozí předloha kategorie
| Stejné jako u vzorové kategorie

|-
| Popis kategorie
| prázdný

|-
| URL kategorie
| prázdný

|}

V druhém kroku se na stránku přiřazují objekty. Platí následující:

* Objekty se řadí na stránky na stejné oblasti a pod stejným stylem (a dalšími nastaveními jako priorita či staticky / dynamicky) jako na vzorové stránce.
* Pokud je konstanta NEW_CATEGORY_PAGE_FRAGMENTS = 1, vkládají se stejné fragmenty, jako jsou na vzorové stránce.
* Pokud je konstanta NEW_CATEGORY_PAGE_LISTS > 0, vkládají se seznamy dle vzorové stránky. Je-li hodnota této konstanty 2, vkládají se všechny seznamy podle vzorové stránky, pokud je hodnota této konstanty 1, vkládají se jen ty, které jsou parametrizované podle kategorie stránky, na které se nacházejí.
* Pokud je konstanta NEW_CATEGORY_PAGE_NAVIGATIONS = 1, přiřazují se na stránku navigace se stejným nastavením jako u vzorové stránky.

Třetím krokem je vygenerování založené stránky

Přístupová práva k oblastem algoritmus nijak nenastavuje, což v praxi znamená, že přístupová práva ke všem oblastem na vytvořené stránce bude mít tým, který vlastní založenou kategorii.

=== Výběr vzorové stránky ===

Celá možnost nasazení této funkčnosti závisí na tom, zda lze globálně stanovit, jak má systém najít stránku, která bude sloužit jako vzor pro automaticky zakládané stránky.

Pro volbu vzorové stránky při automatickém zakládání nové stránky slouží konstanta

<code>
<nowiki>define( 'NEW_CATEGORY_PAGE_PROTOTYPE', 0 );</nowiki>
</code>

Možné hodnoty této konstanty jsou:

* 0 – za vzor pro automatické zakládání výchozích stránek slouží přímo nadřazená kategorie
* Celé kladné číslo - za vzor pro automatické zakládání výchozích stránek slouží nadřazená kategorie v dané úrovni vnoření, 1= nejvyšší úroveň, 2 = druhá nejvyšší úroveň atd.

Výchozí hodnota pro novou instalaci je 2.

To znamená, že proces automatického zakládání hledá zásadně vzorovou stránku v kategoriích, které jsou nadřazené právě zakládané kategorii, pomocí konfigurační konstanty lze definovat globální pravidlo, která z nadřazených kategorií to bude, pravidlo se přitom odvíjí od vnořování těchto kategorií.

== Veřejná a privátní zóna ==
Ačkoliv tento pojem přímo nesouvisí se stromem kategorií, ale spíše s objekty do stromu ukládanými (konkrétně se stránkami a soubory ve zdrojích), je vhodné tyto termíny vysvětlit již v této kapitole.

Termín '''''zóna '''''znamená způsob uložení souboru. Veřejná zóna je část diskového prostoru www serveru, která je přímo přístupná přes virtuální adresáře serveru ve veřejné části a všechny soubory, které se zde nacházejí, jsou automaticky přístupné všem anonymním uživatelům. Založíme-li tedy stránku např. s URL ''/adresar/stranka.htm'' ve veřejné zóně, znamená to, že skutečně fyzicky je takovýto soubor vytvořen v odpovídající složce hned pod kořenovým adresářem webu a je okamžitě přístupný všem anonymním návštěvníkům webu a jeho plná URL adresa je ''www.server.cz/adresar/stranka.htm''.

Pokud ovšem u stránky zvolíme, že je umístěná v privátní zóně a zadáme URL ve tvaru ''/adresar/stranka.htm'', soubor je sice vytvořen v zadané složce, ale v úplně jiné adresářové struktuře WebToDate, která je umístěna mimo přímo přístupné virtuální adresáře www serveru. V důsledku to znamená, že URL adresa ''www.server.cz/adresar/stranka.htm'' neexistuje, místo toho se stránka zobrazuje pomocí prezentačního skriptu na adrese ''www.server.cz/scripts/detail.php?pgid=xxx'', kde xxx je ID stránky. Analogicky toto platí i pro soubory, pouze místo prezentačního skriptu ''detail.php'' se používá skript ''file.php''.

Umístění do veřejné zóny tedy znamená následující:

* Soubory (tj. soubory ve zdrojích a generované stránky) jsou okamžitě po vytvoření v systému dostupné všem anonymním návštěvníkům.
* Ve veřejné zóně nelze zajistit, aby k souboru měla přístup jen omezená skupina uživatelů
* Stahování z veřejné zóny (HTML stránky či jiného typu souboru) je velmi rychlé, protože se jedná o statické soubory, které se na straně www serveru nijak nezpracovávají.

Umístění do privátní zóny naopak znamená:

* Soubory v privátní zóně nejsou automaticky přístupné anonymním návštěvníkům
* Lze zajistit, aby je mohla zobrazit či stahovat jen omezená skupina registrovaných uživatelů (tuto problematiku řeší rozšiřující moduly [[../../Neveřejná část|Neveřejná část]] a [[../../Registrace a personalizace|Registrace a personalizace]])
* Stahování z veřejné zóny je pomalejší, protože neběží přímo, ale přes prezentační PHP skripty.

V globálních předvolbách WebToDate lze navíc zvolit chování vůči souborům v ještě nepublikovaných zdrojích. Pokud není zdroj ve stavu ''Publikováno'' a obsahuje nějaké soubory, lze globálně navolit, zda se tyto soubory umístí nejprve do privátní zóny (přestože uživatel zvolil veřejnou zónu) a teprve v momentě publikace zdroje se do veřejné zóny přesunou, nebo jsou do veřejné zóny umístěny ihned (tj. může je teoreticky kdokoliv stáhnout, přestože nejsou ještě označeny za publikované).

Způsob práce s veřejnou a privátní zónou je třeba předem pečlivě zvážit a nakonfigurovat. Pokud jsou položky umístěny do privátní zóny, je obecně větší kontrola nad možností tyto položky stahovat, ale stahování je náročnější na systémové zdroje.

Jak pro stránky, tak pro soubory ve zdrojích lze nakonfigurovat i možnost výběru vzhledem k uživatelům - lze např. privátní zónu úplně vypnout nebo naopak vynutit ukládání všech souborů do privátní zóny nebo ponechat tuto volbu na uživateli. Více viz kapitola [[../Konfigurace WebToDate#Globální konfigurace WebToDate|Globální konfigurace WebToDate]].

== Možnosti konfigurace funkčnosti stromu kategorií ==
Základní chování stromu kategorií lze ovlivnit nastaveními v globálním konfiguračním souboru WebToDate ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate|global.php]]''. Přehled těchto možností je v následující tabulce.

{| class="prettytable"
| Přístupová práva ke stromu webu
| Lze přepnout režim kontroly řazení zpráv do stromu s následujícími možnostmi:

*Členové týmů mohou řadit do libovolných kategorií
*Editoři mohou řadit do libovolných kategorií, redaktoři jen do těch, do kterých mají přístup
*Členové týmů mohou řadit jen do kategorií, do kterých mají přístup

Lze zvolit, zda uživatelé v roli editor mají možnost zakládat nové podkategorie kategorií, které patří týmům, v nichž jsou členy.

|-
| Zjednodušený režim tvorby stránek
| Pro interface zakládání kategorií lze nastavit výchozí volbu pro zakládání stránek:

*Pokročilý režim
*Zjednodušený režim – výchozí jazyk
*Zjednodušený režim – všechny jazyky
*Pro způsob zakládání výchozích stránek lze nastavit:
*Název souboru pro výchozí stránku (standardně ''default.htm'')
*Způsob výchozího sestavování cesty ke stránkám
*Odvozovat šablony a přiřazení objektů od přímo nadřazené kategorie / nejvyšší nadřazené kategorie
*Automaticky přidat na oblasti podle vzoru všechny fragmenty
*Automaticky přidat na oblasti podle vzoru všechny seznamy / seznamy parametrizované podle kategorie / žádné seznamy
*Automaticky přidat na stránku podle vzoru navigace

|-
| Předlohy pro zprávy
| Lze nastavit, zda se při zobrazení zprávy jako výchozí objekt pro nalezení předlohy bere výchozí kategorie zprávy nebo publikace jako předchozích verzích WebToDate.

|-
| Veřejná a privátní zóna pro stránky
| Lze nastavit název podadresáře adresáře ''offlinedata'', do kterého se ukládají stránky v privátní zóně. Lze nastavit výchozí volbu ukládání stránek (výběr veřejné či privátní zóny).

|}

Podrobný popis konfiguračních konstant naleznete v kapitole [[../Konfigurace WebToDate#Globální konfigurace WebToDate|Globální konfigurace WebToDate]].

== Strom kategorií a jazykové verze ==
Strom kategorií obsahuje podporu vícejazyčných webů. Tato podpora spočívá v následujícím:

* Každá kategorie má lokalizované názvy pro všechny jazykové mutace.
* Každá kategorie dovoluje specifikovat URL pro navigace pro každý jazyk zvlášť (buď výchozí stránku nebo přímo zadané URL).
* Při generování navigace se použije jazykové varianta navigace podle jazyka generované stránky či zobrazované zprávy.

Pokud tedy máte více jazykových mutací webu ve stejné struktuře, doporučujeme vytvořit jeden strom kategorií pro všechny jazyky, definovat všechny jazykově závislé vlastnosti kategorií a jazykové verze zpráv či stránek ukládat vždy do stejného uzlu stromu.

Nic ovšem nebrání tomu, aby byl pro každý jazyk založen jiný strom kategorií (resp. jiná část stromu). Tuto variantu použijte v případě, že jednotlivé jazykové mutace mají odlišnou strukturu prezentace (a patrně i odlišný rozsah apod.). Pak platí následující:

* Na úrovni XSLT transformací bude nutné zajistit, aby se na stránkách generovaly odpovídající navigace. Pro každou jazykovou mutaci bude patrně třeba vytvořit jiné transformace, které berou v potaz jen odpovídající větev stromu kategorií.
* Jazykové verze zpráv a stránek nejsou omezeny v tom, že by se musely nacházet ve stromu kategorií na stejném místě. Umístění jazykových verzí těchto objektů je libovolné.
* Pokud je v dané implementaci plánované fulltextové hledání pouze v daném jazyce, není třeba tento problém nijak řešit v souvislosti se stromem kategorií, jazyk je vlastnost zprávy, se kterou vyhledávací modul pracuje bez ohledu na strom kategorií.

WebToDate/Referenční/Strom kategorií

2020-05-04T07:29:20Z

Jakubn: /* K čemu se používá strom kategorií */

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
== K čemu SE používá strom kategorií ==
Strom kategorií je základní řídící struktura, která dělí celou webovou prezentaci na jednotlivé sekce a podsekce z hlediska obsahu i přístupových práv. Struktura stromu kategorií a vlastnosti jednotlivých kategorií ovlivňují následující funkce a chování webové prezentace:

* Strukturu ukládání souborů do složek na serveru – pokud např. generujeme stránku nebo ukládáme soubor do databáze zdrojů, výchozí cesta k souboru je daná složkami definovanými ve vlastnostech kategorií.
* Přístupová práva – každý uzel stromu kategorií je ve vlastnictví jednoho týmu, což má vliv na možnosti zakládat vnořené kategorie, ukládat do kategorie zprávy či zdroje apod.
* Automaticky generované navigační nabídky – od stromu kategorií se odvozuje struktura automaticky generovaných navigací, přičemž lze ovlivnit URL stránky, na kterou kategorie ukazuje, to, zda se vůbec daná kategorie do navigací zahrnuje apod.
* Zařazení do stromu kategorií je významná metainformace, se kterou lze dále pracovat jak v administračním rozhraní WebToDate, tak při generování veřejně přístupné prezentace. V redakčním rozhraní lze podle kategorií vyhledávat a filtrovat, v prezentační části lze např. vytvářet seznamy zpráv, které vypisují zprávy dané kategorie (případně v kombinaci s mnoha dalšími kritérii týkajícími se metadat).

== Vlastnosti uzlů stromu ==
Na následujícím obrázku je formulář pro nastavení vlastností kategorie. Formulář je rozdělen na horní část, která obsahuje pole nezávislá na jazyku a spodní část, která obsahuje vlastnosti závislé na konkrétním jazyce.

[[Image:referencniprirucka-stromkategorii-img012.png|center]]

Každá kategorie má následující vlastnosti nezávislé na jazyku:

* '''Systémový název''' – název kategorie tak, jak se zobrazuje v administračním rozhraní
* '''Nadřazená kategorie''' – kategorie, která je ve stromu kategorií přímo nadřazená dané kategorii (musí být právě jedna s výjimkou kategorií, které jsou v nejvyšší úrovni, tyto kategorie žádnou nadřazenou kategorii nemají)
* '''Tým''' – tým uživatelů, který vlastní danou kategorii
* '''Fulltextově prohledávat''' – jedná se o informaci pro modul Fulltext, tímto příznakem se vyznačuje, zda jsou zprávy v dané kategorii pro vyhledávací modul viditelné či nikoliv. Zprávy mohou být umístěny ve více kategoriích, v takovém případě je jedna kategorie označena jako ''výchozí''. V takovém případě o tom, zda je zpráva pro vyhledávání viditelná, rozhoduje právě výchozí kategorie.
* '''Vkládat data''' – příznak udává, zda lze do této kategorie vkládat data jako zprávy či zdroje
* '''Priorita''' – lze volitelně zadat celé číslo, které ovlivňuje pořadí kategorie ve výpisech. Např. při generování navigační nabídky se kategorie umístěné ve stejném uzlu řadí primárně podle této priority, sekundárně podle pořadí, v jakém byly vytvořeny.
* '''Vlastní pole – text''' – textové pole, do kterého lze zadat jakýkoliv text
* '''Vlastní pole - číslo''' – pole, do kterého lze zadat jakékoliv číslo

Pořadí podkategorií zvolené kategorie lze kromě ruční změny priority měnit i nástrojem, který se zobrazí pomocí tlačítka '''Pořadí podkategorií'''. Tato stránka zobrazí seznam podkategorií zvolené kategorie, kde lze metodou Táhni a pusť měnit jejich pořadí, po změně je třeba tlačítkem '''Uložit změny''' provedené změny uložit. Interně se jedná o automatické přečíslování priorit kategorií.

[[Image:referencniprirucka-stromkategorii-poradi.png|center]]

Dále následují vlastnosti kategorie, které jsou na jazyku závislé. Na následujícím otisku obrazovky je vidět, jak se formulář mění v případě, že je v systému definován více než jeden jazyk – rozšíří se nabídka jazyků v odpovídajícím radiopřepínači, změna hodnoty tohoto přepínače okamžitě zobrazí hodnoty pro vybraný jazyk.

[[Image:referencniprirucka-stromkategorii-img013.png|center]]

Jazykově závislé vlastnosti jsou:

* '''Lokalizovaný název''' – název kategorie v daném jazyce, používá se pro navigační nabídky.
* '''Název složky''' – název složky, která se zakládá pro soubory v dané kategorii (generované stránky, soubory v databázi zdrojů). Složky se zakládají automaticky a vnořeně podle struktury stromu kategorií. Název složky je tedy vhodné volit tak, aby vyhovoval konvencím pro použití jako součásti URL adresy.
* '''Popis''' – text opět využitelný v navigačních nabídkách
* '''Součást navigace''' – příznak udává, zda se daná kategorie zahrnuje do funkce generování navigačních nabídek nebo je touto funkcí ignorována. Pokud je nějaká kategorie označena tak, že není součástí navigace a přitom má vytvořeny vnořené kategorie, které do navigace patří, je navigační strom navázán na první nadřazenou kategorii, která do navigace patří. To znamená, že tento případ je možný a je podporován.
* '''Výchozí stránka''' – každá kategorie může mít volitelně pro každý jazyk nejvýše jednu výchozí stránku. Tato stránka je oproti ostatním stránkám vloženým do dané kategorie zvýhodněna v tom, že se na ní vkládá URL do automaticky generovaných navigací a dále v tom, že ze záložky pro strom kategorií je na ni jednoduchý přechod (vybere se kategorie a zavolá funkce Výchozí stránka).
* '''Výchozí zpráva''' - pokud má v URL automaticky generovaných navigací pro danou kategorii figurovat odkaz na nějakou konkrétní zprávu, vybírá se tato zpráva zde.
* '''URL''' – lze zadat jakékoliv platné URL, které se má pro danou kategorii vkládat do automaticky generovaných navigací. Smysl má tedy zadat buď URL nebo zvolit výchozí stránku. Pokud jsou vyplněna dvě nebo tři z těchto polí definujících URL v navigacích, přednost při generování navigací má pole URL, pak výchozí zpráva jako druhá v pořadí a nakonec výchozí stránka.
* '''Výchozí předloha''' – lze nepovinně vybrat výchozí předlohu pro zprávy v dané kategorii. Při zadávání zprávy se vybírá předloha pro zobrazení zprávy. Zde místo výběru konkrétní předlohy můžeme ponechat hodnotu ''výchozí''. Pak se předloha hledá buď v definici kategorie nebo v definici publikace. V globálních předvolbách WebToDate lze nastavit, která z těchto dvou voleb má přednost, pokud jsou definovány obě.

Výchozí zpráva se zadává pomocí jejího ID do textového pole vedle popisku. Zadání tohoto ID je zjednodušeno následujícím způsobem:

* Vedle pole pro ID je rozevírací nabídka obsahující nejnovějších 5 zpráv z dané kategorie. Výběrem jedné z těchto zpráv se příslušné ID vloží do textového pole.
* Poslední položkou rozevírací nabídky je položka ''Jiná'', která zobrazí dialog pro výběr ID jiné zprávy.

[[Image:referencniprirucka-stromkategorii-vyberzpr.png|center]]

V horní části dialogu je formulář pro vyhledávání zpráv, ve spodní části je seznam zpráv odpovídajících vyhledávanému kritériu. Klikem na šipku v prvním sloupci tohoto seznamu se ID vybrané zprávy vloží do textového pole.

Strom kategorií má jeden "virtuální" kořen zobrazovaný v administračním rozhraní jako ''Strom kategorií''. Pod tímto kořenem se pak nacházejí kategorie nejvyšší úrovně. Je povoleno vytvořit více než jednu kategorii v nejvyšší úrovni, vhodnost takového řešení závisí na konkrétních cílech implementace.

<div class="note">'''Poznámka''': Kategorie lze libovolně vnořovat podle potřeby, fyzická omezení zde ovšem jsou: může existovat maximálně 85 úrovní vnoření, může existovat maximálně 999 přímých podkategorií dané kategorie.</div>

== Typy objektů vkládaných do stromu kategorií ==
Do stromu kategorií se ukládají následující typy objektů:

# Zprávy
# Fragmenty
# Zdroje
# Stránky

Na následujícím otisku obrazovky je např. formulářový prvek pro řazení zpráv do kategorií.

[[Image:referencniprirucka-stromkategorii-img014.png|center]]

Pro první tři typy objektů platí, že každou položku lze vložit do alespoň jedné kategorie, to znamená, že např. zpráva se může nacházet i ve více kategoriích. Právě jedna kategorie je pak označena jako ''výchozí''.

[[Image:referencniprirucka-stromkategorii-img015.png|center]]

Pojem výchozí kategorie pak používají následující funkce:

* Vyhledávání předlohy – pokud je u zprávy zvolena ''předloha : výchozí'' a předloha se vyhledává podle kategorie, proběhne vyhledání ve výchozí kategorii, do které zpráva patří.
* Zobrazování navigací – navigační elementy při zobrazení zprávy se zobrazují kontextově podle toho, kde se daná zpráva ve stromu kategorií nachází. Pokud je zpráva ve více kategoriích, opět se jako řídící bere výchozí kategorie, umístění v dalších kategoriích je pro navigace irelevantní a je tímto nástrojem ignorováno.
* Fulltextové hledání – o tom, zda je zpráva viditelná z hlediska fulltextu rozhoduje její zařazení do výchozí kategorie.

Pro stránky platí, že každá stránka patří do právě jedné kategorie ve stromu. Výjimkou je speciální typ stránek, tzv. předlohy. Předlohy mají svoje vlastní kategorie předloh – např. ''Zprávy'', ''Zdroje'' či kategorie předloh pro jednotlivé moduly.

== Strom kategorií a navigace webu ==
Strom kategorií má úzkou vazbu na automatické generování navigačních nabídek. Tato funkčnost je založena na následujícím principu:

[[Image:referencniprirucka-stromkategorii-img016.png|center]]

Strom kategorií se nejprve převádí do XML kódu. Tento kód reflektuje stromovou strukturu kategorií a pro každou kategorii obsahuje následující atributy:

* Lokalizovaný název
* URL (buď URL výchozí stránky kategorie nebo výchozí zprávy nebo URL zadané jako vlastnost kategorie)
* ID kategorie (interní jedinečné číslo)
* Popis
* Úroveň vnoření

Ukázka takového XML kódu je na následujícím obrázku. Pro účely ladění navigací jej lze získat pomocí funkce '''Navigace''' z hlavní nabídky – přejdeme do formuláře pro úpravy definice navigace, poslední položkou formuláře je '''XML kód stromu''' a tlačítko '''Zobrazit'''.

[[Image:referencniprirucka-stromkategorii-img017.png|center]]

Do tohoto kódu se vkládají pouze kategorie, které mají příznak '''Součást navigace'''.

Vlastní HTML kód navigace pak vzniká XSLT transformací XML kódu stromu kategorií, příklady výsledné podoby jsou na následujících obrázcích.

[[Image:referencniprirucka-stromkategorii-img018.png|center]]

[[Image:referencniprirucka-stromkategorii-img019.png|center]]

Příslušné transformace mají k dispozici kromě výše uvedených informací ze stromu kategorií ještě informaci o aktivní kategorii – tou je buď kategorie, ve které se nachází stránka, která se právě generuje, nebo výchozí kategorie, ve které se nachází právě zobrazovaná zpráva. Transformace se vytvářejí v rámci implementace designu. Jedna stránka může používat i více automaticky generovaných navigací – jedná se např. typicky o hlavní svislou navigaci webu, drobečkovou navigaci ale může jít např. i o názvy (element ''<nowiki><title''></nowiki>)'' stránky apod.

== Strom kategorií a přístupová práva ==
Každá kategorie je ve vlastnictví nějakého týmu. Prvotní postup je zpravidla takový, že administrátor založí kategorie v prvních dvou či prvních několika úrovních a následně u zvolených kategorií změní tým na odpovídající tým uživatelů, kteří budou danou kategorii používat.

To, že kategorii vlastní nějaký tým znamená, že uživatelé, kteří jsou v daném týmu v roli editor, mohou měnit vlastnosti této kategorie a vytvářet v ní podkategorie. Týmy tedy touto funkcí dostávají nástroj, jak vytvářet a spravovat vlastní strukturu své části webu.

Práva oblastí na stránkách se primárně odvozují od kategorie, ve které se stránka nachází, neboli od týmu, který tuto kategorii vlastní. Teprve v případě nutných výjimek je třeba nastavit práva pro danou oblast na dané stránce explicitně.

[[Image:referencniprirucka-stromkategorii-img020.png|center]]

Předchozí obrázek zobrazuje právě toto explicitní nastavení práv (záložka '''Práva''' ve vlastnostech stránky). Pokud jsou práva na nějakou oblast na stránce nastavena individuálně, platí pouze toto explicitní nastavení a implicitní práva odvozená od stromu kategorií pozbývají pro tuto oblast na stránce význam.

Dále může ve stromu kategorií platit restrikce na vkládání obsahu do kategorií. Jsou k dispozici následující volby:

* 1 – členové týmů mohou řadit data do libovolných kategorií
* 2 – editoři mohou řadit data do libovolných kategorií, redaktoři jen do těch, do kterých mají přístup
* 3 – členové týmů mohou řadit data jen do těch kategorií, do kterých mají přístup

<div class="note">'''Poznámka''': Toto nastavení se konfiguruje v globálních předvolbách, jedná se o konstantu ''TREE_ACCESS_REGIME''.</div>

== Správa stromu kategorií ==
=== Založení nové kategorie ===

Nová kategorie se zakládá ze stromu kategorií. Vyberte existující kategorii nebo virtuální kořen stromu (nazvaný ''Strom kategorií'') a vyvolejte funkci '''Nová''' (buď pomocí kontextové nabídky volané pravým tlačítkem myši, nebo pomocí tlačítka v horní části záložky '''''Strom kategorií''''').

Zobrazí se formulář pro založení nové kategorie. Povinně se zadává:

* '''Systémový název''' (výchozí hodnota je prázdná)
* '''Nadřazená kategorie''' (výchozí hodnota vyplněná podle předchozí vybrané kategorie, lze ji ale změnit)
* '''Tým''' - zde se nabídka liší podle toho, v jakých je uživatel týmech, administrátor zde má k dispozici všechny týmy, editoři týmů pouze týmy, ve kterých jsou v této roli.

Dále doporučujeme vyplnit tato pole, která nejsou povinná, ale např. kvůli generování navigací či ukládání stránek a souborů je velmi vhodné je pečlivě vyplnit (hned nebo co nejdříve):

* Všechna nastavení, která jsou ve formuláři formou zaškrtávacích okének ('''Fulltextově prohledávat''', '''Součást navigace''', '''Vkládat data''')
* '''Název složky'''
* '''Lokalizovaný název''', resp. lokalizované názvy pro jazyky (je nutné pouze, pokud kategorie patří do navigace, ale je poměrně vhodné jej vyplnit hned, protože toto opomenutí může být zdrojem následných chyb).

Při ukládání formuláře se pak kontroluje jednoznačnost:

* Nelze založit dvě kategorie se stejnou nadřazenou kategorií a stejným systémovým názvem
* Nelze založit dvě kategorie se stejnou nadřazenou kategorií a stejným názvem složky

Pokud kategorie patří do navigace, je třeba buď zvolit výchozí stránku, nebo zadat URL. Formulář toto při zakládání nové kategorie nekontroluje, protože např. stránky v kategorii lze vytvářet, až když kategorie existuje, ale tuto činnost je vhodné provést co nejdříve.

<div class="note">Na webu běžícím v ostrém provozu doporučujeme nejprve založit novou kategorii s nastavením "není součást navigace", pak připravit a vygenerovat výchozí stránku kategorie a teprve v posledním kroku kategorii označit jako patřící do navigace. Jiný postup vede k riziku, že na úplně jiných stránkách webové prezentace dojde k aktualizaci a přegenerování, do automaticky generovaných navigací se zde již může zapojit nově založené kategorie, tato kategorie ale ještě nebude mít funkční odkaz v navigacích a tudíž dojde k vytvoření nefunkčního hypertextového odkazu v nabídce na stránkách.
Tato nežádoucí stavy kromě mnoha dalších vyhledává a vypisuje modul '''Verifikace''' - informujte se v příslušné příručce k modulu.</div>

=== Úprava vlastností existující kategorie ===

Ve stromu kategorií vyberte požadovanou kategorii a vyvolejte funkci '''Vlastnosti''' (buď pomocí kontextové nabídky volané pravým tlačítkem myši, nebo pomocí tlačítka v horní části záložky '''''Strom kategorií'''''). Další postup je stejný jako u založení nové kategorie, změny je třeba potvrdit tlačítkem '''Uložit'''.

=== Smazání kategorie ===

Ve formuláři pro úpravu vlastností kategorie je tlačítko '''Smazat'''. Možnost mazání kategorie je ale omezená, smazat kategorii lze v případě, že na ní nejsou vázané další položky v databázi. Pro mazání tedy platí, že

* Kategorie nesmí mít podkategorie
* Kategorie nesmí obsahovat stránky
* Kategorie nesmí obsahovat zprávy, fragmenty a zdroje
* Neexistují další závislosti (odkazy na kategorii v objektech jako akce, seznamy, moduly apod.)

Přímý datový obsah kategorie naleznete v záložce '''Užití''' formuláře, kde jsou vypsány počty zpráv v kategorii, stránek apod.

=== Přesun kategorie na jiné místo ve stromu ===

Kategorii lze přesunout na jiné místo stromu. Ve formuláři pro úpravy vlastností kategorií použijte tlačítko '''Změnit''' u pole '''Nadřazená kategorie'''. Všechny objekty v přesouvané kategorii (stránky, zprávy apod.) zůstávají, nemění se ani jejich URL. Tato akce je ale umožněna z bezpečnostních důvodů pouze administrátorům WebToDate.

Je zde si třeba uvědomit, že po migraci kategorie na jinou úroveň dojde k tomu, že pro nové objekty (stránky a soubory ve zdrojích) ukládané do migrované kategorie se budou automaticky přidělovat jiná URL, resp. jiná složka. Pokud máme např. kategorii ve třetí úrovni a zakládáme v ní novou stránku, bude výchozí URL ve tvaru

<code>
<nowiki>/složka_první_kategorie/složka_druhé_kategorie/složka_třetí kategorie/stranka.htm</nowiki>
</code>

Pokud tuto kategorii budeme migrovat do jiné části stromu kategorií, tato URL existujících stránek zůstanou beze změny, v případě, že budeme v migrované kategorii zakládat novou stránku, přidělí se jí URL podle toho, jak je aktuálně umístěná, tedy např.

<code>
<nowiki>/složka_jiné_první_kategorie /složka_třetí kategorie/stranka.htm</nowiki>
</code>

Všechna tato URL se automaticky předvyplňují a je možné je ručně měnit, nicméně z hlediska pracnosti je vhodné složky v kategoriích dobře nadefinovat a pak automatické předvyplňování plně využívat.

=== Duplikace kategorie ===

Kategorii lze duplikovat (tlačítko '''Duplikovat''' ve formuláři pro vlastnosti kategorie). Právo duplikovat danou kategorii má buď administrátor, nebo editor týmu, který vlastní kategorii nadřazenou k duplikované kategorii.

Duplikát má následující vlastnosti:

* Systémový název odvozený od systémového názvu duplikované kategorie se stejnou konvencí pojmenovávání duplikátů jako se používá např. u zpráv.
* Stejná nadřazená kategorie jako u duplikované kategorie
* Stejné vlastnosti '''Fulltextově prohledávat''' a '''Vkládat data''' jako duplikovaná kategorie
* Součást navigace nastaveno vždy na ''ne'' (aby se duplikace okamžitě nechtěně neprojevila na veřejných stránkách)
* Stejná priorita jako u duplikované kategorie
* Název složky odvozený od názvu složky duplikované kategorie se stejnou konvencí pojmenovávání duplikátů jako se používá např. u zpráv (v případě, že je prázdný u duplikované kategorie, zůstává prázdný i u duplikátu)
* Z jazykově závislých vlastností stejné lokalizované názvy, popisy, výchozí předlohy a URL jako u duplikované kategorie (doslovně stejné bez přejmenovávání)
* Výchozí stránky vždy prázdné

== Režimy zakládání kategorií ==
=== Zjednodušený režim zakládání výchozích stránek ===

Z výše popsaných funkcí vyplývá, že možný postup je ten, že v případě, že chce uživatel založit na webu novou rubriku, tak

* Založí novou kategorii ve stromu kategorií
* Založí novou stránku v této kategorii a označí ji jako výchozí
* Vybere této stránce nějakou šablonu
* Přiřadí na stránku nějaké objekty (zprávy, seznamy, navigace) a vygeneruje.

Kromě této výše popsané možnosti zakládání stránek ovšem existuje zjednodušená varianta. Funkce je orientovaná především na intranetová nasazení, která mají relativně bohatou hierarchii stromu webu a kde stránky v jednotlivých uzlech stromu kategorií vypadají podobně nebo stejně a mají stejnou strukturu. V maximálně možné zjednodušené variantě jde o následující postup:

* Editor založí novou rubriku (tedy nějaký nový uzel stromu kategorií)
* Do tohoto uzlu se začnou vkládat nějaké zprávy
* Uživatelé nic dalšího nebudou dělat, tedy odkaz na novou rubriku se objeví v navigačním menu, rubrika bude mít svou stránku a na ní se zobrazí zprávy do rubriky vložené.

Funkce logicky musí založit ''výchozí stránku'' pro danou kategorii. Tato stránka má řadu vlastností, které je třeba nastavit. V zjednodušeném režimu zakládání položek stromu kategorií se toto provede automaticky s využitím výchozích nastavení definovaných globálně administrátorem, vždy lze ovšem přejít do pokročilejšího režimu, kde se všechny vlastnosti nastavují manuálně.

Na následujícím obrázku jsou znázorněny automaticky spouštěné funkce při použití zjednodušeného režimu.

[[Image:referencniprirucka-stromkategorii-img021.png|center]]

Zjednodušený režim nastavuje pro zakládané stránky automaticky zejména následující vlastnosti:

* Název stránky
* URL stránky
* Šablonu stránky
* Označení stránky jako výchozí
* Práva na oblasti
* Jazyk a značkovací jazyk
* Přiřazení některých objektů na oblasti (zejména seznamů a navigací, případně fragmentů)

Výsledkem by měla být plně funkční stránka připravená k publikaci – typicky se zvolí připravená univerzální šablona a přiřadí se na ni připravený seznam zobrazující zprávy v dané kategorii, pokud je takto založená stránka navíc zobrazovaná dynamicky, může okamžitě zobrazovat publikované zprávy v dané rubrice.

Celý proces je jednoduché používat, je třeba ale věnovat značnou pozornost konfiguraci pomocí globálních předvoleb, aby bylo dosaženo požadovaného výsledku.

=== Použití zjednodušeného režimu uživatelem ===

Ve formuláři pro založení nové kategorie zvolte jeden ze zjednodušených režimů. Lze spustit zjednodušený režim, který zakládá výchozí stránku pouze pro výchozí jazyk, nebo pro všechny jazyky.

[[Image:referencniprirucka-stromkategorii-img022.png|center]]

Přinejmenším ve druhém případě je třeba provést zpětnou kontrolu výsledku - např. pro lokalizované názvy kategorií se použije zadaný systémový název, což může být v pořádku pro jeden jazyk, ale nikoliv pro více jazyků.

Po volbě některého ze zjednodušených režimů se zobrazí stejný formulář jako v případě pokročilého režimu. Ve formuláři se typicky vyplní následující položky:

* Systémový název
* Lokalizovaný název
* Název složky
* Všechna zaškrtávací okénka se zpravidla ponechají zaškrtnutá

Pro volbu ''Zjednodušený režim – výchozí jazyk'' je toto většinou postačující, v rámci založení kategorie se založí i výchozí stránka a přiřadí se na ní objekty dle nastavení.

Pro volbu ''Zjednodušený režim – všechny jazyky'' je třeba se vrátit zpět do vlastností kategorie a doplnit další lokalizované názvy pro další jazyky. Dále je vhodné pro každý jazyk nastavit pole ''Výchozí předloha'' – pro vícejazyčné prezentace je vhodné výchozí předlohy pro zprávy rozlišovat na úrovni stromu kategorií, nikoliv na úrovni publikací.

Pokud se funkci nepodaří některou stránku založit, zobrazí se informační hlášení o této skutečnosti. Důvodem je zpravidla nevyhovující nastavení v globálních předvolbách. Neobsahuje-li např. ani jedna konstanta, pomocí kterých se definují URL automaticky zakládaných stránek klíčové slovo pro kód jazyka a přitom je použit ''Zjednodušený režim – všechny jazyky'', nepodaří se založit více než jednu stránku, protože by takto více stránkám bylo přiřazeno stejné URL, což ve WebToDate není možné.

=== Proces zjednodušeného režimu založení výchozí stránky ===

Proces zjednodušeného zakládání výchozích stránek se spouští, pokud jsou splněny následující podmínky (názvy konstant jsou z konfiguračního souboru ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate|global.php]]''):

* Uživatel zakládající novou kategorii tuto možnost ve formuláři při zakládání nové kategorie zvolil (pokud je konstanta NEW_CATEGORY_REGIME nastavená na 0, nelze tuto možnost zvolit)
* Kategorie není v nejvyšší úrovni vnoření, tj. má existující nadřazenou kategorii
* Je zvolena vlastnost '''Vkládat data''' pro tuto kategorii

Proces lze spustit jen při zakládání nové kategorie, nikoliv pro existující kategorii.

Na proces automatického zakládání stránek mají vliv následující parametry:

* Konstanta NEW_CATEGORY_REGIME – neovlivňuje vlastní algoritmus, ale to, zda jsou příslušné radiopřepínače pro tuto volbu vůbec ve formuláři přítomny a jaké je jejich výchozí nastavení.
* Konstanta NEW_CATEGORY_PAGE_NAME – slouží k vytvoření cesty k výchozí stránce, konkrétně definuje název souboru (při výchozím nastavení "default.htm")
* Konstanta NEW_CATEGORY_PAGE_PATH – slouží k vytvoření cesty k výchozí stránce, konkrétně definuje tvar celé cesty bez názvu souboru
* Konstanta NEW_CATEGORY_PAGE_PROTOTYPE – definuje, kterou stránku ve stromu nadřazených kategorií si algoritmus vezme jako vzor
* Konstanty NEW_CATEGORY_PAGE_FRAGMENTS, NEW_CATEGORY_PAGE_LISTS a NEW_CATEGORY_PAGE_NAVIGATIONS – definují, co se na výchozí stránku automaticky přiřazuje

Proces probíhá v následujících krocích:

# Zakládá se nová stránka, která bude označena jako výchozí
# Přiřazují se požadované objekty na stránku
# Stránka se generuje

V prvním kroku dochází k zakládání stránky, kde se automaticky stanovuje řada parametrů stránky a vlastností kategorie závislých na jazyku:

{| class="prettytable"
| Název stránky
| Systémový název zakládané kategorie + mezera + zkratka jazyka

|-
| Titulek stránky
| prázdný

|-
| URL stránky
| URL sestavené podle konfiguračních parametrů NEW_CATEGORY_PAGE_PATH a NEW_CATEGORY_PAGE_NAME - oba parametry se spojí a vznikne kompletní URL stránky, např. "/prezentace/ceniky/default.htm".

|-
| Kategorie stránky
| Kategorie, která je právě zakládaná

|-
| Jazyk
| Odpovídající jazyk

|-
| Značkovací jazyk
| První v seznamu značkovacích jazyků (podle výchozí instalace ''HTML'')

|-
| Šablona
| Stejné jako u vzorové stránky

|-
| Umístění
| Stejné jako u vzorové stránky

|-
| Server
| Stejné jako u vzorové stránky

|-
| Lokalizovaný název kategorie
| Systémový název zakládané kategorie

|-
| Výchozí předloha kategorie
| Stejné jako u vzorové kategorie

|-
| Popis kategorie
| prázdný

|-
| URL kategorie
| prázdný

|}

V druhém kroku se na stránku přiřazují objekty. Platí následující:

* Objekty se řadí na stránky na stejné oblasti a pod stejným stylem (a dalšími nastaveními jako priorita či staticky / dynamicky) jako na vzorové stránce.
* Pokud je konstanta NEW_CATEGORY_PAGE_FRAGMENTS = 1, vkládají se stejné fragmenty, jako jsou na vzorové stránce.
* Pokud je konstanta NEW_CATEGORY_PAGE_LISTS > 0, vkládají se seznamy dle vzorové stránky. Je-li hodnota této konstanty 2, vkládají se všechny seznamy podle vzorové stránky, pokud je hodnota této konstanty 1, vkládají se jen ty, které jsou parametrizované podle kategorie stránky, na které se nacházejí.
* Pokud je konstanta NEW_CATEGORY_PAGE_NAVIGATIONS = 1, přiřazují se na stránku navigace se stejným nastavením jako u vzorové stránky.

Třetím krokem je vygenerování založené stránky

Přístupová práva k oblastem algoritmus nijak nenastavuje, což v praxi znamená, že přístupová práva ke všem oblastem na vytvořené stránce bude mít tým, který vlastní založenou kategorii.

=== Výběr vzorové stránky ===

Celá možnost nasazení této funkčnosti závisí na tom, zda lze globálně stanovit, jak má systém najít stránku, která bude sloužit jako vzor pro automaticky zakládané stránky.

Pro volbu vzorové stránky při automatickém zakládání nové stránky slouží konstanta

<code>
<nowiki>define( 'NEW_CATEGORY_PAGE_PROTOTYPE', 0 );</nowiki>
</code>

Možné hodnoty této konstanty jsou:

* 0 – za vzor pro automatické zakládání výchozích stránek slouží přímo nadřazená kategorie
* Celé kladné číslo - za vzor pro automatické zakládání výchozích stránek slouží nadřazená kategorie v dané úrovni vnoření, 1= nejvyšší úroveň, 2 = druhá nejvyšší úroveň atd.

Výchozí hodnota pro novou instalaci je 2.

To znamená, že proces automatického zakládání hledá zásadně vzorovou stránku v kategoriích, které jsou nadřazené právě zakládané kategorii, pomocí konfigurační konstanty lze definovat globální pravidlo, která z nadřazených kategorií to bude, pravidlo se přitom odvíjí od vnořování těchto kategorií.

== Veřejná a privátní zóna ==
Ačkoliv tento pojem přímo nesouvisí se stromem kategorií, ale spíše s objekty do stromu ukládanými (konkrétně se stránkami a soubory ve zdrojích), je vhodné tyto termíny vysvětlit již v této kapitole.

Termín '''''zóna '''''znamená způsob uložení souboru. Veřejná zóna je část diskového prostoru www serveru, která je přímo přístupná přes virtuální adresáře serveru ve veřejné části a všechny soubory, které se zde nacházejí, jsou automaticky přístupné všem anonymním uživatelům. Založíme-li tedy stránku např. s URL ''/adresar/stranka.htm'' ve veřejné zóně, znamená to, že skutečně fyzicky je takovýto soubor vytvořen v odpovídající složce hned pod kořenovým adresářem webu a je okamžitě přístupný všem anonymním návštěvníkům webu a jeho plná URL adresa je ''www.server.cz/adresar/stranka.htm''.

Pokud ovšem u stránky zvolíme, že je umístěná v privátní zóně a zadáme URL ve tvaru ''/adresar/stranka.htm'', soubor je sice vytvořen v zadané složce, ale v úplně jiné adresářové struktuře WebToDate, která je umístěna mimo přímo přístupné virtuální adresáře www serveru. V důsledku to znamená, že URL adresa ''www.server.cz/adresar/stranka.htm'' neexistuje, místo toho se stránka zobrazuje pomocí prezentačního skriptu na adrese ''www.server.cz/scripts/detail.php?pgid=xxx'', kde xxx je ID stránky. Analogicky toto platí i pro soubory, pouze místo prezentačního skriptu ''detail.php'' se používá skript ''file.php''.

Umístění do veřejné zóny tedy znamená následující:

* Soubory (tj. soubory ve zdrojích a generované stránky) jsou okamžitě po vytvoření v systému dostupné všem anonymním návštěvníkům.
* Ve veřejné zóně nelze zajistit, aby k souboru měla přístup jen omezená skupina uživatelů
* Stahování z veřejné zóny (HTML stránky či jiného typu souboru) je velmi rychlé, protože se jedná o statické soubory, které se na straně www serveru nijak nezpracovávají.

Umístění do privátní zóny naopak znamená:

* Soubory v privátní zóně nejsou automaticky přístupné anonymním návštěvníkům
* Lze zajistit, aby je mohla zobrazit či stahovat jen omezená skupina registrovaných uživatelů (tuto problematiku řeší rozšiřující moduly [[../../Neveřejná část|Neveřejná část]] a [[../../Registrace a personalizace|Registrace a personalizace]])
* Stahování z veřejné zóny je pomalejší, protože neběží přímo, ale přes prezentační PHP skripty.

V globálních předvolbách WebToDate lze navíc zvolit chování vůči souborům v ještě nepublikovaných zdrojích. Pokud není zdroj ve stavu ''Publikováno'' a obsahuje nějaké soubory, lze globálně navolit, zda se tyto soubory umístí nejprve do privátní zóny (přestože uživatel zvolil veřejnou zónu) a teprve v momentě publikace zdroje se do veřejné zóny přesunou, nebo jsou do veřejné zóny umístěny ihned (tj. může je teoreticky kdokoliv stáhnout, přestože nejsou ještě označeny za publikované).

Způsob práce s veřejnou a privátní zónou je třeba předem pečlivě zvážit a nakonfigurovat. Pokud jsou položky umístěny do privátní zóny, je obecně větší kontrola nad možností tyto položky stahovat, ale stahování je náročnější na systémové zdroje.

Jak pro stránky, tak pro soubory ve zdrojích lze nakonfigurovat i možnost výběru vzhledem k uživatelům - lze např. privátní zónu úplně vypnout nebo naopak vynutit ukládání všech souborů do privátní zóny nebo ponechat tuto volbu na uživateli. Více viz kapitola [[../Konfigurace WebToDate#Globální konfigurace WebToDate|Globální konfigurace WebToDate]].

== Možnosti konfigurace funkčnosti stromu kategorií ==
Základní chování stromu kategorií lze ovlivnit nastaveními v globálním konfiguračním souboru WebToDate ''[[../Konfigurace WebToDate#Globální konfigurace WebToDate|global.php]]''. Přehled těchto možností je v následující tabulce.

{| class="prettytable"
| Přístupová práva ke stromu webu
| Lze přepnout režim kontroly řazení zpráv do stromu s následujícími možnostmi:

*Členové týmů mohou řadit do libovolných kategorií
*Editoři mohou řadit do libovolných kategorií, redaktoři jen do těch, do kterých mají přístup
*Členové týmů mohou řadit jen do kategorií, do kterých mají přístup

Lze zvolit, zda uživatelé v roli editor mají možnost zakládat nové podkategorie kategorií, které patří týmům, v nichž jsou členy.

|-
| Zjednodušený režim tvorby stránek
| Pro interface zakládání kategorií lze nastavit výchozí volbu pro zakládání stránek:

*Pokročilý režim
*Zjednodušený režim – výchozí jazyk
*Zjednodušený režim – všechny jazyky
*Pro způsob zakládání výchozích stránek lze nastavit:
*Název souboru pro výchozí stránku (standardně ''default.htm'')
*Způsob výchozího sestavování cesty ke stránkám
*Odvozovat šablony a přiřazení objektů od přímo nadřazené kategorie / nejvyšší nadřazené kategorie
*Automaticky přidat na oblasti podle vzoru všechny fragmenty
*Automaticky přidat na oblasti podle vzoru všechny seznamy / seznamy parametrizované podle kategorie / žádné seznamy
*Automaticky přidat na stránku podle vzoru navigace

|-
| Předlohy pro zprávy
| Lze nastavit, zda se při zobrazení zprávy jako výchozí objekt pro nalezení předlohy bere výchozí kategorie zprávy nebo publikace jako předchozích verzích WebToDate.

|-
| Veřejná a privátní zóna pro stránky
| Lze nastavit název podadresáře adresáře ''offlinedata'', do kterého se ukládají stránky v privátní zóně. Lze nastavit výchozí volbu ukládání stránek (výběr veřejné či privátní zóny).

|}

Podrobný popis konfiguračních konstant naleznete v kapitole [[../Konfigurace WebToDate#Globální konfigurace WebToDate|Globální konfigurace WebToDate]].

== Strom kategorií a jazykové verze ==
Strom kategorií obsahuje podporu vícejazyčných webů. Tato podpora spočívá v následujícím:

* Každá kategorie má lokalizované názvy pro všechny jazykové mutace.
* Každá kategorie dovoluje specifikovat URL pro navigace pro každý jazyk zvlášť (buď výchozí stránku nebo přímo zadané URL).
* Při generování navigace se použije jazykové varianta navigace podle jazyka generované stránky či zobrazované zprávy.

Pokud tedy máte více jazykových mutací webu ve stejné struktuře, doporučujeme vytvořit jeden strom kategorií pro všechny jazyky, definovat všechny jazykově závislé vlastnosti kategorií a jazykové verze zpráv či stránek ukládat vždy do stejného uzlu stromu.

Nic ovšem nebrání tomu, aby byl pro každý jazyk založen jiný strom kategorií (resp. jiná část stromu). Tuto variantu použijte v případě, že jednotlivé jazykové mutace mají odlišnou strukturu prezentace (a patrně i odlišný rozsah apod.). Pak platí následující:

* Na úrovni XSLT transformací bude nutné zajistit, aby se na stránkách generovaly odpovídající navigace. Pro každou jazykovou mutaci bude patrně třeba vytvořit jiné transformace, které berou v potaz jen odpovídající větev stromu kategorií.
* Jazykové verze zpráv a stránek nejsou omezeny v tom, že by se musely nacházet ve stromu kategorií na stejném místě. Umístění jazykových verzí těchto objektů je libovolné.
* Pokud je v dané implementaci plánované fulltextové hledání pouze v daném jazyce, není třeba tento problém nijak řešit v souvislosti se stromem kategorií, jazyk je vlastnost zprávy, se kterou vyhledávací modul pracuje bez ohledu na strom kategorií.

WebToDate/Struktura databáze/Hlavní databázové tabulky systému WebToDate

2013-01-22T10:21:50Z

Jakubn:

[[Category:WebToDate Struktura databáze]]
[[Category:Struktura databáze]]
== NEWSADS ==
Tabulka obsahuje kódy bannerů použitých systémem WebToDate.

Smyslem kódů je, aby byly schopny zobrazit konkrétní reklamní banner pro různé články, užívající stejnou šablonu, v závislosti na obsahu článku.

* ID – identifikátor záznamu
* NAZEV – název banneru
* KATEGID – odkaz na tabulku NEWSADSKATEG
* KOD – HTML kód banneru

== NEWSADSKATEG ==
Tabulka definuje seznam kategorií, které mohou být použity pro kategorizaci bannerů z tabulky NEWSADS. Kategorizace slouží pouze pro vnitřní rozdělení bannerů.

* KATEGID – identifikátor záznamu
* KATEGNAME – název kategorie

== NEWSADSRULES ==
Tabulka uchovává pravidla pro zobrazování bannerů na jednotlivých stránkách.

* ID – identifikátor záznamu
* STRANAID – identifikátor stránky (odkaz na tabulku NEWSPAGE)
* POZICE – identifikátor pozice
* KATEGID – identifikátor kategorie (odkaz na tabulku NEWSKATEG)
* PUBLID – identifikátor publikace, ke které je článek přiřazen (odkaz na tabulku NEWSPUBL)
* JAZYKID- identifikátor jazyka (odkaz na tabulku NEWSLANGUAGE)
* BANNERID – identifikátor banneru (odkaz na tabulku NEWSADS)

== NEWSAKCE ==
Tabulka uchovává parametry Akcí (seznamů jednotlivých úkonů, jako např. přidání článků do stránky ).

* ID – identifikátor záznamu
* NAZEV – název Akce
* TYP – typ Akce (přidat / odstranit)
* STRANAID – identifikátor Stránky, se kterou má Akce pracovat (odkaz na tabulku NEWSPAGE)
* TYPID – identifikátor Oblasti, se kterou má Akce pracovat (odkaz na tabulku NEWSTYP)
* DNI – počet dní (stáří článků, kterých se Akce týká; 0 = dnešní články)
* SKUPINAID – identifikátor Skupiny zpráv, se kterou má Akce pracovat (odkaz na tabulku NEWSSKUPINA)
* PUBLID – identifikátor Publikace, se kterou má Akce pracovat (odkaz na tabulku NEWSPUBL)
* KATEGID - identifikátor Kategorie, se kterou má Akce pracovat (odkaz na tabulku NEWSKATEG)
* MAXZPRAV – maximum zpráv, které budou přidány do Stránky (má smysl jen pokud jde o přidávací akci).

== NEWSATTACHLISTS ==
Tabulka uchovává seznamy příloh

* ID – identifikátor záznamu
* NAME – název seznamu příloh

== NEWSCONN ==
Tabulka definuje propojení mezi Články a Stránkami, určuje, který Článek je připojen ke které Stránce.

* ID – identifikátor záznamu
* TYPID – identifikátor Oblasti (odkaz na tabulku NEWSTYP)
* LAYOUTID – identifikátor Stylu (odkaz na tabulku NEWSLAYOUT)
* PRIORITA - priorita
* STRANAID – identifikátor Stránky (odkaz na tabulku NEWSPAGE)
* OBJECT – určuje, zda je objekt umístěný do stránky Článek nebo Seznam

1.. objekt je Článek, 2.. objekt je Seznam, 3.. objekt je Navigace

* GENEROVAT – volba určuje, zda je objekt umístěný do Stránky staticky nebo dynamicky
* NEWSID – identifikátor Článku (odkaz na tabulku NEWSDB)
* LISTID – identifikátor Seznamu (odkaz na tabulku NEWSPROPOJENI)
* NAVIGID – identifikátor Navigace (odkaz na tabulku NEWSNAVIG)

== NEWSCONVRULES ==
Tabulka uchovává nastavení konverzních pravidel pro zdroje.

* ID – identifikátor záznamu (generované s využitím tabulky NEWSIDGEN)
* NAME – název pravidla
* FILEKIND – druh souboru (obrázek, video, audio, zip archív, externí)
* FILETYPE – přípona souboru
* RULEKIND – druh pravidla (automatická, volitelná nebo ručně spouštěná konverze)
* OPTARGET – cíl konverze
* OPCOND – podmínka konverze
* OPPARS – další parametry konverze

== NEWSDB ==
Tabulka uchovává data jednotlivých článků.

* ID – identifikátor záznamu (generované s využitím tabulky NEWSIDGEN)
* NADPIS – název Zprávy - povinný
* ABBREV – zkratka, používána k odkazování na Zprávu přes URL
* LINKNADPIS – URL odkaz na detailní stránku se Zprávou
* POPIS – popis Zprávy
* TELO – tělo Zprávy. Pokud jsou Zprávy uloženy v jednotlivých souborech, pole POPIS a TELO mají hodnotu NULL.
* OBRAZEK – odkaz na soubor s případným obrázkem ke Zprávě
* ALTOBRAZEK – popisek k obrázku
* DATUM – datum vytvoření Zprávy
* DATUMPUBL – datum a čas publikování Zprávy
* DATUMEXP – datum a čas expirace Zprávy
* DATUMACT- automaticky doplňované datum a čas poslední úpravy Zprávy
* LINKPOPIS – volitelné; URL odkaz popisu
* PODTEXT – volitelné; doplňující text zprávy, např. zápatí
* LINKPODTEXT – volitelné; URL odkaz podtextu
* KATEGID – identifikátor Kategorie (odkaz na tabulku NEWSKATEG)
* CAS – čas vytvoření Zprávy
* DETAILPAGE – identifikátor Detailní stránky (odkaz na tabulku NEWSPAGE)
* DYNAMIC_BR – určení, zda při zobrazení detailní stránky nahrazovat konce řádků za určený HTML tag
* CESTA – relativní cesta k souboru s textem Zprávy
* PUBLID – identifikátor Publikace (odkaz na tabulku NEWSPUBL)
* VYDANIID – číslo vydání (volitelné)
* STRANA – číslo strany (např. novinová stránka)
* RUBRIKA – název rubriky
* JAZYKID – identifikátor jazyka (odkaz na tabulku NEWSLANGUAGE)
* AUTOR – jméno autora
* AUTORID – identifikátor autora; identifikátor není používán
* KOREKTURA – status Zprávy (3=Vloženo / 6=Ke schválení / 2=Schváleno / 1=Publikováno / 4=Odloženo / 5=Vypršelo / 7=Archivováno)
* POZNAMKA - poznámka
* ISTABLE – používá se v rámci některých importních modulů a vyznačuje tabulku
* IDAUX – pomocný identifikátor (pro import)
* PRIORAUX – pomocná priorita (pro import)
* GROUPID – identifikátor týmu uživatelů, do kterého patří uživatel, který Zprávu do systému vložil (odkaz na tabulku NEWSUSERGROUPS)
* LOCKED – status uzamčení Zprávy
* LOCKUSERID – identifikátor uživatele, který Zprávu uzamkl (odkaz na tabulku NEWSUSERPERSONS)
* LOCKDATE – datum a čas uzamčení Zprávy
* USERID – identifikátor uživatele, který Zprávu vložil
* HTMLFRAGMENT – určuje, zda se jedná o Fragment (1) ,Zprávu (0), nebo Zdroj (2)
* VERSIONID – číslo verze zprávy
* PREVVERREF – identifikátor předchozí verze zprávy
* VARDOCID – identifikátor variabilní struktury zprávy
* VARDOCXML – variabilní struktura zprávy ve formě XML
* URLLOCK – zámek odkazu nadpisu (true=nemá se automaticky přegenerovat)

== NEWSDBLANG ==
Tabulka uchovává vztahy mezi Zprávami se stejným obsahem, ale v různých jazycích.

* SKUPINAID – identifikátor skupiny se stejným obsahem (podle tabulky NEWSIDGEN)
* ZPRAVAID – identifikátor Zprávy (odkaz na tabulku NEWSDB)
* JAZYKID – identifikátor jazyka (odkaz na tabulku NEWSLANGUAGE)

== NEWSDBVAR ==
Tabulka uchovává pole variabilní struktury pokud se používá nastavení ukládání těchto polí do databáze

* NEWSID – identifikátor Zprávy (odkaz na tabulku NEWSDB)

Další pole tabulky odpovídají polím variabilní struktury zpráv definovaných v administračním rozhraní WebToDate

== NEWSDBVIEWS ==
Tabulka definuje, jaký pohled se bude užívat pro zobrazení které Zprávy.

* ZPRAVAID – identifikátor Zprávy (odkaz na tabulku NEWSDB)
* POHLEDID – identifikátor Pohledu (odkaz na tabulku NEWSVIEWS)

== NEWSFILES ==
Tabulka pro ukládání souborů patřících ke zdrojům

* ID – identifikátor záznamu
* NEWSID - odkaz na záznam s metadaty zdroje (NEWSDB.ID)
* FILEVERSIONID - číslování závislé na zdroji. Čísla musí být unikátní pro dané NEWSID.

(1= master, 2=náhled, číslování dalších souborů začíná od 101)

* FILENAME - název uloženého souboru (např. obrazek1.jpg)
* FILEPATH - relativní cesta k souboru
* FILETYPE - typ souboru (koncovka převedená na malá písmena), např. jpg
* FILESIZE - velikost souboru v B
* FILEWIDTH - šířka obrázku
* FILEHEIGHT - výška obrázku
* TARGETLOCATION - cíl uložení (1=veřejná zóna, 2=privátní zóna, 10=externí soubor); výchozí hodnota 1
* CURRENTLOCATION - kde je soubor aktuálně uložen: 1 = veřejná zóna, 2 = privátní zóna v souborovém systému, 3 = privátní zóna v databázi, 10=externí soubor
* FILEBIN - BLOB pole pro uložení vlastního souboru
* EXTERNALURL – URL externího souboru

== NEWSFILETYPES ==
Konfigurační tabulka typů souborů

* ID– identifikátor záznamu
* FILETYPE - typ souboru (koncovka převedená na malá písmena), např. jpg
* CREATETHUMB - pokud je zde hodnota true, spouští se funkce na vytvoření náhledu
* ICONFILE - název souboru s ikonou (např. jpeg.gif)
* MIME - MIME typ pro daný typ souboru

== NEWSIDCONN ==
Tabulka uchovává informace o propojení zpráv pomocí ručního vypsání seznamu souvisejících ID.

* ZPRAVAID – identifikátor primární Zprávy (odkaz na tabulku NEWSDB)
* NEWSID – identifikátor souvisejících Zpráv

== NEWSIDGEN ==
Tabulka slouží jako generátor číselných sekvencí. Je používána pro číslování Zpráv, Publikací ,Vydání a dalších tabulek.

* DBID – identifikátor sekvence
* NEXTID – následující použitelné číslo
* POPIS – název tabulky, ke které se sekvence vztahuje (jen k informativním účelům)

== NEWSIMPRESSIONS ==
Tabulka je určena k uchovávání záznamů o přístupech k jednotlivým článkům.

* ZPRAVAID – identifikátor Zprávy (odkaz na tabulku NEWSDB)
* DATUM – datum přístupu ke Zprávě
* IMPRESSIONS – počet přístupů ke Zprávě za daný den
* SUMMARIZED – určuje, zda jsou data sumarizována v tabulce NEWSIMPSUM

== NEWSIMPSUM ==
Tabulka uchovává sumarizace přístupů (nezávisle na datu přístupu).

Data jsou z tabulky NEWSIMPRESSIONS sumarizována úlohou Sumarizace počtu shlédnutí spouštěnou z plánovače úloh.

* ZPRAVAID – identifikátor Zprávy (odkaz na tabulku NEWSDB)
* IMPRESSIONS – celková počet přístupů ke Zprávě

== NEWSINSTANCE ==
Tabulka instancí souborů ve zprávách

* ID - interní číslování záznamů
* NEWSID - ID zprávy, ke které instance patří (NEWSDB.ID)
* FILEID - ID souboru, který vystupuje v dané instanci (NEWSFILES.ID)
* LAYOUTID - ID stylu, kterým je formátována instance (NEWSLAYOUT.ID)
* ALISTID - ID druhu seznamu příloh (NEWSATTACHLISTS.ID)
* DDEFAULT - true znamená, že se jedná o výchozí dokument, pro stejné NEWSID může mít pouze jeden záznam hodnotu true.
* PRIORITY - priorita určující pořadí v seznamu příloh ke zprávě v případě, že přílohy mají definováno ručně pořadí

== NEWSIPBLACKLIST ==
Tabulku používá implementace blokování přístupů do redakční části (blacklist)

* LDATE – datum a čas pokusu
* IP – IP adresa

== NEWSKATEG ==
Definice stromu kategorií

* ID - číslování záznamů
* NAZEV - systémový název
* FULLTEXTSEARCH - kategorii fulltextově prohledávat, výchozí hodnota true
* PARENTID - ID nadřazené kategorie (ukazuje na NEWSKATEG.ID)
* TREEID - pomocné číslování pro strom
* FOLDERNAME - název složky pro kategorii
* PRIORITY - priorita
* GROUPID - ID týmu vlastnícího danou kategorii (NEWSUSERGROUPS.ID)
* ALLOWDATA - lze vkládat data, výchozí hodnota true
* ALIASID - rezervováno pro budoucí použití, v této verzi se pevně vkládá výchozí hodnota NULL
* CUSTSTRING1 - zákaznický řetězec, výchozí hodnota NULL
* CUSTINT1 - zákaznické číslo, výchozí hodnota NULL

== NEWSKATEGCONN ==
Tabulka obsahuje řazení zpráv do kategorií

* NEWSID - ID zprávy v dané kategorii (NEWSDB.ID)
* KATEGID - ID kategorie, do které zpráva patří (NEWSKATEG.ID)
* TREEID - Pomocné číslování pro strom

== NEWSKATEGLOC ==
Tabulka obsahuje jazykově závislé vlastnosti kategorií

* ID - číslování záznamů
* KATEGID - ID kategorie (NEWSKATEG.ID), ke které jazykové vlastnosti patří
* LANGUAGEID - ID jazyka (NEWSLANGUAGE.ID), ke kterému se vlastnosti vztahují
* NAME - lokalizovaný název kategorie
* DESCRIPTION - popis
* DEFAULTPAGEID - ID výchozí stránky pro daný jazyk (NEWSPAGE.ID)
* URL - URL kategorie
* DEFAULTPATTERNID - ID výchozí předlohy pro daný jazyk (NEWSPAGE.ID)
* NAVIGATION - kategorie patří do navigací, výchozí hodnota true

== NEWSKEYWCONN ==
Tabulka definuje propojení mezi klíčovými slovy a Zprávami.

* ZPRAVAID – identifikátor Zprávy (odkaz na tabulku NEWSDB)
* KEYWID – identifikátor Klíčového slova (odkaz na tabulku NEWSKEYWORDS)

== NEWSKEYWORDS ==
Tabulka uchovává jednotlivá klíčová slova ke článkům.

Každé Klíčové slovo je uloženo pouze jednou a je převedono na malá písmena.

* ID – identifikátor záznamu
* KEYWORD – klíčové slovo

== NEWSLANGUAGE ==
Tabulka uchovává seznam jazyků. Každá Zpráva musí mít nastavenou hodnotu parametru Jazyk.

* ID – identifikátor záznamu
* NAZEV – název jazyka
* LOCALE – dvouznaková zkratka jazyka (Microsoft konvence; CS=česky, EN=anglicky)

== NEWSLAYOUT ==
Tabulka se Styly. Styly jsou části HTML kódu používající databázová pole Zpráv. Ta jsou při generování dané stránky nahrazována odpovídajícími hodnotami.

* ID – identifikátor záznamu
* NAZEV – název Stylu
* HLAVICKA – hlavička Stylu. Pokud je Styl použit na jednotlivé Články, hlavička je aplikována na každý Článek. Pokud je použit na Seznam článků a je povolené dělení do sekcí, hlavička je aplikována na každou sekci Seznamu (příp. jen na začátek Seznamu, pokud v něm žádně sekce nejsou nebo není dělení do sekcí povolené)
* TELO – tělo Stylu
* PATICKA – patička Stylu. Funkčnost je obdobná jako u pole HLAVICKA.
* SECTIONBEGIN – kód vkládaný na začátek každé sekce Seznamu
* SECTIONEND – kód vkládaný za každý konec sekce Seznamu
* LSEPARATOR – oddělovač jednotlivých Zpráv v Seznamu
* NAPOVEDA – nápověda, popiska pro Styl
* PATTERNID – identifikátor Předlohy

== NEWSLISTSPAGING ==
Tabulka obsahuje seznam definic stránkovacích lišt

* ID - identifikátor záznamu
* OBJNAME - pojmenování stránkovací lišty
* IS_DEFAULT - příznak, zda se jedná o výchozí stránkovací lištu

== NEWSLISTSPAGINGLOC ==
Tabulka obsahuje definice stránkovacích lišt v závislosti na jazyce

* PAGING_ID - ID stránkovací lišty v NEWSLISTSPAGING
* LANG_ID - ID jazyka
* TITLE - definice uvozujícího nadpisu
* LINK_PREV - definice položky ''Předchozí'' ve stránkovací liště
* LINK_NEXT - definice položky ''Následující'' ve stránkovací liště
* HEADER - definice hlavičky lišty
* FOOTER - definice patičky lišty
* PAGE_NUMBER - definice položky ''Číslo stránky'' ve stránkovací liště
* PAGE_ACTIVE - definice položky ''Aktivní stránka'' ve stránkovací liště
* LINK_SEPARATOR - definice položky ''Separátor'' ve stránkovací liště
* PAGE_COUNT - počet stránek ve stránkovací liště

== NEWSLISTSUSAGE ==
Tabulka obsahuje informace, která Zpráva je zobrazen na které Stránce pomocí statického Seznamu.

* ZPRAVAID – identifikátor Zprávy (odkaz na tabulku NEWSDB)
* STRANAID – identifikátor Stránky (odkaz na tabulku NEWSPAGE)

== NEWSLOGINHIST ==
Tabulka uchovává historii pokusů o přihlášení se k redakční části systému.

* ID – identifikátor záznamu
* LOGINDATE – datum a čas pokusu
* IP – IP adresa, odkud byl pokus proveden
* USERNAME – uživatelské jméno
* LOGGEDIN – určuje, zda bylo přihlášení úspěšné

== NEWSMIME ==
Tabulka obsahuje seznam MIME typů a jejich hlaviček. Ty jsou používány např. skriptem detail.php při zobrazení pomocí WML šablony.

* ID – identifikátor záznamu
* NAZEV – název typu pro administrační rozhraní
* MIME – MIME typ, např. text/html
* ZKRATKA – standardní souborová přípona (např. html, wml)

== NEWSNAVIG ==
Tabulka definuje navigace

* ID - interní číslování záznamů
* NAME - název navigace
* DESCRIPTION - popis navigace
* TRANSFORMID - která transformace se pro tuto navigaci používá (NEWSTRANSFORM.ID)

== NEWSNAVIGCACHE ==
Tabulka slouží pro cachování HTML kódů navigací

* ID - interní číslování záznamů
* TRANSFORMID - která transformace se pro tuto navigaci používá (NEWSTRANSFORM.ID)
* XMLHASH – hash XML kódu
* HTMLCODE - vygenerovaný HTML kód po transformaci
* LASTMODIF – datum poslední aktualizace

== NEWSNAVIGXML ==
Tabulka slouží pro ukládání XML kódů struktury kategorií pro generování navigací

* LANGUAGEID - ID jazyka (NEWSLANGUAGE.ID)
* LASTMODIF - Datum a čas poslední modifikace záznamu, doplňuje se triggerem u databází toto podporující
* XMLCODE - XML kód

== NEWSPAGE ==
Tabulka obsahuje definice všech stránek.

* ID – identifikátor stránky
* PARENTID – identifikátor nadřazené stránky ve stromu šablon stránek. Tento odkaz se používá při určení, která stránka bude použita pro generování stránky.
* LOGPARENTID – identifikátor nadřazené stránky ve stromu hierarchického zařazení stránek
* PATTERNID – identifikátor kategorie předloh (odkaz na tabulku NEWSPATTERNS)
* CATEGID – identifikátor kategorie (odkaz na tabulku NEWSKATEG)
* NAME – název Stránky
* NAMEUSR – titulek Stránky
* ABBREV – není používáno
* GENERATED – určuje, zda se jedná o primární šablonu nebo zda se Stránka z primární šablony bude generovat: 0.. Stránka se generuje / 1.. jedná se o primární šablonu
* PAGEURL – relativní URL adresa souboru, do kterého se bude stránka generovat (fyzické URL)
* SURL - prezentační URL stránky
* URLLOCK - příznak ''automaticky neměnit'' prezentační URL
* SERVERID – pokud existují nějaké virtuální servery (v tabulce NEWSSERVER), toto pole určuje, ke kterému serveru Stránka patří.
* LANGUAGEID – jazyk stránky (odkaz na tabulku NEWSLANGUAGE)
* MIMEID – MIME typ stránky (odkaz na tabulku NEWSMIME)
* DATECREATED – datum poslední úpravy stránky
* PAGECATEGORY – kategorie stránky
* TARGETLOCATION – cíl uložení (1=veřejná zóna, 2=privátní zóna); výchozí hodnota 1

== NEWSPAGELANG ==
Tabulka uchovává vztahy mezi Stránkami se stejným obsahem, ale v různých jazycích.

* SKUPINAID – identifikátor skupiny Stránek se stejným obsahem v různých jazycích (podle tabulky NEWSIDGEN)
* STRANAID – identifikátor Stránky (odkaz na tabulku NEWSPAGE)
* JAZYKID – identifikátor jazyka (odkaz na tabulku NEWSLANGUAGE)

== NEWSPATTERNS ==
Tabulka uchovává seznam kategorií Předloh (šablon pro některé typy dynamických skriptů)

* ID – identifikátor Předlohy
* PARENTID – identifikátor nadřazené předlohy ve stromu zařazení předloh
* NAME – název Předlohy

== NEWSPROCPROGRESS ==
Tabulka běžících procesů a jejich průběhů.

* ID – identifikátor záznamu
* STARTED – datum a čas spuštění procesu
* TIMEOUT – stanovený timeout pro proces v sekundách
* COUNTELAPS – počet vykonaných kroků
* COUNTTOTAL – celkový počet kroků procesu
* CURRACTIVITY – slovní popis právě vykonávané aktivity
* AUXNOTE – pomocný popis

== NEWSPROPOJENI ==
Tabulka uchovává definice Seznamů všech typů.

* ID – identifikátor Seznamu
* NAZEV – název Seznamu
* KATEGID – identifikátor kategorie (odkaz na tabulku NEWSKATEG, příp. 0, pokud není kategorie definována)
* DATUMDIFF – počet dní od vytvoření Zprávy
* PUBLID – identifikátor Publikace (odkazna tabulku NEWSPUBL, příp. 0, pokud není publikace definována)
* RUBRIKA – název rubriky
* MAXVYDANI – počet publikačních dní
* MAXZPRAV – maximální počet zobrazených Článků
* SKUPINAID – identifikátor Skupiny (odkaz na tabulku NEWSSKUPINA, příp. 0, pokud není Skupina definována)
* SEKCE – název pole, které je použito k dělení Seznamu do sekcí
* TRIDIT – název pole použitého pro třídění
* TYP – typ Seznamu (Seznam, Propojení se zprávou, SQL dotaz, přílohy)
* KEYWORDS – klíčová slova
* KEYWSTEJNA – volba Klíčová slova - stejná
* RELIDS – volba Související ID
* JAZYKID – identifikátor jazyka (odkaz na tabulku NEWSLANGUAGE, příp. 0, pokud je jazyk nedefinován)
* TYPID – identifikátor Oblasti na určité stránce, která má obsahovat či naopak neobsahovat zprávy, které seznam zobrazuje (odkaz na tabulku NEWSTYP)
* STRANAID – identifikátor Stránky, která má obsahovat oblast uvedenou v TYPID (odkaz na tabulku NEWSPAGE)
* SQL_SRC – odpovídající SQL dotaz (generovaný podle nastavení nebo sestavený ručně)
* IS_ALLOWED – zda se má seznam spouštět ne jako SQL uložená procedura, ale jako PHP kód (zpravidla na MySql, kde SQL procedury neexistují).
* SECTIONCOUNT – určuje velikost vynuceně rozděleného seznamu
* INCLSELAREA – volba určující, zda se zprávy umístěné na oblasti TYPID do seznamu zahrnují nebo naopak nezahrnují
* PAGING – volba zda-li se má seznam stánkovat
* ACTIVECATEG – aktivní kategorie
* INCLSUBCAT – volba včetně podkategorií
* ATTACHLISTID – identifikátor seznamu příloh (tabulka NEWSATTACHLISTS)
* KATEGLEVEL – úroveň kategorie
* KOREKTURA – stav zpráv

== NEWSPUBL ==
Tabulka obsahuje záznamy o Publikacích a jejich nastaveních.

* ID – identifikátor záznamu
* NAZEV – název Publikace
* CESTA – relativní cesta adresáře, kde jsou uložené volitelně texty Publikace
* PERIODICKA – určuje, zda je Publikace periodická.
* IMGCESTA – relativní cesta k adresáři s obrázky Publikace (používají pouze některé importní aplikace)
* BARVA – určuje barvu, která bude použita jako pozadí v seznamu Zpráv

== NEWSPUBLDETAIL ==
Tabulka obsahuje detailní informace o Publikacích podle jednotlivých MIME typů (např. pokud existují šablony pro HTML a pro WAP). Počet záznamů odpovídá počtu Publikací vynásobenému počtem MIME typů.

* PUBLID – identifikátor Publikace (odkaz na tabulku NEWSPUBL)
* MIMEID - identifikátor MIME typu (odkaz na tabulku NEWSMIME)
* TEMPLCLANEKID - identifikátor šablony pro kombinaci Zprávy a MIME typu (odkaz na tabulku NEWSPAGE)

== NEWSSERVER ==
Tabulka obsahuje definice virtuálních web serverů; pokud není žádný potřebný, nevkládají se do tabulky žádná data.

* ID – identifikátor záznamu
* URL – URL adresa serveru
* CESTA – absolutní cesta do kořenového adresáře virtulního web serveru
* NAZEV – název virtuálního web serveru
* CESTATXT – pole pro zpětnou kompatibilitu, nevyplňuje se

== NEWSSCHQUE ==
Tabulka slouží jako zásobník sekvencí k vykonání.

* ID – identifikátor záznamu
* RDATE – vypočítaný datum a čas, kdy se má sekvence vykonat
* STATUS – status úlohy
* XMLFILE – název souboru se sekvencí

== NEWSSCHTASKS ==
Tabulka obsahuje seznam sekvencí definovaných v Plánovači úloh.

* ID – identifikátor záznamu
* NAME – název sekvence
* COMMENT – popis sekvence
* ENABLED – určuje, zda je sekvence aktivní
* ACTDATE – datum poslední úpravy
* XMLFILE – jméno XML souboru s definicí sekvence

== NEWSSKUPCONN ==
Tabulka obsahuje propojení zpráv se skupinami – jedna zpráva může být zařazena do více skupin

* NEWSID – identifikátor zprávy (tabulka NEWSDB)
* SKUPID – identifikátor skupiny (tabulka NEWSSKUPINA)

== NEWSSKUPINA ==
Tabulka obsahuje seznam Skupin zpráv. Každá Zpráva může patřit nejvýše do jedné Skupiny.

* ID – identifikátor Skupiny
* NAZEV – název Skupiny

== NEWSTRANSFORM ==
Tabulka obsahuje data o tranformacích

* ID – identifikátor transformace
* NAME – název transformace
* DESCRIPTION – popis
* XMLCODE – XML kód transformace
* TCATEGID – kategorie transformace

== NEWSTYP ==
Tabulka obsahuje data o Oblastech, které mohou být použity na Stránkách.

* ID – identifikátor Oblasti
* IDSTRING – identifikátor-název Oblasti, jak je používán na Stránkách
* NAZEV – název Oblasti pro uživatele
* LAYOUTID – výchozí Styl pro Oblast
* SORTID – identifikátor typu třídění
* MAXZPRAV – maximální počet Zpráv na generované Stránce
* HLAVICKA – hlavička Oblasti (HTML kód). Je vložena do Oblasti, pokud je do té vložen alespoň jeden Článek.
* PATICKA – patička Oblasti (HTML kód). Je vložena do Oblasti, pokud je do té vložen alespoň jeden Článek.
* PRIORITA - priorita

== NEWSTYPSTYL ==
Záznamy v tabulce určují, které Styly jsou použitelné pro jednotlivé Oblasti. Účelem je nabídnou Styly, jejichž použití má pro danou Oblast smysl.

* TYPID – identifikátor Oblasti (odkaz na tabulku NEWSTYP)
* STYLID – identifikátor Stylu (odkaz na tabulku NEWSLAYOUT)

== NEWSUSEDTYPES ==
Tabulka obsahuje seznam Oblastí definovaných pro každou šablonu. Šablona je pak aktualizována automaticky při procházení stránky.

* PAGEID – identifikátor stránky šablony (odkaz na tabulku NEWSPAGE)
* TYPID – identifikátor Oblasti (odkaz na tabulku NEWSTYP)

== NEWSUSERCONN ==
Tabulka definuje zařazení uživatele do týmu uživatelů a určuje jeho roli.

* GROUPID – identifikátor týmu uživatelů (odkaz na tabulku NEWSUSERGROUPS)
* USERID – identifikátor uživatele (odkaz na tabulku NEWSUSERPERSONS)
* ROLE – role uživatele

0.. Administrátor

10.. Editor

20.. Redaktor

== NEWSUSERFILESELECT ==
Tabulka obsahuje uživatelské výběry souborů

* USERID – identifikátor uživatele (odkaz na tabulku NEWSUSERPERSONS)
* FILEID – identifikátor souboru (odkaz na tabulku NEWSFILES)

== NEWSUSERGROUPS ==
Tabulka obsahuje definice týmů uživatelů.

* ID – identifikátor týmu uživatelů
* NAME – název týmu
* DESCRIPTION – popis
* ROOTPATH – relativní cesta do adresáře, kam smí uživatelé vytvářet podadresáře a ukládat soubory (cesta uzavřena do oddělovačů - /images/)

== NEWSUSERPERSONS ==
Tabulka obsahuje data o uživatelích.

* ID – identifikátor uživatele
* FIRSTNAME, LASTNAME – křestní jméno a příjmení uživatele
* EMAIL – emailová adresa
* USERNAME – uživatelské jméno
* PASSWORD – heslo
* ACTIVE – určení, zda je účet uživatele aktivní
* DEFAULTVIEW – výchozí Pohled uživatele (odkaz na tabulku NEWSVIEWS, příp. 0, pokud není definován)
* DEFAULTCATEGID – výchozí kategorie uživatele (odkaz na tabulku NEWSKATEG, příp. 0, pokud není definována)
* SHOWINTEDITOR – určuje, zda se má zobrazovat ikona celoobrazovkového interního editoru
* SHOWEXTEDITOR – určuje, zda se má zobrazovat ikona externího editoru
* FILTERHTML – určuje míru filtrování HTML:

0.. žádné filtrování

1.. pouze základní tagy

2.. převádět do prostého textu

* DISABLEVIEWCHANGE – zakázat změnu pohledu
* DEFAULTGROUP – výchozí tým uživatele
* EDITSOURCE - určuje, zda má uživatel možnost ve formulářích (např. pro zprávy) přímo měnit pole, do kterých se zadává HTML kód. Pokud uživatel tuto možnost nemá, je vkládání kódu přístupné pouze přes WYSIWYG editor

== NEWSUSERTYPES ==
Tabulka definuje, které Oblasti mohou které týmy uživatelů používat. Pro každou Oblast je také rozlišeno, na které Stránce je umístěna.

* GROUPID – identifikátor týmu uživatelů (odkaz na tabulku NEWUSERGROIUPS)
* PAGEID – identifikátor Stránky s Oblastí (odkaz na tabulku NEWSPAGE)
* TYPEID – identifikátor Oblasti (odkaz na tabulku NEWSTYP)

== NEWSVARDOCITEMS ==
Tabulka obsahuje seznam položek variabilní struktury.

* VARFIELDID – identifikátor variabilního pole (tabula NEWSVARFIELDS)
* VARDOCID – identifikátor variabilní struktury zpráv (tabula NEWSVARDOCTYPES)
* FORDERID – pořadí položky

== NEWSVARDOCTYPES ==
Tabulka obsahuje seznam typů variabilní struktury.

* ID – identifikátor variabilní struktury zpráv
* NAME – název variabilní struktury zpráv
* FSYSNAME – systémový název variabilní struktury zpráv

== NEWSVARFIELDS ==
Tabulka obsahuje seznam polí variabilní struktury.

* ID – identifikátor pole variabilní struktury zpráv
* FSYSNAME – systémový název pole variabilní struktury zpráv
* FUSERNAME – uživatelský název pole variabilní struktury zpráv
* FDATATYPE – datový typ pole
* ALLOWMARKUP – povolit vkládání HTML
* AUTOFORMAT – automatické formátování pole
* FMAXLEN – maximální délka
* MANDATORYVALUE – povinná hodnota
* SELID – ID číselníku
* FINDEX – indexování pole
* FFULLTEXT – fulltextové indexování pole

== NEWSVARSELDEF ==
Tabulka obsahuje seznam číselníků

* ID – identifikátor číselníku
* NAME – systémový název číselníku

== NEWSVARSELITEMS ==
Tabulka obsahuje seznam hodnot číselníků

* ID – identifikátor hodnoty číselníku
* SELID – identifikátor číselníku
* SYSVALUE – systémová hodnota
* SYSNAME – systémový název hodnoty

== NEWSVARSELLOC ==
Tabulka obsahuje seznam lokalizovaných názvů hodnot číselníků

* ITEMID – identifikátor hodnoty číselníku
* LANGUAGEID – identifikátor jazyku
* LOCNAME – lokalizovaný název hodnoty

== NEWSVIEWS ==
Tabulka obsahuje seznam definovaných Pohledů.

* ID – identifikátor záznamu
* NAZEV – název Pohledu
* VARDOCID – identifikátor variabilní struktury zpráv

== NEWSVIEWSDEF ==
Tabulka obsahuje detailní definice Pohledů.

* POHLEDID – identifikátor Pohledu (odkaz na tabulku NEWSVIEWS)
* POLE – název pole v Pohledu
* DEFVALUE – výchozí hodnota
* ZOBRAZIT – určení, zda má být pole v Pohledu zobrazeno
* ORDERID – pořadí pole v Pohledu
* FUSERNAME – uživatelský název pole
* DEFVALUEREGIME – režim výchozí hodnoty (0=DEFVALUE,1=hodnota pole DEFVALUEFIELD)
* DEFVALUEFIELD – pole z kterého se má vzít výchozí hodnota (při DEFVALUEREGIME=1)
* WPROFILEID - identifikátor WYSIWYG profilu (odkaz na tabulku NEWSWPROFILES)

== NEWSVYDANI ==
Tabulka obsahuje definice Vydání.

* PUBLID – identifikátor Publikace
* CISLO – číslo Vydání
* NAZEV – název Vydání
* DATUM – datum Vydání
* KOREKTURA – status Vydání:

1.. Publikováno

2.. Schváleno

3.. Vloženo

== NEWSWPROFILES ==
Tabulka obsahuje definice WYSIWYG profilů

* ID - interní číslování
* NAME - název profilu
* WEDITOR - volba ''Upravovat WYSIWYG''; 1 = WYSIWYG i formulář, 2 = pouze WYSIWYG, 3 = pouze formulář
* WCONFIG - Název souboru v adresáři ''application/ckeditor/webtodate/config/profiles/''
* FIELDROWS - počet řádků pole ve formuláři
* HTMLFILTER - aplikovat HTML filtr; 1 = jakékoli HTML, 2 = Filtrované HTML, 3 = bez HTML
* ALLOWEDTAGS - povolené tagy oddělené čárkou
* ALLOWEDATTR - povolené atributy oddělené čárkou

WebToDate/Referenční/Plánovač úloh

2009-12-16T15:42:40Z

Jakubn: /* Volání úloh */

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
== Možnosti plánování úloh ==
Některé úlohy v systému WebToDate, které se běžně provádějí interaktivně (tj. tím, že uživatel spustí nějakou funkci v administračním rozhraní), lze spouštět rovněž automaticky.

Typicky lze řešit např. následující situace:

* Chceme si připravit zítřejší podobu úvodní stránky, tuto stránku upravit a zprávy na ni přiřazené publikovat v určenou dobu v noci.
* Chceme načíst data z externí databáze (např. seznam výročí k danému datu) a tento seznam opět jednou za noc aktualizovat na vybrané stránce.
* Chceme automaticky aktualizovat (např. jednou za půl hodiny) úvodní stránku, na které se zprávy zobrazují pomocí seznamu, když redaktoři a editoři průběžně plní databázi zpráv a nechceme přidávat zprávy na stránku ručně.
* Chceme jednou za určený časový interval zkontrolovat konzistenci databáze zpráv a vyhledat nefunkční odkazy v databázi.

Tyto i další možnosti nabízí funkce Plánovač úloh. Funkce pracuje s následujícími pojmy:

* '''Úloha''' je dále nedělitelný prvek reprezentující jednu akci, kterou lze spouštět automaticky (např. vygenerování jedné stránky).
* '''Sekvence''' je seznam několika úloh v definovaném pořadí s možností definovat závislost ve smyslu chyb při vykonání (tj. zda se má či nemá úloha 2 vykonat, pokud se úlohu 1 vykonat nepodařilo).
* '''Časování''' je předpis, kdy a jak často se má sekvence vykonávat. Časují se zásadně sekvence (i když obsahují jen jednu úlohu); každá sekvence může mít nastaveno více časování.

== Definování sekvencí ==
Definovat plánované úlohy mohou pouze administrátoři. Příkazem '''Administrace''' – '''Plánovač úloh''' se v pravé části nahoře zobrazí seznam plánovaných úloh s položkami

* '''Název sekvence'''
* '''Popis''' – k čemu daná sekvence slouží
* '''Stav''' – zobrazuje ikonou, zda je daná sekvence aktivní (tj. zda alespoň jedno její časování je aktivní a tím pádem se automaticky spouští)
* '''Poslední změny''' – kdy byla provedena poslední změna v definici sekvence

Ve spodní části se pak zobrazuje formulář pro přidávání resp. úpravy sekvencí. Formulář je rozdělen na záložky '''Obecné''' (název sekvence a popis), '''Úlohy''' (seznam úloh v sekvenci) a '''Časování''' (seznam časování dané sekvence). Vybranou sekvenci lze ručně spustit z tohoto rozhraní tlačítkem '''Spustit'''.

[[Image:referencniprirucka-planovaculoh-img159.png|center]]

Při založení nové sekvence nejprve vyplňte pole '''Název sekvence''' a '''Popis'''. V záložce '''Úlohy''' pak definujte seznam úloh v dané sekvenci. V této záložce se zobrazuje seznam úloh v pořadí, v jakém se budou vykonávat. Význam jednotlivých sloupců v tomto seznamu je:

* Sloupec '''Krok''' – automatické číslování pořadí úloh
* '''Úloha''' – zobrazuje se zde typ úlohy (např. Generování stránky), odkazem přidat se přidává nová úloha do sekvence.
* Ve třetím sloupci jsou v každém řádku dvě ikony, pomocí nichž lze v seznamu úlohu posouvat směrem nahoru či dolů a tím definovat pořadí vykonávání úloh.
* Ve čtvrtém sloupci je ikona, pomocí které lze odstranit danou úlohu z upravované sekvence.
* Do sloupce '''Popis''' zadejte svůj popis úlohy (např. Generování úvodní str.).
* V posledním sloupci '''Závislost''' lze definovat, na kterých předchozích úlohách v dané sekvenci je vybraná úloha závislá. Pokud je úloha B závislá na úloze A a při vykonání úlohy A dojde k chybě, úloha B se nespustí. V tomto sloupci lze zadat buď zkrácené volby Na všech, nebo Na žádném (tj. úloha je závislá na všech předchozích krocích nebo na žádném), nebo existuje třetí volba Podrobně. Při zvolení této možnosti se zobrazí v tomto řádku tlačítko Nastavit, které v novém okně zobrazí seznam úloh předcházejících dané úloze. Tam lze zaškrtnout, na kterých úlohách je vybraná úloha závislá.

Pomocí odkazu '''Přidat''' (resp. klepnutím na název úlohy ve druhém sloupci) se otevře dialog pro přidání resp. úpravu parametrů nové úlohy. Nahoře v tomto okně se nachází rozevírací nabídka se seznamem úloh nainstalovaných v systému. Výběrem typu úlohy se mění zbylá část okna, kde se nastavují parametry úlohy, protože každý typ úlohy má jiný počet a význam parametrů. Například úloha pro generování jedné stránky má tyto parametry:

* která stránka se má generovat
* zda se zprávy umístěné na stránce a nacházející se ve stavu ''Schváleno'' mají nejprve přepnout do stavu ''Publikováno''
* zda se má generovat i podstrom stránek

Jiné úlohy mají jiný počet a význam parametrů.

== Časování sekvencí ==
V záložce '''Časování''' lze vytvořit jednu nebo více definic toho, kdy a v jakém intervalu se daná sekvence spouští. Seznam se ovládá analogicky jako seznam úloh, na pořadí definic v seznamu časování nezáleží. Odkazem '''přidat''' (resp. klepnutím na název časování) se v dialogovém okně zobrazí formulář pro definici časování.

[[Image:referencniprirucka-planovaculoh-img160.png|center]]

V tomto formuláři lze nastavit libovolné kombinace podmínek, např. pouze jednou s konkrétním datem a časem, každou středu a neděli v daný čas, každý třetí den v měsíci, jednou za pět minut a podobně. Neopomeňte každé definici časování zadat název a stav, zda je '''aktivní''', nebo ne.

== Spouštění plánovaných úloh ==
=== Způsob automatického spouštění ===

Technicky je časování spouštění řízeno jedním dávkovým příkazem, který se zadá jednou (manuálně) při instalaci do cronu nebo scheduleru. Tento příkaz v zásadě periodicky kontroluje soubor ''schedule.xml'', kde jsou zapsány všechny předpisy pro spouštění sekvencí v čase, a pokud nalezne nějakou sekvenci, kterou je třeba spustit, vykoná to.

Perioda kontroly toho, zda se má spustit nějaká úloha, je standardně jedna minuta, ale může být změněna. To znamená, že funkce musí být schopna najít sekvence, které je třeba spustit v průběhu následujících deseti minut apod.

=== Ochrana před přetížením serveru ===

Dávkový příkaz spouštění z cronu se skládá ze dvou úloh:

* Úloha pro plánování
* Úloha pro spouštění

Úloha pro plánování zjišťuje podle předpisu uvedeného v ''schedule.xml'', zda je třeba spustit nějakou sekvenci. Pokud něco takového zjistí, sekvenci přímo nespouští, ale zapíše ji do fronty sekvencí k vykonání.

Úloha pro spouštění postupně spouští sekvence nalezené ve frontě sekvencí, do které je zapsala první úloha.

Ochrana proti přetížení je přitom řešena následovně:

* Sekvence spouští pouze úloha pro spouštění, která může spustit pouze jednu sekvenci v daný čas. Až sekvence doběhne, může spustit další sekvenci nalezenou ve frontě.
* Pomocí semaforu ve formě zápisu do databáze je řešeno to, aby systém nemohl spustit úlohu pro spouštění víckrát než jednou. Úloha pro spouštění na začátku v semaforu nastaví příznak, že je spuštěna a na konci tento příznak odstraní. Pokud by mezitím došlo k tomu, že se z cronu opět zavolá dávkový příkaz, který spouští úlohu pro spouštění, před spuštěním této úlohy se zjistí, že jiný proces této úlohy již běží a dál se nepokračuje.

=== Volání úloh ===

V adresáři ''scheduler'' je soubor pro shell OS, čili ''cron.sh'' pro UNIX, ''cron.bat'' pro Windows. Spouštění tohoto souboru je třeba zadat do příslušného spouštěcího stroje, čili do cronu nebo Windows scheduleru.

Soubor obsahuje dva řádky, jeden pro spuštění úlohy pro plánování, druhý pro úlohu pro spouštění, čili např.

<code>
<nowiki>@echo off</nowiki>
<nowiki>php.exe -d html_errors=false sch_planner.php "%1"</nowiki>
<nowiki>php.exe -d html_errors=false sch_runner.php</nowiki>
</code>

Pokud se v cronu nastaví, že úloha se nespouští jednou za minutu, ale v delší periodě, je třeba dát za jméno souboru (v položce cronu) parametr – interval spouštění v minutách, který se přenese jako parametr do skriptu pro úlohu pro plánování.

=== Ruční spouštění úloh ===

Úlohy lze spouštět také ručně pomocí tlačítka '''Spustit'''. Po provedení příslušných úloh se objeví formulář '''Výsledky''' informující o úspěšnosti jednotlivých kroků.

== Popis základních úloh ==
Následující úlohy jsou součástí základní instalace WebToDate, některé úlohy jsou ale obsaženy pouze ve variantě '''Enterprise'''.

=== Akce ===

Tato úloha umožňuje spouštět určitou akci. Parametr '''Generovat stránku''' umožňuje přegenerovat odpovídající stránku, další parametr pak dovoluje automaticky '''převést schválené zprávy do stavu Publikováno'''.

[[Image:referencniprirucka-planovaculoh-img161.png|center]]

=== Export XML a Import XML ===

Tyto úlohy zajišťují automatický import či export dat (zpráv) ve formátu XML. Podrobný popis je uveden v příručce k modulu XML.

=== Expirace ===

Tato úloha řídí časovou platnost zprávy podle časových hodnot nastavených ve formuláři Zprávy ('''Publikovat dne''' a '''Vyprší dne'''). Nastaví zprávy do příslušného stavu '''Publikováno''', '''Archivováno''' nebo '''Vypršelo''' a přegeneruje odpovídající stránky.

Pomocí parametru '''Počet dnů''' lze nastavit, zda má být zpráva po určité době smazána. Podmínkou pro mazání zpráv je:

* Zpráva (nebo zdroj, fragment) je ve stavu '''Vypršelo'''
* Rozdíl mezi časem poslední aktualizace a aktuálním časem je větší nebo roven než zadaný počet dnů.

Pomocí parametru '''SQL seznamy''' se volí, zda mají být přegenerovány i stránky s SQL seznamy.

Parametr '''Odstraňovat archivované zprávy ze stránek''' specifikuje, zda se zprávy po přechodu do stavu '''Archivováno''' ze stránek odstraňují. Zprávy přecházející do stavu '''Vypršelo''' se ze stránek odstraňují automaticky vždy.

[[Image:referencniprirucka-planovaculoh-img162.png|center]]

=== Generování stránky ===

Úloha umožňuje vygenerovat vybranou stránku a případně automaticky '''převést schválené zprávy do stavu Publikováno''' (stejnojmenná volba). Prostřednictvím volby '''generovat včetně podstromu''' budou generovány i všechny podstránky.

[[Image:referencniprirucka-planovaculoh-img163.png|center]]

=== Informační mail ===

Odešle na vybranou e-mailovou adresu informaci o výsledcích předešlých kroků.

[[Image:referencniprirucka-planovaculoh-img164.png|center]]

Jako parametry se zadávají e-mailové adresy příjemce a odesílatele.

=== Sumarizace počtu zhlédnutí ===

Úloha umožňuje po určité době automatické sečtení počtu zhlédnutí zpráv (udává se ve dnech).

[[Image:referencniprirucka-planovaculoh-img165.png|center]]

=== Verifikace ===

Úloha zajišťuje automatické provedení určitých kontrol modulu Verifikace.

Výběr jednotlivých kontrol se provádí prostřednictvím zaškrtávacích polí. Podrobný popis je uveden v příručce modulu [[../../Verifikace|Verifikace]].

[[Image:referencniprirucka-planovaculoh-img166.png|center]]

=== Uživatelské úlohy ===

Kromě popsaných úloh lze definovat uživatelské úlohy, tj. úlohy, které nejsou standardní součástí dodávky WebToDate. Tyto práce ovšem vyžadují znalost programování. Pokud potřebujete v této oblasti pomoci, obraťte se na výrobce systému WebToDate.