WebToDate - Příspěvky [cs]

WebToDate/Referenční/Klíčová slova WebToDate

2012-01-21T10:05:52Z

Tomasn: /* Vkládání odkazů na jiné jazykové verze zpráv či stránek */ překlep, PF_LANG místo PG_LANG

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
Klíčová slova WebToDate mají vesměs tvar nepárových značek, které jsou HTML komentáři.

== Klíčová slova použitelná ve stylech a předlohách pro zprávy ==
Následující klíčová slova se používají v předlohách pro zprávy a ve stylech formátujících zprávy na stránkách.

{| class="prettytable"
| '''Pole'''
| '''Význam'''

|-
| <nowiki></nowiki>
| ID zprávy

|-
| <nowiki></nowiki>
| Nadpis zprávy

|-
| <nowiki></nowiki>
| Odkaz nadpisu

|-
| <nowiki></nowiki>
| Popis

|-
| <nowiki></nowiki>
| Tělo zprávy

|-
| <nowiki></nowiki>
| Obrázek

|-
| <nowiki></nowiki>
| Alt. obrázek

|-
| <nowiki></nowiki>
| Datum zprávy

|-
| <nowiki></nowiki>
| Čas zprávy

|-
| <nowiki></nowiki>
| Datum a čas aktualizace

|-
| <nowiki></nowiki>
| Autor

|-
| <nowiki></nowiki>
| Rubrika

|-
| <nowiki></nowiki>
| Priorita zprávy

|-
| <nowiki></nowiki>
| Link popisu

|-
| <nowiki></nowiki>
| Podtext

|-
| <nowiki></nowiki>
| Odkaz podtextu

|-
| <nowiki></nowiki>
| Číslo stránky

|-
| <nowiki></nowiki>
| Název publikace

|-
| <nowiki></nowiki>
| Číslo publikace

|-
| <nowiki></nowiki>
| Lokalizovaný název výchozí kategorie

|-
| <nowiki></nowiki>
| Číslo výchozí kategorie

|-
| <nowiki></nowiki>
| Název tématu

|-
| <nowiki></nowiki>
| Číslo tématu

|-
| <nowiki></nowiki>
| Název vydání

|-
| <nowiki></nowiki>
| Číslo vydání

|-
| <nowiki></nowiki>
| Číslo jazyka

|-
| <nowiki></nowiki>
| Zkratka jazyka

|}

Pokud je definována pro zprávy přizpůsobitelná struktura, pro pole v této struktuře se používají klíčová slova <nowiki>, tedy např. </nowiki>.

== Klíčová slova použitelná ve stylech a předlohách pro zprávy - výchozí přílohy ==
Pokud jsou ke zprávě připojeny soubory z databáze zdrojů, může být jedna tato instance (příloha) označena jako výchozí. Výchozí instance se může vyskytovat přímo ve stylu pro zprávu či v předloze, klíčová slova pro tento účel jsou identická jako [[../Klíčová slova WebToDate#Klíčová slova pro zdroje|Klíčová slova pro zdroje]].

== Klíčová slova použitelná ve stylech pro formátování seznamů ==
Klíčová slova pro styly formátující seznamy zpráv jsou stejná jako pro samotné zprávy, navíc lze použít následující konstrukce:

{| class="prettytable"
| <nowiki></nowiki>
| Použije se v případě, že se vkládá skutečná položka seznamu (viz kapitola [[../Seznamy|Seznamy]])

|-
| <nowiki></nowiki>
| Použije se v případě, že se dopočítává na celočíselný násobek (viz kapitola [[../Seznamy|Seznamy]])

|-
| <nowiki></nowiki>
| Vkládá kód, pokud se jedná o lichý řádek seznamu (viz kapitola [[../Seznamy|Seznamy]])

|-
| <nowiki></nowiki>
| Vkládá kód, pokud se jedná o sudý řádek seznamu. Pokud se styl aplikuje na jednu zprávu či zdroj, jedná se vždy o lichý (jakoby první) řádek, takže ROWEVEN nikdy nenastane. Pokud se aplikuje na seznam (zpráv či příloh ke zprávě - zdrojů), bere se interní číslování řádků výsledků od jedničky, čili první řádek je lichý. Pokud je seznam dělený, čísluje se interně od jedničky vždy, pokud se změní úroveň dělení, takže první řádek v dané úrovni je vždy lichý.

|-
| <nowiki></nowiki>
| Reprezentuje místo, kde se vloží navigační lišta; bez uvedení dalšího parametru se zobrazí výchozí navigační lišta, druhým parametrem může být systémový název definice navigační lišty, tedy např. <nowiki></nowiki>

|-
| <nowiki></nowiki>
| Reprezentuje výpis výsledků (např. ''Dokument 1 až 10 z 50'')

|-
| <nowiki></nowiki>
| ID seznamu, který je právě vykreslován (používá se vytváření URL stránky s detailem obrázku ve fotogalerii)

|}

== Klíčová slova použitelná v definici stránkování ==
Klíčová slova uvedená v této kapitole se používají pro definici zobrazování stránkování u stránkovaných seznamů, neboli ve formuláři '''Administrace''' – '''Nastavení - Stránkování'''.

=== Klíčová slova použitelná v definici stránkovací lišty ===

{| class="prettytable"
| <nowiki></nowiki>
| Klíčové slovo je nahrazováno za odkaz na určitou stránku v rámci stránkování seznamu

|-
| <nowiki></nowiki>
| Klíčové slovo je nahrazováno za pořadové číslo určité stránky v rámci stránkování seznamu

|}

=== Klíčová slova použitelná polích pro tvar URL ===
V polích '''URL první stránky''' a '''Suffix URL dalších stránek''' v definic stránkovací lišty lze použít následující výrazy:

{| class="prettytable"
| <nowiki></nowiki>
| Klíčové slovo je nahrazováno za prezentační URL stránky

|-
| <nowiki></nowiki>
| ID zobrazované stránky nebo zprávy

|-
| <nowiki></nowiki>
| zkratka zobrazované zprávy

|-
| <nowiki></nowiki>
| ID stránkovaného seznamu

|-
| <nowiki></nowiki>
| číslo stránky v rámci stránkování seznamu

|-
| <nowiki></nowiki>
| část URL za otazníkem tak jej generuje stránkovací lišta v nativním tvaru, čili např. ''<nowiki>pgid=173&conn=609&pg=4</nowiki>''

|}

=== Klíčová slova použitelná ve výpisu výsledků ===

{| class="prettytable"
| <nowiki></nowiki>
| Počáteční pořadové číslo zprávy na stránce v seznamu

|-
| <nowiki></nowiki>
| Koncové pořadové číslo zprávy na stránce v seznamu

|-
| <nowiki></nowiki>
| Počet nalezených zpráv celkem

|-
| <nowiki></nowiki>
| Pořadové číslo stránky v rámci stránkování

|-
| <nowiki></nowiki>
| Celkový počet stránek v rámci stránkování

|}

Tato klíčová slova umožňují jak výpis typu "Zprávy 1 až 10 z 50", tak vyznačování na úrovni stránkovacích stránek, tedy např. "1/5" (tj. první z pěti stránek).

== Klíčová slova pro zdroje ==
Tato klíčová slova se používají ve stylech formátujících zdroje (tj. instance souborů ze zdrojů ve zprávách, ať už se jedná o seznam příloh nebo samostatné instance v textu zprávy.

{| class="prettytable"
| <nowiki></nowiki>
| ID zdroje

|-
| <nowiki></nowiki>
| Nadpis zdroje

|-
| <nowiki></nowiki>
| Link nadpisu

|-
| <nowiki></nowiki>
| Popis

|-
| <nowiki></nowiki>
| Datum zdroje

|-
| <nowiki></nowiki>
| Čas zdroje

|-
| <nowiki></nowiki>
| Datum a čas aktualizace

|-
| <nowiki></nowiki>
| Autor

|-
| <nowiki></nowiki>
| Priorita zdroje

|-
| <nowiki></nowiki>
| Název publikace

|-
| <nowiki></nowiki>
| ID publikace

|-
| <nowiki></nowiki>
| Lokalizovaný název výchozí kategorie

|-
| <nowiki></nowiki>
| ID výchozí kategorie

|-
| <nowiki></nowiki>
| Číslo jazyka

|-
| <nowiki></nowiki>
| ID souboru

|-
| <nowiki></nowiki>
| Název souboru

|-
| <nowiki></nowiki>
| URL souboru

|-
| <nowiki></nowiki>
| Typ souboru

|-
| <nowiki></nowiki>
| Velikost souboru v B

|-
| <nowiki></nowiki>
| Šířka obrázku (videa, Flash animace,...)

|-
| <nowiki></nowiki>
| Výška obrázku

|-
| <nowiki></nowiki>
| URL souboru master pro aktuální zdroj

|-
| <nowiki></nowiki>
| ID souboru master pro aktuální zdroj

|-
| <nowiki></nowiki>
| Název souboru master pro aktuální zdroj

|-
| <nowiki></nowiki>
| Typ souboru master pro aktuální zdroj

|-
| <nowiki></nowiki>
| Velikost souboru master pro aktuální zdroj v B

|-
| <nowiki></nowiki>
| Šířka obrázku souboru master pro aktuální zdroj

|-
| <nowiki></nowiki>
| Výška obrázku souboru master pro aktuální zdroj

|}

== Podmíněné vkládání polí do stránek ==
=== Test naplnění obsahu pole ===

U všech výše uvedených polí lze využít podmíněného vkládání do stránek. K tomu se používají klíčová slova

<code>
<nowiki></nowiki>
<nowiki></nowiki>
</code>

kde se za jméno_pole dosadí název zvoleného pole. Pokud je toto pole prázdné, zobrazí se na místě podmínky jméno_poleNULL HTML kód který je obsažen v uvozovkách a podmínka jméno_poleNOTNULL se nahradí prázdným řetězcem, pokud pole není prázdné, zobrazí se na místě podmínky jméno_poleNOTNULL HTML kód který je obsažen v uvozovkách, a podmínka jméno_poleNULL se nahradí prázdným řetězcem.

<code>
<nowiki>Příklad užití: </nowiki>
<nowiki> </nowiki>
<nowiki>">")-->.</nowiki>
</code>

Pro zdroje je pak syntaxe podmíněného vkládání následující:

<code>
<nowiki></nowiki>
<nowiki></nowiki>
</code>

Tedy např.:

<code>
<nowiki></nowiki>
<nowiki></nowiki>
</code>

U zdrojů lze rozlišit, zda se jedná o položku – souboru, nebo o položku – odkaz (např. pro účely zobrazení ikon u odkazů):

<code>
<nowiki></nowiki>
<nowiki></nowiki>
</code>

Pro podmíněné vkládání polí z přizpůsobitelné struktury databáze zpráv se používá syntaxe podobná jako u zdrojů:

<code>
<nowiki></nowiki>
<nowiki></nowiki>
</code>

=== Test stavu zprávy ===

Další konstrukcí umožňující vkládat do stránky nějaký text podmíněně je test stavu zprávy. Syntaxe tohoto výrazu je

<code>
<nowiki></nowiki>
</code>

Používají se zde následující názvy stavů:

# ENTERED – vloženo
# PENDING - ke schválení
# APPROVED – schváleno
# PUBLISHED – publikováno
# SCHEDULED – odloženo
# EXPIRED – vypršelo
# ARCHIVED – archivováno

V praxi má smysl použít pouze stavy PUBLISHED nebo ARCHIVED, protože v ostatních případech by se podmíněně vkládaný text zobrazoval pouze v náhledu zprávy, což nemá přílišné využití.

Příkladem využití může být např. zobrazení informace o umístění zprávy do archívu v drobečkové navigaci. Pokud následující konstrukci umístíme v předloze pro zprávy do oblasti, ve které se nachází navíc nachází WebToDate navigace zobrazující tzv. drobečkovou navigaci, výsledek se může zobrazit tak, jak je naznačeno na následujícím otisku obrazovky.

<nowiki> » </nowiki>

[[Image:referencniprirucka-klicovaslovawebtodate-img172.png|center]]

== Klíčová slova pro listování fotogaleriemi ==
V těle stylu pro zdroje se v případě implementace listování fotogaleriemi (tj. možnosti posunu po jednotlivých fotografiích fotogalerie) mohou použít následující klíčová slova:

{| class="prettytable"
| <nowiki></nowiki>
| ID seznamu, který se právě zobrazuje (zde ID seznamu zobrazujícího fotogalerii)

|-
| <nowiki></nowiki>
| ID zprávy, ke které je právě zobrazovaná položka ze zdrojů připojena

|-
| <nowiki></nowiki>
| URL-enkódované URL zprávy převzaté z pole Odkaz nadpisu zprávy

|-
| <nowiki></nowiki>
| URL-enkódované URL právě zobrazované stránky

|}

Celý odkaz na zobrazení jedné fotografie má pak v nejjednodušším případě tvar

<code>
<nowiki><a href="/scripts/detail.php?id=&newsid=&listid="></nowiki>
</code>

Použijeme-li ve stylu pro zdroje formátujícího seznam náhledů obrázků ve fotogalerii výše uvedený výraz, znamená to, že návratová adresa ve stránce s detailem jedné fotografie (tj. v detailu zdroje) bude mít při dosazení za <nowiki></nowiki> výchozí tvar používaný WebToDate, čili ''/scripts/detail.php?id=xxx'', kde xxx je ID zprávy předané přes parametr ''newsid''. To nemusí být vždy žádoucí, např. pokud se zpráva s fotogalerií zobrazuje s vynucením nějaké šablony (přes parametr ''tmplid'' v URL) nebo se používají jiné SEO tvary URL zpráv, návratová adresa by mohla být jiná než původní adresa stránky se zprávou a mohlo by po kliku na návratové URL dojít i k zobrazení nesprávné stránky. Proto je možné uvést ještě parametr ''returnurl'', kterým se uvede, jaká je návratová adresa ze stránky s detailem zdroje. Odkaz má pak kód

<code>
<nowiki><a href="/scripts/detail.php?id=&newsid=&listid=&returnurl="></nowiki>
</code>

kde lze do parametru ''returnurl'' vkládat buď <nowiki> (pokud se má vždy návratová adresa shodovat s URL zprávy uloženém v poli Odkaz nadpisu zprávy) nebo </nowiki> (pokud se požaduje návrat na přesné URL, ze kterého se detail zdroje zobrazil).

V hlavičce a patičce stylu pro zdroje lze použít následující klíčová slova:

{| class="prettytable"
| <nowiki></nowiki>
| ID zprávy, ke které je právě zobrazovaná položka ze zdrojů připojena

|-
| <nowiki></nowiki>
| Odkaz nadpisu zprávy, ke které je právě zobrazovaná položka ze zdrojů připojena

|}

Tuto možnost lze využít k vytvoření odkazu na zobrazení fotogalerie v jiné předloze (např. kompletní fotogalerie) a to pouze v případě, že nějaká fotogalerie ve zprávě existuje.

<code>
<nowiki>Příklad: chceme mít možnost umístit do fotogalerie libovolné množství obrázků. Ve stránce se zprávou ale chceme zobrazit pouze první tři fotografie, kompletní fotogalerii pak
zobrazit až po kliku na nějaký odkaz ve stránce se zprávou. Toto lze řešit tak, že do předlohy pro zprávy umístíme seznam typu přílohy ke zprávě, který zobrazuje položky
z daného druhu seznamů, ale je omezen jen na tři položky. Dále vytvoříme další předlohu pro zprávy, která nemá např. vloženo tělo zprávy apod., ale má připojen seznam typu
přílohy ke zprávě, který zobrazuje položky ze stejného druhu seznamů, ale s neomezeným počtem položek.</nowiki>
</code>

Do hlavičky či patičky stylu zobrazujícího první tři fotografie ve stránce se zprávou pak umístíme odkaz

<code>
<nowiki><a href="&tmplid=255">Kompletní fotogalerie</a></nowiki>
</code>

kde 255 je ID druhé předlohy pro zprávy, která má zobrazit kompletní fotogalerii.

V předloze pro zdroje lze použít následující klíčová slova:

{| class="prettytable"
| <nowiki></nowiki>
| Odkaz na předchozí položku ve fotogalerii

|-
| <nowiki></nowiki>
| Odkaz na následující položku ve fotogalerii

|-
| <nowiki></nowiki>
| Pořadové číslo aktuální položky ve fotogalerii; pokud není v URL stránky uveden parametr ''listid'', dosadí se hodnota 1

|-
| <nowiki></nowiki>
| Celkový počet položek ve fotogalerii; pokud není v URL stránky uveden parametr ''listid'', dosadí se hodnota 1

|-
| <nowiki></nowiki>
| Odkaz na návrat zpět na fotogalerii

|-
| <nowiki></nowiki>
| ID zprávy, která obsahuje fotogalerii, do které aktuálně zobrazovaná položka patří

|}

Dále se mohou použít následující podmíněné výrazy:

<nowiki></nowiki> - kód se vkládá v případě, že existuje předcházející položka v galerii (aktuálně zobrazovaná položka není první)

<nowiki></nowiki> - kód se vkládá v případě, že existuje následující položka v galerii (aktuálně zobrazovaná položka není poslední)

<nowiki></nowiki> - kód se vkládá v případě, že je známá návratová adresa umožňující se vrátit zpět na fotogalerii (stránku s náhledy).

Příklad části předlohy pro zdroje obsahující funkci pro listování fotogalerií, je tedy následující:

<code>
<nowiki><div class="jednofoto"></nowiki>
<nowiki>" title="Předchozí obrázek v této fotogalerii"><< Předchozí</a>  ")--></nowiki>
<nowiki>" title="Následující obrázek v této fotogalerii">Následující >></a>")--></nowiki>
<nowiki> / ) | <a href="" title="Přeskočit na přehled všech obrázků v této
fotogalerii">Zpět na text</a><br /><br />")--></nowiki>
<nowiki><img src="" alt=""></nowiki>
<nowiki><br /></nowiki>
<nowiki><strong></strong></nowiki>
<nowiki>")--></nowiki>
<nowiki>")--></nowiki>
<nowiki></div></nowiki>
</code>

== Klíčová slova pro vkládání navigací ==
Pomocí klíčového slova <nowiki></nowiki> lze vložit WebToDate navigaci do stránky bez nutnosti přiřadit navigaci ze [[../Navigace a transformace|seznamu navigací]] do oblasti na stránce.

Klíčové slovo má dva parametry:

* ID [[../Navigace a transformace|navigace]], tak jak bylo přiděleno při založení nové navigace
* ID [[../Strom kategorií|kategorie]], tedy parametr určující pro příslušnou transformací, která kategorie je pro zobrazení navigace aktuální

Klíčové slovo se použije v těle WebToDate stylu nebo v šabloně stránky či předloze. V praxi se zpravidla v těle stylu použije konstrukce

<code>
<nowiki>)--></nowiki>
</code>

Díky tomu se navigace zobrazí u každé zprávy v závislosti na ID výchozí kategorie zprávy.

Příklad těla stylu využívajícího takto vloženou navigaci je následující:

<code>
<nowiki><div class="p1"></nowiki>
<nowiki></nowiki>
<nowiki><div class="popisek">)--></div></nowiki>
<nowiki><a href=""></a></nowiki>
<nowiki><div class="popisek2"></div></nowiki>
<nowiki></div></nowiki>
</code>

Výsledkem je zobrazení příslušné navigace zhruba tak, jak je vidět na následujícím otisku obrazovky.

[[Image:referencniprirucka-klicovaslova-navigace-priklad1.png|center]]

== Klíčová slova pro formátování ==
=== Velikost souborů ===

Pro speciální formátování je podporována možnost zobrazení velikosti souborů z databáze zdrojů v kB. Standardně je pro zobrazení velikosti k dispozici klíčové slovo <nowiki></nowiki>, které zobrazí velikost souboru v B. Kromě toho lze použít konstrukci, kterou lze zobrazit velikost v kB:

<nowiki>")--></nowiki>

Výraz má tedy tři parametry:

# Druh formátování – SIZE
# Předpis pro formátování – zde "kB" (převod na kB) nebo "MB" (převod na MB)
# Co se formátuje - <nowiki></nowiki> reprezentuje celé číslo – velikost v B, které se pomocí tohoto výrazu převádí na kB či MB.

Tento výraz je použitelný všude tam, kde samotné klíčové slovo <nowiki></nowiki>, tj. ve stylech pro seznamy příloh i pro jednotlivé instance zdrojů ve zprávách i v předloze pro zdroje (zobrazování přes skript ''detail.php'').

Jako třetí parametr nemusí být nutně uvedeno <nowiki>, může tam být jakýkoliv podporovaný výraz včetně konstantního čísla. Výraz </nowiki> tedy vrátí hodnotu 4. Při vyhodnocování se zjišťuje, jestli poslední parametr je celé číslo, pokud tomu tak je, provede se příslušné formátování, v opačném případě se vrací (tj. do stránky vloží) nezměněná hodnota třetího parametru.

Přepočet čísla v bytech na kB se provádí obvyklým zaokrouhlováním, minimum je ale 1, nikdy se tedy nezobrazí hodnota 0 kB. Při přepočtu se počítá 1 kB = 1024 B.

Druhou možností pro formátování velikosti souboru je

<nowiki>")--></nowiki>

Výraz má opět tři parametry:

# Druh formátování – SSIZE
# Oddělovač – znak(y) oddělující číslo a jednotku
# Co se formátuje - <nowiki></nowiki> reprezentuje celé číslo – velikost v B, které se pomocí tohoto výrazu převádí na jiné jednotky.

Formátování SSIZE vrátí zformátovanou velikost v závislosti na skutečné velikosti – velikost malých souborů (< 1 kB) bude velikost v bytech + znak B, středních (< 1 MB) v kilobytech + znak kB, velkých v MB plus znak MB. Druhý parametr definuje, co se vkládá mezi číslo a jednotku (např. mezera). Znaky jednotek (B, kB, MB) jsou zabudovány natvrdo a nejsou v parametrech.

=== Omezení délky vkládaného textu ===

Další možností konstrukce WTD_FORMAT je možnost omezit vložený text na nějaký maximální počet znaků. Typickým použitím je např. to, že chceme vkládat v nějakém seznamu popisy zpráv, ale zajistit, že ve stránce se zobrazí pouze např. prvních 200 znaků popisu. Syntaxe tohoto příkazu je následující:

<nowiki></nowiki>

Formátovací předpis obsahuje maximální výsledný počet znaků, volitelně řetězec, který se doplňuje, pokud dochází k oříznutí, a dále volitelně specifikace toho, zda dochází k převodu vybraných znaků na entity a odstranění HTML tagů (počet znaků je povinný, další údaje ne). Třetím parametrem (ořezávaný text) může být nějaký statický textový řetězec nebo nějaké klíčové slovo WebToDate.

Funkce pracuje tak, že pokud má třetí parametr tolik znaků kolik je uvedeno ve druhém parametru nebo méně, vrací přesně řetězec, který je třetím parametrem. Pokud má text více znaků je oříznut na daný počet znaků a od konce je navíc odříznuto poslední slovo nebo jeho zbytek (aby text nekončil v půli slova), na konec je doplněn řetězec daný druhou částí předpisu (doporučuje se HTML entita &hellip;, tj. 3 tečky, ale může to být cokoliv jiného).

Max. délka se tedy počítá dle znaků, to znamená např. entita &amp; je z 5 znaků z uvedeného počtu. Pro specifikaci převodu na entity a odstranění HTML značek se používají stejné parametry jako u [[#Převod znaků na HTML entity|<nowiki></nowiki>]].

Příkladem použití je výraz

<nowiki>")--></nowiki>

Toto znamená, že do stránky se vkládá popis zprávy. Pokud je popis kratší než 250 znaků, vloží se celý, pokud je delší, ořízne se výše popsaným způsobem a doplní se třemi tečkami.

V případě, že chceme zároveň převést vybrané znaky na entity a odstranit HTML tagy, použijeme následující tvar:

<nowiki>")--></nowiki>

Další příklady použití jsou např.:

<nowiki>")--></nowiki>

<nowiki></nowiki>

Tento výraz lze opět použít ve WebToDate stylech nebo v předlohách pro zprávy či zdroje.

=== Převod textu na malá nebo velká písmena ===
Je k dispozici převod formátovaného textu na malá resp. velká písmena. Příslušný výraz je

<nowiki></nowiki>

Parametry výrazu jsou

* volba formátování CHARCASE
* volba převodu na velká nebo malá písmena - možné hodnoty jsou UPPER a LOWER
* převáděný text

Příklad použití je tedy

<nowiki>")--></nowiki>

Pokud je hodnota druhého parametru jakákoli jiná než UPPER resp. LOWER, formátování vrací nezměněnou hodnotu třetího parametru (tj. formátovaný řetězec se do stránky vloží bez jakékoli změny).

<div class="note">'''Poznámka''': Je-li webová prezentace provozována v kódování utf-8, je pro správný převod znaků s diakritikou vyžadována instalace PHP extenze [http://cz.php.net/manual/en/book.mbstring.php mbstring]. Není-li extenze instalována, převod znaků s diakritikou v tomto případě není funkční. </div>

=== Formát data ===

Ve stránkách (stylech či předlohách pro zprávy) lze nastavit formátování konkrétního časového údaje. Syntaxe tohoto příkazu je následující:

<nowiki></nowiki>

V části formátovací předpis se uvádí formátovací řetězec v syntaxi PHP, kompletní seznam možností je uveden v dokumentaci PHP např. na stránce [http://cz.php.net/date http://cz.php.net/date]. Formátovaný časový údaj je pole WebToDate s datem (<nowiki>, </nowiki> apod.) nebo pevně daný řetězec s datem.

Příklady užití tedy jsou:

<nowiki>")--></nowiki> - zobrazuje datum aktualizace zprávy ve formátu 2007-11-27 (bez času)

<nowiki>")--></nowiki> - zobrazuje datum a čas aktualizace zprávy ve formátu 03.12.2007 11:55:00, tedy s úvodními nulami a s časem včetně sekund, hodiny ve 12ti hodinovém formátu

<nowiki>")--></nowiki> - zobrazuje datum a čas aktualizace zprávy ve formátu 26.11.07 21:16, tedy datum bez úvodních nul, z letopočtu jen poslední dvojčíslí, čas bez vteřin a s hodinami ve 24-hodinovém formátu.

=== Převod znaků na HTML entity ===

V některých případech je žádoucí v prezentační vrstvě automaticky převádět vybrané znaky v HTML kódu stránky na HTML entity, např. pokud má stránka vyhovět XHTML normě. Pomocí konstrukce WTD_FORMAT lze takto převádět následující entity v textu např. zprávy:

{|
|&quot;
| "
|-
|&amp;
| &
|-
|&lt;
| <
|-
|&gt;
| >
|}

Tento způsob formátování dále může z formátovaného textu odstraňovat HTML značky. Výrazem je tedy možné buď převádět vybrané znaky na entity nebo odstranit HTML značky nebo obojí najednou.

Syntaxe tohoto formátovacího příkazu je následující:

<nowiki></nowiki>

Za ''formátování'' lze zadat hodnoty:

* 0 (nebo jakákoli jiná hodnota kromě 1) - znaky " & <nowiki>< ></nowiki> se převádějí na výše uvedené entity
* 1 - kromě výše uvedených čtyřech znaků se ještě převádějí jednoduché uvozovky ' na číselnou entitu &#039;
* 0T - stejně jako hodnota 0, ale navíc se odstraní HTML značky
* 1T - stejně jako hodnota 1, ale navíc se odstraní HTML značky
* T - odstraní se HTML značky, na entity se žádné znaky nepřevádějí

Existuje tedy 5 přípustných hodnot parametru. Pokud je zadána jakákoli jiná hodnota parametru, formátovaný výraz se ve stránce ponechává beze změny.

Za výraz lze zadat nějaké klíčové slovo WebToDate odpovídající např. klíčovému slovu pro texty z databáze zpráv nebo zdrojů, nebo i statický text. Ve stylu či předloze pro zprávy tak lze použít např. výraz

<nowiki>")--></nowiki>

Tento výraz vloží do stránky nadpis zprávy a znaky " & <nowiki>< ></nowiki> vyskytující se případně v nadpisu zprávy převede před vložením do stránky na výše uvedené entity.

=== Převod řetězce na url-encoded tvar ===
V případě, že se má nějaký textový řetězec stát součástí nějakého URL uvedeného ve stránce, je vhodné jej převést na url-encoded tvar. To se dělá pomocí výrazu

<nowiki></nowiki>

Výraz má následující parametry:

* volba formátování URLENCODE
* způsob převodu
* formátovaný text

Pokud je zadán jako druhý parametr prázdný řetězec nebo cokoli jiného kromě hodnoty RAW, volá se na tuto konverzi PHP funkce [http://cz.php.net/manual/en/function.urlencode.php urlencode()], má-li druhý parametr hodnotu RAW, volá se PHP funkce [http://cz.php.net/manual/en/function.rawurlencode.php rawurlencode()].

Typická příklad použití je

<nowiki>")--></nowiki>

=== Formátování reálných čísel ===

Ve stránkách (stylech či předlohách pro zprávy) lze použít formátování reálných čísel, což má smysl zejména pro formátování položek přizpůsobitelné struktury databáze zpráv typu reálné číslo. Syntaxe tohoto příkazu je následující:

<nowiki></nowiki>

Řetězec ''formátovací předpis'' určuje formátování reálného čísla:

* Jako první nepovinný znak se uvádí oddělovač tisíců.
* Jako druhý znak je počet zobrazovaných desetinných míst.
* Jako třetí nepovinný znak se uvádí oddělovač desetinných čísel – desetinná tečka nebo čárka.
* Jako čtvrtý nepovinný znak je znak nahrazující desetinná místa, pokud jsou nulová – např. pomlčka. (pokud není definován, zobrazí se odpovídající počet nul)

Příklady použití výsledek:

<nowiki></nowiki> 9,10

<nowiki></nowiki> 9,-

<nowiki></nowiki> 9.000,00

=== Formátování pomocí regulárních výrazů ===
Ve stylech a předlohách lze použít formátování pomocí regulárních výrazů, což je vůbec nejuniverzálnější možnost, jak vybraný obsah stránek formátovat. Parametry se zadávají stejně jako u PHP funkce [http://cz.php.net/manual/en/function.ereg-replace.php ereg_replace()]. Syntaxe této možnosti formátu je následující:

<nowiki></nowiki>

Funkce nahradí část ''vstupního řetězce'', která vyhovuje regulárnímu výrazu (''pattern'') řetězcem ''náhrada''. V řetězci ''náhrada'' lze použít i metaznak ''\\číslice'', který určuje podvýraz regulárního výrazu. Metaznak ''\\0'' určuje celý řetězec vyhovující regulárnímu výrazu.

Jednoduché příklady použití možnosti formátování typu REGEXP jsou např.:

* Označení prvního znaku nadpisu zprávy tučně:

<nowiki>")--></nowiki>

* Nahrazení slova „Facebook“ v popisu zprávy plným odkazem na www.facebook.com:

<nowiki>")--></nowiki>

* Oříznutí popisu zprávy přesně na 100 znaků a doplnění tří teček na konec:

<nowiki>")--></nowiki>

* Nahrazení znaku @ za řetězec „- zavináč -“ v e-mailové adrese (při publikaci e-mailů např. v seznamu dotazů v modulu Poradny a rozhovory):

<nowiki>")--></nowiki>

* Vypsání jména před znakem @ v e-mailové adrese:

<nowiki>")--></nowiki>

* Vypsání názvu domény z e-mailové adresy za znakem @:

<nowiki>")--></nowiki>

Příklad WebToDate stylu pro zprávy, kde je pomocí tohoto formátování vyznačeno tučně první písmeno nadpisu zprávy, je tedy

<code>
<nowiki><div class="blok1"></nowiki>
<nowiki><a href=""></nowiki>
<nowiki>")--></nowiki>
<nowiki></a></nowiki>
<nowiki><div class="img160"></div></nowiki>
<nowiki><div class="desclarge"></nowiki>
<nowiki></nowiki>
<nowiki></div></nowiki>
<nowiki></div></nowiki>
</code>

== Klíčová slova pro podporu vícejazyčných webů ==
=== Vkládání odkazů na jiné jazykové verze zpráv či stránek ===

{| class="prettytable"
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Odkaz na jazykovou verzi stránky
| Vloží URL jazykové verze stránky zadané pomocí jejího ID, např.
<nowiki></nowiki> vloží odkaz na anglickou jazykovou verzi stránky s ID 20

|-
| <nowiki></nowiki>
| Odkaz na jazykovou verzi aktuální stránky
| Stejné jako v předchozím případě, ale za znak * se při generování vloží ID aktuálně generované stránky

|-
| <nowiki></nowiki>
| Odkaz na jazykovou verzi dané zprávy
| Vloží URL jazykové verze zprávy zadané pomocí jejího ID, např. <nowiki></nowiki> vloží odkaz na anglickou jazykovou verzi zprávy s ID 25

|-
| <nowiki></nowiki>
| Odkaz na jazykovou verzi aktuální zprávy
| Stejné jako v předchozím případě, ale za znak * se při generování vloží ID aktuálně zobrazované zprávy

|-
| <nowiki></nowiki>
| ID jiné jazykové verze aktuální zprávy
| Vloží ID jazykové verze aktuálně zobrazované zprávy v jazyce definovaném uvedenou zkratkou

|}

Pro nahrazování těchto klíčových slov hodnotou platí následující:

* Pokud je uvedeno konkrétní ID zprávy či stránky, nahradí se klíčové slovo odkazem okamžitě při generování stránky.
* Obsahuje-li klíčové slovo typu WTD_ART_LANG jako parametr hvězdičku, při generování stránky (tj. typicky předlohy pro zprávy) se toto klíčové slovo nenahradí a zůstává ve stránce. Konkrétní hodnota je dosazena až prezentačním skriptem při zobrazení celého textu zprávy.
* Obsahuje-li klíčové slovo typu WTD_PG_LANG jako parametr hvězdičku, nahradí se ve stránce hodnotou, jen pokud generovaná stránka nemá následníka ve stromu stránek, jinak ve stránce zůstává beze změny. To umožňuje toto klíčové slovo vložit do stránky, která je šablonou pro více různých stránek.

=== Podmíněné vkládání odkazů ===

{| class="prettytable"
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Vloží kód, pokud existuje daná jazyková verze stránky s daným ID
| Vkládaný HTML kód může opět obsahovat značky WebToDate

|-
| <nowiki></nowiki>
| Vloží kód, pokud neexistuje daná jazyková verze stránky s daným ID
| Vkládaný HTML kód může opět obsahovat značky WebToDate

|-
| <nowiki></nowiki>
| Vloží kód, pokud existuje daná jazyková verze zprávy s daným ID
| Vkládaný HTML kód může opět obsahovat značky WebToDate

|-
| <nowiki></nowiki>
| Vloží kód, pokud neexistuje daná jazyková verze zprávy s daným ID
| Vkládaný HTML kód může opět obsahovat značky WebToDate

|}

Pro nahrazování těchto podmíněných výrazů platí stejná pravidla jako v předchozí kapitole, lze je tedy bez problémů použít jako v předlohách pro zprávy tak v šablonách stránek.

Příklady:

<code>
<nowiki>">English version</a>")--></nowiki>
<nowiki></nowiki>
<nowiki>">Anglická verze článku </a>")--></nowiki>
</code>

== Další klíčová slova ==
V šabloně stránek lze použít klíčové slovo <nowiki></nowiki>, které reprezentuje titulek stránky. Toto klíčové slovo se ve stránce nahradí titulkem stránky pouze v případě, že stránka nemá následníka ve stromu kategorií. Analogicky funguje i klíčové slovo <nowiki></nowiki>, které reprezentuje URL právě generované stránky.

V šabloně stránek lze rovněž použít klíčové slovo <nowiki></nowiki>, které reprezentuje ID kategorie, ve které se stránka nachází.

WebToDate/Utility

2011-08-01T12:42:26Z

Tomasn:

[[Category:WebToDate Utility]]
[[Category:Utility]]
'''Příručka WebToDate utility'''
#[[/Úvod|Úvod]]
#[[/Mazání kategorií včetně obsahu|Mazání kategorií včetně obsahu]]
#:[[/Mazání kategorií včetně obsahu#Funkcionalita|Funkcionalita]]
#:[[/Mazání kategorií včetně obsahu#Spuštění utility|Spuštění utility]]
#:[[/Mazání kategorií včetně obsahu#Obsluha funkce|Obsluha funkce]]
#[[/Hromadná změna URL zpráv|Hromadná změna URL]]
#:[[/Hromadná změna URL zpráv#Funkcionalita|Funkcionalita]]
#:[[/Hromadná změna URL zpráv#Spuštění utility|Spuštění utility]]
#:[[/Hromadná změna URL zpráv#Obsluha funkce|Obsluha funkce]]
#[[/Odstranění fronty úloh v Plánovači úloh|Odstranění fronty úloh v Plánovači úloh]]
#:[[/Odstranění fronty úloh v Plánovači úloh#Funkcionalita|Funkcionalita]]
#:[[/Odstranění fronty úloh v Plánovači úloh#Spuštění utility|Spuštění utility]]
#:[[/Odstranění fronty úloh v Plánovači úloh#Obsluha funkce|Obsluha funkce]]
#[[/Vytvoření chybějících náhledů ve zdrojích|Vytvoření chybějících náhledů ve zdrojích]]
#:[[/Vytvoření chybějících náhledů ve zdrojích#Funkcionalita|Funkcionalita]]
#:[[/Vytvoření chybějících náhledů ve zdrojích#Spuštění utility|Spuštění utility]]
#:[[/Vytvoření chybějících náhledů ve zdrojích#Obsluha funkce|Obsluha funkce]]
#[[/Kontrola a přesuny souborů ve zdrojích|Kontrola a přesuny souborů ve zdrojích]]
#:[[/Kontrola a přesuny souborů ve zdrojích#Funkcionalita|Funkcionalita]]
#:[[/Kontrola a přesuny souborů ve zdrojích#Spuštění utility|Spuštění utility]]
#:[[/Kontrola a přesuny souborů ve zdrojích#Obsluha funkce|Obsluha funkce]]
#[[/Smazání cache navigací|Smazání cache navigací]]
#:[[/Smazání cache navigací#Funkcionalita|Funkcionalita]]
#:[[/Smazání cache navigací#Spuštění utility|Spuštění utility]]
#:[[/Smazání cache navigací#Obsluha funkce|Obsluha funkce]]
#[[/Výpis PHP konfigurace|Výpis PHP konfigurace]]
#:[[/Výpis PHP konfigurace#Funkcionalita|Funkcionalita]]
#:[[/Výpis PHP konfigurace#Spuštění utility|Spuštění utility]]
#[[/Nastavení týmu pro podkategorie|Nastavení týmu pro podkategorie]]
#:[[/Nastavení týmu pro podkategorie#Funkcionalita|Funkcionalita]]
#:[[/Nastavení týmu pro podkategorie#Spuštění utility|Spuštění utility]]
#:[[/Nastavení týmu pro podkategorie#Obsluha funkce|Obsluha funkce]]
#[[/Vytvoření výchozí stránky kategorie podle jiné stránky|Vytvoření výchozí stránky kategorie podle jiné stránky]]
#:[[/Vytvoření výchozí stránky kategorie podle jiné stránky#Funkcionalita|Funkcionalita]]
#:[[/Vytvoření výchozí stránky kategorie podle jiné stránky#Spuštění utility|Spuštění utility]]
#:[[/Vytvoření výchozí stránky kategorie podle jiné stránky#Obsluha funkce|Obsluha funkce]]

WebToDate/Přehled plánovaných úloh

2011-06-02T08:34:16Z

Tomasn: /* Standardně dodávané plánované úlohy */

== Standardně dodávané plánované úlohy ==
Následující tabulka obsahuje přehled standardně dodávaných [[../Referenční/Plánovač úloh|plánovaných úloh]] WebToDate. Některé úlohy jsou přibalovány k variantě [[../Referenční/Úvod#Varianty Standard a Enterprise|Enterprise]], některé k variantě [[../Referenční/Úvod#Varianty Standard a Enterprise|Standard]], některé úlohy jsou součástí modulů, které lze přikoupit k základní instalaci a některé úlohy jsou dodávány samostatně. Sloupec '''ID''' v tabulce odkazuje na identifikátor, který, je označen záznam úlohy v registračním souboru plánovaných úloh ''offlinedata/scheduler/registration.xml''.

{| class="prettytable"
| '''Úloha'''
| '''ID'''
| '''K čemu se používá'''
| '''Součást modulu či varianty'''

|-
| [[../Referenční/Plánovač úloh#Generování stránky|Generování stránky]]
| ''generator''
| Úloha umožňuje vygenerovat vybranou stránku (volitelně včetně podstránek v rámci stromu šablon) a případně automaticky převést schválené zprávy vložené ručně na generovanou stránku do stavu ''Publikováno''.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Akce|Akce]]
| ''action''
| Tato úloha umožňuje spouštět určitou WebToDate [[../Referenční/Akce#|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''.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Expirace|Expirace]]
| ''expiration''
| Úloha řídí [[../Referenční/Workflow obsahu#Časová platnost zpráv a zdrojů |časovou platnost zprávy]] podle časových hodnot nastavených ve formuláři pro zprávy. Nastaví zprávy do příslušného stavu ''Publikováno'', ''Archivováno'' nebo ''Vypršelo'' a přegeneruje odpovídající stránky.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Sumarizace počtu zhlédnutí|Sumarizace počtu zhlédnutí]]
| ''sumnewsimp''
| Úloha umožňuje po určité době automatické sečtení počtu zhlédnutí zpráv tak, aby se objem údajů v databázi o čtenosti zpráv udržoval v rozumných mezích. Úlohu má smysl nasadit jen pokud je aktivní [[../Extenze/Extenze pro sledování počtu shlédnutí|extenze pro sledování počtu shlédnutí]].
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Informační mail|Informační mail]]
| ''infomail''
| Odešle na vybranou e-mailovou adresu informaci o výsledcích předešlých kroků spuštěné sekvence plánovaných úloh.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Verifikace|Verifikace]]
| ''verify''
| Úloha zajišťuje automatické provedení zvolených kontrol modulu [[../Verifikace|Verifikace]].
| Modul je součástí varianty Enterprise

|-
| [[../XML export - import/Reference#Plánovaná úloha pro export|Export XML]]
| ''xmlexport''
| Úloha exportuje v XML formátu [[../Referenční/Zprávy|zprávy]], [[../Referenční/Zdroje|zdroje]] či [[../Referenční/Fragmenty|fragmenty]] dle nastavených kritérií, volitelně se spuštěním nějaké XSLT transformace na exportovaná data.
| [[../XML export - import|Modul XML Export - import]] je součástí varianty Enterprise

|-
| [[../XML export - import/Reference#Plánovaná úloha pro import|Import XML]]
| ''xmlimport''
| Úloha importuje v XML formátu [[../Referenční/Zprávy|zprávy]], [[../Referenční/Zdroje|zdroje]] či [[../Referenční/Fragmenty|fragmenty]] dle nastavených kritérií, volitelně se spuštěním nějaké XSLT transformace na importovaná data.
| [[../XML export - import|Modul XML Export - import]] je součástí varianty Enterprise

|-
| [[../XML export - import/Reference#Plánovaná úloha pro stahování XML přes http|RSS XML import]]
| ''neris_xmlimport''
| Úloha stahuje ze zadané URL adresy XML data a ukládá je do zvoleného adresáře. Na úlohu typicky navazuje v rámci sekvence [[../XML export - import/Reference#Plánovaná úloha pro import|úloha pro import XML]].
| [[../XML export - import|Modul XML Export - import]] je součástí varianty Enterprise

|-
| [[../Generování sitemap.xml|Generování sitemap.xml]]
| ''sitemap-pages'', ''sitemap-news'', ''sitemap-SQL'', ''sitemap-diary''
| Sada úloh zajišťuje automatické vytváření souborů [http://www.sitemaps.org sitemap.xml] obsahujících seznamy publikovaných [[../Referenční/Zprávy|zpráv]], [[../Referenční/Stránky a předlohy|stránek]], akcí modulu [[../Kalendář akcí|Kalendář akcí]] a seznamy URL daných nějakým SQL dotazem.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Cachování/Reference#Plánovaná úloha na mazání cache|Expirace cache]]
| ''CacheExpire''
| Úloha maže obsah souborové cache zobrazování zpráv v prezentační části.
| Je součástí rozšíření [[../Cachování|Cachování zpráv]], které je přibalováno k variantě Enterprise

|-
| [[../Registrace a personalizace/Reference#Plánované úlohy|Registrace - odstranění starých dat]]
| ''registrationremove''
| Odstraňuje zastaralé záznamy v databázových tabulkách pro uchovávání dat anonymních uživatelů. Jedná se o automaticky ukládané údaje, které moduly navázané na registrační modul ([[../Diskuze|Diskuze]], [[../Poradny a rozhovory|Poradny a rozhovory]], [[../Ankety|Ankety]] apod.) uchovávají v případě, že pracují v anonymním režimu.
| Je součástí modulu [[../Registrace a personalizace|Registrace a personalizace]]

|-
| [[../Registrace a personalizace/Reference#Plánované úlohy|Expirace registrovaných uživatelů]]
| ''regexpire''
| Slouží k tomu, aby bylo možné automaticky podle data expirace v registračních záznamech měnit stav těchto záznamů, např. změnit registrace uživatelů na neaktivní.
| Je součástí modulu [[../Registrace a personalizace|Registrace a personalizace]]

|-
| [[../Diskuze/Reference#Plánované úlohy|Antispamová kontrola - odstranění starších dat]]
| ''removecccodes''
| Pokud se používá ochrana proti spamu typu Opisování kontrolních kódů, je vhodné pomocí této úlohy odmazávat z databáze vygenerované záznamy pro kontrolní kódy, aby se udržel rozumný objem databáze.
| Je určena pro moduly [[../Diskuze|Diskuze]], [[../Poradny a rozhovory|Poradny a rozhovory]], [[../Formuláře a katalogy|Formuláře a katalogy]]

|-
| [[../Diskuze/Reference#Plánované úlohy|Rozesílání diskuzních příspěvků]]
| ''discmail''
| Rozesílá diskuzní příspěvky e-mailem na adresy, na které bylo zadáno zasílání ve chvíli vložení diskuzního příspěvku v prezentační části.
| Je součástí modulu [[../Diskuze|Diskuze]]

|-
| [[../Diskuze/Reference#Plánované úlohy|Odstranění starých subskripcí]]
| ''discsubscribers''
| Slouží k odstraňování starých subskripcí neboli objednávek odesílání e-mailů s diskuzními příspěvky. Pomocí této funkce lze hromadně odstranit objednávky na zasílání e-mailů, kde tyto objednávky jsou starší (datum vložení objednávky je starší) než počet dní zadaný v parametru úlohy.
| Je součástí modulu [[../Diskuze|Diskuze]]

|-
| [[../Ankety/Reference#Plánovaná úloha|Ankety - odstranění starých dat]]
| ''cleanvote''
| Slouží k promazávání databáze a odstraňování již nepotřebných dat modulu - záznamů o tom, zda konkrétní uživatel hlasoval na danou anketu.
| Je součástí modulu [[../Ankety|Ankety]]

|}

Aby úloha byla dostupná v [[../Referenční/Plánovač úloh|Plánovači úloh]], musí být registrována v souboru ''offlinedata/scheduler/registration.xml''. Jedná s o XML seznam úloh, kde každé úloze odpovídá jeden element typu ''<nowiki><task id="id_úlohy" originator="příslušnost k modulu"></nowiki>''. Programové kódy úloh lze nalézt v podadresářích adresáře ''scheduler/tasks/''. V každém takovém podadresáři je soubor pojmenovaný ''_registration_node.xml'', který obsahuje příslušný XML kód pro danou plánovanou úlohu. Pro registraci úlohy je třeba tento kód vložit do souboru ''registration.xml''.

WebToDate/Přehled plánovaných úloh

2011-06-02T08:33:11Z

Tomasn: /* Standardně dodávané plánované úlohy */

== Standardně dodávané plánované úlohy ==
Následující tabulka obsahuje přehled standardně dodávaných [[../Referenční/Plánovač úloh|plánovaných úloh]] WebToDate. Některé úlohy jsou přibalovány k variantě [[../Referenční/Úvod#Varianty Standard a Enterprise|Enterprise]], některé k variantě [[../Referenční/Úvod#Varianty Standard a Enterprise|Standard]], některé úlohy jsou součástí modulů, které lze přikoupit k základní instalaci a některé úlohy jsou dodávány samostatně. Sloupec '''ID''' v tabulce odkazuje na identifikátor, který, je označen záznam úlohy v registračním souboru plánovaných úloh ''offlinedata/scheduler/registration.xml''.

{| class="prettytable"
| '''Úloha'''
| '''ID'''
| '''K čemu se používá'''
| '''Součást modulu či varianty'''

|-
| [[../Referenční/Plánovač úloh#Generování stránky|Generování stránky]]
| ''generator''
| Úloha umožňuje vygenerovat vybranou stránku (volitelně včetně podstránek v rámci stromu šablon) a případně automaticky převést schválené zprávy vložené ručně na generovanou stránku do stavu ''Publikováno''.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Akce|Akce]]
| ''action''
| Tato úloha umožňuje spouštět určitou WebToDate [[../Referenční/Akce#|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''.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Expirace|Expirace]]
| ''expiration''
| Úloha řídí [[../Referenční/Workflow obsahu#Časová platnost zpráv a zdrojů |časovou platnost zprávy]] podle časových hodnot nastavených ve formuláři pro zprávy. Nastaví zprávy do příslušného stavu ''Publikováno'', ''Archivováno'' nebo ''Vypršelo'' a přegeneruje odpovídající stránky.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Sumarizace počtu zhlédnutí|Sumarizace počtu zhlédnutí]]
| ''sumnewsimp''
| Úloha umožňuje po určité době automatické sečtení počtu zhlédnutí zpráv tak, aby se objem údajů v databázi o čtenosti zpráv udržoval v rozumných mezích. Úlohu má smysl nasadit jen pokud je aktivní [[../Extenze/Extenze pro sledování počtu shlédnutí|extenze pro sledování počtu shlédnutí]].
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Informační mail|Informační mail]]
| ''infomail''
| Odešle na vybranou e-mailovou adresu informaci o výsledcích předešlých kroků spuštěné sekvence plánovaných úloh.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Referenční/Plánovač úloh#Verifikace|Verifikace]]
| ''verify''
| Úloha zajišťuje automatické provedení zvolených kontrol modulu [[../Verifikace|Verifikace]].
| Modul je součástí varianty Enterprise

|-
| [[../XML export - import/Reference#Plánovaná úloha pro export|Export XML]]
| ''xmlexport''
| Úloha exportuje v XML formátu [[../Referenční/Zprávy|zprávy]], [[../Referenční/Zdroje|zdroje]] či [[../Referenční/Fragmenty|fragmenty]] dle nastavených kritérií, volitelně se spuštěním nějaké XSLT transformace na exportovaná data.
| [[../XML export - import|Modul XML Export - import]] je součástí varianty Enterprise

|-
| [[../XML export - import/Reference#Plánovaná úloha pro import|Import XML]]
| ''xmlimport''
| Úloha importuje v XML formátu [[../Referenční/Zprávy|zprávy]], [[../Referenční/Zdroje|zdroje]] či [[../Referenční/Fragmenty|fragmenty]] dle nastavených kritérií, volitelně se spuštěním nějaké XSLT transformace na importovaná data.
| [[../XML export - import|Modul XML Export - import]] je součástí varianty Enterprise

|-
| [[../XML export - import/Reference#Plánovaná úloha pro stahování XML přes http|RSS XML import]]
| ''neris_xmlimport''
| Úloha stahuje ze zadané URL adresy XML data a ukládá je do zvoleného adresáře. Na úlohu typicky navazuje v rámci sekvence [[../XML export - import/Reference#Plánovaná úloha pro import|úloha pro import XML]].
|

|-
| [[../Generování sitemap.xml|Generování sitemap.xml]]
| ''sitemap-pages'', ''sitemap-news'', ''sitemap-SQL'', ''sitemap-diary''
| Sada úloh zajišťuje automatické vytváření souborů [http://www.sitemaps.org sitemap.xml] obsahujících seznamy publikovaných [[../Referenční/Zprávy|zpráv]], [[../Referenční/Stránky a předlohy|stránek]], akcí modulu [[../Kalendář akcí|Kalendář akcí]] a seznamy URL daných nějakým SQL dotazem.
| Obsaženo ve variantě Standard i Enterprise

|-
| [[../Cachování/Reference#Plánovaná úloha na mazání cache|Expirace cache]]
| ''CacheExpire''
| Úloha maže obsah souborové cache zobrazování zpráv v prezentační části.
| Je součástí rozšíření [[../Cachování|Cachování zpráv]], které je přibalováno k variantě Enterprise

|-
| [[../Registrace a personalizace/Reference#Plánované úlohy|Registrace - odstranění starých dat]]
| ''registrationremove''
| Odstraňuje zastaralé záznamy v databázových tabulkách pro uchovávání dat anonymních uživatelů. Jedná se o automaticky ukládané údaje, které moduly navázané na registrační modul ([[../Diskuze|Diskuze]], [[../Poradny a rozhovory|Poradny a rozhovory]], [[../Ankety|Ankety]] apod.) uchovávají v případě, že pracují v anonymním režimu.
| Je součástí modulu [[../Registrace a personalizace|Registrace a personalizace]]

|-
| [[../Registrace a personalizace/Reference#Plánované úlohy|Expirace registrovaných uživatelů]]
| ''regexpire''
| Slouží k tomu, aby bylo možné automaticky podle data expirace v registračních záznamech měnit stav těchto záznamů, např. změnit registrace uživatelů na neaktivní.
| Je součástí modulu [[../Registrace a personalizace|Registrace a personalizace]]

|-
| [[../Diskuze/Reference#Plánované úlohy|Antispamová kontrola - odstranění starších dat]]
| ''removecccodes''
| Pokud se používá ochrana proti spamu typu Opisování kontrolních kódů, je vhodné pomocí této úlohy odmazávat z databáze vygenerované záznamy pro kontrolní kódy, aby se udržel rozumný objem databáze.
| Je určena pro moduly [[../Diskuze|Diskuze]], [[../Poradny a rozhovory|Poradny a rozhovory]], [[../Formuláře a katalogy|Formuláře a katalogy]]

|-
| [[../Diskuze/Reference#Plánované úlohy|Rozesílání diskuzních příspěvků]]
| ''discmail''
| Rozesílá diskuzní příspěvky e-mailem na adresy, na které bylo zadáno zasílání ve chvíli vložení diskuzního příspěvku v prezentační části.
| Je součástí modulu [[../Diskuze|Diskuze]]

|-
| [[../Diskuze/Reference#Plánované úlohy|Odstranění starých subskripcí]]
| ''discsubscribers''
| Slouží k odstraňování starých subskripcí neboli objednávek odesílání e-mailů s diskuzními příspěvky. Pomocí této funkce lze hromadně odstranit objednávky na zasílání e-mailů, kde tyto objednávky jsou starší (datum vložení objednávky je starší) než počet dní zadaný v parametru úlohy.
| Je součástí modulu [[../Diskuze|Diskuze]]

|-
| [[../Ankety/Reference#Plánovaná úloha|Ankety - odstranění starých dat]]
| ''cleanvote''
| Slouží k promazávání databáze a odstraňování již nepotřebných dat modulu - záznamů o tom, zda konkrétní uživatel hlasoval na danou anketu.
| Je součástí modulu [[../Ankety|Ankety]]

|}

Aby úloha byla dostupná v [[../Referenční/Plánovač úloh|Plánovači úloh]], musí být registrována v souboru ''offlinedata/scheduler/registration.xml''. Jedná s o XML seznam úloh, kde každé úloze odpovídá jeden element typu ''<nowiki><task id="id_úlohy" originator="příslušnost k modulu"></nowiki>''. Programové kódy úloh lze nalézt v podadresářích adresáře ''scheduler/tasks/''. V každém takovém podadresáři je soubor pojmenovaný ''_registration_node.xml'', který obsahuje příslušný XML kód pro danou plánovanou úlohu. Pro registraci úlohy je třeba tento kód vložit do souboru ''registration.xml''.

WebToDate/Formuláře a katalogy/Reference

2011-05-27T11:06:08Z

Tomasn: /* Klíčová slova modulu */

[[Category:WebToDate Formuláře a katalogy]]
[[Category:Formuláře a katalogy]]
== Administrační rozhraní ==
=== Nabídka modulu ===

Kompletní nabídka modulu vypadá následovně:

'''Nástroje'''

:Položka

:Vyhledávací formulář

:Styly

:Vstupní formulář

:Potvrzovací formulář

'''Nastavení'''

:Seznam předpisů

:Globální

::Seznam katalogů

::Navigační lišta

::Filtr slov

::Další nastavení

:Předpisy

::''název předpisu''

:::Seznam položek

:::Jedna položka

:::Vyhledávání

:::Vkládání

'''Administrace'''

:Práva

:Antispamové profily

:Nový katalog

:''název katalogu''

::Pole

::Třídění

'''Data'''

:Seznam tabulek

:Katalogy

::''název katalogu''

:Import

:Export

:Soubory

:Protokoly

:Zakázané IP adresy

'''Nápověda'''

=== Nástroje ===

Funkce v této nabídce slouží k usnadnění práce při vývoji grafické prezentace katalogu, tj. stránek zobrazujících data katalogu i stránek se vstupními formuláři. Tyto funkce generují WebToDate fragmenty nebo WebToDate styly, které jsou v rámci vytváření definic těchto stránek využitelné. Princip fungování je v zásadě ten, že vždy vybereme, ke kterému katalogu chceme ten který element vygenerovat, funkce podle aktuální definice katalogu vygeneruje příslušný fragment (resp. styl). Tento objekt lze pak po stránce HTML kódu dále upravit a použít na příslušné předloze.
====Položka====
Funkce '''Položka''' generuje fragment, který můžeme použít jako část těla předlohy pro detailní zobrazení jedné položky katalogu.

[[Image:formulare_a_katalogy22-vytvoreni-html-fragmentu.jpg|center]]

V prvé řadě vyberte katalog, pro který chcete příslušný fragment vygenerovat. Dále vyberte jeho zařazení (kategorie apod.) a případně změňte název. Pomocí tlačítka '''Přidat HTML fragment''' se v databázi založí nový fragment, okamžitě se zobrazí tlačítko '''Vyhledat''', pomocí kterého lze přejít do režimu editace tohoto fragmentu.

V těle fragmentu se vygeneruje HTML tabulka se zhruba následujícím kódem.

<code>
<nowiki><table></nowiki>
<nowiki><tr valign="top"><td>Katalogové číslo</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Skladatel</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Interpret</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Titul</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Nosičů</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Nosič</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Čárový kód</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Na skladě</td><td></td></tr></nowiki>
<nowiki></table></nowiki>
</code>

Klíčová slova typu WTD_FC reprezentují jednotlivá pole datové tabulky katalogu, jejich názvy se samozřejmě pro každý katalog liší. Generují se ta pole, která mají ve vlastnostech nastaveno '''Zobrazovat na detailní stránce'''.

<div class="note">Fragment lze přiřadit na příslušnou předlohu pod vhodným stylem – tento styl typicky vkládá jen tělo fragmentu, jeho definice tedy vypadá většinou tak, že v těle obsahuje pouze klíčové slovo <nowiki></nowiki> (platí i pro všechny ostatní fragmenty v této kapitole).</div>

====Vyhledávací formulář====
Funkce '''Vyhledávací formulář''' generuje fragment s vyhledávacím formulářem použitelným pro daný katalog. Vygenerovaný kód vypadá zhruba následovně:

<code>
<nowiki><form action="" method="post"></nowiki>
<nowiki><label for="PRIJMENI">Příjmení</label></nowiki>
<nowiki><input type="text" id="PRIJMENI" name="PRIJMENI" value=""/></nowiki>
<nowiki><input type="submit" name="catalogue_search_button" value="Hledej!" /></nowiki>
<nowiki></form></nowiki>
</code>

Generují se ta pole, která mají ve vlastnostech nastaveno '''Použít při prohledávání'''. Takto vygenerovaný formulář je použitelný pouze v předlohách ke stránkám daného katalogu. Vyhledávací formulář lze vložit i na každou jinou stránku (např. úvodní stránku serveru), v tom případě je ale třeba předem nahradit klíčové slovo <nowiki></nowiki> za URL stránky pro zobrazování seznamu položek daného katalogu, tedy např. ''/scripts/modules/catalogue/list.php?catalogueid=2'' (včetně id katalogu).

====Styly====
Funkce '''Styly''' slouží k vygenerování WebToDate stylu formátujícího seznam položek katalogu. Tento styl se pak nastavuje v předpisu katalogu ('''Nastavení''' / '''Předpisy''' / název předpisu / '''Seznam položek'''). Vygenerovaný kód stylu je závislý na zvoleném katalogu, generuje se formou HTML tabulky, jeho tělo vypadá např. takto:

<code>
<nowiki><tr></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td><a href=""></a></td></nowiki>
<nowiki><td></td></nowiki>
<nowiki></tr></nowiki>
</code>

Klíčová slova typu WTD_FC opět reprezentují jednotlivá pole datové tabulky katalogu, klíčové slovo <nowiki></nowiki> reprezentuje URL pro zobrazení detailního pohledu na jednu položku. Generují se ta pole, která mají ve vlastnostech nastaveno '''Zobrazovat v seznamu''', odkaz se generuje na pole, které má nastavenou vlastnost '''Odkaz na detail''' (pokud takové existuje).

====Vstupní formulář====
Funkce '''Vstupní formulář''' slouží k vygenerování fragmentu s kódem pro formulář použitelný pro daný katalog na veřejné části. Do formuláře se generuje:

* Adresa skriptu pro uložení dat
* Chybová hlášení typu WTD_IF, která se zobrazují ve chvíli, kdy nastala některá z možností podle typu chybového hlášení
* Pole formuláře typu WTD_FCI
* Označení povinných polí s popiskem

Generují se ta pole katalogu, která mají ve vlastnostech nastaveno '''Data lze vkládat z veřejné části'''. Pole, která mají vlastnost '''Povinně vyplnit''', jsou ve vygenerovaném kódu označena.

<div class="note">Poznámka: Ve formuláři se jedná ale jen o grafické označení, povinné vyplnění dat je kontrolováno na straně serveru podle definice polí katalogu nezávisle na přesném tvaru vstupního formuláře.</div>

Definice polí katalogu obsahuje rovněž možnost zadat výchozí hodnotu. Tato výchozí hodnota se do kódu formuláře negeneruje, ale je vkládána až ve chvíli zobrazení stránky s formulářem záměnou za příslušné klíčové slovo typu WTD_FCI.

====Potvrzovací formulář====
Funkce '''Potvrzovací formulář''' slouží k vytvoření fragmentu, který lze použít pro zobrazení potvrzovací stránky před vlastním uložením dat do databáze. Výsledný kód je velmi podobný předchozímu případu, pouze pole typu WTD_FCI jsou ve formuláři vždy dvakrát – jednou v kódu stránky pro zobrazení, podruhé jako ''hidden'' pole formuláře za účelem vložení dat do databáze.

=== Nastavení ===

Tato část nabídky slouží k definování grafické podoby katalogů na veřejné části webu. Oddělují se dvě části – '''Globální''' a '''Předpisy'''. Globální nastavení je takové, které je společné pro celý modul, nastavení v předpisech jsou zpravidla jedinečná pro daný katalog (v některých případech je lze využít pro více katalogů se stejnou strukturou). ''Předpisem'' se rozumí souhrn nastavení pro více stránek – pohledů na data (seznam položek, jedna položka atd.)
====Seznam předpisů====
Pomocí funkce '''Seznam předpisů''' se zakládají nové předpisy, jedinou volbou při zakládání předpisu je jeho název. Po založení se předpis zobrazí v nabídce v této sekci '''Nastavení''', pod názvem předpisu jsou pak jednotlivé položky pro nastavení předpisu.

====Globální nastavení====
=====Seznam katalogů=====
Funkce '''Globální''' / '''Seznam katalogů''' definuje stránku zobrazující seznam katalogů na veřejné části. Tuto stránku (na URL ''/scripts/modules/catalogue/default.php'') lze využít v případě, že na serveru je definováno více katalogů určených pro zobrazování dat a chceme jednoduše zobrazit jejich seznam. Stránka je definovaná předlohou a stylem seznamu katalogů.

[[Image:formulare_a_katalogy24-nastaveni-parametru-seznamu-katalogu.jpg|center]]

URL s odkazem na daný katalog ve stylu seznamu katalogů se pak vždy generuje jako odkaz na stránku se seznamem položek katalogu, tedy /''scripts/modules/catalogue/list.php?catalogueid=číslo_katalogu''.

=====Navigační lišta=====
Ve formuláři '''Navigační lišta''' je definován vzhled lišty, která je používána pro stránkování seznamů položek.

[[Image:formulare_a_katalogy25-navigacni-lista.jpg|center]]

Grafický vzhled jednotlivých prvků navigační lišty se definuje pomocí následujících polí:

# '''Předchozí''' – HTML kód určující formátování odkazu pro přechod na předcházející stránku
# '''Následující''' – HTML kód určující formátování odkazu pro přechod na další stránku
# '''Hlavička''' – HTML kód který je umístěn na počátku výsledného kódu navigační lišty
# '''Patička''' – HTML kód který je umístěn na konci výsledného kódu navigační lišty
# '''Číslo stránky''' – formátování jednotlivých čísel stránky, které umožní odkliknutí na zvolenou stránku
# '''Aktivní stránka''' – formátování údaje o čísle aktuální stránky
# '''Separátor''' – oddělovač mezi jednotlivými čísly stránek.
# '''Počet stránek''' určuje maximální počet čísel stránek v navigační liště a tím nepřímo ovlivňuje i její šířku.

Pro správnou funkci navigační lišty je nutné do výše popsaných polí zadávat i klíčová slova<nowiki> a </nowiki>.

Jejich použití je zřejmé z následujícího jednoduchého příkladu:

[[Image:formulare_a_katalogy26-nastaveni-navigacni-listy.jpg|center]]

<div class="note">Definici navigační lišty je třeba po instalaci každého modulu v instalovaném modulu uložit – výchozí hodnoty se po instalaci v databázi nenacházejí a bez uložení se pak navigační lišta na žádné stránce nezobrazí.</div>

=====Filtr slov=====
Funkce '''Filtr slov''' umožňuje definovat slovník nevhodných výrazů. V horním seznamu se zobrazují slova seřazená podle abecedy, ve spodním rámci se zobrazuje editační formulář.

[[Image:diskuze37-filtr-slov.jpg|center]]

Ve slovech lze používat hvězdičku jako zástupný znak pro více libovolných písmen.

Součástí definice filtrovaného výrazu jsou i příznaky, zda výraz použít při filtraci nežádoucích výrazů a při detekci spamu.

Výrazy označené pro použití při detekci spamu se použijí jen v případě, že v antispamovém profilu, který používá daný katalog, je zvolena možnost ''Vyhledávání spamu podle obsahu příspěvků''.

=====Další nastavení=====
Pokud je v katalogu zapnuta jakákoliv ochrana proti spamu, je třeba nadefinovat, jak se má chovat skript pro vkládání záznamů do katalogu v případě, že je příspěvek označen za spam a do databáze se nevloží. Toto chování definuje volba '''Je-li příspěvek detekován jako spam'''. Na výběr jsou následující možnosti:

* '''Ukončit běh skriptu''' - okamžitě se ukončí běh skriptu pro vložení záznamu. Skript vypíše pouze identifikační značku dané metody kontroly spamu.
* '''Zobrazit stránku pro vložení příspěvku''' - znovu se načte formulář pro vložení záznamu do daného katalogu.
* '''Přesměrovat na zvolenou stránku''' - přesměruje na stránku, kterou je nutné v případě této volby zvolit, jedná se o libovolnou stránku ze stromu kategorií WebToDate.

====Nastavení předpisů====
Dále se v nabídce '''Nastavení''' nacházejí jednotlivé předpisy a jejich nastavovací formuláře (za předpokladu, že je alespoň jeden předpis založen). Každý předpis se skládá z nastavení '''Seznam položek''', '''Jedna položka''', '''Vyhledávání''' a '''Vkládání'''. V následující tabulce jsou uvedena URL stránek, ke kterým se tato nastavení vztahují:

{| class="prettytable"
| '''Seznam položek'''
| '''/''scripts/modules/catalogue/list.php?catalogueid=číslo_katalogu'''''

|-
| Jedna položka
| ''/scripts/modules/catalogue/detail.php?.....''

|-
| Vyhledávání
| ''/scripts/modules/catalogue/search.php?catalogueid=číslo_katalogu''

|-
| Vkládání
| ''/scripts/modules/catalogue/iform.php?catalogueid=číslo_katalogu''

|}

Před uložením kteréhokoliv z těchto formulářů je třeba předem založit příslušnou předlohu resp. předlohy, doporučený postup je založit stránku typu předloha v kategorii Formuláře a katalogy, jako šablonu zvolit předpřipravenou šablonu stránek, která obsahuje vhodnou definici oblasti. Kódy specifické pro danou předlohu je vhodné umístit do separátních fragmentů a ty pak přiřadit na oblast na dané předloze (a předlohu vygenerovat). V rámci jednoho předpisu není povinné volit předlohy a nastavení ve všech čtyřech formulářích – pokud se např. daný katalog používá pouze pro sběr dat pomocí formuláře, není třeba nastavovat vlastnosti zobrazení všech položek či jedné položky apod., ale pouze nastavení pro vkládání dat.

Obecné schéma popisující kroky od použité šablony po výslednou dynamickou HTML stránku je na následujícím obrázku (platí pro všechny moduly WebToDate).

[[Image:formulare_a_katalogy27-schema-uziti-sablony-dhtml.jpg|center]]

=====Seznam položek=====
Formulář '''Seznam položek''' definuje předlohu stránky, styl seznamu položek a počet položek na jednu stránku v rámci stránkování. Všechna tato nastavení je nutno při uložení povinně vyplnit.

===== Jedna položka=====
Formulář '''Jedna položka''' definuje předlohu pro detailní zobrazení jednoho záznamu, jedinou možností v tomto formuláři je právě nastavení této předlohy.

=====Vyhledávání=====
Formulář '''Vyhledávání''' definuje vlastnosti samostatné vyhledávací stránky, jedinou volbou je zde předloha stránky. Výsledky hledání prezentuje stránka '''Seznam položek''', nikoliv tato stránka. Proto je tato stránka použitelná pouze v případě, kdy chceme mít na jedné stránce vyhledávací formulář a na druhé výsledek hledání. V opačném případě je možné vyhledávací formulář (tedy typicky tělo samostatného fragmentu) použít i na předloze stránky '''Seznam položek''', výsledek bude z hlediska funkčnosti identický.

=====Vkládání=====
Posledním formulářem v předpisu je '''Vkládání'''. Charakterizuje všechny stránky, které se mohou týkat vkládání dat do daného katalogu z veřejně přístupného adresáře. Jedná se o tyto předlohy:

* Předloha pro vstupní stránku – použije se pro stránku, ve které je formulář pro vložení dat. Tato volba je ve formuláři povinná, ostatní jsou nepovinné.
* Předloha pro potvrzovací stránku – použije se volitelně pro stránku, která zobrazuje formulář pro potvrzení vložení dat, data jsou v ''hidden'' polích formuláře. Stránka je potřebná pouze pokud se tato funkce používá, neboli ve vlastnostech katalogu je zvoleno '''Potvrzovací stránka''' : '''Ano'''.
* Odmítnutí přístupu – používá se v případě, že ve vlastnostech katalogu je nastaveno čtení nebo zápis s omezením na skupinu vybraných uživatelů.<div class="note">Poznámka: Funkce vyžaduje instalaci modulu [[../../Registrace a personalizace|Registrace a personalizace]].</div> Stránka se vyvolá v případě, že uživatel se úspěšně přihlásí k modulu Registrace a personalizace, ale patří do skupiny, která nemá k dané funkci přístup. Pokud je čtení nebo vkládání dat omezeno na všechny registrované uživatele (ne vybranou skupinu), stránka se nikdy nepoužije a není proto třeba ji nastavovat.
* Předloha pro e-mail – používá se jako předloha pro e-mail s obsahem formuláře zasílaný na adresu definovanou ve vlastnostech katalogu, je potřebná v případě, že je v těchto vlastnostech nastaveno '''Veřejný formulář vyvolává''': '''Odeslání e-mailu''' nebo '''Obojí'''.
* E-mail od - zadává se e-mailová adresa, ze které odcházejí e-maily s daty z formuláře pro vkládání dat do katalogu v prezentační části.

[[Image:formulare_a_katalogy28-nastaveni-parametru-vkladani-predloha-emailu.png|center]]

V případě využívání této funkce pro vkládání dat z formuláře je v zásadě třeba si připravit ještě jednu stránku, a to tu, která se má uživateli zobrazit po úspěšném vložení dat. URL této stránky se ale nedefinuje v tomto nastavení, ale přímo v kódu formuláře v poli ''returnurl''.

=== Administrace ===

Tato část nabídky slouží k zakládání nových katalogů, k definování jejich vlastností a k definování seznamu a vlastností polí katalogů.
====Práva====
První položkou nabídky jsou '''Práva'''. V tomto formuláři se způsobem obvyklým ve všech modulech nastavují práva pro editaci dat jednotlivých katalogů. Po založení katalogu mají právo na editaci dat pouze administrátoři. V tomto formuláři lze tato práva nastavit i pro členy vybraných týmů. V levé části vyberte příslušný katalog, v pravé části vyberte tým a pomocí příslušného tlačítka jej přeřaďte do seznamu '''Autorizované týmy'''.

====Antispamové profily====
V nabídce '''Antispamové profily''' se definují nastavení ochrany proti formulářovému spamu. Antispamový profil je pojmenovaná sada nastavení, pomocí kterých se vybírá, jaký typ ochrany se pro vkládání záznamů aplikuje. Na úrovni definice katalogu se pak vybírá odpovídající profil, který daný katalog použije. Všechny katalogy mohou využívat stejný profil nebo je možné nadefinovat více profilů a ty pak nastavit u různých katalogů dle potřeby.

V horní části okna prohlížeče je seznam profilů, klepnutím na název profilu se zobrazí formulář pro definici profilu.

[[Image:poradny-administrace-antispamoveho-profilu.png|center]]

Přidávat profily a měnit jejich nastavení je možné bez omezení, smazat profil lze jen když není použit u nějakého katalogu.

V následující tabulce je stručně uveden význam jednotlivých voleb, problematice spamu je věnována samostatná kapitola [[../Ochrana proti spamu#Ochrana proti spamu|Ochrana proti spamu]].

{| class="prettytable"
| '''Položka'''
| '''Význam'''
| '''Kroky potřebné pro implementaci'''

|-
| Kontrola URL volající stránky
| Pomocí http ''referer'' se kontroluje, že skript pro vložení záznamu je volán z formuláře zobrazovaného pomocí tohoto modulu na daném serveru. Pokud se cizí aplikace pokouší přímo přes http protokol vložit příspěvek (nevyplňuje formulář na serveru), je příspěvek detekován jako spam.
| Kontrola nevyžaduje žádné další kroky.

|-
| Formulářová návnada
| Do pole '''Názvy polí formuláře''' se zadá jeden nebo několik názvů HTML polí ve vstupním formuláři (názvy se oddělují středníkem). Kontrola zjišťuje, jestli některé z těchto polí není čímkoli vyplněno, pokud zjistí, že některé pole má hodnotu, je příspěvek označen za spam.
| Kontrola vyžaduje vložení jednoho nebo několika formulářových polí do HTML kódu vstupního formuláře pro zadávání nových záznamů. Pole musí být skryta před uživatelem (jako typ ''hidden'' či pomocí CSS). Člověk pak takové pole nevyplňuje, spamovací robot jej může vyplnit.

|-
| Seznam zakázaných IP adres
| Při vložení se kontroluje, zda IP adresa, ze které záznam přichází, není na seznamu zakázaných adres. Pokud tomu tak je, je položka označena za spam.
| Nevyžaduje žádné změny v prezentaci, ale vyžaduje zadání zakázaných IP adres pomocí funkce '''Data''' - '''Zakázané IP adresy''' nebo vložením IP adresy přímo z formuláře pro úpravu záznamu.

|-
| Vyhledávání spamu podle obsahu příspěvků
| V textu příspěvků se před vložením vyhledávají slova zadaná ve funkci '''Filtr slov''' s volbou '''Spam'''.
| Nevyžaduje žádné změny v prezentaci, ale vyžaduje naplnění seznamu nežádoucích výrazů pomocí funkce '''Filtr slov'''.

|-
| Opisování kontrolních kódů
| Uživateli jsou generovány do stránky kontrolní kódy, které musí opsat do daného textového pole. Lze navolit parametry kontrolních kódů - délku, zda se jedná o číslice či písmena apod.
| Vyžaduje do HTML kódu vstupního formuláře doplnění několika vstupních polí a klíčových slov modulu, aby bylo zajištěno zobrazení kontrolních kódů a zobrazilo se vstupní pole pro jejich opsání.

|}

====Nový katalog====
Pomocí další položky nabídky '''Nový katalog''' se zakládají katalogy.

[[Image:formulare_a_katalogy29-administrace-novy-katalog.png|center]]

Povinně se zde vyplňuje název katalogu, volí datová tabulka, nad kterou se katalog vytváří a pole pro jednoznačnou identifikaci záznamů v rámci dané datové tabulky (sloupec datové tabulky, který obsahuje vhodné jedinečné hodnoty, tyto hodnoty musí být použitelné v URL). Ostatní položky jsou nepovinné.

V nabídce '''Datová tabulka''' se ve výchozím stavu zobrazují názvy tabulek spravovaných modulem, tj. těch, jejichž názvy začínají na písmena KATD. Pokud je třeba založit katalog nad tabulkou s jiným názvem, existuje tato možnost – je toto třeba povolit v souboru ''global.php'' v konstantě CATALOGUE_TABLES (viz kapitola
[[../Instalace#Konfigurace v global.php|Konfigurace v global.php]]). Tato volba ovšem pak umožňuje manipulaci s daty této tabulky i s její strukturou (včetně smazání), takže tuto možnost je třeba používat s opatrností. Po založení katalogu již volbu datové tabulky nelze změnit.

V tomto formuláři lze dále volit:

* '''Předpis''' – změnou předpisu dojde ke změně grafických nastavení všech veřejně přístupných stránek patřících k danému katalogu. Jak je vysvětleno v kapitole [[../Pracovní postupy|Pracovní postupy]], při zakládání nového katalogu zpravidla ještě definice předpisu není vytvořená, výjimkou může být pouze opakované použití předpisu pro více katalogů s totožnou strukturou.
* '''Antispamový profil''' - volba [[../Ochrana proti spamu|antispamového profilu]]
* '''Data jsou přístupná pro čtení''' – tato volba definuje, kdo může zobrazovat data katalogu pomocí veřejně přístupných skriptů modulu. Pokud je zvoleno '''Nikomu''', stránky pro zobrazení dat katalogu vypíší pro dané ID katalogu chybové hlášení typu "Katalog nebyl nalezen" i v případě, že všechna ostatní nastavení (předpis apod.) jsou v pořádku a funkční. Další možnosti jsou '''Všem''' (tj. všem anonymním uživatelům) a '''Registrovaným''' s možností nepovinně ještě přístup omezit na vybranou skupinu uživatelů z modulu Registrace a personalizace. V případě, že je použita poslední volba, probíhá před zobrazením stránky s daty katalogu zjišťování, zda je uživatel k modulu Registrace a personalizace přihlášen, pokud tomu tak není, je přesměrován na přihlašovací stránku modulu Registrace a personalizace.
* '''Vkládat data mohou''' – tato volba je analogická předchozí volbě, pouze se vztahuje na možnost vkládání dat pomocí skriptu ''iform.php''.
* '''Přihlašovací režim''' – význam volby je stejný jako v ostatních modulech spolupracujících s modulem Registrace a personalizace. Možnost '''Vyžadovat přihlášení vždy''' vyvolá přihlašovací formulář vždy, když v rámci ''session'' není uživatel přihlášen, možnost '''Rozpoznávat registrované uživatele''' se pokouší identifikovat registrovaného uživatele pomocí cookies, které modul Registrace a personalizace vytváří. Pokud je uživatel pomocí tohoto ''cookie'' jednoznačně identifikován, je přihlášen automaticky, v opačném případě opět dojde na přihlášení přes formulář.
* '''Veřejný formulář vyvolává''' – pokud je daný katalog určen k tomu, aby pracoval se vstupním formulářem z veřejné části, v této volbě je třeba nadefinovat, zda se data z formuláře zapisují do datové tabulky, nebo odesílají e-mailem nebo oboje. Pokud je použito odesílání e-mailem, je třeba zadat e-mailovou adresu, na kterou se pošta odesílá a předmět těchto e-mailů.
* '''Potvrzovací stránka''' – v této volbě lze určit, zda po odeslání formuláře s daty dochází rovnou k zápisu dat nebo se má ještě zobrazit potvrzovací stránka a teprve po schválení v této potvrzovací stránce dojde k zápisu dat z formuláře.

Dále se v nabídce '''Administrace''' zobrazují jednotlivé katalogy. Klepnutím na název katalogu se zobrazují vlastnosti katalogu. Tento formulář je identický s formulářem pro založení nového katalogu, jedinou změnou je, že nelze změnit výběr datové tabulky.

====Pole a Třídění====
V nabídce se pod názvem katalogu zobrazují možnosti '''Pole''' a '''Třídění'''. Pomocí funkce '''Pole''' se zakládají pole katalogu, zpravidla platí, že co sloupec datové tabulky to jedno pole katalogu. Formulář pro vlastnosti polí je zobrazen na následujícím otisku obrazovky, každé pole je třeba explicitně do katalogu přidat (např. odkazem '''Přidat''' vpravo nahoře).

[[Image:formulare_a_katalogy30-nastaveni-polozky-katalogu.png|center]]

Význam jednotlivých políček tohoto formuláře je následující:

* '''Pořadové číslo''' – je třeba povinně explicitně zadat celé číslo, podle kterého se pole řadí. Podle tohoto čísla se řadí pole ve všech případech, kdy se generují fragmenty či styly v sekci '''Nástroje''', podle tohoto čísla jsou rovněž seřazena editační pole v automaticky sestavovaném editačním formuláři dat katalogu v administračním rozhraní v sekci '''Data'''.<div class="note">Nástroje: Ve vygenerovaném stylu či fragmentu lze ovšem dodatečně pořadí zobrazování polí katalogu jednoduše změnit prostým přesunem příslušných klíčových slov pro obsah polí v HTML kódu fragmentu či stylu.</div>
* '''Jméno pole v databázi''' – volí se z nabídky názvů polí tak jak jsou definována v datové tabulce katalogu.
* '''Zobrazování pole''' – zadává se povinně popisek. Tento popisek se používá jednak při zobrazování v administrační části (např. ve formuláři při editaci dat), dále jej používají funkce v sekci '''Nástroje''' při vytváření fragmentů či stylů – po vygenerování takového objektu lze ovšem opět tyto popisky v HTML kódu jakkoliv měnit či dokonce odstranit. Maximální délka popisku je 50 znaků.
* '''Zobrazovat v seznamu''' – udává, zda chceme zobrazovat pole ve stránce pro zobrazení seznamu položek katalogu. Pokud je zvoleno, nástroj pro generování stylu zahrne toto pole do zobrazení. Pokud klíčové slovo pro dané pole ze stylu pro zobrazení seznamu dodatečně odstraníme, pole nebude v seznamu zobrazováno. Pokud naopak dodatečně zrušíme tuto volbu v tomto formuláři, pole opět nebude zobrazováno, přestože odpovídající klíčové slovo ve stylu pro seznam položek zůstane.
* '''Odkaz na detail''' – toto pole má dvojí význam. Při generování stylu pro seznam položek se na toto pole umístit odkaz na detailní zobrazení (neboli HTML značka <nowiki><a></nowiki>), nástroj pro editaci dat katalogu v administrační části na toto pole umístí odkaz na otevření editačního formuláře pro editaci záznamu v seznamu záznamů.
* '''Zobrazovat na detailní stránce''' – pokud je tato volba zvolena, fragment vygenerovaný pomocí funkce '''Položka''' obsahuje klíčové slovo pro toto pole. Pokud klíčové slovo z fragmentu manuálně odstraníme, obsah pole se v detailním pohledu na jeden záznam nezobrazuje stejně tak jako v případě, kdy klíčové slovo ve fragmentu ponecháme ale dodatečně zrušíme tuto volbu v tomto formuláři.
* '''Používat při prohledávání''' – Tato volba má dvojí význam. Jednak specifikuje, že podle daného pole je možné prohledávání v administračním rozhraní při editaci dat, jednak toto pole generuje funkce '''Vyhledávací formulář''' v sekci '''Nástroje''' do příslušného fragmentu. Podporována je možnost hledání pouze u některých datových typů (podle definice typu v datové tabulce) – konkrétně pro textové datové typy a pro celočíselné datové typy. Pokud je tedy např. v datové tabulce sloupec typu ''datum'', nelze v tomto formuláři zvolit jeho prohledávání.
* '''Zobrazovat v seznamu při úpravách''' – pomocí této volby se specifikuje, která pole se zobrazují v seznamu položek v nástroji pro editaci dat v administračním rozhraní. Pokud potřebujete data katalogu v administračním rozhraní editovat, je třeba aspoň jedno pole katalogu označit touto volbou.
* '''Data lze vkládat z veřejné části''' – tato volba vyznačuje, že do tohoto pole je možné vkládat data pomocí vstupního formuláře veřejné části. Takto označená pole generuje funkce '''Vstupní formulář''' v sekci '''Nástroje''' do HTML kódu fragmentu. Pokud je dodatečně tato volba zrušena, je potřeba i příslušné klíčové slovo typu WTD_FCI odstranit z fragmentu – skript pro vkládání dat s klíčovým slovem příslušným k danému poli přestane pracovat a výsledkem je chyba typu FIELDSNOACCESS (viz chybové stavy v kapitole Veřejné skripty).
* '''Výchozí hodnota''' – v tomto poli lze definovat výchozí hodnotu, která se předvyplní jak v administračním rozhraní ve formuláři pro editaci dat, tak ve veřejném formuláři dosazením hodnoty za příslušné klíčové slovo typu WTD_FCI.
* '''Povinně vyplnit''' – volba vyznačuje, že pole musí povinně obsahovat nějakou hodnotu. Povinné vyplnění se kontroluje jak při vkládání dat formulářem z veřejné části tak při editaci dat v administračním rozhraní.
* '''Jedinečná hodnota''' - volba vyznačuje, že pole musí obsahovat jedinečnou hodnotu v rámci daného sloupce datové tabulky. Hodnota se kontroluje jak při vkládání dat formulářem z veřejné části tak při editaci dat v administračním rozhraní.
* '''Typ pole''' - rozevírací nabídka s možnostmi ''Běžné pole / ID souboru ze zdrojů''. Volba ''Běžné pole'' je určena pro vstupní pole zadávaná běžným způsobem, která reprezentují nějaký text, číslo apod. Volba ''ID souboru ze zdrojů'' je určena k tomu, aby bylo možné do dané tabulky vkládat odkazy na soubory z databáze zdrojů pomocí jejich ID. Volbu ''ID souboru ze zdrojů'' lze provést jen pro takové pole datové tabulky, jehož datový typ je celé číslo.

Je-li nějaké pole označené jako '''Jedinečná hodnota''', '''Povinně vyplnit''' a zároveň je použito jako pole pro jednoznačnou identifikaci ve vlastnostech katalogu a jeho typ je celočíselný, modul jej při vkládání dat z veřejně přístupného formuláře autoinkrementuje, počáteční hodnota je 1.

Druhou funkcí je '''Třídění'''. Pomocí definic třídění se specifikuje, v jakém pořadí se budou zobrazovat položky katalogu v zobrazení seznamu položek, týká se to jak zobrazení na veřejné části webu tak v administračním rozhraní pro editaci dat. Pravidel pro třídění pro vybraný katalog lze zadat více, pořadí v jakém se třídící kritéria uplatní se definují ve formuláři pro editaci způsobu třídění.

[[Image:formulare_a_katalogy31-trideni-kriterii.jpg|center]]

Zadává se pole, podle kterého se třídí (výběrem z polí datové tabulky), pořadí v pravidlech třídění a způsob třídění (vzestupně, sestupně).

=== Data ===

Nabídka modulu v této části umožňuje:

* Zakládat nové datové tabulky, měnit jejich strukturu či je mazat
* Exportovat z datových tabulek data a naopak je do nich importovat
* Spravovat soubory k importu a exportované soubory
* Editovat data jednotlivých katalogů

====Seznam tabulek====
První položkou nabídky je '''Seznam tabulek'''. V pravé horní části se zobrazí seznam datových tabulek katalogu, u každé tabulky jsou tlačítka '''Náhled''', '''Export''' a '''Editovat'''.

Funkce '''Náhled''' je nejrychlejší způsob, jak zkontrolovat obsah tabulky – zobrazí v režimu pouze pro čtení prvních několik desítek záznamů v datové tabulce.

Společný formulář se používá pro zakládání nové tabulky (odkaz '''Přidat''' vpravo nahoře) a editaci struktury existující tabulky (tlačítko '''Editovat''').

[[Image:formulare_a_katalogy32-vytvareni-tabulky.jpg|center]]

Formulář má dvě záložky – v záložce '''Tabulka''' se zadává pouze jméno tabulky (automaticky se ke jménu předřazují písmena KATD), v záložce '''Sloupce''' lze měnit strukturu tabulky.

Editor struktury tabulek mění strukturu okamžitě po potvrzení editace daného řádku, nelze tedy např. přidat několik sloupců na straně prohlížeče a pak změnu dávkově odeslat na server. Tlačítko '''Odebrat sloupec''' funguje bez potvrzování, změna se okamžitě provede. Pokud klepneme do kteréhokoliv pole v editačním řádku, ostatní řádky se uzamknou a formulář je v režimu změny vybraného sloupce tabulky.

Názvy sloupců lze volit libovolně s těmito omezeními:

* Tabulka nesmí obsahovat dva sloupce stejného názvu
* Maximální délka názvu je 50 znaků
* Doporučujeme v názvech sloupců používat pouze písmena bez diakritiky a čísla, nikoliv např. mezery apod.

Datové typy se specifikují výběrem v poli '''Typ sloupce'''. Možné hodnoty jsou:

* Celé číslo
* Znak
* Řetězec
* Text
* Reálné číslo
* Datum

Typ ''Znak'' volte v případě, že pole má obsahovat menší a vždy stejný počet znaků. Typ ''Řetězec'' volte v případě, že pole obsahuje pokaždé jiný omezený (typicky do 255) počet znaků. Typ ''Text'' volte pro delší texty.

Délky polí lze volit pouze u typů ''Řetězec'' a ''Znak'', u ostatních polí se délky nastavují automaticky a nelze je měnit.
<div class="note">Řetězec a Znak: Maximální délky těchto polí jsou omezeny, omezení závisí na konkrétním typu použité databáze a její verze – tato omezení je třeba zjistit v dokumentaci k dané databázi, jedná se o maximální délky typů VARCHAR a CHAR.</div>

Pole lze rovněž opatřit databázovým indexem. Index je struktura databáze, která zrychluje přístup k datům podle daného sloupce. Použijte tuto možnost v případě, že se podle tohoto pole má třídit nebo vyhledávat. Pole typu ''Text'' nelze indexovat.

<div class="note">Strukturu datových tabulek lze měnit i v případě, že tabulka již obsahuje data. Je proto vhodné postupovat velmi obezřetně, data z odstraněného sloupce již rozhodně nelze obnovit.</div>

====Katalogy====
Další funkcí je editace dat katalogů. Pod nabídkou '''Data''' / '''Katalogy''' se zobrazují názvy existujících katalogů, klepnutím na název se přechází do nástroje pro editaci dat katalogu. Obrazovka může vypadat např. tak, jak je znázorněno na následujícím otisku.

[[Image:formulare_a_katalogy33-editace-katalogu.png|center]]

V horní části se zobrazuje stránkovaný seznam položek, vpravo nahoře jsou odkazy pro stránkování, přidání nového záznamu a přechod na vyhledávání. V seznamu se zobrazují ty sloupce, které mají v definici katalogu zvoleno '''Zobrazovat v seznamu při úpravách'''. Klepnutím na položku se ve spodní části otevírá editační formulář. Odkaz na otevření tohoto formuláře se umístí na to pole, které má v definici katalogu zvoleno '''Odkaz na detail'''.

Pomocí editačního formuláře lze záznamy měnit, mazat i přidávat. Formulář nemusí obsahovat všechny sloupce datové tabulky – obsahuje jen ty sloupce, pro které je definováno pole katalogu. Pořadí polí ve formuláři je dáno vlastností '''Pořadové číslo''' v definici pole katalogu. Formulář používá i další vlastnosti polí katalogu jako výchozí hodnoty a jedinečnost údaje ve sloupci tabulky. Je-li součástí formuláře pole pro jednoznačnou identifikaci, jeho popisek je zvýrazněn tučně. Pokud je pole označeno jako ''Povinně vyplnit'', přidávají se za název pole v popisku formuláře znaky (*). Pokud je pole v datové tabulce typu ''text'', objevuje se vedle vstupního pole ikona WYSIWYG editoru, po klepnutí na tuto ikonu lze obsah tohoto pole měnit a formátovat pomocí tohoto editoru.

Je-li v definici polí katalogu pole typu ''ID souboru ze zdrojů'', příslušný řádek formuláře pro toto pole vypadá tak, jak je patrno z následujícího otisku obrazovky (pole "Obrázek").

[[Image:formulare_a_katalogy-data-s-obrazkem.png|center]]

Do pole lze pak vložit jen celé číslo, které existuje jako ID souboru v databázi zdrojů. Pomocí tlačítka '''Náhled''' se vyvolá náhled tohoto souboru v novém okně prohlížeče, pomocí tlačítka '''Vložit''' se vyvolá formulář pro výběr souboru z databáze zdrojů.

[[Image:formulare_a_katalogy-vyber-obr.png|center]]

V horní části tohoto okna je vyhledávací formulář pro vyhledávání v databázi zdrojů, vyhledat můžete dle jakékoli kombinace metadat. Ve spodní části se po vyhledávání zobrazí seznam zdrojů odpovídající vyhledávací podmínce, u každého zdroje je seznam všech souborů ve zdroji. Klepnutím na šipku vlevo od názvu souboru se do formuláře pro editaci záznamu katalogu vkládá ID souboru, po klepnutí na šipku se toto okno uzavírá.

Vyhledávání používá ta pole, která mají v definici katalogu nastaveno '''Používat při prohledávání'''. Pokud je vyplněno více polí vyhledávacího formuláře, spojují se ve vyhledávací podmínce logickou spojkou "a zároveň".

[[Image:formulare_a_katalogy34-vyhledavani-zaznamu.jpg|center]]

Je-li nastaveno prohledávání podle aspoň jednoho textového pole, obsahuje formulář zaškrtávací okénko z volbou, zda prohledávat jen začátky textových polí. Pokud je toto zvoleno, musí obsah pole začínat na zadaný text, v opačném případě musí pole obsahovat (kdekoliv) zadaný text. Žádné složitější vyhledávací výrazy nejsou podporovány.

Jako poslední jsou v v nabídce '''Data''' funkce pro export a import dat. Pro manipulaci se soubory, které se mají importovat, resp. s exportovanými soubory slouží funkce '''Soubory'''. Grafické rozhraní této funkce zpřístupňuje obsah adresáře ''wwwroot/data'' a jeho podadresářů. Výchozí složky jsou

''/data/katalogy/export/''

pro export dat, resp.

''/data/katalogy/import/''

pro import dat. Adresář pro import lze změnit tak jak je popsáno v kapitole Konfigurace v global.php. Je nutné ručně zajistit, aby exportní i importní adresář existovaly, v opačném případě funkce pro export resp. import nejsou funkční.

V levé části okna pro soubory se přechází mezi složkami. V pravé části se zobrazuje obsah složky, klepnutím na název souboru se zobrazí jeho náhled, tak jak je vidět na následujícím otisku obrazovky.

[[Image:formulare_a_katalogy35-zobrazeni-struktury-slozek-nahledy.jpg|center]]

Tlačítko '''Přidat soubor''' použijte v případě, že chcete do adresáře na serveru kopírovat soubor připravený k importu a umístěný na lokálním disku počítače. Naopak tlačítko '''Stáhnout soubor''' použijte v případě, že chcete na lokální disk stáhnout exportovaný soubor.
<div class="note">Poznámka: Maximální velikost souboru při kopírování z lokálního počítače na server je omezena nastavením v souboru ''php.ini'', v případě práce s většími soubory je tedy třeba nejprve zkontrolovat toto nastavení, případně nakonfigurovat k adresáři přístup přes ftp server či jiný podobný způsob přímého přístupu.</div>

====Import====
Funkce '''Import''' nejprve v pravé horní části okna zobrazí seznam souborů v importním adresáři. Klepnutím na název souboru se otevírá ve spodní části formulář pro spuštění importu.

[[Image:formulare_a_katalogy36-import-dat-ze-souboru.jpg|center]]

V záložce '''Soubor''' se nachází pouze informace o tom, který soubor bude importován. V záložce '''Tabulka''' se nacházejí důležitá nastavení importu. V prvé řadě se zde volí, zda se importuje do existující tabulky nebo má import založit novou tabulku. Pokud se importuje do existující tabulky, lze zvolit, zda nová importovaná data pouze přidat a stávající ponechat nebo původní data nejprve smazat. Tlačítko '''Náhled''' zobrazí v novém okně náhled na importovaná data (prvních několik desítek záznamů), tlačítko '''Import''' spouští vlastní import dat.

Importovat lze z jednoho z podporovaných formátů dat, poznámky k jednotlivým formátům jsou v následující tabulce.

{| class="prettytable"
| rowspan="5"| DBF

| PHP funkce pro manipulaci s DBF soubory nepodporují datový typ MEMO, neboli dlouhé texty. Sloupce typu MEMO v importovaném DBF souboru se při importu ignorují.

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců z DBF souboru a přiřadí se jim nejpodobnější datové typy SQL databáze.

|-
| Při importu do existující tabulky se porovnávají názvy sloupců v SQL tabulce a v importované tabulce a importuje se vyhledáváním sloupců se stejným názvem. To znamená, že struktura SQL tabulky nemusí být identická se strukturou importovaného DBF souboru – pokud jsou v DBF souboru nějaké sloupce navíc, ignorují se, pokud jsou naopak navíc nějaké sloupce v SQL tabulce, dosadí se do nich při importu hodnota ''null''.

|-
| DBF formát obsahuje standardně nezobrazovaný sloupec nazvaný ''deleted'', pomocí kterého se v tomto formátu označují odstraněné řádky. Import s tímto sloupcem pracuje – pokud import automaticky zakládá novou tabulku, vytvoří se i sloupce nazvaný ''deleted''. Tento sloupec lze ale z SQL tabulky odstranit a bez problémů z DBF souboru importovat (viz předchozí poznámka).

|-
| Texty musí být v DBF souboru v takové kódové stránce v jaké mají být uloženy v SQL databázi, při importu nedochází k překódování.

|-
| rowspan="4"|XML

| Konvence ohledně pojmenování XML elementů v importovaném souboru je následující:
*Název kořenového elementu může být libovolný
*Elementy oddělující jednotlivé řádky (původní záznamy v SQL tabulce) se vždy musí jmenovat <nowiki><row></nowiki>
*Elementy pro jednotlivá pole jsou pojmenovány stejně jako názvy sloupců v datové tabulce, tedy např. <nowiki><NAZEV></nowiki> apod.

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců podle XML struktury. Všechny automaticky založené sloupce datové tabulky v SQL databázi budou mít typ ''řetězec'' o délce 255 znaků. Pokud se tedy používá automatické zakládání tabulky při importu, je vhodné následně nastavit správné datové typy pro sloupce tabulky. Další vlastnost, která z tohoto chování vyplývá je ta, že v tomto případě budou všechny texty oříznuty na délku max. 255 znaků. Pokud tedy XML elementy obsahují texty delší než 255 znaků, je třeba buď nejprve strukturu tabulky založit ručně nebo po importu strukturu odpovídajících sloupců změnit (na typ ''dlouhý text'') a import spustit ještě jednou.

|-
| Datumy by v importovaném souboru měly být v XML formátu 2005-05-04 11:41:00.

|-
| Nejvhodnější kódová stránka pro import je utf-8, importovat lze ale i XML soubory v jiných kódových stránkách.

|-
| rowspan="5"|CSV

| Zatímco u ostatních formátů se nastavuje pouze tabulka do které se importuje a možnost ponechat či odstranit původní data v datové SQL tabulce, u CSV formátu se ve formuláři vyskytuje důležitá volba '''Data obsahují názvy sloupců''' – tuto volbu je třeba vždy správně nastavit.
Oddělovač sloupců může být čárka nebo středník, což je při importu detekováno automaticky.

|-
| Při automatickém zakládání SQL tabulky při importu budou mít všechny sloupce typ ''řetězec'' o délce 255 znaků – chování je stejné jako u XML formátu včetně možného nežádoucího oříznutí delších textů, je tedy vhodné nejprve strukturu tabulky připravit ručně.
Pokud CSV soubor neobsahuje v prvním řádku názvy sloupců, založí se názvy automaticky podle jmenné konvence ''sloupec_1'', ''sloupec_2'' atd., v opačném případě se sloupce v SQL tabulce pojmenují podle prvního řádku CSV souboru.

|-
| Pokud CSV soubor obsahuje v prvním řádku názvy sloupců, při importu do existující tabulky se importuje metodou vyhledávání stejných názvů sloupců v SQL tabulce – záleží tedy na těchto názvech a pokud se název sloupce liší nebude takový sloupec importován. Pokud naopak v prvním řádku názvy sloupců nejsou, importuje se podle pořadí, v jakém jsou sloupce definovány.

|-
| Texty musí být v  CSV souboru v takovém kódování, v jakém mají být uloženy v SQL databázi.

|-
| Formát datumů se očekává stejný jako u XML formátu.

|}

<div class="note">Při používání importu doporučujeme používat obvyklé konvence pro názvy sloupců tabulek apod., tj. spíše kratší jména, bez diakritiky, pouze písmena a číslice. Funkčnost importu je do značné míry daná tím, jak pracují příslušné funkce PHP – např. PHP funkce zjišťující název sloupce tabulky vrací pro databázi MS SQL Server maximálně 30 znaků, je-li název sloupce delší, import nemůže proběhnout.</div>

====Export====
Pomocí funkce '''Export''' lze exportovat data nejen z tabulek, které spravuje modul Formuláře a katalogy, ale ze všech tabulek databáze, kterou instalace WebToDate používá. V pravé horní části se zobrazuje seznam těchto SQL tabulek, v každém řádku je tlačítko '''Náhled''', které ve spodním rámci zobrazí prvních několik záznamů v tabulce, a dále tlačítko '''Export''', které vyvolá ve spodním rámci formulář pro export dat.

[[Image:formulare_a_katalogy37-export-dat-tabulky.jpg|center]]

První záložka exportního formuláře se nazývá '''Tabulka'''. Lze v ní specifikovat:

* Které sloupce vybrané SQL tabulky se exportují
* Které záznamy tabulky se exportují
* V jakém pořadí se exportují

V prvé řadě se ve sloupci '''Vybrat''' pomocí zaškrtávacích políček vyznačí sloupce, které se mají exportovat.

<div class="note">Výchozí stav formuláře je takový, že není vybrán žádný sloupec. Přinejmenším je proto třeba použít tlačítko '''Vše''' a tím vybrat všechny sloupce tabulky.</div>

Dále lze specifikovat kritéria pro export, v podstatě vyhledávací podmínku, která vybere určitou množinu záznamů tabulky. V příslušném řádku formuláře se ve sloupci '''Splňující podmínku''' vybere operátor (tj. např. =, >, < apod.) a ve stejném řádku ve sloupci '''Vzhledem k '''se zadá příslušná hodnota. Těchto omezujících podmínek lze zadat několik, ve spodní části formuláře je radiopřepínač specifikující, zda se více zadaných podmínek spojuje logickou spojkou "a zároveň" nebo logickou spojkou "nebo". Operátor ''LIKE'' znamená, že zadaný řetězec se vyskytuje kdekoliv v textu. Pokud není zadaná žádná omezující podmínka, exportují se všechny záznamy.

Další možností je specifikovat řazení záznamů do exportovaného souboru. Lze vybrat dva sloupečky, podle kterých se řadí (ve formuláři sloupce '''Primárně''' a '''Sekundárně'''), v posledním sloupci formuláře lze pak specifikovat, zda se jedná o vzestupné nebo sestupné řazení. Není-li žádné řazení vybráno, záznamy se exportují v pořadí, v jakém se nacházejí v SQL tabulce.

Ve druhé záložce '''Soubor''' se specifikuje formát exportovaného souboru, jeho název a volba, zda soubor v případě jeho existence kompletně přepsat nebo připojit data na konec souboru.

[[Image:formulare_a_katalogy38-export-souboru.jpg|center]]

Název výstupního souboru zadávejte včetně přípony, vytváří se soubor podle přesně zadaného jména. Pomocí tlačítka '''Test''' lze ověřit, zda soubor se zadaným jménem již existuje a export se jej pokusí přepsat nebo takový soubor neexistuje a bude se zakládat nový.
====Soubory====
Exportovaný soubor je exportní funkcí uložen do adresáře pro export, ze kterého je možné jej stáhnout pomocí funkce '''Soubory'''.

Zvolit lze jeden z podporovaných formátů exportovaného souboru, poznámky k jednotlivým formátům jsou v následující tabulce.

{| class="prettytable"
| rowspan="5"| DBF
| PHP funkce pro manipulaci s DBF soubory nepodporují datový typ MEMO, neboli dlouhé texty. Sloupce typu MEMO v importovaném DBF souboru se při importu ignorují.

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců z DBF souboru a přiřadí se jim nejpodobnější datové typy SQL databáze.

|-
| Při importu do existující tabulky se porovnávají názvy sloupců v SQL tabulce a v importované tabulce a importuje se vyhledáváním sloupců se stejným názvem. To znamená, že struktura SQL tabulky nemusí být identická se strukturou importovaného DBF souboru – pokud jsou v DBF souboru nějaké sloupce navíc, ignorují se, pokud jsou naopak navíc nějaké sloupce v SQL tabulce, dosadí se do nich při importu hodnota ''null''.

|-
| DBF formát obsahuje standardně nezobrazovaný sloupec nazvaný ''deleted'', pomocí kterého se v tomto formátu označují odstraněné řádky. Import s tímto sloupcem pracuje – pokud import automaticky zakládá novou tabulku, vytvoří se i sloupce nazvaný ''deleted''. Tento sloupec lze ale z SQL tabulky odstranit a bez problémů z DBF souboru importovat (viz předchozí poznámka).

|-
| Texty musí být v DBF souboru v takové kódové stránce v jaké mají být uloženy v SQL databázi, při importu nedochází k překódování.

|-
| rowspan="4"|XML
| Konvence ohledně pojmenování XML elementů v importovaném souboru je následující:

* Název kořenového elementu může být libovolný
* <nowiki>Elementy oddělující jednotlivé řádky (původní záznamy v SQL tabulce) se vždy musí jmenovat <row></nowiki>
* <nowiki>Elementy pro jednotlivá pole jsou pojmenovány stejně jako názvy sloupců v datové tabulce, tedy např. <NAZEV> apod.</nowiki>

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců podle XML struktury. Všechny automaticky založené sloupce datové tabulky v SQL databázi budou mít typ ''řetězec'' o délce 255 znaků. Pokud se tedy používá automatické zakládání tabulky při importu, je vhodné následně nastavit správné datové typy pro sloupce tabulky. Další vlastnost, která z tohoto chování vyplývá je ta, že v tomto případě budou všechny texty oříznuty na délku max. 255 znaků. Pokud tedy XML elementy obsahují texty delší než 255 znaků, je třeba buď nejprve strukturu tabulky založit ručně nebo po importu strukturu odpovídajících sloupců změnit (na typ ''dlouhý text'') a import spustit ještě jednou.

|-
| Datumy by v importovaném souboru měly být v XML formátu 2005-05-04 11:41:00.

|-
| Nejvhodnější kódová stránka pro import je utf-8, importovat lze ale i XML soubory v jiných kódových stránkách.

|-
| rowspan="5"|CSV
| Zatímco u ostatních formátů se nastavuje pouze tabulka do které se importuje a možnost ponechat či odstranit původní data v datové SQL tabulce, u CSV formátu se ve formuláři vyskytuje důležitá volba '''Data obsahují názvy sloupců''' – tuto volbu je třeba vždy správně nastavit.

Oddělovač sloupců může být čárka nebo středník, což je při importu detekováno automaticky.

|-
| Při automatickém zakládání SQL tabulky při importu budou mít všechny sloupce typ ''řetězec'' o délce 255 znaků – chování je stejné jako u XML formátu včetně možného nežádoucího oříznutí delších textů, je tedy vhodné nejprve strukturu tabulky připravit ručně.

Pokud CSV soubor neobsahuje v prvním řádku názvy sloupců, založí se názvy automaticky podle jmenné konvence ''sloupec_1'', ''sloupec_2'' atd., v opačném případě se sloupce v SQL tabulce pojmenují podle prvního řádku CSV souboru.

|-
| Pokud CSV soubor obsahuje v prvním řádku názvy sloupců, při importu do existující tabulky se importuje metodou vyhledávání stejných názvů sloupců v SQL tabulce – záleží tedy na těchto názvech a pokud se název sloupce liší nebude takový sloupec importován. Pokud naopak v prvním řádku názvy sloupců nejsou, importuje se podle pořadí, v jakém jsou sloupce definovány.

|-
| Texty musí být v  CSV souboru v takovém kódování, v jakém mají být uloženy v SQL databázi.

|-
| Formát datumů se očekává stejný jako u XML formátu.

|}

====Protokoly====
V části '''Protokoly''' lze procházet protokol modulu týkající se zápisů nových záznamů.

[[Image:poradny-zobrazit-protokol.png|center]]

Zobrazují se záznamy o vložených i odmítnutých záznamech, pokud je vložení odmítnuto antispamovou kontrolou, je zde uveden typ kontroly, která odmítnutí vyvolala.

====Zakázané IP adresy====
Funkce '''Zakázané IP adresy''' ovládá přidávání IP adres na blacklist (seznam zakázaných adres) a jejich odstraňování z blacklistu.

[[Image:diskuze47-zakazane-ip-adresy.jpg|center]]

Seznam adres je společný pro všechny katalogy a ovládá se stejným způsobem jako jiné funkce WebToDate modulů. Ve formuláři se zadává pouze IP adresa, datum vložení a údaj o uživateli se doplňuje automaticky.

== Veřejné skripty ==
=== Zobrazování dat ===

Prezentační skripty modulu se nacházejí v adresáři ''/scripts/modules/catalogue''/.'' Pro zobrazování dat lze použít skripty:

* ''default.php'' – zobrazuje seznam katalogů
* ''list.php'' – zobrazuje seznam položek katalogu
* ''detail.php'' – zobrazuje jednu položku katalogu
* ''search.php'' – zobrazuje vyhledávací stránku pro katalog

Skript ''default.php'' zobrazující seznam katalogů zobrazuje názvy existujících katalogů a odkazy na stránky zobrazující seznam položek katalogu. Skript zobrazuje jen ty katalogy, u kterých je nastaveno '''Data jsou přístupná pro čtení''' : '''Všem'''. Využití této stránky je nepovinné, odkazy na jednotlivé katalogy lze používat v jiných stránkách libovolně a stránka zobrazující seznam všech veřejně přístupných katalogů nemusí mít na daném webu využití.

Seznam katalogů je reprezentován v předloze stránky klíčovým slovem <nowiki>. Žádné jiné klíčové slovo nelze v předloze použít, pouze lze v předloze použít podmíněné zobrazení chybového hlášení </nowiki>. Seznam katalogů se formátuje zvoleným WebToDate stylem. Nejjednodušší styl lze pro tyto účely vytvořit tak, že do jeho těla zadáme kód

<code>
<nowiki><a href=""></a><br/></nowiki>
</code>

Tento příklad obsahuje klíčová slova pro název katalogu a pro odkaz na stránku se seznamem položek. Kromě toho lze v tomto stylu použít i klíčové slovo <nowiki></nowiki>, za které se dosazuje pro daný katalog URL vyhledávací stránky.

Důležitějším skriptem je skript ''list.php'' zobrazující seznam položek daného katalogu. Základní objekty, které se mohou v předloze vyskytovat, jsou seznam záznamů (reprezentovaný klíčovým slovem <nowiki>) a stránkovací navigační lišta (reprezentovaná klíčovým slovem </nowiki>). Dále lze do předlohy této stránky umístit:

* název zobrazovaného katalogu (<nowiki></nowiki>)
* ID zobrazovaného katalogu (<nowiki></nowiki>)
* Odkaz na první stránku se seznamem položek (<nowiki></nowiki>)
* Odkaz na vyhledávací stránku (<nowiki></nowiki>)
* Hlášení o tom, že katalog neobsahuje žádné položky (<nowiki></nowiki>.)

Ve stránce se může navíc vyskytovat vyhledávací formulář – z tohoto hlediska jsou možnosti práce s předlohou stejné jako na stránce pro '''Vyhledávání''' (z klíčových slov tedy ve stránce fungují klíčová slova typu <nowiki></nowiki>).

Stránkovací lišta se vždy formátuje jednotně podle nastavení pro navigační lištu v nastaveních modulu. Seznam položek katalogu se formátuje zvoleným WebToDate stylem. Jednoduchý příklad těla tohoto stylu vypadá následovně:

<code>
<nowiki><tr></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td></td></nowiki>
<nowiki></tr></nowiki>
</code>

Klíčová slova typu <nowiki></nowiki> zde reprezentují pole katalogu, přičemž ''neco'' je název sloupce datové tabulky. Dále lze ve stylu použít tyto klíčová slova:

* <nowiki></nowiki> - kód se vkládá pouze pokud pole neco je prázdné
* <nowiki></nowiki> - kód se vkládá pouze pokud pole neco není prázdné
* <nowiki></nowiki> - číslování záznamů v seznamu
* <nowiki></nowiki> - odkaz na detailní stránku

Podmíněné vkládání obsahu polí lze použít např. v případech, kdy chceme odkaz (obrázek či e-mailovou adresu apod.) vložit pouze v případě, kdy je v záznamu nějaká hodnota, např. takto:
<code>
<nowiki>'></a>")--></nowiki>
</cede>
Číslování pomocí <nowiki></nowiki> zobrazuje pro větší přehlednost pro každý záznam katalogu číslo dané vypisovaným pořadím na stránce se započtením stránkování záznamů, toto číslování tedy nemá žádnou souvislost s daty katalogu.

Důležité je klíčové slovo <nowiki></nowiki>, za které se dosazuje odkaz na zobrazení detailní stránky s jednou položkou katalogu. Toto URL se generuje ve tvaru

''detail.php?catalogueID=číslo_katalogu&linkvalue=hodnota_pole_pro_jednoznačnou_identifikaci''

V parametrech skriptu pro zobrazení detailu jedné položky se tedy musí vyskytovat jak ID katalogu, tak identifikátor záznamu (v parametru ''linkvalue'').

Skript pro zobrazení jedné položky ''detail.php'' je určen k zobrazení jednoho záznamu datové tabulky katalogu. Všechna klíčová slova se zde umísťují do předlohy, stránka nepoužívá žádný WebToDate styl. Nejdůležitější klíčová slova v předloze jsou:

* <nowiki></nowiki> - klíčové slovo zastupující pole datové tabulky (neco = název sloupce datové tabulky)
* <nowiki></nowiki> - kód se vkládá pouze pokud pole ''neco'' je prázdné
* <nowiki></nowiki> - kód se vkládá pouze pokud pole ''neco'' není prázdné

Jednoduchý příklad HTML kódu části předlohy zobrazující vybraná data z jedné položky katalogu vypadá následovně:
<code>
<nowiki></nowiki>
<nowiki><table></nowiki>
<nowiki><tr><td>Katalogové číslo</td><td></td></tr></nowiki>
<nowiki><tr><td>Interpret</td><td><strong></strong></td></tr></nowiki>
<nowiki><tr><td>Titul</td><td></td></tr></nowiki>
<nowiki><tr><td>Počet nosičů</td><td></td></tr></nowiki>
<nowiki><tr><td>Nosič</td><td></td></tr></nowiki>
<nowiki></table></nowiki>
</code>
I v této stránce lze použít klíčová slova jako název katalogu apod. a vytvořit vyhledávací formulář (jsou tedy zde aktivní klíčová slova <nowiki></nowiki>), více viz kapitola [[../Reference#Klíčová slova modulu|Klíčová slova modulu]].

Stránku s vyhledávacím formulářem lze vytvořit pomocí zobrazení skriptu ''search.php''. Skript vyžaduje jako povinný parametr ID katalogu, zobrazuje se tedy např. jako ''/scripts/modules/catalogue/search.php?catalogueID=1''. Možnosti vyhledávacího formuláře v této stránce platí i pro stránky zobrazující seznam položek katalogu a detail jedné položky.

Příklad vyhledávacího formuláře je následující:
<code>
<nowiki><form action="" method="post"></nowiki>
<nowiki><table></nowiki>
<nowiki><tr valign="top"></nowiki>
<nowiki><td></nowiki>
<nowiki><label for="ARTINAME">Interpret</label></nowiki>
<nowiki></td></nowiki>
<nowiki><td> <input type="text" id="ARTINAME" name="ARTINAME" value=""/> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr valign="top"></nowiki>
<nowiki><td></nowiki>
<nowiki><label for="PRODTITL">Titul</label></nowiki>
<nowiki></td></nowiki>
<nowiki><td> <input type="text" id="PRODTITL" name="PRODTITL" value=""/> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr valign="top"></nowiki>
<nowiki><td></nowiki>
<nowiki><label for="MAJCONFC">Nosič</label></nowiki>
<nowiki></td></nowiki>
<nowiki><td></nowiki>
<nowiki><select name="MAJCONFC"></nowiki>
<nowiki><option value="" selected>--nerozlišovat--</option></nowiki>
<nowiki></nowiki>
<nowiki></select></nowiki>
<nowiki></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></table></nowiki>
<nowiki><input type="submit" name="catalogue_search_button" value="Hledat" /></nowiki>
<nowiki></form></nowiki>
</code>
Za klíčové slovo <nowiki></nowiki> se v tomto příkladu dosadí URL pro zobrazení seznamu položek daného katalogu. Textová pole formuláře pro hledání musí mít atribut ''name'' odpovídající názvům polí (sloupců datové tabulky) katalogu.

Pro prohledávání platí:

* Prohledávat lze v katalogu jen pole textových a celočíselných typů, prohledávání jiných typů polí není podporováno.
* Prohledává se pouze s testem na rovnost nebo u textových polí na výskyt uvnitř textu (tj. podmínka LIKE). Není podporována možnost prohledávat na podmínku danou intervalem hodnot (tedy např. že daná hodnota musí být větší než nějaké číslo a menší než nějaké číslo).
* Tato pole musí být v katalogu označena jako '''Používat při prohledávání'''.

Pokud má formulář více vyplněných polí, spojuje se vždy vyhledávací podmínka logickou spojkou "a zároveň". Pokud se prohledává podle celočíselného pole, hledá se vždy podle testu na rovnost. Pokud se prohledává podle textového pole, hledá se výskyt řetězce kdekoliv uvnitř textového pole. Existuje zde ovšem možnost, jak hledání v textech omezit na hledání výskytu textového řetězce na začátku textových polí. Z vyhledávacího formuláře je třeba v tom případě předat parametr ''searchin'' s hodnotou ''begin'', např. pomocí následujícího kódu umístěného dovnitř formuláře:

<code>
<nowiki><input type="hidden" name="searchin" value="begin"></nowiki>
</code>

V tom případě se hledaný text nemá vyskytovat kdekoliv uvnitř textového pole, ale na jeho začátku.

Jednoduchý vyhledávací formulář tedy obsahuje pouze textová pole pojmenovaná odpovídajícím způsobem. Je ovšem podporována i složitější možnost – totiž vytváření pop-up menu, která nabízejí jedinečné hodnoty z daného sloupce databáze. Výše uvedený příklad prohledává katalog hudebních titulů, kde chceme kromě textových polí typu "interpret" prohledávat i podle typu nosiče (CD, MC apod.). Typ nosiče je v datové tabulce uveden jako text, pomocí klíčového slova <nowiki>) vložíme do formuláře všechny unikátní hodnoty daného sloupce s typem nosiče včetně příslušných HTML <option></nowiki> značek:
<code>
<nowiki><select name="MAJCONFC"></nowiki>
<nowiki><option value="" selected>--nerozlišovat--</option></nowiki>
<nowiki></nowiki>
<nowiki></select></nowiki>
</code>
Výsledný formulář pak vypadá v HTML stránce zhruba takto:

[[Image:formulare_a_katalogy39-vysledny-formular.jpg|center]]

Výpis položek je standardně setříděn podle nastavení '''Administrace''' / ''název katalogu'' / '''Třídění''' v administračním rozhraní modulu. Toto třídění lze změnit přes parametr ''sort'' z vyhledávacího formuláře nebo z URL. Jako hodnota parametru sort se vkládá název sloupce, podle kterého se má třídit. Třídění je pak vždy podle tohoto jednoho vybraného sloupce vzestupně.

Příklad HTML kódu pro volbu třídění je pak následující:
<code>
<nowiki><label for="sort">Třídit podle</label><br /></nowiki>
<nowiki><input type="radio" name="sort" value="nazev" checked="checked" /></nowiki> Názvu
<nowiki><input type="radio" name="sort" value="autor" /></nowiki> Jména autora
</code>
<div class="note">Poznámka: pokud se používá možnost volby třídění a v dané datové tabulce katalogu je větší množství záznamů, je doporučeno opatřit sloupce, podle kterých se třídí indexem (viz kapitola [[../Reference#Data|Data]]), jinak hrozí zpomalení sestavování stránek se seznamem položek a vyšší zátěž serveru.</div>

Další možností rozšíření možností vyhledávání je hledání dle intervalu hodnot. Uvedeme-li ve vyhledávacím formuláři např. pole
<code>
Počet kusů: <nowiki><input type="text" name="pockusu" value="" /></nowiki>
</code>
a je-li toto pole vyplněno, testuje se v prohledávaném sloupci na výskyt zadané hodnoty (pokud se jedná o textový sloupec) nebo na rovnost (pokud se jedná o jiné datové typy). Pokud ale uvedeme ve formuláři pole
<code>
Min. počet kusů: <nowiki><input type="text" name="pockusu[min]" value="" /></nowiki>
Max. počet kusů: <nowiki><input type="text" name="pockusu[max]" value="" /></nowiki>
</code>
můžeme prohledávat na rozsah hodnot, tj. hledat záznamy, kde v daném sloupci se vyskytuje jako minimální číslo hodnota zadaná do pole ''pockusu[min]'' a jako maximální číslo hodnota zadaná do pole ''pockusu[max''].'' Pro tuto volbu se tedy postupuje tak, že jako jméno pole formuláře nebo parametr URL se použije název sloupec datové tabulky s příponou ''[min]'' resp. ''[max''].'' Pro možnost prohledávání dle intervalu hodnot jsou podporovány celočíselné datové typy datové tabulky katalogu.

Vyhledávací formulář nepodporuje žádná další "aktivní" klíčová slova, nelze tedy např. zajistit, že stránka s výsledky hledání zobrazí formulář, který bude obsahovat údaje již uživatelem zadané v předchozí stránce apod.

=== Vkládání dat ===

Pro vkládání dat se používá skript ''/scripts/modules/catalogue/iform.php''. Hlavní možnosti tohoto skriptu jsou:

* Zobrazení formuláře pro vkládání dat
* Zobrazení potvrzovací stránky
* Zobrazování chybových hlášení aktivovaných kontrolou zadaných dat
* Odeslání e-mailu s daty vloženými do formuláře
* Přesměrování na vybranou stránku po úspěšném vložení dat z formuláře do katalogu.

Logika fungování tohoto skriptu je zhruba popsána následujícím vývojovým diagramem:

[[Image:formulare_a_katalogy40-diagram-logiky-fungovani-skriptu-vkladani-dat.jpg|center]]

Hlavním povinným parametrem skriptu je ID katalogu, do kterého se vkládají data ''catalogueid''.

Příklad jednoduchého kódu pro vstupní formulář je následující:
<code>
<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=" method="post"></nowiki>
<nowiki><input type="hidden" name="returnurl" value="/"/></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki><label for="JMENO">Jméno a příjmení</label><br/></nowiki>
<nowiki><input type="text" id="JMENO" name="JMENO" value=""/></nowiki> *
<nowiki><br/></nowiki>
<nowiki><label for="EMAIL">E-mailová adresa</label><br/></nowiki>
<nowiki><input type="text" id="EMAIL" name="EMAIL" value=""/></nowiki> *
<nowiki><br/></nowiki>
<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>
<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"></textarea></nowiki>
<nowiki><br/></nowiki>
<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>
<nowiki><p> Pole označená * jsou povinná. </p></nowiki>
<nowiki></form></nowiki>
</code>
Hlavní "aktivní" klíčová slova jsou <nowiki> zastupující hodnoty vkládaných polí. Názvy polí katalogu, do kterých se vkládá, se musí shodovat s atributem ''name'' vstupního formuláře. Klíčová slova </nowiki> jsou zde proto, aby v případě, že data neprojdou vstupní kontrolu se mohl zobrazit formulář včetně zadaných hodnot a vedle toho případná chybová hlášení reprezentovaná klíčovými slovy typu WTD_IF.

Na stejném principu pracuje i případná potvrzovací stránka, i zde se používají klíčová slova typu <nowiki></nowiki>, jednou se použijí pro zobrazení a podruhé jako hodnota ''hidden'' pole, která se po potvrzení přenáší jako hodnota, která bude uložena. Jedna položka formuláře na potvrzovací stránce pak vypadá např. takto:
<code>
<nowiki><tr></nowiki>
<nowiki><td> <label for="email">E-mail</label> </td></nowiki>
<nowiki><td></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" id="email" name="email" value=""/></nowiki>
<nowiki></td></nowiki>
<nowiki></tr></nowiki>
</code>
<div class="note">Jako u všech ostatních typů stránek, i zde je vhodné tyto kódy formulářů primárně vygenerovat jako fragmenty pomocí nabídky '''Nástroje''' a následně je upravit podle potřeb.</div>

Vstupní skript provádí řadu kontrol a to i několikrát (pokud je použita potvrzovací stránka, tak i před uložením z potvrzovací stránky). Jedná se zejména o:

* Datové typy polí (tj. zda se např. někdo nepokouší do celočíselného pole zadat text apod.)
* Povinné vyplnění polí a unikátní hodnoty
* Názvy polí formulářů a názvy polí datové tabulky musí odpovídat
* Zda nejde o pokus zapsat hodnotu pole, které v definice katalogu není určeno k zápisům z veřejné části serveru.

Těmto kontrolám odpovídají možná chybová hlášení uvedená v kapitole [[../Reference#Klíčová slova modulu|Klíčová slova modulu]] .

Pokud se k vygenerování vstupního formuláře použije funkce z nabídky '''Nástroje''', vygenerují se všechna vstupní pole jako textová. Následně je možné změnit vstupní formulář tak, že místo některých textových polí se vytvoří nabídky formou pop-up menu, radiopřepínačů apod. Platí to, že důležité jsou pro daný element formuláře atributy ''name'' a ''value'', na typu pole nezáleží. Je třeba si ovšem uvědomit, že pokud dojde k chybě, zobrazí skript pro vkládání dat tu samou stránku se vstupním formulářem, kde klíčová slova typu WTD_FCI nahradí údaji, které zadal uživatel – pro jiná pole než textová pak dost dobře nelze nastavit správnou volbu, kterou uživatel v předchozím kroku zadal (atribut ''selected'' daného formulářového pole).

=== Možnosti omezení přístupu k zobrazení nebo vkládání dat ===

Jak je uvedeno v kapitole [[../Reference#Administrace|Administrace]], lze na úrovni katalogu nadefinovat, kdo (z hlediska veřejné části webu) může zobrazovat data katalogu a kdo do katalogu může vkládat.

Pokud je pro zobrazování zvoleno '''Nikomu''', je chování následující:

* Katalog se nezobrazuje v seznamu katalogů
* Pokud se pokusíme zobrazit seznam položek katalogu přímo přes skript ''list.php'', dostáváme chybové hlášení typu "Katalog nebyl nalezen"
* Stejné hlášení dostáváme u daného katalogu i pro skripty zobrazující jeden záznam a vyhledávací stránku.

Pokud vyvoláme skript pro vkládání dat iform.php pro katalog, který má nastaveno pro vkládání dat '''Nikdo''', dostáváme chybové hlášení typu "Předloha není definována".

Je-li na serveru instalován navíc modul Registrace a personalizace, lze kromě přístupů '''Všichni''' / '''Nikdo''' nastavit ve vlastnostech katalogu ještě přístup registrovaným uživatelům, a to odděleně pro prohlížení dat katalogu a pro vkládání dat do katalogu. V obou případech lze zvolit, že přístup mají buď všichni registrovaní nebo jen jedna vybraná skupina. Chování veřejných skriptů je pak následující:

* Pokud uživatel není přihlášen a pokusí se zobrazit nějakou stránku související s daným katalogem (zobrazení dat nebo vstupní formulář), je přesměrován na přihlašovací stránku ''(/''scripts/modules/registration/login.php''). Po úspěšném přihlášení je přesměrován zpět na původní stránku.
* Pokud uživatel je přihlášen a je nastaven přístup všem registrovaným, požadovaná stránka se ihned zobrazí.
* Pokud je uživatel přihlášen a je nastaven přístup pouze určité skupině uživatelů, je při pokusu o zobrazení stránky nejprve vyhodnoceno, zda přihlášený uživatel patří do nastavené skupiny. Pokud tomu tak je, stránka se zobrazí, pokud tomu tak není, je uživatel přesměrován na stránku ''Odmítnutí přístupu'' v případě vkládání dat a na přihlašovací formulář v případě zobrazování dat.

=== Klíčová slova modulu ===

Tato kapitola obsahuje souhrn všech klíčových slov modulu, která se používají v předlohách a WebToDate stylech.

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – všechny stránky kromě seznamu katalogů a e-mailů'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| ID katalogu
|

|-
| <nowiki></nowiki>
| Název katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující stránku se seznamem položek katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující vyhledávací stránku pro daný katalog
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – seznam katalogů'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Seznam katalogů
|

|-
| <nowiki></nowiki>
| Hlášení v případě, že nebyl nalezen žádný katalog
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná ve stylu seznamu katalogů'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Název katalogu
|

|-
| <nowiki></nowiki>
| ID katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující stránku se seznamem položek katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující vyhledávací stránku pro daný katalog
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – seznam položek katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Seznam položek (záznamů)
|

|-
| <nowiki></nowiki>
| Navigační lišta
|

|-
| <nowiki></nowiki>
| Hlášení v případě, že nebyl nalezen žádný záznam
|

|-
| <nowiki></nowiki>
| Zobrazení jedinečných hodnot daného sloupce
| Pro účely vyhledávacího formuláře, vytváří se včetně HTML <nowiki><option></nowiki> značek

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná ve stylu seznamu položek katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující hodnotu pole datové tabulky
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' je prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' není prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Číslování položek v zobrazeném seznamu
|

|-
| <nowiki></nowiki>
| Odkaz na zobrazení detailní stránky zobrazující jeden záznam
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze - zobrazení jedné položky katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující hodnotu pole datové tabulky
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' je prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' není prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Zobrazení jedinečných hodnot daného sloupce
| Pro účely vyhledávacího formuláře, vytváří se včetně HTML <nowiki><option></nowiki> značek

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze - vyhledávací stránka katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Zobrazení jedinečných hodnot daného sloupce
| Pro účely vyhledávacího formuláře, vytváří se včetně HTML <nowiki><option></nowiki> značek

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – stránky pro vkládání dat přes formulář'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující hodnotu atributu ''value'' vstupního formuláře
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Skrytý kontrolní kód
| Používá se pro [[../Ochrana proti spamu|antispamovou ochranu]] typu ''Opisování kontrolních kódů''

|-
| <nowiki></nowiki>
| Zobrazovaný kód k opsání
| Používá se pro [[../Ochrana proti spamu|antispamovou ochranu]] typu ''Opisování kontrolních kódů''

|-
| <nowiki></nowiki>
| bylo zjištěno, že datový typ některého pole neodpovídá datové tabulce
|

|-
| <nowiki></nowiki>
| některé povinné pole není vyplněno
|

|-
| <nowiki></nowiki>
| některé pole, které má obsahovat unikátní hodnoty není správně vyplněno
|

|-
| <nowiki></nowiki>
| některé pole v kolekci formuláře v datové tabulce neexistuje
|

|-
| <nowiki></nowiki>
| některé pole v kolekci formuláře v datové tabulce nemá povolen zápis z veřejné části
|

|-
| <nowiki></nowiki>
| jiná chyba, např. nelze naplnit pole pro jednoznačnou identifikaci, SQL databáze vrátila při pokusu o zápis chybu apod.
|

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že uživatel špatně opsal kontrolní kód pro antispamovou ochranu
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|-
| <nowiki></nowiki>
| Kód vloží antispamová ochrana v případě, že adresa uživatele vkládajícího dotaz je na seznamu zakázaných adres
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|-
| <nowiki></nowiki>
| Vloží se pokud byl příspěvek detekován jako spam a nejde o předchozí dva případy.
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – e-mail s obsahem vstupního formuláře'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující vloženou hodnotu pole datové tabulky
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Název katalogu
| <nowiki></nowiki>

|-
| <nowiki></nowiki>
| ID katalogu
| <nowiki></nowiki>

|}

Modul dále podporuje [[../../Referenční/Klíčová slova WebToDate#Klíčová slova pro formátování|Klíčová slova pro formátování]] typu WTD_FORMAT, tedy např.

''<nowiki></nowiki>''

apod.

=== Speciální názvy parametrů ===

Skripty používají následující speciální parametry (v URL nebo ve vyhledávacích formulářích). Vzhledem k vyhrazenému významu těchto parametrů to znamená, že '''názvy sloupců datových tabulek se nesmí shodovat s názvy těchto parametrů''':

* catalogueid – ID katalogu
* linkvalue – hodnota pole pro jednoznačnou identifikaci (používá skript pro zobrazení detailní stránky jedné položky katalogu)
* pg – používá stránkovací lišta pro stránkování
* searchin – udává způsob prohledávání textových polí (používá skript pro zobrazení seznamu položek katalogu)
* sort – může být použit pro výběr sloupce, podle kterého se třídí seznam položek
* returnurl – využívá skript pro vkládání dat z veřejných formulářů jako URL stránky zobrazené po úspěšném vložení záznamu
* tmplid – parametrem lze vynutit pro stránku jinou předlohu, hodnotou je ID této předlohy
* lid, locale, dlid, dlocale – využívají všechny moduly jako identifikátory pro jazyky
* ccid, ccvalue - parametry pro práci s kontrolními kódy [[../Ochrana proti spamu|antispamové ochrany]]

== Rozhraní pro napojení jiných aplikací ==
Modul obsahuje rozhraní pro napojení jiných aplikací, které umožňuje těmto aplikacím aktualizaci obsahu jednotlivých katalogů, tj. vkládání, aktualizaci a mazání záznamů v datových tabulkách katalogů.

=== Princip řešení ===

Na serveru je umístěn skript ''/gate/catupdate/default.php''. Adresář ''gate'' je virtuální adresář www serveru fyzicky umístěný na stejné úrovni jako např. adresář wwwroot. Z bezpečnostních důvodů je velmi vhodné přístup na tento virtuální adresář omezit pouze na IP adresu serveru, na kterém běží aplikace, která má měnit data modulu.

Tento skript přijímá přes protokol http POST příkazy ve formátu XML, provádí je a zpět zasílá (opět v XML) potvrzení. Příkazem může být buď pokyn ke smazání jedné položky daného katalogu nebo pokyn k vložení nebo aktualizaci záznamu jednoho katalogu.

Vkládání / aktualizace se synchronizuje na úrovni ID záznamů, externí aplikace tedy musí znát a používat identifikátory používané v dané datové tabulce. Při mazání se načítá jen ID záznamu, který se má mazat, při vkládání nebo aktualizaci celý záznam, tj. jeden řádek tabulky.

Skript zachycuje všechny potencionální chybové stavy a podává o nich hlášení prostřednictvím vraceného XML kódu – jedná se například o žádost o smazání neexistujícího záznamu, chybu při zápisu do databáze apod. Všechny události se protokolují do speciálního logu, kde se dá kontrolovat, zda komunikace probíhá v pořádku.

=== XML formáty přenosů ===

Každá žádost o aktualizaci obsahuje název datové tabulky, se kterou se manipuluje. Následuje příkaz (smazat / přidat nebo aktualizovat). Pak následují vlastní data – buď je uveden pouze unikátní identifikátor (v případě mazání) nebo celý řádek tabulky (v případě vložení či aktualizace).

Kořenový element žádosti o aktualizaci je vždy ''<nowiki><catupdaterequest''>,'' následuje kód ''<dbtable name="název_tabulky" idcolumn="název_sloupec_pro_jednoznačnou_identifikaci''"/>,'' který specifikuje, která datová tabulka se má aktualizovat a jaký sloupec se používá pro vyhledávání záznamů (jednoznačnou identifikaci). Dále je povinné uvést element ''<command''></nowiki>,'' který má v atributu ''type'' uveden typ operace, možné hodnoty jsou ''delete'' / ''update''.

==== Smazání záznamu ====

Následující XML kód slouží jako příkaz ke smazání jednoho záznamu s daným ID. ''per_id'' je název sloupce datové tabulky použitého v katalogu jako sloupec pro identifikaci záznamů.
<code>
<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki>
<nowiki><catupdaterequest></nowiki>
<nowiki><dbtable name="KATDTBL" idcolumn="per_id"/></nowiki>
<nowiki><command type="delete"></nowiki>
<nowiki><per_id>2506</per_id></nowiki>
<nowiki></command></nowiki>
<nowiki></catupdaterequest></nowiki>
</code>

==== Potvrzení smazání ====

Následující kód dostává zpět externí aplikace jako odpověď na příkaz smazání položky.
<code>
<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki>
<nowiki><catupdateresponse></nowiki>
<nowiki><status>error</status></nowiki>
<nowiki><description>Záznam s ID=2506 v tabulce KATDTBL se nepodařilo smazat.</description></nowiki>
<nowiki></catupdateresponse></nowiki>
</code>
Element ''status'' může nabývat hodnot ''ok / error'', v případě chyby obsahuje element ''description'' textový popis chyby.

==== Vložení nebo aktualizace záznamu ====

Následující kód reprezentuje příkaz na vložení nebo aktualizaci jednoho záznamu.
<code>
<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki>
<nowiki><catupdaterequest></nowiki>
<nowiki><dbtable name=" KATDTBL" idcolumn="per_id"/></nowiki>
<nowiki><command type="update"></nowiki>
<nowiki><per_id>2507</per_id></nowiki>
<nowiki><vydavatel>Vydavatel s.r.o.</vydavatel></nowiki>
<nowiki><okres>Praha</okres></nowiki>
<nowiki><nazev>Křížovky a rébusy</nazev></nowiki>
<nowiki><zamereni>Časopisy pro luštitele</zamereni></nowiki>
<nowiki><regionalni>Ne</regionalni></nowiki>
<nowiki><per>6</per></nowiki>
<nowiki></command></nowiki>
<nowiki></catupdaterequest></nowiki>
</code>
Nejprve je uvedena informace o tom, které tabulky se příkaz týká, atribut ''idcolumn'' zde musí obsahovat jako hodnotu název sloupce datové tabulky, který se používá pro identifikaci záznamů a pomocí kterého se provádí příkazy pro aktualizaci či mazání těchto záznamů. Pak je uveden vlastní příkaz a seznam hodnot jednotlivých polí. Tento seznam není pevně dán, ale liší se dle struktury katalogu, jména elementů odpovídají názvům sloupců datové tabulky modulu Formuláře a katalogy.

WebToDate/Formuláře a katalogy/Reference

2011-04-12T14:17:55Z

Tomasn: /* Klíčová slova modulu */ chyba v FCxFCI u klíčového slova pro předlohu e-mailů

[[Category:WebToDate Formuláře a katalogy]]
[[Category:Formuláře a katalogy]]
== Administrační rozhraní ==
=== Nabídka modulu ===

Kompletní nabídka modulu vypadá následovně:

'''Nástroje'''

:Položka

:Vyhledávací formulář

:Styly

:Vstupní formulář

:Potvrzovací formulář

'''Nastavení'''

:Seznam předpisů

:Globální

::Seznam katalogů

::Navigační lišta

::Filtr slov

::Další nastavení

:Předpisy

::''název předpisu''

:::Seznam položek

:::Jedna položka

:::Vyhledávání

:::Vkládání

'''Administrace'''

:Práva

:Antispamové profily

:Nový katalog

:''název katalogu''

::Pole

::Třídění

'''Data'''

:Seznam tabulek

:Katalogy

::''název katalogu''

:Import

:Export

:Soubory

:Protokoly

:Zakázané IP adresy

'''Nápověda'''

=== Nástroje ===

Funkce v této nabídce slouží k usnadnění práce při vývoji grafické prezentace katalogu, tj. stránek zobrazujících data katalogu i stránek se vstupními formuláři. Tyto funkce generují WebToDate fragmenty nebo WebToDate styly, které jsou v rámci vytváření definic těchto stránek využitelné. Princip fungování je v zásadě ten, že vždy vybereme, ke kterému katalogu chceme ten který element vygenerovat, funkce podle aktuální definice katalogu vygeneruje příslušný fragment (resp. styl). Tento objekt lze pak po stránce HTML kódu dále upravit a použít na příslušné předloze.
====Položka====
Funkce '''Položka''' generuje fragment, který můžeme použít jako část těla předlohy pro detailní zobrazení jedné položky katalogu.

[[Image:formulare_a_katalogy22-vytvoreni-html-fragmentu.jpg|center]]

V prvé řadě vyberte katalog, pro který chcete příslušný fragment vygenerovat. Dále vyberte jeho zařazení (kategorie apod.) a případně změňte název. Pomocí tlačítka '''Přidat HTML fragment''' se v databázi založí nový fragment, okamžitě se zobrazí tlačítko '''Vyhledat''', pomocí kterého lze přejít do režimu editace tohoto fragmentu.

V těle fragmentu se vygeneruje HTML tabulka se zhruba následujícím kódem.

<code>
<nowiki><table></nowiki>
<nowiki><tr valign="top"><td>Katalogové číslo</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Skladatel</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Interpret</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Titul</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Nosičů</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Nosič</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Čárový kód</td><td></td></tr></nowiki>
<nowiki><tr valign="top"><td>Na skladě</td><td></td></tr></nowiki>
<nowiki></table></nowiki>
</code>

Klíčová slova typu WTD_FC reprezentují jednotlivá pole datové tabulky katalogu, jejich názvy se samozřejmě pro každý katalog liší. Generují se ta pole, která mají ve vlastnostech nastaveno '''Zobrazovat na detailní stránce'''.

<div class="note">Fragment lze přiřadit na příslušnou předlohu pod vhodným stylem – tento styl typicky vkládá jen tělo fragmentu, jeho definice tedy vypadá většinou tak, že v těle obsahuje pouze klíčové slovo <nowiki></nowiki> (platí i pro všechny ostatní fragmenty v této kapitole).</div>

====Vyhledávací formulář====
Funkce '''Vyhledávací formulář''' generuje fragment s vyhledávacím formulářem použitelným pro daný katalog. Vygenerovaný kód vypadá zhruba následovně:

<code>
<nowiki><form action="" method="post"></nowiki>
<nowiki><label for="PRIJMENI">Příjmení</label></nowiki>
<nowiki><input type="text" id="PRIJMENI" name="PRIJMENI" value=""/></nowiki>
<nowiki><input type="submit" name="catalogue_search_button" value="Hledej!" /></nowiki>
<nowiki></form></nowiki>
</code>

Generují se ta pole, která mají ve vlastnostech nastaveno '''Použít při prohledávání'''. Takto vygenerovaný formulář je použitelný pouze v předlohách ke stránkám daného katalogu. Vyhledávací formulář lze vložit i na každou jinou stránku (např. úvodní stránku serveru), v tom případě je ale třeba předem nahradit klíčové slovo <nowiki></nowiki> za URL stránky pro zobrazování seznamu položek daného katalogu, tedy např. ''/scripts/modules/catalogue/list.php?catalogueid=2'' (včetně id katalogu).

====Styly====
Funkce '''Styly''' slouží k vygenerování WebToDate stylu formátujícího seznam položek katalogu. Tento styl se pak nastavuje v předpisu katalogu ('''Nastavení''' / '''Předpisy''' / název předpisu / '''Seznam položek'''). Vygenerovaný kód stylu je závislý na zvoleném katalogu, generuje se formou HTML tabulky, jeho tělo vypadá např. takto:

<code>
<nowiki><tr></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td><a href=""></a></td></nowiki>
<nowiki><td></td></nowiki>
<nowiki></tr></nowiki>
</code>

Klíčová slova typu WTD_FC opět reprezentují jednotlivá pole datové tabulky katalogu, klíčové slovo <nowiki></nowiki> reprezentuje URL pro zobrazení detailního pohledu na jednu položku. Generují se ta pole, která mají ve vlastnostech nastaveno '''Zobrazovat v seznamu''', odkaz se generuje na pole, které má nastavenou vlastnost '''Odkaz na detail''' (pokud takové existuje).

====Vstupní formulář====
Funkce '''Vstupní formulář''' slouží k vygenerování fragmentu s kódem pro formulář použitelný pro daný katalog na veřejné části. Do formuláře se generuje:

* Adresa skriptu pro uložení dat
* Chybová hlášení typu WTD_IF, která se zobrazují ve chvíli, kdy nastala některá z možností podle typu chybového hlášení
* Pole formuláře typu WTD_FCI
* Označení povinných polí s popiskem

Generují se ta pole katalogu, která mají ve vlastnostech nastaveno '''Data lze vkládat z veřejné části'''. Pole, která mají vlastnost '''Povinně vyplnit''', jsou ve vygenerovaném kódu označena.

<div class="note">Poznámka: Ve formuláři se jedná ale jen o grafické označení, povinné vyplnění dat je kontrolováno na straně serveru podle definice polí katalogu nezávisle na přesném tvaru vstupního formuláře.</div>

Definice polí katalogu obsahuje rovněž možnost zadat výchozí hodnotu. Tato výchozí hodnota se do kódu formuláře negeneruje, ale je vkládána až ve chvíli zobrazení stránky s formulářem záměnou za příslušné klíčové slovo typu WTD_FCI.

====Potvrzovací formulář====
Funkce '''Potvrzovací formulář''' slouží k vytvoření fragmentu, který lze použít pro zobrazení potvrzovací stránky před vlastním uložením dat do databáze. Výsledný kód je velmi podobný předchozímu případu, pouze pole typu WTD_FCI jsou ve formuláři vždy dvakrát – jednou v kódu stránky pro zobrazení, podruhé jako ''hidden'' pole formuláře za účelem vložení dat do databáze.

=== Nastavení ===

Tato část nabídky slouží k definování grafické podoby katalogů na veřejné části webu. Oddělují se dvě části – '''Globální''' a '''Předpisy'''. Globální nastavení je takové, které je společné pro celý modul, nastavení v předpisech jsou zpravidla jedinečná pro daný katalog (v některých případech je lze využít pro více katalogů se stejnou strukturou). ''Předpisem'' se rozumí souhrn nastavení pro více stránek – pohledů na data (seznam položek, jedna položka atd.)
====Seznam předpisů====
Pomocí funkce '''Seznam předpisů''' se zakládají nové předpisy, jedinou volbou při zakládání předpisu je jeho název. Po založení se předpis zobrazí v nabídce v této sekci '''Nastavení''', pod názvem předpisu jsou pak jednotlivé položky pro nastavení předpisu.

====Globální nastavení====
=====Seznam katalogů=====
Funkce '''Globální''' / '''Seznam katalogů''' definuje stránku zobrazující seznam katalogů na veřejné části. Tuto stránku (na URL ''/scripts/modules/catalogue/default.php'') lze využít v případě, že na serveru je definováno více katalogů určených pro zobrazování dat a chceme jednoduše zobrazit jejich seznam. Stránka je definovaná předlohou a stylem seznamu katalogů.

[[Image:formulare_a_katalogy24-nastaveni-parametru-seznamu-katalogu.jpg|center]]

URL s odkazem na daný katalog ve stylu seznamu katalogů se pak vždy generuje jako odkaz na stránku se seznamem položek katalogu, tedy /''scripts/modules/catalogue/list.php?catalogueid=číslo_katalogu''.

=====Navigační lišta=====
Ve formuláři '''Navigační lišta''' je definován vzhled lišty, která je používána pro stránkování seznamů položek.

[[Image:formulare_a_katalogy25-navigacni-lista.jpg|center]]

Grafický vzhled jednotlivých prvků navigační lišty se definuje pomocí následujících polí:

# '''Předchozí''' – HTML kód určující formátování odkazu pro přechod na předcházející stránku
# '''Následující''' – HTML kód určující formátování odkazu pro přechod na další stránku
# '''Hlavička''' – HTML kód který je umístěn na počátku výsledného kódu navigační lišty
# '''Patička''' – HTML kód který je umístěn na konci výsledného kódu navigační lišty
# '''Číslo stránky''' – formátování jednotlivých čísel stránky, které umožní odkliknutí na zvolenou stránku
# '''Aktivní stránka''' – formátování údaje o čísle aktuální stránky
# '''Separátor''' – oddělovač mezi jednotlivými čísly stránek.
# '''Počet stránek''' určuje maximální počet čísel stránek v navigační liště a tím nepřímo ovlivňuje i její šířku.

Pro správnou funkci navigační lišty je nutné do výše popsaných polí zadávat i klíčová slova<nowiki> a </nowiki>.

Jejich použití je zřejmé z následujícího jednoduchého příkladu:

[[Image:formulare_a_katalogy26-nastaveni-navigacni-listy.jpg|center]]

<div class="note">Definici navigační lišty je třeba po instalaci každého modulu v instalovaném modulu uložit – výchozí hodnoty se po instalaci v databázi nenacházejí a bez uložení se pak navigační lišta na žádné stránce nezobrazí.</div>

=====Filtr slov=====
Funkce '''Filtr slov''' umožňuje definovat slovník nevhodných výrazů. V horním seznamu se zobrazují slova seřazená podle abecedy, ve spodním rámci se zobrazuje editační formulář.

[[Image:diskuze37-filtr-slov.jpg|center]]

Ve slovech lze používat hvězdičku jako zástupný znak pro více libovolných písmen.

Součástí definice filtrovaného výrazu jsou i příznaky, zda výraz použít při filtraci nežádoucích výrazů a při detekci spamu.

Výrazy označené pro použití při detekci spamu se použijí jen v případě, že v antispamovém profilu, který používá daný katalog, je zvolena možnost ''Vyhledávání spamu podle obsahu příspěvků''.

=====Další nastavení=====
Pokud je v katalogu zapnuta jakákoliv ochrana proti spamu, je třeba nadefinovat, jak se má chovat skript pro vkládání záznamů do katalogu v případě, že je příspěvek označen za spam a do databáze se nevloží. Toto chování definuje volba '''Je-li příspěvek detekován jako spam'''. Na výběr jsou následující možnosti:

* '''Ukončit běh skriptu''' - okamžitě se ukončí běh skriptu pro vložení záznamu. Skript vypíše pouze identifikační značku dané metody kontroly spamu.
* '''Zobrazit stránku pro vložení příspěvku''' - znovu se načte formulář pro vložení záznamu do daného katalogu.
* '''Přesměrovat na zvolenou stránku''' - přesměruje na stránku, kterou je nutné v případě této volby zvolit, jedná se o libovolnou stránku ze stromu kategorií WebToDate.

====Nastavení předpisů====
Dále se v nabídce '''Nastavení''' nacházejí jednotlivé předpisy a jejich nastavovací formuláře (za předpokladu, že je alespoň jeden předpis založen). Každý předpis se skládá z nastavení '''Seznam položek''', '''Jedna položka''', '''Vyhledávání''' a '''Vkládání'''. V následující tabulce jsou uvedena URL stránek, ke kterým se tato nastavení vztahují:

{| class="prettytable"
| '''Seznam položek'''
| '''/''scripts/modules/catalogue/list.php?catalogueid=číslo_katalogu'''''

|-
| Jedna položka
| ''/scripts/modules/catalogue/detail.php?.....''

|-
| Vyhledávání
| ''/scripts/modules/catalogue/search.php?catalogueid=číslo_katalogu''

|-
| Vkládání
| ''/scripts/modules/catalogue/iform.php?catalogueid=číslo_katalogu''

|}

Před uložením kteréhokoliv z těchto formulářů je třeba předem založit příslušnou předlohu resp. předlohy, doporučený postup je založit stránku typu předloha v kategorii Formuláře a katalogy, jako šablonu zvolit předpřipravenou šablonu stránek, která obsahuje vhodnou definici oblasti. Kódy specifické pro danou předlohu je vhodné umístit do separátních fragmentů a ty pak přiřadit na oblast na dané předloze (a předlohu vygenerovat). V rámci jednoho předpisu není povinné volit předlohy a nastavení ve všech čtyřech formulářích – pokud se např. daný katalog používá pouze pro sběr dat pomocí formuláře, není třeba nastavovat vlastnosti zobrazení všech položek či jedné položky apod., ale pouze nastavení pro vkládání dat.

Obecné schéma popisující kroky od použité šablony po výslednou dynamickou HTML stránku je na následujícím obrázku (platí pro všechny moduly WebToDate).

[[Image:formulare_a_katalogy27-schema-uziti-sablony-dhtml.jpg|center]]

=====Seznam položek=====
Formulář '''Seznam položek''' definuje předlohu stránky, styl seznamu položek a počet položek na jednu stránku v rámci stránkování. Všechna tato nastavení je nutno při uložení povinně vyplnit.

===== Jedna položka=====
Formulář '''Jedna položka''' definuje předlohu pro detailní zobrazení jednoho záznamu, jedinou možností v tomto formuláři je právě nastavení této předlohy.

=====Vyhledávání=====
Formulář '''Vyhledávání''' definuje vlastnosti samostatné vyhledávací stránky, jedinou volbou je zde předloha stránky. Výsledky hledání prezentuje stránka '''Seznam položek''', nikoliv tato stránka. Proto je tato stránka použitelná pouze v případě, kdy chceme mít na jedné stránce vyhledávací formulář a na druhé výsledek hledání. V opačném případě je možné vyhledávací formulář (tedy typicky tělo samostatného fragmentu) použít i na předloze stránky '''Seznam položek''', výsledek bude z hlediska funkčnosti identický.

=====Vkládání=====
Posledním formulářem v předpisu je '''Vkládání'''. Charakterizuje všechny stránky, které se mohou týkat vkládání dat do daného katalogu z veřejně přístupného adresáře. Jedná se o tyto předlohy:

* Předloha pro vstupní stránku – použije se pro stránku, ve které je formulář pro vložení dat. Tato volba je ve formuláři povinná, ostatní jsou nepovinné.
* Předloha pro potvrzovací stránku – použije se volitelně pro stránku, která zobrazuje formulář pro potvrzení vložení dat, data jsou v ''hidden'' polích formuláře. Stránka je potřebná pouze pokud se tato funkce používá, neboli ve vlastnostech katalogu je zvoleno '''Potvrzovací stránka''' : '''Ano'''.
* Odmítnutí přístupu – používá se v případě, že ve vlastnostech katalogu je nastaveno čtení nebo zápis s omezením na skupinu vybraných uživatelů.<div class="note">Poznámka: Funkce vyžaduje instalaci modulu [[../../Registrace a personalizace|Registrace a personalizace]].</div> Stránka se vyvolá v případě, že uživatel se úspěšně přihlásí k modulu Registrace a personalizace, ale patří do skupiny, která nemá k dané funkci přístup. Pokud je čtení nebo vkládání dat omezeno na všechny registrované uživatele (ne vybranou skupinu), stránka se nikdy nepoužije a není proto třeba ji nastavovat.
* Předloha pro e-mail – používá se jako předloha pro e-mail s obsahem formuláře zasílaný na adresu definovanou ve vlastnostech katalogu, je potřebná v případě, že je v těchto vlastnostech nastaveno '''Veřejný formulář vyvolává''': '''Odeslání e-mailu''' nebo '''Obojí'''.
* E-mail od - zadává se e-mailová adresa, ze které odcházejí e-maily s daty z formuláře pro vkládání dat do katalogu v prezentační části.

[[Image:formulare_a_katalogy28-nastaveni-parametru-vkladani-predloha-emailu.png|center]]

V případě využívání této funkce pro vkládání dat z formuláře je v zásadě třeba si připravit ještě jednu stránku, a to tu, která se má uživateli zobrazit po úspěšném vložení dat. URL této stránky se ale nedefinuje v tomto nastavení, ale přímo v kódu formuláře v poli ''returnurl''.

=== Administrace ===

Tato část nabídky slouží k zakládání nových katalogů, k definování jejich vlastností a k definování seznamu a vlastností polí katalogů.
====Práva====
První položkou nabídky jsou '''Práva'''. V tomto formuláři se způsobem obvyklým ve všech modulech nastavují práva pro editaci dat jednotlivých katalogů. Po založení katalogu mají právo na editaci dat pouze administrátoři. V tomto formuláři lze tato práva nastavit i pro členy vybraných týmů. V levé části vyberte příslušný katalog, v pravé části vyberte tým a pomocí příslušného tlačítka jej přeřaďte do seznamu '''Autorizované týmy'''.

====Antispamové profily====
V nabídce '''Antispamové profily''' se definují nastavení ochrany proti formulářovému spamu. Antispamový profil je pojmenovaná sada nastavení, pomocí kterých se vybírá, jaký typ ochrany se pro vkládání záznamů aplikuje. Na úrovni definice katalogu se pak vybírá odpovídající profil, který daný katalog použije. Všechny katalogy mohou využívat stejný profil nebo je možné nadefinovat více profilů a ty pak nastavit u různých katalogů dle potřeby.

V horní části okna prohlížeče je seznam profilů, klepnutím na název profilu se zobrazí formulář pro definici profilu.

[[Image:poradny-administrace-antispamoveho-profilu.png|center]]

Přidávat profily a měnit jejich nastavení je možné bez omezení, smazat profil lze jen když není použit u nějakého katalogu.

V následující tabulce je stručně uveden význam jednotlivých voleb, problematice spamu je věnována samostatná kapitola [[../Ochrana proti spamu#Ochrana proti spamu|Ochrana proti spamu]].

{| class="prettytable"
| '''Položka'''
| '''Význam'''
| '''Kroky potřebné pro implementaci'''

|-
| Kontrola URL volající stránky
| Pomocí http ''referer'' se kontroluje, že skript pro vložení záznamu je volán z formuláře zobrazovaného pomocí tohoto modulu na daném serveru. Pokud se cizí aplikace pokouší přímo přes http protokol vložit příspěvek (nevyplňuje formulář na serveru), je příspěvek detekován jako spam.
| Kontrola nevyžaduje žádné další kroky.

|-
| Formulářová návnada
| Do pole '''Názvy polí formuláře''' se zadá jeden nebo několik názvů HTML polí ve vstupním formuláři (názvy se oddělují středníkem). Kontrola zjišťuje, jestli některé z těchto polí není čímkoli vyplněno, pokud zjistí, že některé pole má hodnotu, je příspěvek označen za spam.
| Kontrola vyžaduje vložení jednoho nebo několika formulářových polí do HTML kódu vstupního formuláře pro zadávání nových záznamů. Pole musí být skryta před uživatelem (jako typ ''hidden'' či pomocí CSS). Člověk pak takové pole nevyplňuje, spamovací robot jej může vyplnit.

|-
| Seznam zakázaných IP adres
| Při vložení se kontroluje, zda IP adresa, ze které záznam přichází, není na seznamu zakázaných adres. Pokud tomu tak je, je položka označena za spam.
| Nevyžaduje žádné změny v prezentaci, ale vyžaduje zadání zakázaných IP adres pomocí funkce '''Data''' - '''Zakázané IP adresy''' nebo vložením IP adresy přímo z formuláře pro úpravu záznamu.

|-
| Vyhledávání spamu podle obsahu příspěvků
| V textu příspěvků se před vložením vyhledávají slova zadaná ve funkci '''Filtr slov''' s volbou '''Spam'''.
| Nevyžaduje žádné změny v prezentaci, ale vyžaduje naplnění seznamu nežádoucích výrazů pomocí funkce '''Filtr slov'''.

|-
| Opisování kontrolních kódů
| Uživateli jsou generovány do stránky kontrolní kódy, které musí opsat do daného textového pole. Lze navolit parametry kontrolních kódů - délku, zda se jedná o číslice či písmena apod.
| Vyžaduje do HTML kódu vstupního formuláře doplnění několika vstupních polí a klíčových slov modulu, aby bylo zajištěno zobrazení kontrolních kódů a zobrazilo se vstupní pole pro jejich opsání.

|}

====Nový katalog====
Pomocí další položky nabídky '''Nový katalog''' se zakládají katalogy.

[[Image:formulare_a_katalogy29-administrace-novy-katalog.png|center]]

Povinně se zde vyplňuje název katalogu, volí datová tabulka, nad kterou se katalog vytváří a pole pro jednoznačnou identifikaci záznamů v rámci dané datové tabulky (sloupec datové tabulky, který obsahuje vhodné jedinečné hodnoty, tyto hodnoty musí být použitelné v URL). Ostatní položky jsou nepovinné.

V nabídce '''Datová tabulka''' se ve výchozím stavu zobrazují názvy tabulek spravovaných modulem, tj. těch, jejichž názvy začínají na písmena KATD. Pokud je třeba založit katalog nad tabulkou s jiným názvem, existuje tato možnost – je toto třeba povolit v souboru ''global.php'' v konstantě CATALOGUE_TABLES (viz kapitola
[[../Instalace#Konfigurace v global.php|Konfigurace v global.php]]). Tato volba ovšem pak umožňuje manipulaci s daty této tabulky i s její strukturou (včetně smazání), takže tuto možnost je třeba používat s opatrností. Po založení katalogu již volbu datové tabulky nelze změnit.

V tomto formuláři lze dále volit:

* '''Předpis''' – změnou předpisu dojde ke změně grafických nastavení všech veřejně přístupných stránek patřících k danému katalogu. Jak je vysvětleno v kapitole [[../Pracovní postupy|Pracovní postupy]], při zakládání nového katalogu zpravidla ještě definice předpisu není vytvořená, výjimkou může být pouze opakované použití předpisu pro více katalogů s totožnou strukturou.
* '''Antispamový profil''' - volba [[../Ochrana proti spamu|antispamového profilu]]
* '''Data jsou přístupná pro čtení''' – tato volba definuje, kdo může zobrazovat data katalogu pomocí veřejně přístupných skriptů modulu. Pokud je zvoleno '''Nikomu''', stránky pro zobrazení dat katalogu vypíší pro dané ID katalogu chybové hlášení typu "Katalog nebyl nalezen" i v případě, že všechna ostatní nastavení (předpis apod.) jsou v pořádku a funkční. Další možnosti jsou '''Všem''' (tj. všem anonymním uživatelům) a '''Registrovaným''' s možností nepovinně ještě přístup omezit na vybranou skupinu uživatelů z modulu Registrace a personalizace. V případě, že je použita poslední volba, probíhá před zobrazením stránky s daty katalogu zjišťování, zda je uživatel k modulu Registrace a personalizace přihlášen, pokud tomu tak není, je přesměrován na přihlašovací stránku modulu Registrace a personalizace.
* '''Vkládat data mohou''' – tato volba je analogická předchozí volbě, pouze se vztahuje na možnost vkládání dat pomocí skriptu ''iform.php''.
* '''Přihlašovací režim''' – význam volby je stejný jako v ostatních modulech spolupracujících s modulem Registrace a personalizace. Možnost '''Vyžadovat přihlášení vždy''' vyvolá přihlašovací formulář vždy, když v rámci ''session'' není uživatel přihlášen, možnost '''Rozpoznávat registrované uživatele''' se pokouší identifikovat registrovaného uživatele pomocí cookies, které modul Registrace a personalizace vytváří. Pokud je uživatel pomocí tohoto ''cookie'' jednoznačně identifikován, je přihlášen automaticky, v opačném případě opět dojde na přihlášení přes formulář.
* '''Veřejný formulář vyvolává''' – pokud je daný katalog určen k tomu, aby pracoval se vstupním formulářem z veřejné části, v této volbě je třeba nadefinovat, zda se data z formuláře zapisují do datové tabulky, nebo odesílají e-mailem nebo oboje. Pokud je použito odesílání e-mailem, je třeba zadat e-mailovou adresu, na kterou se pošta odesílá a předmět těchto e-mailů.
* '''Potvrzovací stránka''' – v této volbě lze určit, zda po odeslání formuláře s daty dochází rovnou k zápisu dat nebo se má ještě zobrazit potvrzovací stránka a teprve po schválení v této potvrzovací stránce dojde k zápisu dat z formuláře.

Dále se v nabídce '''Administrace''' zobrazují jednotlivé katalogy. Klepnutím na název katalogu se zobrazují vlastnosti katalogu. Tento formulář je identický s formulářem pro založení nového katalogu, jedinou změnou je, že nelze změnit výběr datové tabulky.

====Pole a Třídění====
V nabídce se pod názvem katalogu zobrazují možnosti '''Pole''' a '''Třídění'''. Pomocí funkce '''Pole''' se zakládají pole katalogu, zpravidla platí, že co sloupec datové tabulky to jedno pole katalogu. Formulář pro vlastnosti polí je zobrazen na následujícím otisku obrazovky, každé pole je třeba explicitně do katalogu přidat (např. odkazem '''Přidat''' vpravo nahoře).

[[Image:formulare_a_katalogy30-nastaveni-polozky-katalogu.png|center]]

Význam jednotlivých políček tohoto formuláře je následující:

* '''Pořadové číslo''' – je třeba povinně explicitně zadat celé číslo, podle kterého se pole řadí. Podle tohoto čísla se řadí pole ve všech případech, kdy se generují fragmenty či styly v sekci '''Nástroje''', podle tohoto čísla jsou rovněž seřazena editační pole v automaticky sestavovaném editačním formuláři dat katalogu v administračním rozhraní v sekci '''Data'''.<div class="note">Nástroje: Ve vygenerovaném stylu či fragmentu lze ovšem dodatečně pořadí zobrazování polí katalogu jednoduše změnit prostým přesunem příslušných klíčových slov pro obsah polí v HTML kódu fragmentu či stylu.</div>
* '''Jméno pole v databázi''' – volí se z nabídky názvů polí tak jak jsou definována v datové tabulce katalogu.
* '''Zobrazování pole''' – zadává se povinně popisek. Tento popisek se používá jednak při zobrazování v administrační části (např. ve formuláři při editaci dat), dále jej používají funkce v sekci '''Nástroje''' při vytváření fragmentů či stylů – po vygenerování takového objektu lze ovšem opět tyto popisky v HTML kódu jakkoliv měnit či dokonce odstranit. Maximální délka popisku je 50 znaků.
* '''Zobrazovat v seznamu''' – udává, zda chceme zobrazovat pole ve stránce pro zobrazení seznamu položek katalogu. Pokud je zvoleno, nástroj pro generování stylu zahrne toto pole do zobrazení. Pokud klíčové slovo pro dané pole ze stylu pro zobrazení seznamu dodatečně odstraníme, pole nebude v seznamu zobrazováno. Pokud naopak dodatečně zrušíme tuto volbu v tomto formuláři, pole opět nebude zobrazováno, přestože odpovídající klíčové slovo ve stylu pro seznam položek zůstane.
* '''Odkaz na detail''' – toto pole má dvojí význam. Při generování stylu pro seznam položek se na toto pole umístit odkaz na detailní zobrazení (neboli HTML značka <nowiki><a></nowiki>), nástroj pro editaci dat katalogu v administrační části na toto pole umístí odkaz na otevření editačního formuláře pro editaci záznamu v seznamu záznamů.
* '''Zobrazovat na detailní stránce''' – pokud je tato volba zvolena, fragment vygenerovaný pomocí funkce '''Položka''' obsahuje klíčové slovo pro toto pole. Pokud klíčové slovo z fragmentu manuálně odstraníme, obsah pole se v detailním pohledu na jeden záznam nezobrazuje stejně tak jako v případě, kdy klíčové slovo ve fragmentu ponecháme ale dodatečně zrušíme tuto volbu v tomto formuláři.
* '''Používat při prohledávání''' – Tato volba má dvojí význam. Jednak specifikuje, že podle daného pole je možné prohledávání v administračním rozhraní při editaci dat, jednak toto pole generuje funkce '''Vyhledávací formulář''' v sekci '''Nástroje''' do příslušného fragmentu. Podporována je možnost hledání pouze u některých datových typů (podle definice typu v datové tabulce) – konkrétně pro textové datové typy a pro celočíselné datové typy. Pokud je tedy např. v datové tabulce sloupec typu ''datum'', nelze v tomto formuláři zvolit jeho prohledávání.
* '''Zobrazovat v seznamu při úpravách''' – pomocí této volby se specifikuje, která pole se zobrazují v seznamu položek v nástroji pro editaci dat v administračním rozhraní. Pokud potřebujete data katalogu v administračním rozhraní editovat, je třeba aspoň jedno pole katalogu označit touto volbou.
* '''Data lze vkládat z veřejné části''' – tato volba vyznačuje, že do tohoto pole je možné vkládat data pomocí vstupního formuláře veřejné části. Takto označená pole generuje funkce '''Vstupní formulář''' v sekci '''Nástroje''' do HTML kódu fragmentu. Pokud je dodatečně tato volba zrušena, je potřeba i příslušné klíčové slovo typu WTD_FCI odstranit z fragmentu – skript pro vkládání dat s klíčovým slovem příslušným k danému poli přestane pracovat a výsledkem je chyba typu FIELDSNOACCESS (viz chybové stavy v kapitole Veřejné skripty).
* '''Výchozí hodnota''' – v tomto poli lze definovat výchozí hodnotu, která se předvyplní jak v administračním rozhraní ve formuláři pro editaci dat, tak ve veřejném formuláři dosazením hodnoty za příslušné klíčové slovo typu WTD_FCI.
* '''Povinně vyplnit''' – volba vyznačuje, že pole musí povinně obsahovat nějakou hodnotu. Povinné vyplnění se kontroluje jak při vkládání dat formulářem z veřejné části tak při editaci dat v administračním rozhraní.
* '''Jedinečná hodnota''' - volba vyznačuje, že pole musí obsahovat jedinečnou hodnotu v rámci daného sloupce datové tabulky. Hodnota se kontroluje jak při vkládání dat formulářem z veřejné části tak při editaci dat v administračním rozhraní.
* '''Typ pole''' - rozevírací nabídka s možnostmi ''Běžné pole / ID souboru ze zdrojů''. Volba ''Běžné pole'' je určena pro vstupní pole zadávaná běžným způsobem, která reprezentují nějaký text, číslo apod. Volba ''ID souboru ze zdrojů'' je určena k tomu, aby bylo možné do dané tabulky vkládat odkazy na soubory z databáze zdrojů pomocí jejich ID. Volbu ''ID souboru ze zdrojů'' lze provést jen pro takové pole datové tabulky, jehož datový typ je celé číslo.

Je-li nějaké pole označené jako '''Jedinečná hodnota''', '''Povinně vyplnit''' a zároveň je použito jako pole pro jednoznačnou identifikaci ve vlastnostech katalogu a jeho typ je celočíselný, modul jej při vkládání dat z veřejně přístupného formuláře autoinkrementuje, počáteční hodnota je 1.

Druhou funkcí je '''Třídění'''. Pomocí definic třídění se specifikuje, v jakém pořadí se budou zobrazovat položky katalogu v zobrazení seznamu položek, týká se to jak zobrazení na veřejné části webu tak v administračním rozhraní pro editaci dat. Pravidel pro třídění pro vybraný katalog lze zadat více, pořadí v jakém se třídící kritéria uplatní se definují ve formuláři pro editaci způsobu třídění.

[[Image:formulare_a_katalogy31-trideni-kriterii.jpg|center]]

Zadává se pole, podle kterého se třídí (výběrem z polí datové tabulky), pořadí v pravidlech třídění a způsob třídění (vzestupně, sestupně).

=== Data ===

Nabídka modulu v této části umožňuje:

* Zakládat nové datové tabulky, měnit jejich strukturu či je mazat
* Exportovat z datových tabulek data a naopak je do nich importovat
* Spravovat soubory k importu a exportované soubory
* Editovat data jednotlivých katalogů

====Seznam tabulek====
První položkou nabídky je '''Seznam tabulek'''. V pravé horní části se zobrazí seznam datových tabulek katalogu, u každé tabulky jsou tlačítka '''Náhled''', '''Export''' a '''Editovat'''.

Funkce '''Náhled''' je nejrychlejší způsob, jak zkontrolovat obsah tabulky – zobrazí v režimu pouze pro čtení prvních několik desítek záznamů v datové tabulce.

Společný formulář se používá pro zakládání nové tabulky (odkaz '''Přidat''' vpravo nahoře) a editaci struktury existující tabulky (tlačítko '''Editovat''').

[[Image:formulare_a_katalogy32-vytvareni-tabulky.jpg|center]]

Formulář má dvě záložky – v záložce '''Tabulka''' se zadává pouze jméno tabulky (automaticky se ke jménu předřazují písmena KATD), v záložce '''Sloupce''' lze měnit strukturu tabulky.

Editor struktury tabulek mění strukturu okamžitě po potvrzení editace daného řádku, nelze tedy např. přidat několik sloupců na straně prohlížeče a pak změnu dávkově odeslat na server. Tlačítko '''Odebrat sloupec''' funguje bez potvrzování, změna se okamžitě provede. Pokud klepneme do kteréhokoliv pole v editačním řádku, ostatní řádky se uzamknou a formulář je v režimu změny vybraného sloupce tabulky.

Názvy sloupců lze volit libovolně s těmito omezeními:

* Tabulka nesmí obsahovat dva sloupce stejného názvu
* Maximální délka názvu je 50 znaků
* Doporučujeme v názvech sloupců používat pouze písmena bez diakritiky a čísla, nikoliv např. mezery apod.

Datové typy se specifikují výběrem v poli '''Typ sloupce'''. Možné hodnoty jsou:

* Celé číslo
* Znak
* Řetězec
* Text
* Reálné číslo
* Datum

Typ ''Znak'' volte v případě, že pole má obsahovat menší a vždy stejný počet znaků. Typ ''Řetězec'' volte v případě, že pole obsahuje pokaždé jiný omezený (typicky do 255) počet znaků. Typ ''Text'' volte pro delší texty.

Délky polí lze volit pouze u typů ''Řetězec'' a ''Znak'', u ostatních polí se délky nastavují automaticky a nelze je měnit.
<div class="note">Řetězec a Znak: Maximální délky těchto polí jsou omezeny, omezení závisí na konkrétním typu použité databáze a její verze – tato omezení je třeba zjistit v dokumentaci k dané databázi, jedná se o maximální délky typů VARCHAR a CHAR.</div>

Pole lze rovněž opatřit databázovým indexem. Index je struktura databáze, která zrychluje přístup k datům podle daného sloupce. Použijte tuto možnost v případě, že se podle tohoto pole má třídit nebo vyhledávat. Pole typu ''Text'' nelze indexovat.

<div class="note">Strukturu datových tabulek lze měnit i v případě, že tabulka již obsahuje data. Je proto vhodné postupovat velmi obezřetně, data z odstraněného sloupce již rozhodně nelze obnovit.</div>

====Katalogy====
Další funkcí je editace dat katalogů. Pod nabídkou '''Data''' / '''Katalogy''' se zobrazují názvy existujících katalogů, klepnutím na název se přechází do nástroje pro editaci dat katalogu. Obrazovka může vypadat např. tak, jak je znázorněno na následujícím otisku.

[[Image:formulare_a_katalogy33-editace-katalogu.png|center]]

V horní části se zobrazuje stránkovaný seznam položek, vpravo nahoře jsou odkazy pro stránkování, přidání nového záznamu a přechod na vyhledávání. V seznamu se zobrazují ty sloupce, které mají v definici katalogu zvoleno '''Zobrazovat v seznamu při úpravách'''. Klepnutím na položku se ve spodní části otevírá editační formulář. Odkaz na otevření tohoto formuláře se umístí na to pole, které má v definici katalogu zvoleno '''Odkaz na detail'''.

Pomocí editačního formuláře lze záznamy měnit, mazat i přidávat. Formulář nemusí obsahovat všechny sloupce datové tabulky – obsahuje jen ty sloupce, pro které je definováno pole katalogu. Pořadí polí ve formuláři je dáno vlastností '''Pořadové číslo''' v definici pole katalogu. Formulář používá i další vlastnosti polí katalogu jako výchozí hodnoty a jedinečnost údaje ve sloupci tabulky. Je-li součástí formuláře pole pro jednoznačnou identifikaci, jeho popisek je zvýrazněn tučně. Pokud je pole označeno jako ''Povinně vyplnit'', přidávají se za název pole v popisku formuláře znaky (*). Pokud je pole v datové tabulce typu ''text'', objevuje se vedle vstupního pole ikona WYSIWYG editoru, po klepnutí na tuto ikonu lze obsah tohoto pole měnit a formátovat pomocí tohoto editoru.

Je-li v definici polí katalogu pole typu ''ID souboru ze zdrojů'', příslušný řádek formuláře pro toto pole vypadá tak, jak je patrno z následujícího otisku obrazovky (pole "Obrázek").

[[Image:formulare_a_katalogy-data-s-obrazkem.png|center]]

Do pole lze pak vložit jen celé číslo, které existuje jako ID souboru v databázi zdrojů. Pomocí tlačítka '''Náhled''' se vyvolá náhled tohoto souboru v novém okně prohlížeče, pomocí tlačítka '''Vložit''' se vyvolá formulář pro výběr souboru z databáze zdrojů.

[[Image:formulare_a_katalogy-vyber-obr.png|center]]

V horní části tohoto okna je vyhledávací formulář pro vyhledávání v databázi zdrojů, vyhledat můžete dle jakékoli kombinace metadat. Ve spodní části se po vyhledávání zobrazí seznam zdrojů odpovídající vyhledávací podmínce, u každého zdroje je seznam všech souborů ve zdroji. Klepnutím na šipku vlevo od názvu souboru se do formuláře pro editaci záznamu katalogu vkládá ID souboru, po klepnutí na šipku se toto okno uzavírá.

Vyhledávání používá ta pole, která mají v definici katalogu nastaveno '''Používat při prohledávání'''. Pokud je vyplněno více polí vyhledávacího formuláře, spojují se ve vyhledávací podmínce logickou spojkou "a zároveň".

[[Image:formulare_a_katalogy34-vyhledavani-zaznamu.jpg|center]]

Je-li nastaveno prohledávání podle aspoň jednoho textového pole, obsahuje formulář zaškrtávací okénko z volbou, zda prohledávat jen začátky textových polí. Pokud je toto zvoleno, musí obsah pole začínat na zadaný text, v opačném případě musí pole obsahovat (kdekoliv) zadaný text. Žádné složitější vyhledávací výrazy nejsou podporovány.

Jako poslední jsou v v nabídce '''Data''' funkce pro export a import dat. Pro manipulaci se soubory, které se mají importovat, resp. s exportovanými soubory slouží funkce '''Soubory'''. Grafické rozhraní této funkce zpřístupňuje obsah adresáře ''wwwroot/data'' a jeho podadresářů. Výchozí složky jsou

''/data/katalogy/export/''

pro export dat, resp.

''/data/katalogy/import/''

pro import dat. Adresář pro import lze změnit tak jak je popsáno v kapitole Konfigurace v global.php. Je nutné ručně zajistit, aby exportní i importní adresář existovaly, v opačném případě funkce pro export resp. import nejsou funkční.

V levé části okna pro soubory se přechází mezi složkami. V pravé části se zobrazuje obsah složky, klepnutím na název souboru se zobrazí jeho náhled, tak jak je vidět na následujícím otisku obrazovky.

[[Image:formulare_a_katalogy35-zobrazeni-struktury-slozek-nahledy.jpg|center]]

Tlačítko '''Přidat soubor''' použijte v případě, že chcete do adresáře na serveru kopírovat soubor připravený k importu a umístěný na lokálním disku počítače. Naopak tlačítko '''Stáhnout soubor''' použijte v případě, že chcete na lokální disk stáhnout exportovaný soubor.
<div class="note">Poznámka: Maximální velikost souboru při kopírování z lokálního počítače na server je omezena nastavením v souboru ''php.ini'', v případě práce s většími soubory je tedy třeba nejprve zkontrolovat toto nastavení, případně nakonfigurovat k adresáři přístup přes ftp server či jiný podobný způsob přímého přístupu.</div>

====Import====
Funkce '''Import''' nejprve v pravé horní části okna zobrazí seznam souborů v importním adresáři. Klepnutím na název souboru se otevírá ve spodní části formulář pro spuštění importu.

[[Image:formulare_a_katalogy36-import-dat-ze-souboru.jpg|center]]

V záložce '''Soubor''' se nachází pouze informace o tom, který soubor bude importován. V záložce '''Tabulka''' se nacházejí důležitá nastavení importu. V prvé řadě se zde volí, zda se importuje do existující tabulky nebo má import založit novou tabulku. Pokud se importuje do existující tabulky, lze zvolit, zda nová importovaná data pouze přidat a stávající ponechat nebo původní data nejprve smazat. Tlačítko '''Náhled''' zobrazí v novém okně náhled na importovaná data (prvních několik desítek záznamů), tlačítko '''Import''' spouští vlastní import dat.

Importovat lze z jednoho z podporovaných formátů dat, poznámky k jednotlivým formátům jsou v následující tabulce.

{| class="prettytable"
| rowspan="5"| DBF

| PHP funkce pro manipulaci s DBF soubory nepodporují datový typ MEMO, neboli dlouhé texty. Sloupce typu MEMO v importovaném DBF souboru se při importu ignorují.

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců z DBF souboru a přiřadí se jim nejpodobnější datové typy SQL databáze.

|-
| Při importu do existující tabulky se porovnávají názvy sloupců v SQL tabulce a v importované tabulce a importuje se vyhledáváním sloupců se stejným názvem. To znamená, že struktura SQL tabulky nemusí být identická se strukturou importovaného DBF souboru – pokud jsou v DBF souboru nějaké sloupce navíc, ignorují se, pokud jsou naopak navíc nějaké sloupce v SQL tabulce, dosadí se do nich při importu hodnota ''null''.

|-
| DBF formát obsahuje standardně nezobrazovaný sloupec nazvaný ''deleted'', pomocí kterého se v tomto formátu označují odstraněné řádky. Import s tímto sloupcem pracuje – pokud import automaticky zakládá novou tabulku, vytvoří se i sloupce nazvaný ''deleted''. Tento sloupec lze ale z SQL tabulky odstranit a bez problémů z DBF souboru importovat (viz předchozí poznámka).

|-
| Texty musí být v DBF souboru v takové kódové stránce v jaké mají být uloženy v SQL databázi, při importu nedochází k překódování.

|-
| rowspan="4"|XML

| Konvence ohledně pojmenování XML elementů v importovaném souboru je následující:
*Název kořenového elementu může být libovolný
*Elementy oddělující jednotlivé řádky (původní záznamy v SQL tabulce) se vždy musí jmenovat <nowiki><row></nowiki>
*Elementy pro jednotlivá pole jsou pojmenovány stejně jako názvy sloupců v datové tabulce, tedy např. <nowiki><NAZEV></nowiki> apod.

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců podle XML struktury. Všechny automaticky založené sloupce datové tabulky v SQL databázi budou mít typ ''řetězec'' o délce 255 znaků. Pokud se tedy používá automatické zakládání tabulky při importu, je vhodné následně nastavit správné datové typy pro sloupce tabulky. Další vlastnost, která z tohoto chování vyplývá je ta, že v tomto případě budou všechny texty oříznuty na délku max. 255 znaků. Pokud tedy XML elementy obsahují texty delší než 255 znaků, je třeba buď nejprve strukturu tabulky založit ručně nebo po importu strukturu odpovídajících sloupců změnit (na typ ''dlouhý text'') a import spustit ještě jednou.

|-
| Datumy by v importovaném souboru měly být v XML formátu 2005-05-04 11:41:00.

|-
| Nejvhodnější kódová stránka pro import je utf-8, importovat lze ale i XML soubory v jiných kódových stránkách.

|-
| rowspan="5"|CSV

| Zatímco u ostatních formátů se nastavuje pouze tabulka do které se importuje a možnost ponechat či odstranit původní data v datové SQL tabulce, u CSV formátu se ve formuláři vyskytuje důležitá volba '''Data obsahují názvy sloupců''' – tuto volbu je třeba vždy správně nastavit.
Oddělovač sloupců může být čárka nebo středník, což je při importu detekováno automaticky.

|-
| Při automatickém zakládání SQL tabulky při importu budou mít všechny sloupce typ ''řetězec'' o délce 255 znaků – chování je stejné jako u XML formátu včetně možného nežádoucího oříznutí delších textů, je tedy vhodné nejprve strukturu tabulky připravit ručně.
Pokud CSV soubor neobsahuje v prvním řádku názvy sloupců, založí se názvy automaticky podle jmenné konvence ''sloupec_1'', ''sloupec_2'' atd., v opačném případě se sloupce v SQL tabulce pojmenují podle prvního řádku CSV souboru.

|-
| Pokud CSV soubor obsahuje v prvním řádku názvy sloupců, při importu do existující tabulky se importuje metodou vyhledávání stejných názvů sloupců v SQL tabulce – záleží tedy na těchto názvech a pokud se název sloupce liší nebude takový sloupec importován. Pokud naopak v prvním řádku názvy sloupců nejsou, importuje se podle pořadí, v jakém jsou sloupce definovány.

|-
| Texty musí být v  CSV souboru v takovém kódování, v jakém mají být uloženy v SQL databázi.

|-
| Formát datumů se očekává stejný jako u XML formátu.

|}

<div class="note">Při používání importu doporučujeme používat obvyklé konvence pro názvy sloupců tabulek apod., tj. spíše kratší jména, bez diakritiky, pouze písmena a číslice. Funkčnost importu je do značné míry daná tím, jak pracují příslušné funkce PHP – např. PHP funkce zjišťující název sloupce tabulky vrací pro databázi MS SQL Server maximálně 30 znaků, je-li název sloupce delší, import nemůže proběhnout.</div>

====Export====
Pomocí funkce '''Export''' lze exportovat data nejen z tabulek, které spravuje modul Formuláře a katalogy, ale ze všech tabulek databáze, kterou instalace WebToDate používá. V pravé horní části se zobrazuje seznam těchto SQL tabulek, v každém řádku je tlačítko '''Náhled''', které ve spodním rámci zobrazí prvních několik záznamů v tabulce, a dále tlačítko '''Export''', které vyvolá ve spodním rámci formulář pro export dat.

[[Image:formulare_a_katalogy37-export-dat-tabulky.jpg|center]]

První záložka exportního formuláře se nazývá '''Tabulka'''. Lze v ní specifikovat:

* Které sloupce vybrané SQL tabulky se exportují
* Které záznamy tabulky se exportují
* V jakém pořadí se exportují

V prvé řadě se ve sloupci '''Vybrat''' pomocí zaškrtávacích políček vyznačí sloupce, které se mají exportovat.

<div class="note">Výchozí stav formuláře je takový, že není vybrán žádný sloupec. Přinejmenším je proto třeba použít tlačítko '''Vše''' a tím vybrat všechny sloupce tabulky.</div>

Dále lze specifikovat kritéria pro export, v podstatě vyhledávací podmínku, která vybere určitou množinu záznamů tabulky. V příslušném řádku formuláře se ve sloupci '''Splňující podmínku''' vybere operátor (tj. např. =, >, < apod.) a ve stejném řádku ve sloupci '''Vzhledem k '''se zadá příslušná hodnota. Těchto omezujících podmínek lze zadat několik, ve spodní části formuláře je radiopřepínač specifikující, zda se více zadaných podmínek spojuje logickou spojkou "a zároveň" nebo logickou spojkou "nebo". Operátor ''LIKE'' znamená, že zadaný řetězec se vyskytuje kdekoliv v textu. Pokud není zadaná žádná omezující podmínka, exportují se všechny záznamy.

Další možností je specifikovat řazení záznamů do exportovaného souboru. Lze vybrat dva sloupečky, podle kterých se řadí (ve formuláři sloupce '''Primárně''' a '''Sekundárně'''), v posledním sloupci formuláře lze pak specifikovat, zda se jedná o vzestupné nebo sestupné řazení. Není-li žádné řazení vybráno, záznamy se exportují v pořadí, v jakém se nacházejí v SQL tabulce.

Ve druhé záložce '''Soubor''' se specifikuje formát exportovaného souboru, jeho název a volba, zda soubor v případě jeho existence kompletně přepsat nebo připojit data na konec souboru.

[[Image:formulare_a_katalogy38-export-souboru.jpg|center]]

Název výstupního souboru zadávejte včetně přípony, vytváří se soubor podle přesně zadaného jména. Pomocí tlačítka '''Test''' lze ověřit, zda soubor se zadaným jménem již existuje a export se jej pokusí přepsat nebo takový soubor neexistuje a bude se zakládat nový.
====Soubory====
Exportovaný soubor je exportní funkcí uložen do adresáře pro export, ze kterého je možné jej stáhnout pomocí funkce '''Soubory'''.

Zvolit lze jeden z podporovaných formátů exportovaného souboru, poznámky k jednotlivým formátům jsou v následující tabulce.

{| class="prettytable"
| rowspan="5"| DBF
| PHP funkce pro manipulaci s DBF soubory nepodporují datový typ MEMO, neboli dlouhé texty. Sloupce typu MEMO v importovaném DBF souboru se při importu ignorují.

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců z DBF souboru a přiřadí se jim nejpodobnější datové typy SQL databáze.

|-
| Při importu do existující tabulky se porovnávají názvy sloupců v SQL tabulce a v importované tabulce a importuje se vyhledáváním sloupců se stejným názvem. To znamená, že struktura SQL tabulky nemusí být identická se strukturou importovaného DBF souboru – pokud jsou v DBF souboru nějaké sloupce navíc, ignorují se, pokud jsou naopak navíc nějaké sloupce v SQL tabulce, dosadí se do nich při importu hodnota ''null''.

|-
| DBF formát obsahuje standardně nezobrazovaný sloupec nazvaný ''deleted'', pomocí kterého se v tomto formátu označují odstraněné řádky. Import s tímto sloupcem pracuje – pokud import automaticky zakládá novou tabulku, vytvoří se i sloupce nazvaný ''deleted''. Tento sloupec lze ale z SQL tabulky odstranit a bez problémů z DBF souboru importovat (viz předchozí poznámka).

|-
| Texty musí být v DBF souboru v takové kódové stránce v jaké mají být uloženy v SQL databázi, při importu nedochází k překódování.

|-
| rowspan="4"|XML
| Konvence ohledně pojmenování XML elementů v importovaném souboru je následující:

* Název kořenového elementu může být libovolný
* <nowiki>Elementy oddělující jednotlivé řádky (původní záznamy v SQL tabulce) se vždy musí jmenovat <row></nowiki>
* <nowiki>Elementy pro jednotlivá pole jsou pojmenovány stejně jako názvy sloupců v datové tabulce, tedy např. <NAZEV> apod.</nowiki>

|-
| Je-li SQL tabulka při importu zakládána automaticky, převezmou se názvy sloupců podle XML struktury. Všechny automaticky založené sloupce datové tabulky v SQL databázi budou mít typ ''řetězec'' o délce 255 znaků. Pokud se tedy používá automatické zakládání tabulky při importu, je vhodné následně nastavit správné datové typy pro sloupce tabulky. Další vlastnost, která z tohoto chování vyplývá je ta, že v tomto případě budou všechny texty oříznuty na délku max. 255 znaků. Pokud tedy XML elementy obsahují texty delší než 255 znaků, je třeba buď nejprve strukturu tabulky založit ručně nebo po importu strukturu odpovídajících sloupců změnit (na typ ''dlouhý text'') a import spustit ještě jednou.

|-
| Datumy by v importovaném souboru měly být v XML formátu 2005-05-04 11:41:00.

|-
| Nejvhodnější kódová stránka pro import je utf-8, importovat lze ale i XML soubory v jiných kódových stránkách.

|-
| rowspan="5"|CSV
| Zatímco u ostatních formátů se nastavuje pouze tabulka do které se importuje a možnost ponechat či odstranit původní data v datové SQL tabulce, u CSV formátu se ve formuláři vyskytuje důležitá volba '''Data obsahují názvy sloupců''' – tuto volbu je třeba vždy správně nastavit.

Oddělovač sloupců může být čárka nebo středník, což je při importu detekováno automaticky.

|-
| Při automatickém zakládání SQL tabulky při importu budou mít všechny sloupce typ ''řetězec'' o délce 255 znaků – chování je stejné jako u XML formátu včetně možného nežádoucího oříznutí delších textů, je tedy vhodné nejprve strukturu tabulky připravit ručně.

Pokud CSV soubor neobsahuje v prvním řádku názvy sloupců, založí se názvy automaticky podle jmenné konvence ''sloupec_1'', ''sloupec_2'' atd., v opačném případě se sloupce v SQL tabulce pojmenují podle prvního řádku CSV souboru.

|-
| Pokud CSV soubor obsahuje v prvním řádku názvy sloupců, při importu do existující tabulky se importuje metodou vyhledávání stejných názvů sloupců v SQL tabulce – záleží tedy na těchto názvech a pokud se název sloupce liší nebude takový sloupec importován. Pokud naopak v prvním řádku názvy sloupců nejsou, importuje se podle pořadí, v jakém jsou sloupce definovány.

|-
| Texty musí být v  CSV souboru v takovém kódování, v jakém mají být uloženy v SQL databázi.

|-
| Formát datumů se očekává stejný jako u XML formátu.

|}

====Protokoly====
V části '''Protokoly''' lze procházet protokol modulu týkající se zápisů nových záznamů.

[[Image:poradny-zobrazit-protokol.png|center]]

Zobrazují se záznamy o vložených i odmítnutých záznamech, pokud je vložení odmítnuto antispamovou kontrolou, je zde uveden typ kontroly, která odmítnutí vyvolala.

====Zakázané IP adresy====
Funkce '''Zakázané IP adresy''' ovládá přidávání IP adres na blacklist (seznam zakázaných adres) a jejich odstraňování z blacklistu.

[[Image:diskuze47-zakazane-ip-adresy.jpg|center]]

Seznam adres je společný pro všechny katalogy a ovládá se stejným způsobem jako jiné funkce WebToDate modulů. Ve formuláři se zadává pouze IP adresa, datum vložení a údaj o uživateli se doplňuje automaticky.

== Veřejné skripty ==
=== Zobrazování dat ===

Prezentační skripty modulu se nacházejí v adresáři ''/scripts/modules/catalogue''/.'' Pro zobrazování dat lze použít skripty:

* ''default.php'' – zobrazuje seznam katalogů
* ''list.php'' – zobrazuje seznam položek katalogu
* ''detail.php'' – zobrazuje jednu položku katalogu
* ''search.php'' – zobrazuje vyhledávací stránku pro katalog

Skript ''default.php'' zobrazující seznam katalogů zobrazuje názvy existujících katalogů a odkazy na stránky zobrazující seznam položek katalogu. Skript zobrazuje jen ty katalogy, u kterých je nastaveno '''Data jsou přístupná pro čtení''' : '''Všem'''. Využití této stránky je nepovinné, odkazy na jednotlivé katalogy lze používat v jiných stránkách libovolně a stránka zobrazující seznam všech veřejně přístupných katalogů nemusí mít na daném webu využití.

Seznam katalogů je reprezentován v předloze stránky klíčovým slovem <nowiki>. Žádné jiné klíčové slovo nelze v předloze použít, pouze lze v předloze použít podmíněné zobrazení chybového hlášení </nowiki>. Seznam katalogů se formátuje zvoleným WebToDate stylem. Nejjednodušší styl lze pro tyto účely vytvořit tak, že do jeho těla zadáme kód

<code>
<nowiki><a href=""></a><br/></nowiki>
</code>

Tento příklad obsahuje klíčová slova pro název katalogu a pro odkaz na stránku se seznamem položek. Kromě toho lze v tomto stylu použít i klíčové slovo <nowiki></nowiki>, za které se dosazuje pro daný katalog URL vyhledávací stránky.

Důležitějším skriptem je skript ''list.php'' zobrazující seznam položek daného katalogu. Základní objekty, které se mohou v předloze vyskytovat, jsou seznam záznamů (reprezentovaný klíčovým slovem <nowiki>) a stránkovací navigační lišta (reprezentovaná klíčovým slovem </nowiki>). Dále lze do předlohy této stránky umístit:

* název zobrazovaného katalogu (<nowiki></nowiki>)
* ID zobrazovaného katalogu (<nowiki></nowiki>)
* Odkaz na první stránku se seznamem položek (<nowiki></nowiki>)
* Odkaz na vyhledávací stránku (<nowiki></nowiki>)
* Hlášení o tom, že katalog neobsahuje žádné položky (<nowiki></nowiki>.)

Ve stránce se může navíc vyskytovat vyhledávací formulář – z tohoto hlediska jsou možnosti práce s předlohou stejné jako na stránce pro '''Vyhledávání''' (z klíčových slov tedy ve stránce fungují klíčová slova typu <nowiki></nowiki>).

Stránkovací lišta se vždy formátuje jednotně podle nastavení pro navigační lištu v nastaveních modulu. Seznam položek katalogu se formátuje zvoleným WebToDate stylem. Jednoduchý příklad těla tohoto stylu vypadá následovně:

<code>
<nowiki><tr></nowiki>
<nowiki><td></td></nowiki>
<nowiki><td></td></nowiki>
<nowiki></tr></nowiki>
</code>

Klíčová slova typu <nowiki></nowiki> zde reprezentují pole katalogu, přičemž ''neco'' je název sloupce datové tabulky. Dále lze ve stylu použít tyto klíčová slova:

* <nowiki></nowiki> - kód se vkládá pouze pokud pole neco je prázdné
* <nowiki></nowiki> - kód se vkládá pouze pokud pole neco není prázdné
* <nowiki></nowiki> - číslování záznamů v seznamu
* <nowiki></nowiki> - odkaz na detailní stránku

Podmíněné vkládání obsahu polí lze použít např. v případech, kdy chceme odkaz (obrázek či e-mailovou adresu apod.) vložit pouze v případě, kdy je v záznamu nějaká hodnota, např. takto:
<code>
<nowiki>'></a>")--></nowiki>
</cede>
Číslování pomocí <nowiki></nowiki> zobrazuje pro větší přehlednost pro každý záznam katalogu číslo dané vypisovaným pořadím na stránce se započtením stránkování záznamů, toto číslování tedy nemá žádnou souvislost s daty katalogu.

Důležité je klíčové slovo <nowiki></nowiki>, za které se dosazuje odkaz na zobrazení detailní stránky s jednou položkou katalogu. Toto URL se generuje ve tvaru

''detail.php?catalogueID=číslo_katalogu&linkvalue=hodnota_pole_pro_jednoznačnou_identifikaci''

V parametrech skriptu pro zobrazení detailu jedné položky se tedy musí vyskytovat jak ID katalogu, tak identifikátor záznamu (v parametru ''linkvalue'').

Skript pro zobrazení jedné položky ''detail.php'' je určen k zobrazení jednoho záznamu datové tabulky katalogu. Všechna klíčová slova se zde umísťují do předlohy, stránka nepoužívá žádný WebToDate styl. Nejdůležitější klíčová slova v předloze jsou:

* <nowiki></nowiki> - klíčové slovo zastupující pole datové tabulky (neco = název sloupce datové tabulky)
* <nowiki></nowiki> - kód se vkládá pouze pokud pole ''neco'' je prázdné
* <nowiki></nowiki> - kód se vkládá pouze pokud pole ''neco'' není prázdné

Jednoduchý příklad HTML kódu části předlohy zobrazující vybraná data z jedné položky katalogu vypadá následovně:
<code>
<nowiki></nowiki>
<nowiki><table></nowiki>
<nowiki><tr><td>Katalogové číslo</td><td></td></tr></nowiki>
<nowiki><tr><td>Interpret</td><td><strong></strong></td></tr></nowiki>
<nowiki><tr><td>Titul</td><td></td></tr></nowiki>
<nowiki><tr><td>Počet nosičů</td><td></td></tr></nowiki>
<nowiki><tr><td>Nosič</td><td></td></tr></nowiki>
<nowiki></table></nowiki>
</code>
I v této stránce lze použít klíčová slova jako název katalogu apod. a vytvořit vyhledávací formulář (jsou tedy zde aktivní klíčová slova <nowiki></nowiki>), více viz kapitola [[../Reference#Klíčová slova modulu|Klíčová slova modulu]].

Stránku s vyhledávacím formulářem lze vytvořit pomocí zobrazení skriptu ''search.php''. Skript vyžaduje jako povinný parametr ID katalogu, zobrazuje se tedy např. jako ''/scripts/modules/catalogue/search.php?catalogueID=1''. Možnosti vyhledávacího formuláře v této stránce platí i pro stránky zobrazující seznam položek katalogu a detail jedné položky.

Příklad vyhledávacího formuláře je následující:
<code>
<nowiki><form action="" method="post"></nowiki>
<nowiki><table></nowiki>
<nowiki><tr valign="top"></nowiki>
<nowiki><td></nowiki>
<nowiki><label for="ARTINAME">Interpret</label></nowiki>
<nowiki></td></nowiki>
<nowiki><td> <input type="text" id="ARTINAME" name="ARTINAME" value=""/> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr valign="top"></nowiki>
<nowiki><td></nowiki>
<nowiki><label for="PRODTITL">Titul</label></nowiki>
<nowiki></td></nowiki>
<nowiki><td> <input type="text" id="PRODTITL" name="PRODTITL" value=""/> </td></nowiki>
<nowiki></tr></nowiki>
<nowiki><tr valign="top"></nowiki>
<nowiki><td></nowiki>
<nowiki><label for="MAJCONFC">Nosič</label></nowiki>
<nowiki></td></nowiki>
<nowiki><td></nowiki>
<nowiki><select name="MAJCONFC"></nowiki>
<nowiki><option value="" selected>--nerozlišovat--</option></nowiki>
<nowiki></nowiki>
<nowiki></select></nowiki>
<nowiki></td></nowiki>
<nowiki></tr></nowiki>
<nowiki></table></nowiki>
<nowiki><input type="submit" name="catalogue_search_button" value="Hledat" /></nowiki>
<nowiki></form></nowiki>
</code>
Za klíčové slovo <nowiki></nowiki> se v tomto příkladu dosadí URL pro zobrazení seznamu položek daného katalogu. Textová pole formuláře pro hledání musí mít atribut ''name'' odpovídající názvům polí (sloupců datové tabulky) katalogu.

Pro prohledávání platí:

* Prohledávat lze v katalogu jen pole textových a celočíselných typů, prohledávání jiných typů polí není podporováno.
* Prohledává se pouze s testem na rovnost nebo u textových polí na výskyt uvnitř textu (tj. podmínka LIKE). Není podporována možnost prohledávat na podmínku danou intervalem hodnot (tedy např. že daná hodnota musí být větší než nějaké číslo a menší než nějaké číslo).
* Tato pole musí být v katalogu označena jako '''Používat při prohledávání'''.

Pokud má formulář více vyplněných polí, spojuje se vždy vyhledávací podmínka logickou spojkou "a zároveň". Pokud se prohledává podle celočíselného pole, hledá se vždy podle testu na rovnost. Pokud se prohledává podle textového pole, hledá se výskyt řetězce kdekoliv uvnitř textového pole. Existuje zde ovšem možnost, jak hledání v textech omezit na hledání výskytu textového řetězce na začátku textových polí. Z vyhledávacího formuláře je třeba v tom případě předat parametr ''searchin'' s hodnotou ''begin'', např. pomocí následujícího kódu umístěného dovnitř formuláře:

<code>
<nowiki><input type="hidden" name="searchin" value="begin"></nowiki>
</code>

V tom případě se hledaný text nemá vyskytovat kdekoliv uvnitř textového pole, ale na jeho začátku.

Jednoduchý vyhledávací formulář tedy obsahuje pouze textová pole pojmenovaná odpovídajícím způsobem. Je ovšem podporována i složitější možnost – totiž vytváření pop-up menu, která nabízejí jedinečné hodnoty z daného sloupce databáze. Výše uvedený příklad prohledává katalog hudebních titulů, kde chceme kromě textových polí typu "interpret" prohledávat i podle typu nosiče (CD, MC apod.). Typ nosiče je v datové tabulce uveden jako text, pomocí klíčového slova <nowiki>) vložíme do formuláře všechny unikátní hodnoty daného sloupce s typem nosiče včetně příslušných HTML <option></nowiki> značek:
<code>
<nowiki><select name="MAJCONFC"></nowiki>
<nowiki><option value="" selected>--nerozlišovat--</option></nowiki>
<nowiki></nowiki>
<nowiki></select></nowiki>
</code>
Výsledný formulář pak vypadá v HTML stránce zhruba takto:

[[Image:formulare_a_katalogy39-vysledny-formular.jpg|center]]

Výpis položek je standardně setříděn podle nastavení '''Administrace''' / ''název katalogu'' / '''Třídění''' v administračním rozhraní modulu. Toto třídění lze změnit přes parametr ''sort'' z vyhledávacího formuláře nebo z URL. Jako hodnota parametru sort se vkládá název sloupce, podle kterého se má třídit. Třídění je pak vždy podle tohoto jednoho vybraného sloupce vzestupně.

Příklad HTML kódu pro volbu třídění je pak následující:
<code>
<nowiki><label for="sort">Třídit podle</label><br /></nowiki>
<nowiki><input type="radio" name="sort" value="nazev" checked="checked" /></nowiki> Názvu
<nowiki><input type="radio" name="sort" value="autor" /></nowiki> Jména autora
</code>
<div class="note">Poznámka: pokud se používá možnost volby třídění a v dané datové tabulce katalogu je větší množství záznamů, je doporučeno opatřit sloupce, podle kterých se třídí indexem (viz kapitola [[../Reference#Data|Data]]), jinak hrozí zpomalení sestavování stránek se seznamem položek a vyšší zátěž serveru.</div>

Další možností rozšíření možností vyhledávání je hledání dle intervalu hodnot. Uvedeme-li ve vyhledávacím formuláři např. pole
<code>
Počet kusů: <nowiki><input type="text" name="pockusu" value="" /></nowiki>
</code>
a je-li toto pole vyplněno, testuje se v prohledávaném sloupci na výskyt zadané hodnoty (pokud se jedná o textový sloupec) nebo na rovnost (pokud se jedná o jiné datové typy). Pokud ale uvedeme ve formuláři pole
<code>
Min. počet kusů: <nowiki><input type="text" name="pockusu[min]" value="" /></nowiki>
Max. počet kusů: <nowiki><input type="text" name="pockusu[max]" value="" /></nowiki>
</code>
můžeme prohledávat na rozsah hodnot, tj. hledat záznamy, kde v daném sloupci se vyskytuje jako minimální číslo hodnota zadaná do pole ''pockusu[min]'' a jako maximální číslo hodnota zadaná do pole ''pockusu[max''].'' Pro tuto volbu se tedy postupuje tak, že jako jméno pole formuláře nebo parametr URL se použije název sloupec datové tabulky s příponou ''[min]'' resp. ''[max''].'' Pro možnost prohledávání dle intervalu hodnot jsou podporovány celočíselné datové typy datové tabulky katalogu.

Vyhledávací formulář nepodporuje žádná další "aktivní" klíčová slova, nelze tedy např. zajistit, že stránka s výsledky hledání zobrazí formulář, který bude obsahovat údaje již uživatelem zadané v předchozí stránce apod.

=== Vkládání dat ===

Pro vkládání dat se používá skript ''/scripts/modules/catalogue/iform.php''. Hlavní možnosti tohoto skriptu jsou:

* Zobrazení formuláře pro vkládání dat
* Zobrazení potvrzovací stránky
* Zobrazování chybových hlášení aktivovaných kontrolou zadaných dat
* Odeslání e-mailu s daty vloženými do formuláře
* Přesměrování na vybranou stránku po úspěšném vložení dat z formuláře do katalogu.

Logika fungování tohoto skriptu je zhruba popsána následujícím vývojovým diagramem:

[[Image:formulare_a_katalogy40-diagram-logiky-fungovani-skriptu-vkladani-dat.jpg|center]]

Hlavním povinným parametrem skriptu je ID katalogu, do kterého se vkládají data ''catalogueid''.

Příklad jednoduchého kódu pro vstupní formulář je následující:
<code>
<nowiki><form action="/scripts/modules/catalogue/iform.php?catalogueid=" method="post"></nowiki>
<nowiki><input type="hidden" name="returnurl" value="/"/></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki></nowiki>
<nowiki><label for="JMENO">Jméno a příjmení</label><br/></nowiki>
<nowiki><input type="text" id="JMENO" name="JMENO" value=""/></nowiki> *
<nowiki><br/></nowiki>
<nowiki><label for="EMAIL">E-mailová adresa</label><br/></nowiki>
<nowiki><input type="text" id="EMAIL" name="EMAIL" value=""/></nowiki> *
<nowiki><br/></nowiki>
<nowiki><label for="VZKAZ">Další požadavky a komentáře</label><br/></nowiki>
<nowiki><textarea rows="10" rows="" name="VZKAZ" id="VZKAZ"></textarea></nowiki>
<nowiki><br/></nowiki>
<nowiki><input type="submit" name="catalogue_insert_button" value="Odeslat" /></nowiki>
<nowiki><p> Pole označená * jsou povinná. </p></nowiki>
<nowiki></form></nowiki>
</code>
Hlavní "aktivní" klíčová slova jsou <nowiki> zastupující hodnoty vkládaných polí. Názvy polí katalogu, do kterých se vkládá, se musí shodovat s atributem ''name'' vstupního formuláře. Klíčová slova </nowiki> jsou zde proto, aby v případě, že data neprojdou vstupní kontrolu se mohl zobrazit formulář včetně zadaných hodnot a vedle toho případná chybová hlášení reprezentovaná klíčovými slovy typu WTD_IF.

Na stejném principu pracuje i případná potvrzovací stránka, i zde se používají klíčová slova typu <nowiki></nowiki>, jednou se použijí pro zobrazení a podruhé jako hodnota ''hidden'' pole, která se po potvrzení přenáší jako hodnota, která bude uložena. Jedna položka formuláře na potvrzovací stránce pak vypadá např. takto:
<code>
<nowiki><tr></nowiki>
<nowiki><td> <label for="email">E-mail</label> </td></nowiki>
<nowiki><td></nowiki>
<nowiki></nowiki>
<nowiki><input type="hidden" id="email" name="email" value=""/></nowiki>
<nowiki></td></nowiki>
<nowiki></tr></nowiki>
</code>
<div class="note">Jako u všech ostatních typů stránek, i zde je vhodné tyto kódy formulářů primárně vygenerovat jako fragmenty pomocí nabídky '''Nástroje''' a následně je upravit podle potřeb.</div>

Vstupní skript provádí řadu kontrol a to i několikrát (pokud je použita potvrzovací stránka, tak i před uložením z potvrzovací stránky). Jedná se zejména o:

* Datové typy polí (tj. zda se např. někdo nepokouší do celočíselného pole zadat text apod.)
* Povinné vyplnění polí a unikátní hodnoty
* Názvy polí formulářů a názvy polí datové tabulky musí odpovídat
* Zda nejde o pokus zapsat hodnotu pole, které v definice katalogu není určeno k zápisům z veřejné části serveru.

Těmto kontrolám odpovídají možná chybová hlášení uvedená v kapitole [[../Reference#Klíčová slova modulu|Klíčová slova modulu]] .

Pokud se k vygenerování vstupního formuláře použije funkce z nabídky '''Nástroje''', vygenerují se všechna vstupní pole jako textová. Následně je možné změnit vstupní formulář tak, že místo některých textových polí se vytvoří nabídky formou pop-up menu, radiopřepínačů apod. Platí to, že důležité jsou pro daný element formuláře atributy ''name'' a ''value'', na typu pole nezáleží. Je třeba si ovšem uvědomit, že pokud dojde k chybě, zobrazí skript pro vkládání dat tu samou stránku se vstupním formulářem, kde klíčová slova typu WTD_FCI nahradí údaji, které zadal uživatel – pro jiná pole než textová pak dost dobře nelze nastavit správnou volbu, kterou uživatel v předchozím kroku zadal (atribut ''selected'' daného formulářového pole).

=== Možnosti omezení přístupu k zobrazení nebo vkládání dat ===

Jak je uvedeno v kapitole [[../Reference#Administrace|Administrace]], lze na úrovni katalogu nadefinovat, kdo (z hlediska veřejné části webu) může zobrazovat data katalogu a kdo do katalogu může vkládat.

Pokud je pro zobrazování zvoleno '''Nikomu''', je chování následující:

* Katalog se nezobrazuje v seznamu katalogů
* Pokud se pokusíme zobrazit seznam položek katalogu přímo přes skript ''list.php'', dostáváme chybové hlášení typu "Katalog nebyl nalezen"
* Stejné hlášení dostáváme u daného katalogu i pro skripty zobrazující jeden záznam a vyhledávací stránku.

Pokud vyvoláme skript pro vkládání dat iform.php pro katalog, který má nastaveno pro vkládání dat '''Nikdo''', dostáváme chybové hlášení typu "Předloha není definována".

Je-li na serveru instalován navíc modul Registrace a personalizace, lze kromě přístupů '''Všichni''' / '''Nikdo''' nastavit ve vlastnostech katalogu ještě přístup registrovaným uživatelům, a to odděleně pro prohlížení dat katalogu a pro vkládání dat do katalogu. V obou případech lze zvolit, že přístup mají buď všichni registrovaní nebo jen jedna vybraná skupina. Chování veřejných skriptů je pak následující:

* Pokud uživatel není přihlášen a pokusí se zobrazit nějakou stránku související s daným katalogem (zobrazení dat nebo vstupní formulář), je přesměrován na přihlašovací stránku ''(/''scripts/modules/registration/login.php''). Po úspěšném přihlášení je přesměrován zpět na původní stránku.
* Pokud uživatel je přihlášen a je nastaven přístup všem registrovaným, požadovaná stránka se ihned zobrazí.
* Pokud je uživatel přihlášen a je nastaven přístup pouze určité skupině uživatelů, je při pokusu o zobrazení stránky nejprve vyhodnoceno, zda přihlášený uživatel patří do nastavené skupiny. Pokud tomu tak je, stránka se zobrazí, pokud tomu tak není, je uživatel přesměrován na stránku ''Odmítnutí přístupu'' v případě vkládání dat a na přihlašovací formulář v případě zobrazování dat.

=== Klíčová slova modulu ===

Tato kapitola obsahuje souhrn všech klíčových slov modulu, která se používají v předlohách a WebToDate stylech.

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – všechny stránky kromě seznamu katalogů a e-mailů'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| ID katalogu
|

|-
| <nowiki></nowiki>
| Název katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující stránku se seznamem položek katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující vyhledávací stránku pro daný katalog
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – seznam katalogů'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Seznam katalogů
|

|-
| <nowiki></nowiki>
| Hlášení v případě, že nebyl nalezen žádný katalog
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná ve stylu seznamu katalogů'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Název katalogu
|

|-
| <nowiki></nowiki>
| ID katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující stránku se seznamem položek katalogu
|

|-
| <nowiki></nowiki>
| URL zobrazující vyhledávací stránku pro daný katalog
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – seznam položek katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Seznam položek (záznamů)
|

|-
| <nowiki></nowiki>
| Navigační lišta
|

|-
| <nowiki></nowiki>
| Hlášení v případě, že nebyl nalezen žádný záznam
|

|-
| <nowiki></nowiki>
| Zobrazení jedinečných hodnot daného sloupce
| Pro účely vyhledávacího formuláře, vytváří se včetně HTML <nowiki><option></nowiki> značek

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná ve stylu seznamu položek katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující hodnotu pole datové tabulky
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' je prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' není prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Číslování položek v zobrazeném seznamu
|

|-
| <nowiki></nowiki>
| Odkaz na zobrazení detailní stránky zobrazující jeden záznam
|

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze - zobrazení jedné položky katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující hodnotu pole datové tabulky
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' je prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| kód se vkládá pouze pokud pole ''neco'' není prázdné
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Zobrazení jedinečných hodnot daného sloupce
| Pro účely vyhledávacího formuláře, vytváří se včetně HTML <nowiki><option></nowiki> značek

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze - vyhledávací stránka katalogu'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| Zobrazení jedinečných hodnot daného sloupce
| Pro účely vyhledávacího formuláře, vytváří se včetně HTML <nowiki><option></nowiki> značek

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – stránky pro vkládání dat přes formulář'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující hodnotu atributu ''value'' vstupního formuláře
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Skrytý kontrolní kód
| Používá se pro [[../Ochrana proti spamu|antispamovou ochranu]] typu ''Opisování kontrolních kódů''

|-
| <nowiki></nowiki>
| Zobrazovaný kód k opsání
| Používá se pro [[../Ochrana proti spamu|antispamovou ochranu]] typu ''Opisování kontrolních kódů''

|-
| <nowiki></nowiki>
| bylo zjištěno, že datový typ některého pole neodpovídá datové tabulce
|

|-
| <nowiki></nowiki>
| některé povinné pole není vyplněno
|

|-
| <nowiki></nowiki>
| některé pole, které má obsahovat unikátní hodnoty není správně vyplněno
|

|-
| <nowiki></nowiki>
| některé pole v kolekci formuláře v datové tabulce neexistuje
|

|-
| <nowiki></nowiki>
| některé pole v kolekci formuláře v datové tabulce nemá povolen zápis z veřejné části
|

|-
| <nowiki></nowiki>
| jiná chyba, např. nelze naplnit pole pro jednoznačnou identifikaci, SQL databáze vrátila při pokusu o zápis chybu apod.
|

|-
| <nowiki></nowiki>
| Kód se vloží v případě, že uživatel špatně opsal kontrolní kód pro antispamovou ochranu
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|-
| <nowiki></nowiki>
| Kód vloží antispamová ochrana v případě, že adresa uživatele vkládajícího dotaz je na seznamu zakázaných adres
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|-
| <nowiki></nowiki>
| Vloží se pokud byl příspěvek detekován jako spam a nejde o předchozí dva případy.
| Lze použít v předloze obsahující formulář pro vložení nového dotazu

|}

{| class="prettytable"
| colspan="3" | '''Klíčová slova použitelná v předloze – e-mail s obsahem vstupního formuláře'''

|-
| '''Klíčové slovo'''
| '''Význam'''
| '''Poznámka'''

|-
| <nowiki></nowiki>
| klíčové slovo zastupující vloženou hodnotu pole datové tabulky
| (''neco'' = název sloupce datové tabulky)

|-
| <nowiki></nowiki>
| Název katalogu
| <nowiki></nowiki>

|-
| <nowiki></nowiki>
| ID katalogu
| <nowiki></nowiki>

|}

Modul dále podporuje [[../../Referenční/Klíčová slova WebToDate#Klíčová slova pro formátování|Klíčová slova pro formátování]] typu WTD_FORMAT, tedy např.

''<nowiki></nowiki>''

apod.

=== Speciální názvy parametrů ===

Skripty používají následující speciální parametry (v URL nebo ve vyhledávacích formulářích). Vzhledem k vyhrazenému významu těchto parametrů to znamená, že '''názvy sloupců datových tabulek se nesmí shodovat s názvy těchto parametrů''':

* catalogueid – ID katalogu
* linkvalue – hodnota pole pro jednoznačnou identifikaci (používá skript pro zobrazení detailní stránky jedné položky katalogu)
* pg – používá stránkovací lišta pro stránkování
* searchin – udává způsob prohledávání textových polí (používá skript pro zobrazení seznamu položek katalogu)
* sort – může být použit pro výběr sloupce, podle kterého se třídí seznam položek
* returnurl – využívá skript pro vkládání dat z veřejných formulářů jako URL stránky zobrazené po úspěšném vložení záznamu
* tmplid – parametrem lze vynutit pro stránku jinou předlohu, hodnotou je ID této předlohy
* lid, locale, dlid, dlocale – využívají všechny moduly jako identifikátory pro jazyky
* ccid, ccvalue - parametry pro práci s kontrolními kódy [[../Ochrana proti spamu|antispamové ochrany]]

== Rozhraní pro napojení jiných aplikací ==
Modul obsahuje rozhraní pro napojení jiných aplikací, které umožňuje těmto aplikacím aktualizaci obsahu jednotlivých katalogů, tj. vkládání, aktualizaci a mazání záznamů v datových tabulkách katalogů.

=== Princip řešení ===

Na serveru je umístěn skript ''/gate/catupdate/default.php''. Adresář ''gate'' je virtuální adresář www serveru fyzicky umístěný na stejné úrovni jako např. adresář wwwroot. Z bezpečnostních důvodů je velmi vhodné přístup na tento virtuální adresář omezit pouze na IP adresu serveru, na kterém běží aplikace, která má měnit data modulu.

Tento skript přijímá přes protokol http POST příkazy ve formátu XML, provádí je a zpět zasílá (opět v XML) potvrzení. Příkazem může být buď pokyn ke smazání jedné položky daného katalogu nebo pokyn k vložení nebo aktualizaci záznamu jednoho katalogu.

Vkládání / aktualizace se synchronizuje na úrovni ID záznamů, externí aplikace tedy musí znát a používat identifikátory používané v dané datové tabulce. Při mazání se načítá jen ID záznamu, který se má mazat, při vkládání nebo aktualizaci celý záznam, tj. jeden řádek tabulky.

Skript zachycuje všechny potencionální chybové stavy a podává o nich hlášení prostřednictvím vraceného XML kódu – jedná se například o žádost o smazání neexistujícího záznamu, chybu při zápisu do databáze apod. Všechny události se protokolují do speciálního logu, kde se dá kontrolovat, zda komunikace probíhá v pořádku.

=== XML formáty přenosů ===

Každá žádost o aktualizaci obsahuje název datové tabulky, se kterou se manipuluje. Následuje příkaz (smazat / přidat nebo aktualizovat). Pak následují vlastní data – buď je uveden pouze unikátní identifikátor (v případě mazání) nebo celý řádek tabulky (v případě vložení či aktualizace).

Kořenový element žádosti o aktualizaci je vždy ''<nowiki><catupdaterequest''>,'' následuje kód ''<dbtable name="název_tabulky" idcolumn="název_sloupec_pro_jednoznačnou_identifikaci''"/>,'' který specifikuje, která datová tabulka se má aktualizovat a jaký sloupec se používá pro vyhledávání záznamů (jednoznačnou identifikaci). Dále je povinné uvést element ''<command''></nowiki>,'' který má v atributu ''type'' uveden typ operace, možné hodnoty jsou ''delete'' / ''update''.

==== Smazání záznamu ====

Následující XML kód slouží jako příkaz ke smazání jednoho záznamu s daným ID. ''per_id'' je název sloupce datové tabulky použitého v katalogu jako sloupec pro identifikaci záznamů.
<code>
<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki>
<nowiki><catupdaterequest></nowiki>
<nowiki><dbtable name="KATDTBL" idcolumn="per_id"/></nowiki>
<nowiki><command type="delete"></nowiki>
<nowiki><per_id>2506</per_id></nowiki>
<nowiki></command></nowiki>
<nowiki></catupdaterequest></nowiki>
</code>

==== Potvrzení smazání ====

Následující kód dostává zpět externí aplikace jako odpověď na příkaz smazání položky.
<code>
<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki>
<nowiki><catupdateresponse></nowiki>
<nowiki><status>error</status></nowiki>
<nowiki><description>Záznam s ID=2506 v tabulce KATDTBL se nepodařilo smazat.</description></nowiki>
<nowiki></catupdateresponse></nowiki>
</code>
Element ''status'' může nabývat hodnot ''ok / error'', v případě chyby obsahuje element ''description'' textový popis chyby.

==== Vložení nebo aktualizace záznamu ====

Následující kód reprezentuje příkaz na vložení nebo aktualizaci jednoho záznamu.
<code>
<nowiki><?xml version="1.0" encoding="UTF-8"?></nowiki>
<nowiki><catupdaterequest></nowiki>
<nowiki><dbtable name=" KATDTBL" idcolumn="per_id"/></nowiki>
<nowiki><command type="update"></nowiki>
<nowiki><per_id>2507</per_id></nowiki>
<nowiki><vydavatel>Vydavatel s.r.o.</vydavatel></nowiki>
<nowiki><okres>Praha</okres></nowiki>
<nowiki><nazev>Křížovky a rébusy</nazev></nowiki>
<nowiki><zamereni>Časopisy pro luštitele</zamereni></nowiki>
<nowiki><regionalni>Ne</regionalni></nowiki>
<nowiki><per>6</per></nowiki>
<nowiki></command></nowiki>
<nowiki></catupdaterequest></nowiki>
</code>
Nejprve je uvedena informace o tom, které tabulky se příkaz týká, atribut ''idcolumn'' zde musí obsahovat jako hodnotu název sloupce datové tabulky, který se používá pro identifikaci záznamů a pomocí kterého se provádí příkazy pro aktualizaci či mazání těchto záznamů. Pak je uveden vlastní příkaz a seznam hodnot jednotlivých polí. Tento seznam není pevně dán, ale liší se dle struktury katalogu, jména elementů odpovídají názvům sloupců datové tabulky modulu Formuláře a katalogy.

WebToDate/Referenční/Konfigurace WebToDate

2009-12-01T12:06:13Z

Tomasn: /* Filtrace HTML kódu ve zprávách */

[[Category:WebToDate Referenční]]
[[Category:Referenční]]
[[Category:WYSIWYG editor]]
== Globální konfigurace WebToDate ==
V konfiguračním souboru ''global.php'' je k dispozici celá řada parametrů, kterými lze ovlivnit chování jednotlivých částí WebToDate. Nejvýznamnější z parametrů již byly zmíněny v jednotlivých kapitolách této příručky, kompletní seznam je pak uveden v tabulce níže. Možné hodnoty parametrů i příklady nastavení jsou rovněž popsány v komentovaném souboru ''global.php''.

{| class="prettytable"
| '''Název konstanty'''
| '''Význam konstanty'''

|-
| colspan="2" | '''Interní cesty k adresářům, souborům a URL'''

|-
| WTDPATH
| Fyzická cesta k instalaci WebToDate. Uvádí se včetně posledního lomítka.

|-
| WTDPATHSCRIPTS
| Fyzická cesta k adresáři se skripty. Podle konstanty WTDPATH se vyhledávají cesty k adresářům WWWROOT a OFFLINEDATA, cesty k ostatním adresářům se hledají podle WTDPATHSCRIPTS. To umožňuje oddělit umístění datových adresářů WWWROOT a OFFLINEDATA od ostatních (DETAILPATH apod.) a umístit je z bezpečnostních či výkonnostních důvodů na jiné místo v diskové struktuře či na jiný disk. Výchozí hodnota WTDPATHSCRIPTS je nicméně nastavena na WTDPATH, takže pokud se např. adresář ''scripts'' má nacházet na stejné úrovni adresářové struktury jako ''wwwroot'' (což je výchozí umístění), není třeba nic nastavovat.

|-
| WWWROOT
| Název kořenového adresáře, výchozí hodnota ''wwwroot''

|-
| WWWIMAGES
| Název kořenového adresáře pro obrázky (funkce [[../Obrázky|Obrázky]]), výchozí hodnota ''images''

|-
| FILES
| Název adresáře s přílohami. Používá se pouze z důvodů zpětné kompatibility s předchozími verzemi, výchozí hodnota ''files''

|-
| JOBPATH
| Název adresáře s úlohami Plánovače úloh (v XML formátu), výchozí hodnota ''scheduler''

|-
| ADMINPATH
| Název virtuálního adresáře s administračními skripty. Pokud chcete z bezpečnostních důvodů změnit virtuální název adresáře (aby přístup nebyl na adrese ''název_serveru/admin''/),'' změňte tuto konstantu a virtuální název adresáře v konfiguraci www serveru; výchozí hodnota ''admin''

|-
| PHYSADMINPATH
| Fyzický název adresáře s administračními skripty, výchozí hodnota ''application''

|-
| PUBLICSERVERPREFIX
| Protokol, URL a port veřejných skriptů. Je třeba zadat např. v případě, kdy provozujete přístup k administračnímu rozhraní pod protokolem https

|-
| DETAILPATH
| Název složky s veřejnými skripty, výchozí hodnota ''scripts''

|-
| RDATA
| Absolutní cesta k adresáři RDATA, výchozí hodnota WTDPATHSCRIPTS + 'rdata/'

|-
| RESOURCES
| Absolutní cesta k hlavnímu adresáři se zdroji (lokalizačními zprávami apod.), výchozí hodnota WTDPATHSCRIPTS + 'rdata/resources/'

|-
| LOC_WTD
| Cesta k lokalizačnímu souboru WebToDate.

|-
| LOC_MODULES
| Cesta k lokalizačnímu souboru modulů.

|-
| WTDMENUFILE
| Cesta k XML souboru administračního menu WebToDate.

|-
| OFFLINEDATA
| Název adresáře, kam mohou být ukládána data nepřístupná přímo přes virtuální adresáře www serveru, výchozí hodnota ''offlinedata''

|-
| LOGS
| Název adresáře s protokoly, cesta je relativní vůči adresáři OFFLINEDATA, výchozí hodnota logs

|-
| TEMPDIR
| Složka dočasných souborů, uvádí se plná cesta ke složce

|-
| colspan="2" | '''Kódování'''

|-
| CHARSET
| Znaková sada, ve které je server provozován, např. ''iso-8859-2''

|-
| DB_LANGUAGE
| Nastavení znakové sady databáze.

|-
| DB_INIT_COMMANDS
| Pouze pro databázi MySQL. Příkazy vložené do tohoto řetězce se posílají do databáze při každém připojení skriptů k databázi. Je možné využít např. pro nastavení kódování češtiny, pak je vhodné zadat následující hodnotu (pro kódování ISO Latin 2):
"SET NAMES latin2; SET CHARACTER SET latin2; SET COLLATION_CONNECTION='latin2_general_ci';"

|-
| colspan="2" | '''Připojení k databází'''

|-
| DB_SERVER
| Typ databáze ('mysql' nebo 'mssql')

|-
| DB_HOST
| Název nebo IP adresa databázového serveru.

|-
| DB_NAME
| Název databáze pro datové tabulky WebToDate

|-
| DB_USER
| Jméno uživatele databáze

|-
| DB_PASS
| Heslo uživatele databáze

|-
| colspan="2" | '''Vytváření URL stránek'''

|-
| DETAILURL
| Vzor URL pro zobrazování zpráv. Je třeba změnit, pokud používáte možnost změny URL zpráv pomocí ''mod_rewrite'' či podobné techniky. Výchozí hodnota ''/scripts/detail.php?id=<nowiki></nowiki>''

|-
| NEWSABBREV_AUTOFILL
| Definuje, co se vkládá jako hodnota pro pole Zkratka v případě, že je předchozí konstanta nastavena na ''true''. Typická hodnota je '<nowiki>', neboli vkládá se ID zprávy, nebo '</nowiki>', neboli vkládá se konvertovaný nadpis zprávy.

|-
| URL_CONVERT_FIND a URL_CONVERT_REPLACE
| Tyto dvě konstanty definují mapování jednotlivých znaků (tj. obě musí obsahovat stejný počet znaků) při případné konverzi nadpisu zprávy do URL zprávy.

|-
| URL_CONVERT_NOCHAR
| Konstanta definuje, které znaky se při případné konverzi nadpisu zprávy do URL bez náhrady odstraňují.

|-
| URL_CONVERT_CASE
| Konstanta definuje, zda se při generování URL zprávy či zdroje spouští převod na malá nebo velká písmena. Možné hodnoty jsou LOWER (malá písmena) UPPER (velká písmena) nebo prázdná hodnota (nekonvertovat).

|-
| $url_convert_entities_map, URL_CONVERT_OTHER_ENTITIES a URL_CONVERT_ENTITIES_CHAR
| V poli ''$url_convert_entities_map'' se mapují číselné entity na znaky, toto mapování se použije při generování URL zpráv (tedy typicky při převodu nadpisu do URL). Numerické entity, které nejsou v poli, se převedou na znak definovaný v URL_CONVERT_ENTITIES_CHAR (může být i prázdný znak), ale jen v případě, že je nastaveno URL_CONVERT_OTHER_ENTITIES = true.

|-
| NEWSURL_MAXLENGTH
| Definuje maximální délku obsahu pole Odkaz nadpisu. Pokud je sestavený řetězec delší, ořízne se zprava na tuto hodnotu.

|-
| NEWSURL_CONVERT_MAXLENGTH
| Definuje maximální délku té části URL, která vzniká konverzí nadpisu pomocí <nowiki></nowiki>. Pokud je tedy výsledek konverze nadpisu delší než zadaná konstanta, ořízne se zprava.

|-
| NEWSABBREV_MAXLENGTH
| Definuje maximální celkovou délku zkratky, význam je stejný jako u NEWSURL_MAXLENGTH, pouze se aplikuje na obsah pole Zkratka.

|-
| NEWSABBREV_CONVERT_MAXLENGTH
| Význam konstanty je stejný jako NEWSURL_CONVERT_MAXLENGTH, pouze se aplikuje na obsah pole Zkratka.

|-
| NEWSABBREV_UNIQUE_DELIMITER
| V případě vygenerování zkratky, která již existuje, se na konec přidává oddělovač a číslo, konstanta definuje tento oddělovač, výchozí hodnota je '_'.

|-
| NEWSURL_AUTOUPDATE
| Konstanta NEWSURL_AUTOUPDATE definuje režim automatických změn obsahu polí Odkaz nadpisu a Zkratka. Možné hodnoty jsou:
*0 - zkratka se automaticky nevyplňuje, URL se přidělí podle konstanty DETAILURL při prvním uložení zprávy a už se nikdy automaticky nemění
*1 - zkratka se automaticky vyplňuje pokud je konstanta NEWSABBREV_AUTOFILL neprázdná. Jak zkratka tak URL se vyplní při prvním uložení zprávy a už se automaticky nemění
*2 - zkratka a URL se může automaticky změnit při uložení, pokud se změnily údaje, podle kterých se tvoří (seznam údajů je daný konstantami NEWSABBREV_AUTOFILL resp. DETAILURL) a pokud zpráva není ve stavu ''Publikováno'' či ''Archivováno''.
*3 - stejné jako předchozí případ, ale změna zkratky i URL je povolena i v případě, že zpráva je ve stavu ''Publikováno'' či ''Archivováno''.

|-
| NEWSABBREV_LOCK
| Hodnota ''false'' znamená, že pole Zkratka ve zprávách je možné běžným způsobem editovat. Hodnota ''true'' znamená, že uživatelé s výjimkou členů týmu ''Administrátoři'' nemají možnost hodnotu tohoto pole měnit.

|-
| ABBREV_AUTOFILL_ON_PUBLISH
| Hodnota ''true'' znamená, že je požadováno zachování URL mezi různými verzemi zpráv (tj. při publikaci nové verze se přebírá zkratka a URL předchozí publikované verze), hodnota ''false'' znamená, že URL různých verzí zprávy spolu nesouvisejí a chovají se z tohoto hlediska jako samostatné zprávy.Po instalaci je výchozí hodnota ''false''.

|-
| URL_PARAMETERS_DELIMITER
| Oddělovač parametrů v sestavovaných dynamických URL - výchozí hodnota je '&', můžete ale změnit na '&'

|-
| colspan="2" | '''Formátování ve stránkách'''

|-
| DYNAMIC_LINE_BREAK_BEGIN
| Počáteční značka používaná při automatickém řádkování těla zpráv.

|-
| DYNAMIC_LINE_BREAK_END
| Koncová značka používaná při automatickém řádkování těla zpráv.

|-
| ADMIN_DATE_FORMAT_STRING
| Formát data pro administrační část. Pro formát se používá (stejně jako pro dalších pět níže uvedených konstant) syntaxe PHP funkcí pro formátování data a času. Výchozí hodnota ''j.n.Y''

|-
| PUBLIC_DATE_FORMAT_STRING
| Formát data pro veřejnou část

|-
| ADMIN_TIME_FORMAT_STRING
| Formát času pro administrační část

|-
| PUBLIC_TIME_FORMAT_STRING
| Formát času pro veřejnou část

|-
| ADMIN_DATE_TIME_FORMAT_STRING
| Formát data a času pro administrační část

|-
| PUBLIC_DATE_TIME_FORMAT_STRING
| Formát data a času pro veřejnou část

|-
| colspan="2" | '''Zapínání a vypínání funkcí v administrační části'''

|-
| BANNER
| Aktivace systému správy reklamy.

|-
| REDUCE_MENU
| Redukce menu pro redaktory - je-li nastaveno na hodnotu ''true'' (výchozí hodnota), uživatelé v roli redaktor dostávají hlavní nabídku WebToDate redukovanou jen na položky pro ně potřebné.

|-
| RECIPIDS
| Reciprocita souvisejících ID u zpráv (souvisí-li zpráva A se zprávou B, uloží se i opačná informace, že B souvisí s A), výchozí hodnota ''true''

|-
| AUTHOR_FILL_FIELD
| Vyplňování pole Autor jménem přihlášeného uživatele. Hodnota ''true'' znamená, že pro zprávy se do pole ''Autor'' automaticky vyplní jméno přihlášeného uživatele.

|-
| AUTHOR_CHECK_ACCESS_FIELD
| Zakázání úpravy pole Autor uživatelem v roli redaktor

|-
| ENABLE_KW_ADDING_FROM_USER
| Povolení přidávání klíčových slov uživatelem. Pokud je nastaveno na false, klíčová slova do slovníku klíčových slov pro databázi zpráv a zdrojů může přidávat pouze administrátor

|-
| ENABLE_KW_ADDING_FROM_XML_IMPORT
| Povolení přidávání klíčových slov XML importem.

|-
| NEWSLOCK
| Zapínání / vypínání systému uzamykání zpráv. Pokud je nastaveno na hodnotu ''true'', systém uzamykání zpráv je aktivní.

|-
| colspan="2" | '''Atributy zakládaných souborů'''

|-
| PUBLIC_FILES_ATTRIBUTES
| atributy nastavované pro přímo veřejně přístupné soubory ( z hlediska systému Linux, tedy např. 644)

|-
| PUBLIC_DIRECTORIES_ATTRIBUTES
| atributy nastavované pro přímo veřejně přístupné adresáře

|-
| PRIVATE_FILES_ATTRIBUTES
| atributy nastavované pro interní soubory vytvářené WebToDate

|-
| PRIVATE_DIRECTORIES_ATTRIBUTES
| atributy nastavované pro interní adresáře vytvářené WebToDate

|-
| colspan="2" | '''Import dokumentů MS Word'''

|-
| WVWARE_EXE
| Cesta ke složce s "EXE" souborem programu wvWare (import dokumentů MS Word).

|-
| WVWARE_XML_DIR
| Cesta ke složce s XML předlohami programu wvWare.

|-
| WVWARE_ENCODING
| Znaková sad používaná při konverzi wvWare.

|-
| colspan="2" | '''Galerie formátů'''

|-
| GALLERY_CACHE
| Definuje název adresáře cache pro galerii formátů

|-
| GALLERY_CACHE_REFRESH_INTERVAL
| Definuje interval (v minutách) expirace položek cache pro galerii formátů

|-
| GALLERY_SERVER
| Definuje URL serveru pro obsah galerie formátů

|-
| GALLERY_URL
| Definuje URL výchozího XML souboru pro obsah galerie formátů

|-
| colspan="2" | '''Funkce stromu kategorií'''

|-
| NEW_CATEGORY_REGIME
| Výchozí režim zakládání výchozích stránek kategorií, Možné hodnoty jsou:
:0 – vynucený pokročilý režim, tj. z hlediska aplikace stejné jako 1, ale radiopřepínače pro volbu režimu se ve formuláři pro zakládání nové kategorie vůbec nezobrazuje
:1 – pokročilý režim
:2 – zjednodušený režim – výchozí jazyk
:3 – zjednodušený režim – všechny jazyky

|-
| NEW_CATEGORY_PAGE_NAME
| Výchozí název souboru s výchozí stránkou. V konstantě lze použít rovněž klíčové slovo <nowiki></nowiki> (zkratka jazyka)

|-
| NEW_CATEGORY_PAGE_PATH
| Předpisu výchozího tvaru cesty ke stránce. Lze zde použít klíčová slova <nowiki> (cesta daná vnořením složek dle stromu kategorií) a </nowiki> (zkratka jazyka)

|-
| NEW_CATEGORY_PAGE_PROTOTYPE
| Volba vzorové stránky při automatickém zakládání nové stránky. Možné hodnoty 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.

|-
| NEW_CATEGORY_PAGE_FRAGMENTS
| Volba určuje, zda na automaticky zakládané stránky vkládat fragmenty dle vzorové stránky. Možné hodnoty jsou 0 (ne) a 1 (ano)

|-
| NEW_CATEGORY_PAGE_LISTS
| Volba určuje, zda na automaticky zakládané stránky vkládat seznamy dle vzorové stránky. Možné hodnoty jsou 0 (ne) a 1 (ano, ale jen ty, které jsou parametrizované podle kategorie, ve které se stránka nachází), 2 (ano)

|-
| NEW_CATEGORY_PAGE_NAVIGATIONS
| Volba určuje, zda na automaticky zakládané stránky vkládat navigace dle vzorové stránky. Možné hodnoty jsou 0 (ne) a 1 (ano)

|-
| USE_CATEGORY_PATTERNS
| Určuje, kde se hledají výchozí předlohy pro zprávy. Možné hodnoty jsou
''true'' – předloha zprávy se hledá nejprve ve výchozí kategorii, pokud není nalezena tak v publikaci
''false'' – předloha zprávy se hledá nejprve v publikaci, pokud není nalezena tak ve výchozí kategorii.

|-
| TREE_ACCESS_REGIME
| Přístupová práva pro vkládání zpráv a zdrojů do stromu kategorií. Možné hodnoty jsou:
: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

|-
| ALLOW_INSERT_CATEG
| Pokud je nastaveno na hodnotu ''true'', mají uživatelé v roli editor právo zakládat podkategorie kategorií, které vlastní tým, v němž figurují v roli editora. Pokud je nastaveno na ''false'', mají možnost zakládat nové kategorie ve stromu kategorií pouze členové týmu ''Administrátoři''.

|-
| PRIVATEPAGES
| Název adresáře pro ukládání stránek v privátní zóně

|-
| PRIVATEPAGES_REGIME
| Definuje možnosti ohledně ukládání stránek v privátní zóně. Možné hodnoty jsou:
:1 – nové stránky se ukládají do veřejné zóny a uživatelsky toto nelze změnit
:2 – uživatel může vybrat způsob uložení, výchozí volba je veřejná zóna
:3 – nové stránky se ukládají do privátní zóny a nelze toto uživatelsky změnit
:4 - uživatel může vybrat způsob uložení, výchozí volba je privátní zóna

|-
| colspan="2" | '''Funkce databáze zdrojů'''

|-
| ASSETS_CREATE_THUMBNAILS
| Definuje, zda se spouští funkce na vytváření náhledů. Hodnota ''true'' znamená, že se aplikace pokouší vytvářet náhledy pro typ souborů obrázek

|-
| ASSETS_THUMBS_WIDTH
| Maximální šířka náhledu

|-
| ASSETS_THUMBS_HEIGHT
| Maximální výška náhledu

|-
| ASSETS_CONVERSION_APP_PATH
| Cesta k instalaci aplikace '''ImageMagick'''

|-
| ASSETS_PREFFERED_IMAGE_DIM
| Předdefinované rozměry obrázků nabízené ve funkci pro vytváření nových variant obrázků, např. '160x120;200x140;80x60'

|-
| ASSETS_UNSHARP_RADIUS
| Výchozí poloměr pro funkci Doostřit, výchozí hodnota 1.5

|-
| ASSETS_UNSHARP_SIGMA
| Výchozí sigma pro funkci Doostřit, výchozí hodnota 1.2

|-
| ASSETS_UNSHARP_AMOUNT
| Výchozí míra (v procentech) pro funkci Doostřit, výchozí hodnota 100

|-
| ASSETS_UNSHARP_THRESHOLD
| Výchozí práh (v procentech) pro funkci Doostřit, výchozí hodnota 5

|-
| ASSETS_WATERMARK_FILES
| Seznam souborů pro vodoznaky, např. '/images/watermark/w1.gif (malé logo); /images/watermark/w2.jpg (velké logo)' - nejprve se uvede URL, v závorce název prezentovaný uživatelům, oddělovačem položek je středník.

|-
| ASSETS_WATERMARK_GRAVITY
| Výchozí umístění vodoznaku (pořadové číslo z nabídky umístění) pro funkci Vodoznak, výchozí hodnota 9

|-
| ASSETS_WATERMARK_BRIGHTNESS
| Výchozí jas (v procentech) pro funkci Vodoznak, výchozí hodnota 30

|-
| ASSETS_PRIVATEFILES
| Název adresáře pro umístění souborů do privátní zóny

|-
| ASSETS_PUBLICFILES
| Název adresáře pro umístění souborů do veřejné zóny

|-
| ASSETS_STORE_TO_DATABASE
| Pokud je nastaveno na ''true'', ukládají se soubory do databáze, jinak do souborového systému

|-
| ASSETS_NEW_FILE_PATH
| Výchozího tvar cesty k souboru. V definici lze použít konstanty <nowiki> (adresáře dané kategoriemi),  (zkratka jazyka) a  (dělení adresářů na roky a měsíce). Nastavení konstanty na hodnotu
</nowiki>
tedy vygeneruje cestu ve tvaru
''/cz/dokumenty/marketing/letaky/2004/12/''

|-
| ASSETS_SET_SIMPLE_FILENAMES
| Možnost přidělování jednoduchých názvů souborů. Pokud je nastavena na hodnotu ''true'', ponechávají se souborům tzv. dočasná jména přidělená PHP uploadem (tedy např. ''phpnB55YV.jpg'').

|-
| ASSETS_FILENAME_CONVERT_CASE
| Definuje, zda při přejmenování souborů při vkládání do zdroje dochází ke konverzi názvu souboru na malá resp. velká písmena. Možné hodnoty jsou LOWER (malá písmena) UPPER (velká písmena) nebo prázdná hodnota (nekonvertovat).

|-
| ASSETS_AUTOREPAIR_FILENAMES
| Definuje, zda se při zpracování mění názvy souborů tak, aby neobsahovaly nepřípustné znaky (diakritiku apod.). Pokud je hodnota konstanty jiná než prázdný řetězec, nahrazují se znaky nepovolené v URL zadanou hodnotou. Základní způsob konverze znaků je přitom dán konstantami URL_CONVERT_FIND, URL_CONVERT_REPLACE a URL_CONVERT_NOCHAR. Hodnota této konstanty se použije jen v případě, že je nalezen nežádoucí znak, který není uveden v konstantě URL_CONVERT_FIND ani v URL_CONVERT_NOCHAR.

|-
| ASSETS_AUTORENAME_FILENAMES
| Pokud je zde prázdný řetězec a ukládá se soubor do adresáře, kde existuje soubor se stejným názvem, nelze soubor vložit a uživateli se zobrazí chybová hláška. Pokud je zde neprázdný řetězec, vytváří se názvy připojením tohoto řetězce + čísla. To znamená, že k souboru ''obrazek.jpg'' vznikají další názvy ''obrazek_1.jpg'', ''obrazek_2.jpg'' atd. (nikoliv ''obrazek_1_1.jpg'').

|-
| ASSETS_PRIVATEFILES_REGIME
| Režim ukládání souborů do privátní zóny. Možné hodnoty jsou
:1 – nové soubory se ukládají do veřejné zóny a uživatelsky toto nelze změnit
:2 – uživatel může vybrat způsob uložení, výchozí volba je veřejná zóna
:3 – nové soubory se ukládají do privátní zóny a nelze toto uživatelsky změnit
:4 - uživatel může vybrat způsob uložení, výchozí volba je privátní zóna

|-
| ASSETS_ENFORCE_STATE_LOCATION
| Vynucovat fyzické umístění souborů podle stavu zdroje. Hodnota ''true'' znamená, že soubor bude fyzicky v privátní zóně do té doby, než bude zdroj ve stavu publikováno, i když je umístění zvoleno do veřejné zóny.

|-
| ASSETS_SIMPLE_ACCESS_RIGHTS
| Definuje, zda mohou zdroje publikovat i uživatelé v roli redaktor. Pokud je zde hodnota ''true'', znamená, že to redaktoři mohou pro zdroje nastavovat kterýkoliv stav (pokud zdroj patří jejich týmu) a výchozí stav pro nové zdroje se automaticky předvyplní na ''Publikováno''.

|-
| ASETS_USERS_FTP_ACCESS
| Definuje přístup k uživatelských schránkám přes protokol FTP, např. 'ftp://mujserver.cz/schranky/'. FTP adresa musí být taková, že směřuje na adresář ''offlinedata/assets/users''/.'' Aplikace pak doplní adresu tak, že ukazuje na adresář ''offlinedata/assets/users/id_uživatele/var''/.''
Výchozí hodnota je prázdná, pokud je zde prázdný řetězec, znamená to, že funkce není nakonfigurovaná a v administračním rozhraní WebToDate není přístupná.

|-
| ASETS_ALLOW_STATIC_IMAGES
| Pokud je následující konstanta nastavena na hodnotu ''true'', mají k funkci '''Obrázky''' přístup všichni uživatelé (podobně jako ve verzích WebToDate starších než 4.0), v opačném případě k ní mají přístup pouze administrátoři.

|-
| ASSETS_ALLOW_MULTIPLE_FILES
| Určuje, zda lze v databázi zdrojů do jednoho zdroje vkládat více než jeden soubor

|-
| ASSETS_JPEG_QUALITY
| Stupeň JPEG komprese pro náhledy obrázků vytvářené pro potřeby redakčního rozhraní. Pokud konstanta není definována, použije se stejný stupeň komprese jako u původního obrázku. Možné hodnoty jsou 1 – 100 (celé číslo), doporučená hodnota je cca 80.

|-
| ASSETS_FRIENDLY_URL
| Pokud je konstanta nastavena na hodnotu ''true'', generují se zkratky a URL pro zdroje stejně jako pro zprávy, v opačném případě se zkratky negenerují a URL zdrojů se vytvářejí v systémovém tvaru.

|-
| ASSETS_IPTC_CHARSET
| V této konstantě lze uvést znakovou sadu, která se použije při načítaní IPTC metadat obrázků. Výchozí hodnota je stejné kódování, v jakém je provozována daná webová prezentace, čili dle konfigurační konstanty CHARSET, jinak se uvede např. 'windows-1250' apod.

|-
| VIDEO_CONVERSION_APP_PATH
| Plná cesta k adresáři s aplikací '''FFmpeg''' pro konverzi videa

|-
| VIDEO_THUMBS_DELAY
| Z jakého snímku v rámci videosouboru od začátku videosekvence se dělají náhledy, údaj je v sekundách, čili 5 znamená snímek ze začátku páté sekundy, 0 znamená první snímek videosekvence apod.

|-
| colspan="2" | '''Chybové výpisy, bezpečnost a interní kontroly a instalace'''

|-
| SESSION_EXPIRE
| Časový údaj v minutách, udává po jakém čase se ukončí platnost přihlášení k redakčnímu rozhraní WebToDate v případě neaktivity uživatele

|-
| USEMD5PASSWORDS
| Používání hesel ve formátu MD5.

|-
| MIN_LOGIN_LENGTH
| Minimální délka přihlašovacího jména a hesla.

|-
| MAX_LOGIN_ATTEMPTS
| Maximální počet neúspěšných přihlášení.

|-
| CHECK_LOGIN_INTERVAL
| Interval pro kontrolu neúspěšných přihlášení do systému (v sekundách)

|-
| BLACKLIST_EXPIRATION
| Interval vypršení zakázaných IP adres (v sekundách)

|-
| INTEGAUTHENT
| Způsob autentifikace. Je-li nastaveno na ''false'', používá se interní autentifikace přes formulář, je-li nastaveno na ''true'', používají se [[../Bezpečnost#Zásuvné moduly pro autentizaci |autentizační moduly]].

|-
| AUTH_MODULE
| Obsahuje cestu k zásuvnému modulu pro autentizaci, má smysl je pokud je INTEGAUTHENT = true

|-
| AUTH_AUTO_ADD_NEW_USER
| Definuje, zda je povoleno automatické přidání úspěšně autentizovaného uživatele do seznamu uživatelů WebToDate (hodnota ''true''), má smysl je pokud je INTEGAUTHENT = true

|-
| AUTH_AUTO_ADD_SEND_MAIL
| Definuje odesílání e-mailů s informací o automatickém založení nového uživatele (hodnota ''true''), má smysl je pokud je INTEGAUTHENT = true

|-
| DEBUG
| Způsob výpisu databázových chyb. Možné hodnoty 0 (úplné potlačení chybových hlášení aplikace) až 2 (podrobná chybová hlášení.) Hodnota pro instalace v ostrém provozu by měla být 0.

|-
| SQL_DEBUG_LIMIT
| Pokud není pomocí DEBUG potlačeno vypisování chybových hlášení a dojde při provozu k nějaké chybě SQL příkazu, vypisuje se chybové hlášení obsahující příslušné SQL dotazy. Touto konstantou je možné omezit délku tohoto chybového výpisu, hodnotou je počet znaků, které se mají zobrazit před SQL příkazem, který vyvolal chybu. Výchozí hodnota je 10000.

|-
| SHOW_DEVELOPERS_OPTIONS
| Pomocný parametr používaný pro ladění skriptů. Pro ostrou instalaci použijte hodnotu ''false''.

|-
| DB_CONSTRAINTS_FILE
| XML soubor pro databázovou kontrolu.

|-
| CHECK_WTD_VERSION
| Kontrola konzistence databáze.

|-
| CHECK_FILEACCESS_GLOBAL
| Zapnutí kontroly neautorizovaných přístupů.

|-
| CHECK_FILEACCESS_STRUCTURE
| Kontrola přístupových práv souborové struktury. Možné hodnoty:
:0 - nekontrolovat
:1 – kontrolovat pouze, zda jsou přístupová práva postačující (výchozí hodnota)
:2 - kontrolovat pouze, zda jsou přístupová práva postačující a nejsou v některých adresářích nadbytečná (např. zda není povolen zápis do adresáře, kde to není vyžadováno).

|-
| ALLOW_PUBLIC_FRAGMENTS
| Pokud je tato konstanta nastavena na hodnotu ''true'', lze zobrazovat fragmenty přes prezentační skript ''/scripts/detail.php?id=xxx''. Je-li tato možnost zapnuta, může dojít k nežádoucímu úniku zdrojových kódů případných skriptů generovaných z WebToDate, proto se toto nedoporučuje povolovat. Při nastavení ''false'' (výchozí hodnota) je pokus o zobrazení takového URL přesměrován na stránku danou konfigurační konstantou ''c_error_page_news_nonexistent''.

|-
| colspan="2" | '''Cache pro zprávy'''

|-
| CACHE_REGIME
| Režim nastavení cache.

|-
| CACHE_REFRESH_INTERVAL
| Interval automatického vypršení cache.

|-
| ALLWAYS_USE_CONNECTION
| Vynucené připojování k databázi v případě použití cache pro zprávy

|-
| PATH_TO_CACHE
| Fyzická cesta ke složce souborů cache.

|-
| colspan="2" | '''Verze zpráv a časová platnost zpráv'''

|-
| ON_NEWS_EXPIRATION
| Udává stav, který se nastaví, pokud končí platnost zprávy (nastává datum ''Vyprší dne''). ''0'' = ''Platnost vypršela'', ''1'' = ''Archivováno''. Výchozí hodnota je 0.

|-
| ON_VERSION_PUBLISH
| Udává, co se má stát s předchozí verzí, která je ve stavu ''Publikováno'' nebo ''Archivováno'' ve chvíli, kdy se zpráva publikuje. 0 = předchozí verzi nastavit ''Platnost vypršela'', 1 = předchozí verzi nastavit ''Archivováno''. Výchozí hodnota je 0.

|-
| ALLWAYS_ALLOW_PUBLISH
| Udává, zda umožnit uživatelům publikovat i zprávy, jejichž interval platnosti se neslučuje a aktuálním časem; ''true'' = umožnit. Výchozí hodnota je ''true''.

|-
| colspan="2" | '''Různé'''

|-
| LONG_TASK_TIMEOUT
| Časový interval v sekundách pro nastavení vypršení platnosti spuštění úloh či funkcí, u kterých se předpokládá delší čas běhu. Většina skriptů WebToDate používá ''timeout'' definovaný v konfiguračním souboru PHP, vybrané skripty se pak řídí touto konstantou. Jedná se zejména o:
*Spuštění plánované úlohy ručně z administračního rozhraní
*Generování stránek včetně podstromu
*Vytváření více zdrojů najednou podle obsahu schránky
*Importy a exporty ve vybraných modulech WebToDate (XML Export / import apod.)
Výchozí hodnota je 600 sekund.

|-
| PUBLIC_LONG_TASK_TIMEOUT
| Časový interval v sekundách pro nastavení vypršení platnosti skriptů v prezentační části webu, u kterých se předpokládá delší čas běhu. V současnosti se aplikuje pouze u skriptu ''/scripts/file.php'' pro načítání souborů ze zdrojů.
Výchozí hodnota je 600 sekund.

|-
| MIN_PRIORITY
| Minimální hodnota pole ''priorita''. Platí všude, kde se vyskytuje nějaká priorita (zprávy, kategorie apod.)

|-
| MAX_PRIORITY
| Maximální hodnota pole ''priorita''. Platí všude, kde se vyskytuje nějaká priorita (zprávy, kategorie apod.). Výchozí hodnota je 1000.

|-
| DEFAULT_PRIORITY
| Výchozí hodnota pole ''priorita''. Platí pouze pro řazení zpráv na stránky.Výchozí hodnota je 5.

|-
| VEDIT_DISABLED_AREAS
| V této konstantě lze definovat seznam oblastí, které nelze měnit pomocí vizuálního režimu pro úpravy obsahu stránky. Zadávají se názvy oblastí oddělené středníkem.

|-
| INPUT_FIELDS_ROWS
| Počet řádek ve formulářových polích, ve kterých se zadává obsah polí přizpůsobitelné struktury databáze zpráv. Výchozí hodnota je 3 řádky.

|-
| VARDOCXML
| Způsob interního uložení přizpůsobitelné struktury databáze zpráv. Je-li tato nastaveno na ''true'', pak pro obsah vstupních polí přizpůsobitelné struktury existuje jedno databázové pole typu TEXT neomezené délky, data se zde ukládají v XML struktuře. Pokud je nastaveno na ''false'', ukládají se pole rozšířené struktury do speciální databázové tabulky, co pole to jeden sloupec této tabulky.

|-
| CONST_IMPORT_KATALOGY_PATH
| Cesta ke složce Importu pro modul Formuláře a katalogy.

|-
| SCHED_SEQTIMEOUT
| Timeout pro sekvence Plánovače úloh.

|-
| SCHED_INTERTIMEOUT
| Interval pro sekvence Plánovače úloh.

|-
| MAX_SEQ_TASKS
| Maximální přípustný počet úloh v jedné sekvenci Plánovače. Výchozí hodnota je 10.

|-
| MAX_TASK_PARS
| Maximální přípustný počet parametrů úloh v Plánovači. Výchozí hodnota je 30.

|-
| MAX_SEQ_SCHEDS
| Maximální počet různých časování pro jednu sekvenci, které lze v Plánovači úloh nastavit. Výchozí hodnota je 5.

|-
| XML_PARSER_TIME_LIMIT
| Timeout XML parseru.

|-
| XML_PARSER_CHUNK_SIZE
| Velikost bloku dat XML parseru.

|}

V konfiguračním souboru se dále nastavuje ''error_reporting''. Jedná se o funkci PHP specifikující úroveň výpisu chyb. Více o nastavení výpisů chyb v PHP naleznete v dokumentaci k PHP na [http://www.php.net/ www.php.net].

V konfiguračním souboru dále naleznete konstrukci ''$g_errorPages = array''(…);,'' ve které jsou uvedeny konstanty vyznačující definované chybové stavy při zobrazování dynamických stránek a URL stránek, na které je uživatel v případě takové chyby přesměrován. Např.

<code>
<nowiki>c_error_page_news_no_template => '/errmsg/errorNoTemplate.html'</nowiki>
</code>

znamená, že v případě, že se pokoušíme zobrazit zprávu (pomocí skriptu ''detail.php'') a pro zprávu nebyla nalezena předloha, je uživatel přesměrován na URL uvedené v pravé části konstrukce. URL těchto stránek můžete buď změnit, nebo na těchto URL vytvořit stránky s vlastními chybovými hlášeními.

== Další možnosti konfigurace ==
=== Konfigurace WYSIWYG editoru ===

WebToDate od verze 4.1 používá jako editor pro HTML kódy FCKeditor. Jednou z vlastností tohoto editoru je rozsáhlá možnost konfigurace a přizpůsobení funkčnosti.

Konfigurační soubory editoru, které lze měnit bez rizika přepsání v případě upgrade systému, se nalézají v adresáři ''application/fckeditor/webtodate/config''/.''

Možnosti konfigurace jsou zejména následující:

* Lze přizpůsobit nástrojové lišty, tj. zvolit, které funkce jsou uživatelům přístupny a které nikoliv
* Lze definovat náplň jednotlivých rozevíracích nabídek
* Lze definovat, která kontextová menu (zobrazovaná pravým tlačítkem myši v textu) lze používat
* Lze definovat, kolik kroků zpět je možné se v úpravách vrátit (funkce "undo" a "redo")

Nejdůležitější možnosti konfigurace jsou popsány v této kapitole, další naleznete na stránkách produktu FCKeditor ([http://www.fckeditor.net/ www.fckeditor.net ]resp. wiki.fckeditor.net).

V prvé řadě existují dva hlavní konfigurační soubory – jeden se použije pro uživatele, kteří jsou členy týmu Administrátoři, druhý pro ostatní uživatele. To umožňuje, aby např. administrátoři měli bohatší nabídku možností a funkcí, ostatní uživatelé pak pouze to, co mají skutečně používat. Tyto soubory jsou:

* ''application/fckeditor/webtodate/config/adminconfig.php'' – konfigurační soubor pro administrátory
* ''application/fckeditor/webtodate/config/userconfig.php'' – konfigurační soubor pro ostatní uživatele

Jedná se o PHP soubory, většina kódu je ale v jazyce javascript. PHP kódy neměňte, kódy javascript lze přizpůsobovat dle potřeby.

V prvé řadě je možné definovat, které pluginy editoru jsou přístupné:

<code>
<nowiki>FCKConfig.Plugins.Add( 'wtdkeyword', 'cs,en,it' ) ;</nowiki>
<nowiki>FCKConfig.Plugins.Add( 'wtdchapter', 'cs,en,it' ) ;</nowiki>
<nowiki>FCKConfig.Plugins.Add( 'wtdsource', 'cs,en,it' ) ;</nowiki>
</code>

První řádek se týká vkládání klíčových slov WebToDate, druhý řádek vkládání klíčových slov modulu '''Stránkování zpráv''', třetí řádek vkládání položek ze zdrojů. Pokud některý z těchto pluginů nepoužíváte, můžete řádek zakomentovat nebo odstranit.

Do editační oblasti editoru lze vložit odkaz na CSS soubor. Pokud tento CSS soubor bude obsahovat podobnou definici CSS tříd, jako se používá v prezentační části, bude vizuálně upravovaný obsah formátován velmi podobně, jako se pak zobrazuje v prezentační části. Toto se provádí příkazem

<code>
<nowiki>FCKConfig.EditorAreaCSS = 'URL_CSS_souboru' ;</nowiki>
</code>

Užitečná může být volba

<code>
<nowiki>FCKConfig.AdditionalNumericEntities = "'" ;</nowiki>
</code>

Jako hodnotu tohoto parametru lze uvést seznam znaků, které se mají převádět na číselné HTML entity. Je-li potřeba zadat více znaků, oddělují se znakem |, hodnotu lze zadat i jako regulární výraz.

Nastavení ''FillEmptyBlocks'' říká, zda do prázdných buněk HTML tabulky má editor automaticky vkládat entitu  , tedy např.

<code>
<nowiki>FCKConfig.FillEmptyBlocks = false ;</nowiki>
</code>

Dále je možné upravit obsah nástrojové lišty.

<code>
<nowiki>FCKConfig.ToolbarSets["Default"] = [</nowiki>
<nowiki> ['Source','-','Save','Preview','-','Templates'],…</nowiki>
</code>

V tomto příkazu můžete odstranit ty funkce, které nechcete používat.

Dále lze definovat, která kontextová menu jsou přístupná:

<code>
<nowiki>FCKConfig.ContextMenu = ['Generic','Link','Anchor','Image','Flash','Select',…</nowiki>
</code>

Nabídka barev pro formátování textu se definuje v příkazu

<code>
<nowiki>FCKConfig.FontColors = '000000,993300,333300,003300,003366,…</nowiki>
</code>

Nabídka řezů písma se definuje v příkazu

<code>
<nowiki>FCKConfig.FontNames = 'Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana' ;</nowiki>
</code>

Nabídka velikostí písma se definuje v příkazu

<code>
<nowiki>FCKConfig.FontSizes = 'smaller;larger;xx-small;x-small;small;medium;large;x-large;xx-large' ;</nowiki>
</code>

Nabídka formátů pro paragrafy se definuje v příkazu

<code>
<nowiki>FCKConfig.FontFormats = 'p;div;pre;address;h1;h2;h3;h4;h5;h6' ;</nowiki>
</code>

Jaké HTML značky konkrétně jsou vkládány pro základní formátování (tj. zda se ''tučně'' vkládá jako <nowiki><b> či <strong></nowiki> apod.) se definuje pomocí nastavení ''FCKConfig.CoreStyles''. V tomto nastavení nelze přidávat další značky a výrazy, pouze měnit existující seznam.

Pomocí ''FCKConfig.Keystrokes'' se definují klávesové zkratky. Prvních pět zkratek ve výchozí konfiguraci (např. ''[ CTRL + 65 /*A*/, true'' ])'' jsou klávesové zkratky prohlížeče a je doporučeno je neměnit, ostatní lze volně měnit. Např. výraz ''[ CTRL + 76 /*L*/, 'Link' ]'' znamená, že klávesa Ctrl + L zobrazí dialog pro vložení hypertextového odkazu.

Pokud při vkládání tabulek MS Excel ze schránky má dojít k označení buněk v prvním řádku a prvním sloupci tabulky jako <nowiki><th></nowiki>, je třeba ponechat nastavení

<code>
<nowiki>FCKConfig.MSWReplaceTDTH = true;</nowiki>
</code>

a

<code>
<nowiki>FCKConfig.CleanWordKeepsStructure = true;</nowiki>
</code>

Maximální počet kroků pro funkci ''Zpět'' se definuje v příkazu

<code>
<nowiki>FCKConfig.MaxUndoLevels = 15 ;</nowiki>
</code>

Dále lze zapnout nebo vypnout podporu přímého vkládání obrázků, odkazů či flash animací. Jedná se o následující příkazy:

<code>
<nowiki>FCKConfig.LinkBrowser = true ;</nowiki>
<nowiki>FCKConfig.ImageBrowser = true ;</nowiki>
<nowiki>FCKConfig.FlashBrowser = true ;</nowiki>
<nowiki>FCKConfig.LinkUpload = false ;</nowiki>
<nowiki>FCKConfig.ImageUpload = true ;</nowiki>
<nowiki>FCKConfig.FlashUpload = true ;</nowiki>
</code>

Editor podporuje nabídku ''Styl'', kterou lze rovněž naplnit podle potřeb dané implementace. Obsah této nabídky se definuje v XML souboru, který je umístěn na adrese ''application/fckeditor/webtodate/config/fckstyles.xml''.

Definovaný XML formát umožňuje v pravé řadě definice CSS tříd, které se při aplikaci daného stylu použijí (vygeneruje se HTML element ''<nowiki><span class="xxx''"></nowiki>),'' lze ale definovat i celé bloky kódů s využitím jiných elementů, např. XML kód

<code>
<nowiki> <Style name="Custom Ruler" element="hr"></nowiki>
<nowiki> <Attribute name="size" value="1" /></nowiki>
<nowiki> <Attribute name="color" value="#ff0000" /></nowiki>
<nowiki> </Style></nowiki>
</code>

se při aplikaci v editoru převede na HTML tag ''<nowiki><hr color="#ff0000" size="1"'' /></nowiki>.''

Styly v nabídce jsou zobrazovány tak, jak ve skutečnosti vypadají, jak je zřejmé z následujícího otisku obrazovky.

[[Image:referencniprirucka-konfiguracewebtodate-img174.png|center]]

Pokud chceme použít nějakou definici CSS třídy, je třeba postupovat následovně:

# Definici třídy zadat v konfiguračním XML souboru:
#: <code>
#: <nowiki> <Style name="Red on Black Global" element="span"></nowiki>
#: <nowiki><Attribute name="class" value="red" /></nowiki>
#: <nowiki></Style></nowiki>
#: </code>
# Definici třídy vytvořit v CSS souboru ''application/fckeditor/webtodate/config/css/custom.css'', který používá editor jako zdroj pro uživatelsky definované CSS třídy:
#:<code>
#: <nowiki>.red { color: #ff0000; background: black; }</nowiki>
#:</code>
# Stejnou definici třídy vložit do CSS souboru, který se je vkládán do stránek na veřejné části webové prezentace.

Tlačítkem '''Šablony''' lze vkládat šablony HTML kódů. Tyto šablony se definují v souboru ''application/fckeditor/webtodate/config/fcktemplates.xml''. Definice šablony se v tomto XML kódu skládá z názvu a popisu a pak vlastního HTML kódu (v sekci CDATA XML souboru), který se vkládá do editovaného textu. Lze tak např. připravit šablonu pro strukturovaný HTML kód těla zprávy typu popis produktu, životopis apod.

=== Filtrace HTML kódu ve zprávách ===

V definici profilu uživatele (viz kapitola [[../Uživatelé a přístupová práva#Používání editorů a kódu HTML|Používání editorů a kódu HTML]]) lze nastavit, že zprávy zadávané tímto uživatelem mají být filtrovány. To znamená, že při uložení dojde k automatickému odstranění nežádoucích HTML značek z textu zprávy.

Seznam těchto značek se definuje v souboru ''rdata/config/secureTags.txt''.

=== MIME typy stránek ===

Podporované typy značkovacích jazyků jsou v databázi v tabulce NEWSMIME. Její sloupce jsou:

* ID - interní číslování
* NAZEV - název značkovacího jazyka
* MIME - MIME typ
* ZKRATKA - typická koncovka pro tento typ stránek / souborů

Význam této tabulky je následující:

* Ve formuláři pro vlastnosti stránky se volí značkovací jazyk. Náplň této nabídky pochází z této tabulky.
* Pokud se stránka zobrazuje dynamicky, prezentační skript vkládá do http hlavičky odpovídající MIME typ podle značkovacího jazyka (podle značkovacího jazyka stránky v případě dynamicky zobrazovaných stránek, podle značkovacího jazyka předlohy v případě zpráv).
* Pokud se stránka generuje a zobrazuje staticky, nemá tato tabulka žádný vliv - MIM typ odesílaný serverem je dán v konfiguraci www serveru, který jej stanoví podle koncovky souboru.

=== Virtuální servery ===

Virtuální server se konfiguruje v tabulce NEWSSERVER. Tabulka obsahuje následující sloupce:

* ID - interní číslování
* URL - URL kořene virtuálního serveru
* CESTA - fyzická cesta ke kořenovému adresáři virtuálního serveru
* NAZEV - název virtuálního serveru jak se zobrazuje v administračním rozhraní
* CESTATXT - existuje z důvodů zpětné kompatibility, nepoužívá se

První virtuální server (označovaný pak v administračním rozhraní jako "aktuální") se zde nezadává, přidávají se až další virtuální servery.

=== Kalendářové tabulky ===

Při instalaci systému se instalují kalendářové tabulky se seznamem názvů měsíců a prvního dne v týdnu. V současnosti je používá pouze modul Kalendář akcí (pro zobrazování výběrů akcí podle měsíčního kalendáře), v budoucnu je ale mohou používat další funkce systému.

Tabulky jsou po instalaci naplněny pouze pro český jazyk. Pokud provozujete vícejazyčný web, může vzniknout potřeba doplnit další jazyky. Struktura tabulek je následující:

Tabulka CALMONTHS (měsíce v roce):

* MONTHID - pořadové číslo měsíce
* LANGUAGEID - interní číslo jazyka (naleznete v tabulce NEWSLANGUAGE)
* NAME - jméno měsíce
* ABBREV - zkratka měsíce

Tabulka CALWEEKDAY (první den v týdnu):

* LANGUAGEID - interní číslo jazyka (naleznete v tabulce NEWSLANGUAGE)
* FIRSTDAY - pořadové číslo prvního dne v týdnu (1 = pondělí atd.)

=== Převod dokumentů MS Word do HTML na straně serveru ===

Import dokumentů MS Word je realizován prostřednictvím programu wvWare, jehož chování určují následující konstanty v souboru global.php:

<code>
<nowiki>define ("WVWARE_EXE", "/usr/bin/wvWare") … cesta ke složce, kde je "exe" soubor" instalovaného programu wvWare.</nowiki>
<nowiki>define ("WVWARE_XML_DIR", "/usr/share/wv/") …cesta ke složce, kde jsou uloženy XML předlohy WvWare.</nowiki>
<nowiki>define ("WVWARE_ENCODING", "windows-1250") … znaková sada použitá při konverzi dokumentů.</nowiki>
</code>

Pokud nejsou tyto konstanty správně definovány, nemusí být tlačítko pro import dokumentů ve formulářích pro zprávy vůbec dostupné.

Výchozí nastavení pro konstantu WVWARE_XML_DIR je

<code>
<nowiki>define ("WVWARE_XML_DIR", RDATA."config/wvware/");</nowiki>
</code>

To znamená, že konstanta ukazuje na adresář rdata/config/wvware, kde se nacházejí konfigurační soubory upravené tak, aby výsledkem konverze byl HTML kód co nejvíce odpovídající standardům a co nejčistší. Soubory wvHtml.xml (definuje konverzi do HTML) a wvText.xml (definuje konverzi do čistého textu) je povoleno upravovat dle potřeby, při upgrade WebToDate se nepřepisují.

<div class="note">Aplikace pracuje se soubory wvHtml.xml a wvText.xml. Pokud jsou v tomto adresáři pouze soubory wvHtml.release.xml a wvText.release.xml, vytvořte jejich kopie a přejmenujte na názvy bez "release" řetězce.</div>

Původní soubory dodávané s aplikací wvWare naleznete v adresáři této aplikace, např. na serveru MS Windows se jedná ve výchozím umístění o adresář ''c:\Program Files\GnuWin32\share\wv''. Je možné rovněž přesměrovat konstantu WVWARE_XML_DIR na tento adresář a tím využívat originálně dodávané konfigurační soubory.

== Výpis konfigurace WebToDate ==
V základní nabídce '''Administrace''' – '''Konfigurace''' naleznete výpis aktuálně nastavených konfiguračních hodnot WebToDate. Tato funkce je přístupná pouze administrátorům.

[[Image:referencniprirucka-konfiguracewebtodate-img175.png|center]]

Naleznete zde zejména výpis konfigurace nastavovaný v konfiguračním souboru ''global.php'' a zobrazený srozumitelnější formou s vysvětlujícími popisky, ale i další informace o konfiguraci, která se provádí jiným způsobem (např. nastavení podpory virtuálních serverů).

Informace jsou rozděleny do několika logických celků (např. ''databáze zpráv'', ''bezpečnost'', ''zdroje'' apod.).

Je-li nakonfigurována [[../Správa více virtuálních serverů|podpora více virtuálních serverů]], zobrazuje se zde tabulka se seznamem těchto serverů (název a URL).

Diskuse:WebToDate/Referenční/Styly

2009-11-02T11:36:32Z

Tomasn: problém screenshotů

Obsahuje screenshoty ze starší verze!

Diskuse:WebToDate/Referenční/Stránky a předlohy

2009-10-22T20:41:10Z

Tomasn: Založena nová stránka: Na této stránce jsem našel: Vytvoření nové stránky # Titulek stránky nahradí při generování stránky klíčové slovo </tt>, obsažené…

Na této stránce jsem našel:
Vytvoření nové stránky
# Titulek stránky nahradí při generování stránky klíčové slovo </tt>, obsažené v šabloně. Nejběžnější způsob použití je pomocí syntaxe <tt><title></title>. Klíčové slovo pro titulek stránky se na rozdíl od jiných klíčových slov WebToDate nahrazuje obsahem pouze v případě, že příslušné databázové pole je neprázdné. Důvodem je zachovat toto klíčové slovo v rámci stromu stránek pro stránky, které toto klíčové slovo skutečně používají.
# Pole Zařazení zobrazuje umístění stránky ve stromu kategorií. Tlačítkem Změnit můžete vybrat jinou kategorii než tu, která byla nastavena.

Diskuse:WebToDate/Instalace Linux/Požadavky na systém

2009-10-16T08:32:26Z

Tomasn: podporované prohlížeče

== Prohlížeč pro administrační část ==
V této kapitole je zatím uvedeno "MS Internet Explorer 5.5 a vyšší, doporučená verze 7.0".
Doporučuji uvést pro IE minimální verzo 6.0 a dále pak již doplnit FireFox, ale tady nevím, od které verze.