WebToDate/Kalendář akcí/Reference
Administrační rozhraní
Nabídka modulu
Nabídka modulu vypadá následovně:
Nástroje
- Formuláře
- Detail akce
- Měsíční kalendář
Nastavení
- Seznam předpisů
- Globální
- Navigační lišta
- Předpisy
- název předpisu
- Seznam akcí
- Jedna akce
- Samostatný kalendář
Administrace
- Práva
- Kalendáře
- Stavy akcí
- Témata
Data
- Kategorie
- Kalendáře
- název kalendáře
K administrační části modulu mají přístup pouze administrátoři WebToDate. Výjimkou je sekce Data nabídky, kterou lze zpřístupnit i jiným týmům pomocí funkce Práva.
Nastavení
V této sekci nabídky se nastavuje grafický vzhled a chování všech veřejně přístupných stránek modulu.
Pro kalendáře se podobně jako pro některé další moduly používají tzv. předpisy. Předpis je sada grafických a případně i funkčních nastavení, který se může týkat více různých typů stránek najednou. V tomto modulu každý definovaný předpis reprezentuje jednu sadu grafických nastavení pro kalendář. V jednom předpisu lze nadefinovat zobrazování stránek typu seznam akcí – detailní informace o jedné akci. Všechny kalendáře pak mohou používat jeden předpis, nebo (pokud se zobrazují graficky odlišně) používat několik různých předpisů.
Předpis se zakládá pomocí funkce Seznam předpisů. Ve formuláři se vyplňuje pouze název, který lze volit dle potřeby. Existující předpis lze libovolně přejmenovávat, smazat jen v případě, že není někde (u nějakého kalendáře) použit.
V této části nabídky je jako první sekce Globální – tato sekce sdružuje nastavení, která jsou společná pro všechny kalendáře. V tomto modulu se jedná pouze o navigační lištu.
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.
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<!--WTD_NAVIG(URL)--> a <!--WTD_NAVIG(NUMBER)-->.
Jejich použití je zřejmé z následujícího jednoduchého příkladu:
[[Image:|center]]
Navigační lišta je pak v předloze reprezentována klíčovým slovem <!--WTD_DIARY(NAVIG)-->.
V druhé sekci části Nastavení nazvané Předpisy se nastavují jednotlivé předpisy. Pod každým názvem předpisu se zde zobrazují dvě položky reprezentující dva možné způsoby zobrazení dat daného kalendáře, třetí položka pak definuje případné zobrazení měsíčního kalendáře v jiných stránkách www prezentace než ve stránkách modulu:
- Seznam akcí – toto nastavení definuje zobrazení seznamů akcí v daném kalendáři
- Jedna akce – toto nastavení definuje zobrazení jedné vybrané položky kalendáře.
- Samostatný kalendář - nastavuje se pouze styl, kterým se může formátovat měsíční kalendář generovaný na jiné stránky www prezentace.
Nastavení pro Seznam akcí se definuje v podstatě vždy, nastavení Jedna akce je třeba nadefinovat, pokud má být součástí grafického designu a funkcionality skutečně dvouúrovňové zobrazení seznam – detail. V praxi toto nemusí být vždy požadováno, pokud jsou např. popisky akcí tvořeny jednou či dvěma větami, je možné tyto popisky zobrazovat přímo v seznamu a vytvářet speciální typ stránky pro zobrazení informací o jedné akci pak není nutné.
Pomocí nastavení Seznam akcí v předpisu se definuje vzhled stránky prezentující seznamy akcí.
[[Image:|center]]
Stránka se zobrazuje na veřejně přístupné části prezentace pomocí skriptu /scripts/modules/diary/default.php?calid=xxx a může obsahovat následující "aktivní" elementy (tj. prvky, do kterých se doplňují nějaká data dynamicky ve chvíli požadavku na zobrazení:
- Seznam akcí
- Seznam kategorií akcí
- Měsíční kalendář pro výběr nějakého data
- Vyhledávací formulář
- Stránkovací lištu
Ve formuláři Seznam akcí se definuje:
- Předloha – šablona pro zobrazení seznamu akcí
- Styl seznamu akcí – WebToDate styl, kterým se formátují seznamy akcí
- Styl seznamu kategorií - WebToDate styl, kterým se formátuje seznam kategorií
- Styl měsíčního kalendáře - WebToDate styl, kterým se formátuje měsíční kalendář.
Postup vytvoření prvních tří prvků je popsán v kapitole Vytvoření výpisu seznamu akcí, základní podoba stylu pro měsíční kalendář se nejjednodušeji získá tak, že se styl vygeneruje pomocí funkce Nástroje – Měsíční kalendář.
Pro toto zobrazení je třeba vždy definovat minimálně předlohu a seznam akcí, zobrazení ostatních výše uvedených elementů není povinné a nemusí být definováno ani používáno.
Pokud např. nechcete, aby se seznam kategorií v této stránce zobrazoval, stačí, aby odpovídající klíčové slovo <!--WTD_DIARY(LISTCATEGORIES)--> nebylo v HTML kódu předlohy uvedeno.
Druhým nastavením v předpisu je Jedna akce, tento formulář definuje podobu stránky zobrazující detailní zobrazení záznamu jedné akce z kalendáře. Taková stránka se na veřejně přístupné části prezentace zobrazuje pomocí URL /scripts/modules/diary/action.php?id=xxx, kde xxx je ID položky kalendáře. Tato stránka může zobrazovat následující prvky:
- Pole jednoho záznamu kalendáře akcí (název akce, popis atd.)
- Seznam kategorií aktuálního kalendáře
- Měsíční kalendář pro výběr nějakého data
- Seznam kategorií, ve kterých se akce nachází
- Seznam témat, ve kterých se akce nachází
[[Image:|center]]
Ve formuláři Jedna akce se definuje:
- Předloha – šablona pro zobrazení detailních informací o jedné akci
- Styl seznamu kategorií - WebToDate styl, kterým se formátuje seznam kategorií kalendáře
- Styl měsíčního kalendáře - WebToDate styl, kterým se formátuje měsíční kalendář.
- Styl seznamu kategorií, ve kterých se akce nachází - může vypsat seznam kategorií aktuálního kalendáře, do kterých je akce zařazena
- Styl seznamu témat, ve kterých se akce nachází - může vypsat seznam témat, do kterých je akce zařazena
Postup vytvoření definice této stránky je podobný jako pro seznam akcí popsaný v kapitole Začínáme. Pro vygenerování fragmentu, který obsahuje klíčová slova pro položky jedné akce, lze použít funkci Nástroje – Detail akce.
Pomocí nastavení Samostatný kalendář předpisu lze definovat styl, kterým se generuje měsíční kalendář na jiných stránkách, než na stránkách zobrazovaných přes skripty tohoto modulu.
[[Image:|center]]
V tomto nastavení se vybírá pouze styl, kterým se tento měsíční kalendář formátuje. Samotná funkce je podrobně popsána v kapitole Extenze pro generování měsíčního kalendáře.
Administrace
Pomocí funkce Práva se nastavují týmy, které mají přístup k datům Kalendáře akcí a mohou zadávat a měnit akce. Seznam oprávněných týmů se spravuje způsobem obvyklým v modulech WebToDate. Každý kalendář může mít vlastní seznam oprávněných týmů.
[[Image:|center]]
Pomocí funkce Kalendáře se zakládají nové kalendáře, které pak fungují jako samostatná úložiště seznamů akcí.
[[Image:|center]]
Součástí nastavení kalendáře je systémový název, výchozí jazyk (nezobrazuje se, pokud je ve WebToDate nadefinován jen jeden) a předpis. Jako výchozí jazyk se volí jazyk akcí, ve kterém se do tohoto kalendáře zadávají akcí nejčastěji. Systémový název je název zobrazovaný pouze v redakčním rozhraní modulu. Pokud se má název kalendáře zobrazovat v prezentační části pomocí příslušného klíčového slova modulu, je třeba zadat i Lokalizovaný název, který se zadává zvlášť pro každý jazyk ve spodní části formuláře.
Všechna nastavení lze dodatečně měnit, kalendář lze ale odstranit jen pokud neobsahuje žádné akce ani kategorie.
Funkce Stavy akcí definuje seznam stavů, které lze pro akce zvolit. Tato funkce má následující možnosti:
- Lze nadefinovat libovolný počet stavů. Seznam stavů je společný pro všechny kalendáře.
- Využívání stavů není povinné. Pokud je nadefinován alespoň jeden stav, objevuje se výběr stavu formou rozevírací nabídky ve formuláři pro zadávání akcí. I tam je ale pak výběr stavu volitelný, akce nemusí být označena stavem.
- V prezentační části existují klíčová slova pro název stavu a ID stavu (lze tedy v seznamu akcí či v detailní stránce pro jednu akci vypsat její stav) a dále lze pomocí parametru v URL vypsat jen akce s požadovaným stavem.
Možné nasazení je např. při publikaci kalendáře seminářů či podobných událostí, kde lze pomocí stavu vyznačit, zda jsou na seminář ještě volná místa či zda je počet míst již zaplněn apod. Obecně se ovšem jedná v zásadě o další nezávislou kategorizací akcí společnou pro všechny kalendáře.
V horní části okna se v administračním rozhraní objevuje seznam stavů, ve spodní části formulář pro vložení či úpravu stavu. Opět se zadává Systémový název pro zobrazení v redakční části modulu a Lokalizovaný název pro každý jazyk pro zobrazení názvu stavu v prezentační části.
[[Image:|center]]
Stavy lze bez omezení přidávat a přejmenovávat, smazat jen když stav není použit u žádné akce.
Funkce Témata umožňuje nadefinovat seznam témat jako další možnost nezávislé kategorizace akcí. Vlastnosti témat jsou následující:
- Seznam témat je společný pro všechny kalendáře
- Zařazení do témat není povinné, pro každou akci lze zvolit žádné, jedno nebo i více témat
- V prezentační vrstvě lze podle témat zobrazit seznam akcí (zadáním příslušného parametru v URL), je podporováno i zobrazení a výběr ze seznamu témat ve vyhledávacím formuláři.
[[Image:|center]]
V horní části okna se v administračním rozhraní objevuje seznam témat, ve spodní části formulář pro vložení či úpravu tématu. Opět se zadává Systémový název pro zobrazení v redakční části modulu a Lokalizovaný název pro každý jazyk pro zobrazení názvu tématu v prezentační části.
Témata lze bez omezení přidávat a přejmenovávat, smazat jen když téma není použito u žádné akce.
Nástroje
V sekci Nástroje nabídky se nacházejí následující funkce:
- Formuláře – vygeneruje WebToDate fragment, v jehož těle je funkční kód vyhledávacího formuláře pro akce, který lze použít v předloze pro seznam akcí.
- Detail akce – vygeneruje WebToDate fragment, v jehož těle je HTML kód s klíčovými slovy pro položky záznamů v kalendáři akcí, fragment je určen pro umístění v předloze pro zobrazení jedné akce.
- Měsíční kalendář – vygeneruje WebToDate styl, kterým se formátuje zobrazení měsíčního kalendáře. Měsíční kalendář lze zobrazovat v seznamu akcí i ve stránce zobrazující detail jedné akce.
Data
Pomocí funkce Kategorie se spravuje seznam kategorií obdobným způsobem jako jiné seznamy položek ve WebToDate.
[[Image:|center]]
Každá kategorie patří k právě jednomu kalendáři, po uložení nelze volbu kalendáře v kategorii měnit. Zadávají se systémové a lokalizované názvy podobně jako u témat či stavů. Přidávat a měnit kategorie lze bez omezení, ale s ohledem na přístupová práva:
- Pokud se kategorie nachází v kalendáři, ke kterému nemá uživatel přístup, lze formulář zobrazit, ale nelze ukládat změny.
- Pro založení nové kategorie se v rozevírací nabídce Kalendář nabízejí pouze ty kalendáře, ke kterým má uživatel přístup.
Mazat kategorie lze jen tehdy, pokud v kategorii není žádná akce.
Pomocí funkce Data – Kalendáře – zvolený kalendář se spravují vlastní data modulu, neboli záznamy v kalendáři akcí.
[[Image:|center]]
Nová položka se přidává pomocí odkazu Přidat v pravé horní části okna prohlížeče. Povinně se pro každou akci zadává pouze Název. Pokud není zadán Začátek akce nebo Konec akce, doplní se automaticky aktuální datum. Pokud není vybrán jiný kalendář, akce se vloží do kalendáře, který byl vybrán z nabídky modulu. Není-li ručně změněn jazyk, vybere se automaticky jazyk označený v tomto kalendáři jako výchozí.
[[Image:|center]]
Formulář pro úpravy akce se skládá ze dvou záložek - Text a Vlastnosti. V záložce Text se vyplňují následující pole:
- Název - název akce, nutné vyplnit
- Stručný popis - stručný popis bez omezení délky
- Popis - textový popis akce bez omezení délky textu
- Automatické řádkování - pokud je zaškrtnuto, formátuje se popis při zobrazení jedním z prezentačních skriptů stejným způsobem jako tělo zprávy stejnou funkcí v samotném WebToDate – konce odstavců se nahrazují znaky definovanými v globálních předvolbách WebToDate (typicky <p>, </p>).
V záložce Vlastnosti se vyplňují následující pole:
- Začátek akce - datum a čas začátku
- Konec akce - datum a čas konce akce
- Zařazení - v této funkci se řadí akce do kalendářů a kategorií. Vedle popisku formulářového pole se zobrazuje textově seznam kalendářů a kategorií, ve kterých se akce nachází. Tlačítkem Změnit se otevírá dialogové okno, ve kterém se pomocí zaškrtávacích okének kalendáře a akce vybírají. Je třeba vybrat alespoň jeden kalendář, výběr kategorií není povinný.
[[Image:|center]]
- Témata - seznam témat, ve kterých se akce nachází, se zobrazuje v poli vedle popisku. Tlačítkem Vybrat se zobrazí dialog, ve kterém se zaškrtávacími okénky vybírají témata, do kterých akce patří. Zařazení akce do témat není povinné.
[[Image:|center]]
- Jazyk - v rozevírací nabídce se vybírá právě jeden jazyk akce. Akce mohou mít jazykové verze, viz popis v této kapitole níže.
- Stav akce - rozevírací nabídka se stavem akce, výchozí hodnota je "žádný". Význam stavů akcí je popsán v kapitole [#_Nastavení Nastavení]. Výběr stavů se zobrazuje pouze v případě, že je definován alespoň jeden stav.
- Umístění - textové pole, do kterého lze zadat místo konání akce
- Odkaz 1 - volně definovatelné pole, do kterého lze zadat např. nějaké další URL. Obsahu pole odpovídá klíčové slovo, kterým lze zobrazit obsah tohoto pole v prezentační části.
- Odkaz 2 - analogický význam jako Odkaz 1
- Odkaz 3 - analogický význam jako Odkaz 1
Položky lze přidávat, měnit i odebírat dle potřeby bez omezení. Pomocí odkazu Vyhledat v pravém horním rohu okna prohlížeče lze zobrazit vyhledávací formulář, hledat lze podle ID akce, textu, jazyka, kalendáře, kategorie, tématu, stavu a data od – do.
Speciální možností pro tvorbu stránek s akcemi, které v popisu obsahují bohaté formátování včetně např. obrázků apod. je funkce Vložit zprávu vedle pole Popis resp. Stručný popis. Tato funkce zobrazí dialogové okno pro výběr zprávy / zdroje / fragmentu z databáze WebToDate.
[[Image:]]
Dialogové okno se obsluhuje podobně jako vyhledávání ve zprávách WebToDate. Základní rozdíl je v tom, že šipka v levém sloupci seznamu zpráv vkládá do textového pole s popisem klíčové slovo typu <!--WTD_NEWS(xxx)-->, za které se pak při zobrazení akce dosazuje kompletní zobrazení zprávy / zdroje / fragmentu jako kdyby byl zobrazován přes prezentační skript /scripts/detail.php WebToDate.
Aby byla tato funkce využitelná, je tedy třeba:
- Vytvořit předlohu pro zprávy, která ze zpráv používaných k tomuto účelu zobrazuje jen žádoucí pole (např. jen tělo zprávy), nemá smysl, aby předloha zobrazovala navigační elementy a další prvky layoutu celého webu.
- Zvolit pro ukládání takových zpráv vhodnou kategorii ve stromu kategorií, která nebude fulltextově prohledávaná.
Pole pro popis akce pak může obsahovat buď jen jednu, nebo několik značek typu <!--WTD_NEWS(xxx)-->, nebo jen prostý text s popisem, nebo kombinaci obojího. I když do popisu lze ručně vkládat HTML formátování, při potřebě složitějšího bohatě formátovaného textu zobrazujícího se ve stránce s akcí je vhodnější využít tuto funkci Vložit zprávu.
V horní části formuláře jsou kromě běžných tlačítek pro uložení či zmazání zprávy tlačítka
- Náhled - zobrazí v novém okně prohlížeče náhled detailu akce, neboli stránku s URL /scripts/modules/diary/action.php?id=xxx&calid=yyy
- Duplikovat - zobrazí dialog pro duplikaci resp. vytvoření jazykové verze akce
[[Image:|center]]
V tomto dialogu tlačítko Duplikovat vytvoří prostou kopii dané akce, tlačítko Nová verze vytvoří jazykovou verzi ve vybraném jazyce. V rozevírací nabídce pro výběr jazyka se nabízejí jen ty jazyky, pro které ještě pro danou akci neexistuje jazyková verze. Takto vytvořená jazyková verze se liší zvoleným jazykem a přejmenovaným nadpisem, jinak jsou údaje v ní identické jako v duplikované akci, typicky je třeba přeložit textové popisky akce.
Práce s jazykovými verzemi je možná ve spodní části formuláře v záložce Vlastnosti. Jsou k dispozici následující funkce:
- Přejít na akci v jazyce - pokud existuje pro aktuálně zobrazenou akci nějaká jazyková verze, zobrazí se tento text a rozevírací nabídka s jazyky, pro které jazykové verze existují. Přechod na formulář pro úpravu vybrané jazykové verze se potvrzuje tlačítkem OK.
- Připojit akci s ID - tato možnost se použije v případě, že do databáze již byla zadána nějaká akce jako samostatná (bez jazykových verzí) a je třeba ji označit jako jazykovou verzi právě upravované akce. Do textového pole se zadá ID akce, kterou je třeba s aktuálně zobrazenou akcí propojit a jazyk této připojované akce. Pokud akce má verze ve všech jazycích, tato možnost se nenabízí a zobrazí se text Akce má verze ve všech jazycích.
Veřejné skripty
Prezentační skripty
V adresáři /scripts/modules/diary/ se nacházejí veřejně přístupné prezentační skripty modulu. Jedná se o následující skripty:
| Skript | Funkce |
| default.php | Skript vypisuje seznam akcí |
| action.php | Skript vypisuje detail jedné akce |
| ical.php | Skript pro export do formátu iCalendar |
Seznam akcí je vždy tříděn podle data vzestupně. Pokud je skript volán bez dalších upřesňujících parametrů, zobrazí se akce, které právě probíhají nebo nastanou v budoucnu, starší akce lze zobrazit pouze pomocí vyhledávání, resp. zadání počátečního data v URL.
Pro další seznamy položek, které mohou skripty vypisovat, platí, že se třídí podle systémových názvů položek vzestupně. Jedná se o následující pomocné seznamy:
- Seznam kategorií kalendáře
- Seznam kategorií, ve kterých se akce nachází
- Seznam témat, ve kterých se akce nachází
- Seznam kategorií jako rozevírací nabídka ve vyhledávacím formuláři
- Seznam témat jako rozevírací nabídka ve vyhledávacím formuláři
Klíčová slova modulu - seznam akcí
V následujících tabulkách jsou uvedeny seznamy klíčových slov, která lze používat v předlohách nebo ve WebToDate stylech.
| klíčová slova použitelná v těle stylu pro seznam akcí | ||
| Klíčové slovo | Význam | Poznámka |
| <!--WTD_DIARY(NAME)--> | Název akce | |
| <!--WTD_DIARY(DIARYID)--> | ID akce | |
| <!--WTD_DIARY(DATEFROM)--> | Datum od | |
| <!--WTD_DIARY(TIMEFROM)--> | Čas od | |
| <!--WTD_DIARY(DATETO)--> | Datum do | |
| <!--WTD_DIARY(TIMETO)--> | Čas do | |
| <!--WTD_DIARY(DESCRIPTION)--> | Popis akce | |
| <!--WTD_DIARY(DIARYURL)--> | URL pro zobrazení detailu akce | |
| <!--WTD_DIARY(SHORTDESCRIPTION)--> | Krátký popis akce | |
| <!--WTD_DIARY(LOCATION)--> | Umístění | |
| <!--WTD_DIARY(STATUSNAME)--> | Název stavu akce | |
| <!--WTD_DIARY(STATUSID)--> | ID stavu akce | |
| <!--WTD_DIARY(CALNAME)--> | Název aktuálně zobrazovaného kalendáře | |
| <!--WTD_DIARY(CALID)--> | ID aktuálně zobrazovaného kalendáře | |
Jednoduchá definice stylu pro seznam akcí je tedy např. následující:
Hlavička
<table class="action_table">
<tr><th>Položka</th><th>Od</th><th>Do</th><th>Místo konání</th></tr>
Tělo
<tr>
<td><a href="<!--WTD_DIARY(DIARYURL)-->"><!--WTD_DIARY(NAME)--></a></td>
<td><!--WTD_DIARY(DATEFROM)--></td>
<td><!--WTD_DIARY(DATETO)--></td>
<td><!--WTD_DIARY(LOCATION)--></td>
</tr>
Patička
</table>
| Klíčová slova použitelná v předloze pro seznam akcí | ||
| Klíčové slovo | Význam | Poznámka |
| <!--WTD_DIARY(LIST)--> | Seznam akcí | |
| <!--WTD_DIARY(NAVIG)--> | Navigační lišta | |
| <!--WTD_DIARY(LISTCATEGORIES)--> | Seznam kategorií kalendáře | |
| <!--WTD_DIARY(CALENDAR)--> | Měsíční kalendář | |
| <!--WTD_DIARY(CALNAME)--> | Název kalendáře | |
| <!--WTD_DIARY(CALID)--> | ID kalendáře | |
| <!--WTD_DIARY(PATTERNID)--> | ID předpisu | Používá se ve vyhledávacím formuláři, pokud se z URL vynucuje jiný předpis pro zobrazení, jinak nemá smysl použít |
| <!--WTD_DIARY(CATEGORY)--> | Název zobrazované kategorie | Pro výpis toho, co se právě zobrazuje za seznam |
| <!--WTD_DIARY(CATEGORYID)--> | ID zobrazované kategorie | Pro výpis toho, co se právě zobrazuje za seznam |
| <!--WTD_DIARY(THEME)--> | Název zobrazovaného tématu | Pro výpis toho, co se právě zobrazuje za seznam |
| <!--WTD_DIARY(THEMEID)--> | ID zobrazovaného tématu | Pro výpis toho, co se právě zobrazuje za seznam |
| <!--WTD_DIARY(STATUSNAME)--> | Název zobrazovaného stavu | Pro výpis toho, co se právě zobrazuje za seznam |
| <!--WTD_DIARY(STATUSID)--> | ID zobrazovaného stavu | Pro výpis toho, co se právě zobrazuje za seznam |
Výše uvedená klíčová slova pro výpis toho, co se právě zobrazuje, mohou informovat o tom, zde se aktuálně vypisují akce z nějakého tématu či kategorie apod. Obsah se za ně dosazuje pouze v případě, že korespondující parametr je uveden v URL skriptu. Pokud tedy např. je zobrazen seznam /scripts/modules/diary/default.php?calid=1&categid=2, dosadí se za <!--WTD_DIARY(CATEGORYID)--> číslo 2 a za <!--WTD_DIARY(CATEGORY)--> lokalizovaný název kategorie s ID=2, pro URL /scripts/modules/diary/default.php?calid=1 se za obě uvedená klíčová slova dosadí prázdný řetězec.
Možné jsou i konstrukce
<!--WTD_IF(CATEGORYNOTNULL,"Akce z kategorie <!--WTD_DIARY(CATEGORY)-->")-->
<!--WTD_IF(CATEGORYNULL,"Akce ze všech kategorií")-->
Analogicky pak výrazy
<!--WTD_IF(THEMENOTNULL,"…")-->
<!--WTD_IF(THEMENULL,"…")-->
<!--WTD_IF(STATUSNOTNULL,"…")-->
<!--WTD_IF(STATUSNULL,"…")-->
vkládají obsah podle toho, zda je výpis filtrován na nějaké téma či stav.
Pokud má daná akce stejný datum začátku i konce (čas začátku a konce akce se může lišit), může být účelné vypsat toto datum pouze jednou a nikoli jako dvě stejná data začátku a konce. K tomu slouží konstrukce
<!--WTD_IF(SAMEDATE,"…")--> - obsah se vloží, pokud je datum začátku a konce akce stejné
<!--WTD_IF(NOTSAMEDATE,"…")--> - obsah se vloží, pokud se data začátku a konce akce liší.
Vypisujeme-li tedy seznam akcí jako HTML tabulku, může se ve stylu pro seznam položek toto využít např. následovně:
<!--WTD_IF(SAMEDATE,"<td colspan="2" align="center"> <!--WTD_DIARY(DATEFROM)--></td>")-->
<!--WTD_IF(NOTSAMEDATE,"<td><!--WTD_DIARY(DATEFROM)--></td><td><!--WTD_DIARY(DATETO)--></td>")-->
Jednoduchý kód předlohy pro seznam akcí tedy vypadá např. následovně:
<h2><!--WTD_DIARY(CALNAME)--></h2>
<!--WTD_IF(CATEGORYNOTNULL,"<p>Akce z kategorie <!--WTD_DIARY(CATEGORY)--></p>")-->
<!--WTD_IF(CATEGORYNULL,"<p>Výpis akcí ze všech kategorií</p>")-->
<!--WTD_IF(THEMENOTNULL,"<p>Akce z tématu<!--WTD_DIARY(THEME)--></p>")-->
<!--WTD_IF(THEMENULL,"<p>Výpis akcí ze všech témat</p>")-->
<div><!--WTD_DIARY(LIST)--></div>
<div><!--WTD_DIARY(NAVIG)--></div>
<div><!--WTD_DIARY(LISTCATEGORIES)--></div>
Tento kód zobrazuje popořadě:
- Název kalendáře
- Pokud se vypisuje seznam z nějaké konkrétní kategorie či tématu, tak název této kategorie resp. tématu
- Vlastní seznam akcí
- Stránkovací lištu
- Seznam kategorií aktuálního kalendáře.
V předloze pro seznam akcí se může rovněž vyskytovat vyhledávací formulář:
| Klíčová slova pro vyhledávací formulář – lze použít v předloze pro seznam akcí | ||
| Klíčové slovo | Význam | Poznámka |
| <!--WTD_DIARY(SEARCHTEXT)--> | Vyhledávaný text | |
| <!--WTD_DIARY(SEARCHDATEFROM)--> | Datum od | |
| <!--WTD_DIARY(SEARCHDATETO)--> | Datum do | |
| <!--WTD_DIARY(CATEGORIES)--> | Seznam kategorií | Vytvoří jednotlivé <option> elementy pro všechny kategorie kalendáře |
| <!--WTD_DIARY(THEMES)--> | Seznam témat | Vytvoří jednotlivé <option> elementy pro všechna definovaná témata |
| <!--WTD_DIARY(SEARCHLOCATION)--> | Umístění | |
| <!--WTD_DIARY(LOCALEID)--> | ID jazyka | |
| <!--WTD_DIARY(FORMURL)--> | URL pro hledání | Lze použít v atributu action formuláře |
Pomocí konstrukce WTD_IF lze specifikovat chybová hlášení. Např. se jedná o konstrukci
<!--WTD_IF(WRONGDATEFROM,"Chybně vložený formát v políčku s počátečním datem.")-->
Lze použít tyto události dle následující tabulky:
| Chybová a informační hlášení související s vyhledáváním | ||
| Klíčové slovo | Význam | Poznámka |
| WRONGDATEFROM | chybně zadané datum od | |
| WRONGDATETO | chybně zadané datum do | |
| NOTHINGFOUND | podmínkám nevyhovuje žádný záznam | |
Klíčová slova modulu - detail akce
V předloze pro detail akce se používají následující klíčová slova:
| Klíčová slova použitelná v předloze pro detail akce | ||
| Klíčové slovo | Význam | Poznámka |
| <!--WTD_DIARY(NAME)--> | Název akce | |
| <!--WTD_DIARY(DIARYID)--> | ID akce | |
| <!--WTD_DIARY(DATEFROM)--> | Datum od | |
| <!--WTD_DIARY(TIMEFROM)--> | Čas od | |
| <!--WTD_DIARY(DATETO)--> | Datum do | |
| <!--WTD_DIARY(TIMETO)--> | Čas do | |
| <!--WTD_DIARY(DESCRIPTION)--> | Popis akce | |
| <!--WTD_DIARY(SHORTDESCRIPTION)--> | Krátký popis akce | |
| <!--WTD_DIARY(LOCATION)--> | Umístění | |
| <!--WTD_DIARY(STATUSNAME)--> | Název stavu akce | |
| <!--WTD_DIARY(STATUSID)--> | ID stavu akce | |
| <!--WTD_DIARY(CALNAME)--> | Název kalendáře | Zobrazuje lokalizovaný název kalendáře, ale jen pokud je v URL specifikováno ID kalendáře nebo je akce jen v jednom kalendáři; jinak se dosadí prázdný řetězec |
| <!--WTD_DIARY(CALID)--> | ID kalendáře | Vkládá ID kalendáře, ale jen pokud je v URL specifikováno ID kalendáře nebo je akce jen v jednom kalendáři; jinak se dosadí prázdný řetězec |
| <!--WTD_DIARY(LINK1)--> | Odkaz 1 | |
| <!--WTD_DIARY(LINK2)--> | Odkaz 2 | |
| <!--WTD_DIARY(LINK3)--> | Odkaz 3 | |
| <!--WTD_DIARY_LANG(id_akce,kód_jazyka)--> | Odkaz na jazykovou verzi | Vloží URL jazykové verze akce s ID id_akce v jazyce kód_jazyka |
| <!-- WTD_DIARY_LANG(*,kód_jazyka)--> | Odkaz na jazykovou verzi | Vloží URL jazykové verze právě zobrazované akce v jazyce kód_jazyka |
| <!--WTD_DIARY(LISTCATEGORIES)--> | Seznam kategorií kalendáře | |
| <!--WTD_DIARY(CURRENTCATEGORIES)--> | Seznam kategorií, ve kterých se akce nachází | |
| <!--WTD_DIARY(CURRENTTHEMES)--> | Seznam témat, ve kterých se akce nachází | |
Rovněž jsou možné konstrukce typu
<!--WTD_IF(LINK1NOTNULL,"…")-->
<!--WTD_IF(LINK1NULL,"…")-->
<!--WTD_IF(SHORTDESCRIPTIONNULL,"…")-->
pro všechna pole, která nejsou v záznamu akce povinná. Kód v uvozovkách se tedy vloží jen v případě, že pole uvedené ve výrazu je resp. není vyplněno. Použití je tedy např.:
<!--WTD_IF(STATUSNOTNULL,"<br /><em><!--WTD_DIARY(STATUSNAME)--></em>")-->
Stejně jako v seznamu akcí fungují výrazy
<!--WTD_IF(SAMEDATE,"…")--> - obsah se vloží, pokud je datum začátku a konce akce stejné
<!--WTD_IF(NOTSAMEDATE,"…")--> - obsah se vloží, pokud se data začátku a konce akce liší.
Pro odkazy na jazykové verze zobrazované akce jsou možné konstrukce
<!--WTD_IF(DIARY_LANGNOTNULL,ID akce,kód jazyka,"vkládaný HTML kód")-->
<!--WTD_IF(DIARY_LANGNULL,ID akce,kód jazyka,"vkládaný HTML kód")-->
ID akce zde může být buď číslo, nebo znak *. Příklad podmíněného vložení odkazu na jazykovou verzi v angličtině pokud existuje, je tedy:
<!--WTD_IF(DIARY_LANGNOTNULL,*,EN,"<a href="<!--WTD_DIARY_LANG(*,EN)-->">Anglická verze popisu akce</a>")-->
Ve stylu pro seznam kategorií, ve kterých se akce nachází, lze použít klíčová slova
| Klíčová slova pro seznam kategorií, ve kterých se akce nachází, a seznam všech kategorií kalendáře | ||
| Klíčové slovo | Význam | Poznámka |
| <!--WTD_DIARY(CATEGORY)--> | Název kategorie | |
| <!--WTD_DIARY(CATEGORYID)--> | ID kategorie | |
| <!--WTD_DIARY(CATEGORYURL)--> | URL vypisující akce dané kategorie | |
Ve stylu pro seznam témat, ve kterých se akce nachází, lze použít:
| Klíčová slova pro seznam témat, ve kterých se akce nachází | ||
| Klíčové slovo | Význam | Poznámka |
| <!--WTD_DIARY(THEME)--> | Název tématu | |
| <!--WTD_DIARY(THEMEID)--> | ID tématu | |
| <!--WTD_DIARY(THEMEURL)--> | URL vypisující akce daného tématu | |
Kód předlohy pro detail akce tedy může vypadat např. následovně:
<h3><!--WTD_DIARY(NAME)--></h3>
<p>Od <!--WTD_DIARY(DATEFROM)--> do <!--WTD_DIARY(DATETO)-->
<!--WTD_IF(LOCATIONNOTNULL,"(<!--WTD_DIARLOCATION)-->)")--></p>
<p><!--WTD_DIARY(DESCRIPTION)--></p>
<p><a href="/scripts/modules/diary/ical.php?id=<!--WTD_DIARY(DIARYID)-->">
Načíst do Outlooku</a></p>
<p><!--WTD_DIARY(CURRENTCATEGORIES)--></p>
<p><!--WTD_DIARY(CURRENTTHEMES)--></p>
<p><!--WTD_DIARY(LISTCATEGORIES)--></p>
Tento kód vypisuje popořadě:
- Název akce
- Datum od - do, pokud je vyplněno umístění, tak umístění
- Popis akce
- Odkaz na export akce do formátu iCalendar
- Seznam kategorií, ve kterých se akce nachází
- Seznam témat, ve kterých se akce nachází
- Seznam všech kategorií aktuálního kalendáře
Formátování data
Je k dispozici možnost formátování data pomocí konstrukce
<!--WTD_FORMAT(DATE,"formátovací předpis","formátovaný časový údaj")-->
ve stejné syntaxi, jako se používá v samotném WebToDate (viz referenční příručka WebToDate). Výraz lze použít ve stránce se seznamem akcí i v detailu akce.
Příklad vypisující pro počáteční datum akce pouze den a měsíc je:
<!--WTD_FORMAT(DATE,"j.n.","<!--WTD_DIARY(DATEFROM)-->")-->
Klíčová slova pro zobrazení měsíčního kalendáře
Následující klíčová slova se používají pro formátování měsíčního kalendáře. Ten je v předloze reprezentován jediným klíčovým slovem <!--WTD_DIARY(CALENDAR)-->, celé formátování kalendáře je definováno jedním WebToDate stylem, ve kterém lze následující klíčová slova použít.
| Klíčová slova pro hlavičku či patičku stylu | |
| Klíčové slovo | Význam |
| <!--WTD_CALENDAR(CURRENTMONTHNAME)--> | Jméno zobrazovaného měsíce |
| <!--WTD_CALENDAR(CURRENTMONTHABBREV)--> | Zkratka zobrazovaného měsíce |
| <!--WTD_CALENDAR(CURRENTYEARNAME)--> | Zobrazovaný rok |
| <!--WTD_CALENDAR(PREVMONTHLINK)--> | Odkaz na zobrazení předcházejícího měsíce |
| <!--WTD_CALENDAR(NEXTMONTHLINK)--> | Odkaz na zobrazení následujícího měsíce |
| <!--WTD_CALENDAR(PREVYEARLINK)--> | Odkaz na zobrazení předcházejícího roku |
| <!--WTD_CALENDAR(NEXTYEARLINK)--> | Odkaz na zobrazení následujícího roku |
| Klíčová slova pro tělo stylu | |
| Klíčové slovo | Význam |
| <!--WTD_CALENDAR(DAYNUMBER)--> | Pořadové číslo dne v měsíci |
| <!--WTD_CALENDAR(MONTHNUMBER)--> | Pořadové číslo měsíce v roce |
| <!--WTD_CALENDAR(YEARNUMBER)--> | Rok |
| <!--WTD_CALENDAR(DAYLINK)--> | Odkaz umístěný na číslo dne |
| )--></nowiki> | Kód se vkládá v případě, že se jedná o prázdnou buňku na začátku a na konci měsíčního kalendáře |
| )--></nowiki> | Kód se vkládá v případě, že se jedná o prázdnou buňku na začátku a na konci měsíčního kalendáře |
| )--></nowiki> | Kód se vkládá v případě, že se jedná o prázdnou buňku na začátku a na konci měsíčního kalendáře |
| )--></nowiki> | Kód se vkládá v případě, že se jedná o prázdnou buňku na začátku a na konci měsíčního kalendáře |
| )--></nowiki> | Kód se vkládá v případě, že se jedná o prázdnou buňku na začátku a na konci měsíčního kalendáře |
| )--></nowiki> | Kód se vkládá v případě, že se jedná o prázdnou buňku na začátku a na konci měsíčního kalendáře |
Příklad stylu pro kalendář využívajícího výše zmíněná klíčová slova je následující:
Hlavička
<table border="1" cellspacing="0" cellpadding="2">
<tr>
<th colspan="7">
<!--WTD_CALENDAR(CURRENTMONTHNAME)--> <!--WTD_CALENDAR(CURRENTYEARNAME)-->
</th>
</tr>
<tr>
<th> Po </th>
<th> Út </th>
<th> St </th>
<th> Čt </th>
<th> Pá </th>
<th> So </th>
<th> Ne </th>
</tr>
Tělo
<!--WTD_IF(CALCELLEMPTY,"<td> </td>")-->
<!--WTD_IF(CALCELLDAYONLY,"<td><!--WTD_CALENDAR(DAYNUMBER)--></td>")-->
<!--WTD_IF(CALCELLDAYLINK,"<td><a href='<!--WTD_CALENDAR(DAYLINK)-->'>
<!--WTD_CALENDAR(DAYNUMBER)--></a></td>-->
<!--WTD_IF(CALCELLCURRENTDAYONLY,"<td bgcolor='orange'>
<!--WTD_CALENDAR(DAYNUMBER)--></td>")-->
<!--WTD_IF(CALCELLCURRENTDAYLINK,"<td bgcolor='orange'>
<a href='<!--WTD_CALENDAR(DAYLINK)-->'><!--WTD_CALENDADAYNUMBER)--></a></td>")-->
<!--WTD_IF(CALCELLSELECTEDDAYLINK,"<td bgcolor='red'>
<a href='<!--WTD_CALENDAR(DAYLINK)-->'><!--WTD_CALENDADAYNUMBER)--></a></td>")-->
Patička
<tr>
<td colspan="7">
<table width="100%" border="0" cellspacing="0" cellpadding"0">
<tr>
<td>
<a href="<!--WTD_CALENDAR(PREVMONTHLINK)-->">«</a>
</td>
<td align="right">
<a href="<!--WTD_CALENDAR(NEXTMONTHLINK)-->">»</a>
</td>
</tr>
</table>
</td>
</tr>
</table>
Začátek sekce
<tr>
Konec sekce
</tr>
Formulářová pole a další možné parametry prezentačních skriptů
Názvy formulářových polí je třeba přesně dodržet, jinak může být vyhledávací formulář nefunkční.
Následující tabulka shrnuje možné parametry skriptu pro seznam akcí. Žádný z parametrů není povinný, není-li parametr uveden, použije se výchozí hodnota.
| Parametry skriptu default.php pro seznam akcí | ||
| Název pole nebo parametru | Význam | Poznámka |
| calid | ID kalendáře | Pokud není uvedeno, zobrazuje se kalendář, který má nejnižší ID |
| categid | ID kategorie | ID kategorie akcí, které se mají vypisovat |
| statusid | ID stavu | Pokud je zadáno nenulové číslo, vypisují se pouze akce s daným stavem |
| themeid | ID tématu | ID tématu akcí, které se mají vypisovat |
| datefrom | datum od pro vyhledávání | |
| dateto | datum do pro vyhledávání | |
| searchtext | hledaný text | |
| location | umístění | |
| event | příznak zda jde o vyhledávací režim | |
| pg | stránkování seznamu akcí | |
| patternid | ID předpisu | Pokud není uvedeno, použije se předpis nastavený v definici kalendáře |
| tmplid | ID předlohy | |
| lid | ID jazyka v případě používání jiné jazykové mutace než výchozí | |
| locale | locale string jazyka (CS, EN, DE). Výsledek stejný jako výše. | |
| dlid | ID jazyka pro data | |
| dlocale | zkratka jazyka pro data | |
| calyear | Měsíční kalendář – vybraný rok | |
| calmonth | Měsíční kalendář - vybraný měsíc | |
| calday | Měsíční kalendář - vybraný den | |
| dayfrom | Počet dní ve výpisu | Nastavuje počet dní od data zvoleného přes měsíční kalendář, pro které se akce zobrazují v seznamu akcí; 0 = pouze vybraný den, 1 = vybraný den + jeden následující kalendářní den atd. |
Jazykové nastavení objasňují následující příklady (používají se parametry pro zkratku jazyka locale resp. dlocale, stejným způsobem se ale používají parametry pro ID jazyka lid resp. dlid, jedná se vždy o stejný význam, tj. volbu jazyka, jde jen o způsob této volby):
URL /scripts/modules/diary/default.php?calid=1 vypisuje seznam akcí daného kalendáře s výběrem jazyka pro šablony jako výchozího jazyka, zobrazuje všechny akce kalendáře ve všech jazycích.
URL /scripts/modules/diary/default.php?calid=1&dlocale=EN vypisuje seznam akcí daného kalendáře, kde akce jsou v angličtině. Předloha a styl se hledá tak, že nejprve se zjistí, zda existuje nastavení v předpisu pro jazyk angličtina, pokud ne, hledá se předloha a styl pro výchozí jazyk. Platí tedy, že pokud není explicitně specifikován parametr locale resp. lid, snaží se modul data v angličtině zobrazit v šabloně pro angličtinu apod.
URL /scripts/modules/diary/default.php?calid=1&dlocale=EN&locale=CS zobrazí seznam akcí v angličtině s využitím české předlohy a stylu.
Parametr patternid lze využít pro zobrazení kalendáře s jiným grafickým nastavením (předpisem), než je uvedeno v definici kalendáře. Toto se využívá např. pro zobrazení stejného kalendáře na různých virtuálních serverech s jinou grafikou. Jako vstupní stránka se pak použije např. URL /scripts/modules/diary/default.php?calid=2&patternid=12, kde 2 je ID zobrazovaného kalendáře a 12 ID předpisu, který se má použít. Oba parametry se pak přenášejí mezi jednotlivými stránkami (dosazují se do URL pro stránkovací lištu, odkazy na výpisy dle kategorií či měsíčního kalendáře apod.), takže je zajištěno, že volba kalendáře i předpisu platí pro všechny zobrazované stránky.
Aby byl v takovém případě funkční i vyhledávací formulář, doporučujeme do jeho HTML kódu vložit následující řádky:
<input type="hidden" name="calid" value="<!--WTD_DIARY(CALID)-->" />
<input type="hidden" name="patternid" value="<!--WTD_DIARY(PATTERNID)-->" />
Tím je zajištěno, že ve formuláři bude korektním způsobem uvedeno, jaký kalendář se prohledává a jaký předpis je případně zvolen v URL stránky.
Pomocí parametru dayfrom lze definovat, kolik dní se vypisuje v seznamu akcí. Např. URL /scripts/modules/diary/default.php?calid=1&calyear=2008&calmonth=12&calday=18&dayfrom=0 vypíše seznam akcí, které probíhají pouze dne 18.12.2008 a žádné další. Aby byla volba intervalu pomocí dayfrom funkční, musí být uveden počáteční den, čili např. URL default.php?calid=1&calyear=2008&calmonth=12&dayfrom=0 žádný den nevybere, stránka bude vypadat tak, že zobrazí měsíční kalendář na vybraný měsíc a seznam akcí ve výchozím tvaru, čili od aktuálního data dál.
Pro zobrazení detailu akce lze použít následující parametry:
| Parametry skriptu action.php pro detail akce | ||
| Název pole nebo parametru | Význam | Poznámka |
| id | ID akce | |
| calid | ID kalendáře | Není-li zadáno, použije se kalendář s nejnižším ID, ve kterém se akce nachází |
| patternid | ID předpisu | |
| tmplid | ID předlohy | |
| lid | ID jazyka pro prezentační vrstvu | |
| locale | Zkratka jazyka pro prezentační vrstvu | |
Parametr id specifikuje akci, ostatní parametry mohou ovlivnit volbu předlohy. Při jejich zpracování se postupuje v následujícím pořadí:
- Je zadán tmplid - pak je šablona zvolena explicitně a další volby se týkají jen stylů
- Je zadán patternid - tím je zvolen předpis a rozhoduje se jen o jazyce zobrazení
- Je zadán calid - opět je zprostředkovaně zvolen předpis a rozhoduje se jen o jazyce
- Je zadáno lid nebo locale - je zvolen jazyk pro šablonu
- Není-li jazyk zvolen explicitně, použije se jazyk akce
- Je-li akce ve více kalendářích s různými předpisy a z parametrů nevyplynulo, který předpis se má použít, použije se předpis kalendáře s nižším ID
Exportní skript do formátu iCalendar používá následující parametry:
| Parametry skriptu ical.php pro export do formátu iCalendar | ||
| Název pole nebo parametru | Význam | Poznámka |
| id | ID akce | |
| calid | ID kalendáře | Není-li zadáno, použije se kalendář s nejnižším ID, ve kterém se akce nachází |
| categid | ID kategorie akcí | ID kategorie akcí, které se mají exportovat |
| themeid | ID tématu akcí | ID tématu akcí, které se mají exportovat |
| dlid | ID jazyka pro výběr dat | |
| dlocale | Zkratka jazyka pro výběr dat | |
Je-li uvedeno ID akce, exportuje se jedna akce s daným ID a ostatní parametry se ignorují. V opačném případě se exportují všechny akce odpovídající kritériím zadaných parametrů, kritéria se kombinují logickou spojkou "a zároveň". Tedy např.
/scripts/modules/diary/ical.php?calid=3&dlocale=EN exportuje všechny akce v angličtině z kalendáře s ID = 3
/scripts/modules/diary/ical.php?categid=12 exportuje všechny akce z kategorie ID=12 ve všech jazycích.
Export dat ve formátu iCalendar
Skript /scripts/modules/diary/ical.php poskytuje data daná parametry v URL ve formátu iCalendar, takže takové akce lze jednoduše načíst do aplikací typu MS Outlook apod.
Formát dat, který skript sestavuje (dle RFC 2445, viz http://tools.ietf.org/html/rfc2445) je následující:
BEGIN:VCALENDAR
PRODID:-//Macron Software//NONSGML WebToDate//EN
VERSION:2.0
METHOD:publish
BEGIN:VEVENT
DTSTAMP:20080513T125158
DTSTART:20080602T150000
DTEND:20080602T160000
LOCATION:Brno
DESCRIPTION:Tady je popisek akce
SUMMARY:Tady je název akce
CLASS:PUBLIC
END:VEVENT
END:VCALENDAR
Hlavička od začátku textu až po METHOD:publish je vždy stejná, pak následuje jeden nebo více bloků označených BEGIN:VEVENT / END:VEVENT, každý blok reprezentuje jednu akci. Data se dosazují dle následující tabulky:
| DTSTAMP | Aktuální datum a čas |
| DTSTART | Datum a čas počátku akce |
| DTEND | Datum a čas ukončení akce |
| LOCATION | Umístění |
| DESCRIPTION | Popis akce bez HTML tagů |
| SUMMARY | Název akce |
Možné parametry skriptu jsou uvedeny v kapitole [#_Formulářová_pole_a Formulářová pole a další možné parametry prezentačních skriptů]. Pokud je např. žádoucí např. ve stránce s detailem akce nabídnout export zobrazované akce do formátu iCalendar, použije se v předloze pro detail akce kód
<a href="/scripts/modules/diary/ical.php?id=<!--WTD_DIARY(DIARYID)-->">Export do formátu iCalendar</a>
Extenze pro generování měsíčního kalendáře
Modul Kalendář akcí má možnost generovat měsíční kalendář i na jiné stránky webové prezentace než ty, které se zobrazují přes skripty modulu (tj. skripty uvedené v kapitole [#_Prezentační_skripty Prezentační skripty]). Princip této funkce je následující:
- Kalendář se vkládá pomocí extenze pro generátor stránek, tj. kódu, který může modifikovat obsah stránky sestavované ve WebToDate jako generovaná stránka.
- Do příslušné stránky se vloží klíčové slovo (popsané níže), které daná extenze hledá a nahradí za cílový HTML kód. Tento kód se vloží ve chvíli generování, pak je ve stránce staticky a mění se jedině při dalším generování takové stránky.
- HTML kód měsíčního kalendáře je dán stylem, který lze nastavit v předpisu, kterým se formátuje daný kalendáře.
Výsledkem je zobrazení měsíčního kalendáře pro aktuální měsíc, tak jak je znázorněno na následujícím otisku obrazovky.
[[Image:|center]]
Je důležité si uvědomit, že jde o statický HTML kód vložený do stránky. Z toho vyplývá např.:
- Změny v obsahu daného kalendáře (např. přidání další akce na den, který ještě žádnou akci neměl) se zde promítnou, až když je stránka přegenerována.
- Všechny hypertextové odkazy v měsíčním kalendáři vedou na skripty modulu, čili na jiné stránky. Zobrazení tohoto měsíčního kalendáře např. na úvodní stránce webu tedy neznamená, že odkazy na listování po měsících mění v této úvodní stránce pouze měsíční kalendář a zbytek stránky zůstává, ale že se zobrazí jiná stránka, která zobrazuje seznam akcí modulu a kde je vybrán v měsíčním kalendáři jiný měsíc.
Aby bylo možné měsíční kalendář do takovýchto stránek generovat, je třeba instalovat příslušnou extenzi, jak je popsáno v kapitole [#_Umístění_extenzí Umístění extenzí].
Extenze podporuje následující klíčová slova:
<!--WTD_DIARYCALENDAR(2,EN)--> - vkládá měsíční kalendář pro kalendář s ID=2 a pro jazyk angličtina
<!--WTD_DIARYCALENDAR(2)--> - vkládá měsíční kalendář pro kalendář s ID=2, jako jazyk se použije jazyk stránky, která se generuje.
Styl pro formátování měsíčního kalendáře se nastavuje v nabídce Nastavení - název jazyka - Předpisy - název předpisu - Samostatný kalendář.
