Flashový kalendář – vzorový XML soubor
Pokud nechcete nebo nemůžete používat administrační rozhraní a chcete v kalendáři zobrazovat události, musíte vytvořit a spravovat XML soubor, který potom namapujete do kalendáře pomocí jeho nastavení.
Zdrojový kód
Pro správnou podporu národních znaků musí být XML soubor uložen v kódové stránce UTF-8.
<?xml version="1.0" encoding="utf-8"?>
<xmldates>
<colors>
<color name="Rezervováno" back="FFC070" front="FF0000" />
<color name="Předběžně" back="E6E6E6" front="505050" />
<color name="Dovolená" back="607FF0" front="20007F" />
</colors>
<dates>
<year year="2011">
<month month="7">
<day day="15" type="Rezervováno">Práce v Praze od 8.00 do 11.00</day>
<day day="17" type="Předběžně">Práce v Brně</day>
<day day="22" type="Dovolená">Dovolená v Rakousku</day>
</month>
<month month="8">
<day day="4" type="Rezervováno">Svatba v Brně\npan Novák</day>
</month>
</year>
<year year="2012">
<month month="1">
<day day="4" type="Rezervováno">Svatba v Líšni\nsl. Novotná</day>
<day day="11" type="Rezervováno">Svatba Šlapanice\n,sl. Nováčková</day>
</month>
<month month="3">
<day day="3" type="Předběžně">Práce pro BVV</day>
</month>
</year>
</dates>
</xmldates>
Popis
XML soubor (uložený ve znakové sadě UTF-8) je rozdělen do dvou sekcí. V první sekci <colors></colors> jsou definovány kategorie kalendáře, v sekci <dates></dates> jsou uložena data s popisy jednotlivých dní. Obě sekce jsou uvnitř kořenového elementu <xmldates></xmldates>. Názvy všech atributů jednotlivých elementů musí být napsány malými písmeny a jejich hodnoty uzavřeny v uvozovkách.
Před kořenovým elementem je jako první uveden XML prolog <?xml version="1.0" encoding="utf-8"?>.
Sekce <colors></colors>
V této sekci se deklarují jednotlivé kategorie. Každá kategorie, která je identifikována podle svého jména, může být uvedena pouze jednou. Kategorie je deklarována elementem <color /> podle následujícího schématu:
<color name="jmeno_kategorie" back="barva" front="barva" />
V této deklaraci jsou všechny atributy povinné.
Atributy
Hodnota atributu name znamená jméno kategorie. Jméno kategorie smí být jen jednoslovní výraz (bez mezer).
Hodnota atributu back a front jsou hodnoty barev textu (front) a pozadí (back) políčka dne kalendáře, ve kterém se vyskytuje událost této kategorie. Hodnota barvy se musí uvést v hexadecimálním webovém formátu RRGGBB, kde znaky RR jsou nahrazeny hodnotou červeného kanálu v šestnáctkové soustavě, GG zeleného kanálu a BB modrého kanálu.
Pozn.: Pro získání odpovídající barvy můžete využít například online nástroj Colorpicker. Pokud použijete administrační rozhraní kalendáře, budete mít volbu barev políčka stejně jako vytváření celého XML souboru značně zjednodušenu.
Sekce <dates></dates>
V této sekci jsou uvedeny v hierarchickém pořadí dny, ve kterých nastane nějaká událost. Nejdříve jsou v elementech <year></year> uvedeny roky. V nich jsou v elementech <month></month> uvedeny měsíce a teprve v nich jsou v elementech <day></day> uvedeny události jednotlivých dnů.
Pokud se v daném roce, resp. měsíci nevyskytuje žádná událost, nemusí se psát.
Element <year></year>
<year year="2011">
…
</year>
Uvnitř tohoto elementu se smí nacházet jen elementy <month></month>. Povinným atributem je atribut year, který čtyřciferným číslem určuje rok události.
Element <month></month>
<month month="5">
…
</month>
Uvnitř tohoto elementu se smí nacházet jen elementy <day></day>. Povinným atributem je atribut month, který číselným vyjádřením určuje pořadí měsíce v roce (leden = 1, prosinec = 12).
Element <day></day>
<day day="13" type="název_kategorie">
Popis události dne
</day>
Povinnými atributy tohoto elementu jsou day, který reprezentuje číslo dne v daném měsíci, kdy se koná událost, a type, který odpovídá jedné z kategorií, která byla uvedena v sekci <colors></colors>. Pokud kategori nebude nalezena, událost se nezpracuje.
Obsahem atributu je popis události dne.
Pozn.: Ačkoliv nic nebrání tomu mít na jeden a tentýž den definováno více událostí, políčko dne bude mít v kalendáři barvu textu a pozadí podle kategorie poslední uvedené události.
Pozn.: V případě, že potřebujete zalomit řádek, napište v místě zalomení znaky \n. Znak zpětného lomítka (\) napíšete na české klávesnici v systému Windows pomocí klávesové zkratky AltGr + Q (AltGr leží na pravé straně mezerníku).