Flashový kalendář – nastavení
Pokud si chcete ulehčit vytvoření konfigurace kalendáře, použijte generátor nastavení Flashového kalendáře, kde přesně uvidíte, co se při určitém nastavení stane s kalendářem.
Úvod
Veškerá nastavení se do kalendáře přenáší pomocí speciálního řetězce, tzv. flashvars. Ten se umisťuje do HTML kódu pomocí značky <param /> do míst, kde se vkládá kód pro vložení kalendáře.
Pro usnadnění a větší komfort lze pomocí JavaScriptu Swfobject tento řetězec vložit mnohem snadněji.
Obecně platí následující syntaxe:
<param name="flashvars" value="vlastnost=hodnota">
kde vlastnost je název vlastnosti a hodnota je její hodnota.
Pokud chcete zadat více vlastností najednou, spojte jednotlivé vlastnosti znakem &:
<param name="flashvars" value="vlastnost1=hodnota1&vlastnost2=hodnota2">
Pozn.: Pokud používáte typ dokumentu XHTML, je nutné místo znaku & vkládat textovou entitu &: <param name="flashvars" value="vlastnost1=hodnota1&vlastnost2=hodnota2">.
Pokud pro vkládání kalendáře použijete JavaScript Swfobject, který je použit pro vkládání kalendáře v jednoduché variantě s JavaScriptem a plné variantě, je zadávání flashvars ještě jednodušší. Do odpovídajícího místa v hlavičce stránky ve značce <script></script> se vloží tento kód:
flashvars.vlastnost1 = "hodnota1";
flashvars.vlastnost2 = "hodnota2";
Pokud si chcete práci s nastavením kalendáře ulehčit, použijte generátor nastavení!
Vlastnosti
- todayTextColor
- todayBackgroundColor
- sundayTextColor
- sundayBackgroundColor
- controlColor
- backgroundColor
- borderColor
Při zadávání je třeba dbát na správně zapsané názvy vlastností i hodnot. Zejména se jedná o psaní malých a velkých písmen!
xmlFile
Hodnotou této vlastnosti je cesta k XML souboru, ve kterém jsou uložena data. XML soubor musí kvůli bezpečnostním zásadám ležet ve stejné doméně, jako leží kalendář! Nelze tedy mít kalendář v domémě www.mojestranky.cz a odkazovat na XML soubor ležící v doméně www.jinestranky.cz!
Pokud používáte administrační rozhraní, nasměrujte tuto vlastnost na soubor xml.php.
Pozn.: Pokud cestu k XML souboru nezadáte, nebude kalendář zobrazovat žádné události!
Příklad
<param name="flashvars" value="xmlFile=xml.php">
flashvars.xmlFile = "xml.php";
days
V této vlastnosti se uvádí zkrácené dvoupísmenné názvy dní týdne, které se od sebe oddělí čárkou. Jejich počet musí být přesně sedm! První den uvedený v této vlastnosti bude umístěn do prvního sloupce kalendáře.
Pozn.: Pokud tuto vlastnost neuvedete, budou názvy dní v kalendáři české a první den bude pondělí.
Příklad
<param name="flashvars" value="days=su, mo, tu, we, th, fr, sa">
flashvars.days = "su, mo, tu, we, th, fr, sa";
months
Hodnotou této vlastnosti jsou názvy měsíců, které se od sebe oddělí čárkou. Jejich počet musí být přesně dvanáct! Posloupnost měsíců pak bude odpovídat poslopnosti měsíců v kalendáři.
Pozn.: Pokud tuto vlastnost neuvedete, budou názvy měsíců v kalendáři české.
Příklad
<param name="flashvars" value="January, February, March, April, May, June, July, August, September, October, November, December">
flashvars.months = "January, February, March, April, May, June, July, August, September, October, November, December";
firstday
Tato vlastnost určuje, který sloupec bude v kalendáři formátován jako neděle. Pokud je hodnotou této vlastnosti 0, bude jako neděle formátován první sloupec. Pokud uvedete jako hodnotu číslo 1, bude jako neděle formátován poslední sloupec kalendáře.
Pozn.: Pokud tuto vlastnost neuvedete, bude se jako neděle formátovat poslední sloupec v kalendáři.
Příklad
<param name="flashvars" value="firstday=0">
flashvars.firstday = "0";
animation
Tato vlastnost definuje způsob animace políček dní při přechodu mezi měsíci, resp. roky. Povolené jsou jen hodnoty 0, 1, 2 nebo 3:
- 0: žádná animace
- 1: při změně měsíce, resp. roku, dochází k přesouvání políček dní po skupinách zleva doprava a obráceně.
- 2: při změně dochází k přesouvání políček dnů tak, že se políčka nejdříve vrátí na střed kalendáře a poté se přesunou na své nové místo. Při prvním načtení kalendáře se políčka na své místo rozbíhají rovněž ze středu.
- 3: při načtení kalendáře se provede animace jako ve variantě 2, při změně měsíců resp. roků se políčka animují jako ve variantě 1.
Pozn.: Pokud tuto vlastnost neuvedete, nebude se provádět žádná animace.
Příklad
<param name="flashvars" value="animation=2">
flashvars.animation = "2";
showControls
Touto vlastností ovlivňujete, zda se zobrazí ovládací prvky pro změnu měsíce a roku. Povoleny jsou jen hodnoty true nebo false. Pokud zvolíte hodnotu false, ovládací prvky se skryjí, pokud zadáte hodnotu true, ovládání bude vidět.
Pozn.: Pokud tuto vlastnost neuvedete, budou ovládací prvky viditelné.
Příklad
<param name="flashvars" value="showControls=false">
flashvars.showControls = "false";
showCategory
Touto vlastností ovlivňujete, zda se bude v detailu události dne ukazovat na prvním (resp. druhém) řádku název kategorie. Povoleny jsou jen hodnoty true nebo false. Pokud zvolíte hodnotu false, kategorie se nezobrazí, pokud zadáte hodnotu true, kategorie bude zobrazena.
Pozn.: Pokud tuto vlastnost neuvedete, bude název kategorie v detailu vidět.
Příklad
<param name="flashvars" value="showCategory=false">
flashvars.showCategory = "false";
showDate
Touto vlastností ovlivňujete, zda se bude v detailu události dne ukazovat na prvním řádku datum události. Povoleny jsou jen hodnoty true nebo false. Pokud zvolíte hodnotu false, datum se nezobrazí, pokud zadáte hodnotu true, datum bude zobrazen.
Pozn.: Pokud tuto vlastnost neuvedete, bude datum události v detailu vidět.
Příklad
<param name="flashvars" value="showDate=false">
flashvars.showDate = "false";
fontsize
Touto vlastností nastavujete jakou velikostí písma (v pixelech) budou zapsány čísla a názvy dnů a název měsíce. Povolená jsou jen kladná celá čísla. Toto nastavení nemá vliv na velikost textu v detailu dne.
Pozn.: Pokud tuto vlastnost neuvedete, bude velikost písma 14 pixelů.
Příklad
<param name="flashvars" value="fontsize=12">
flashvars.fontsize = "12";
dayTextColor
Barva textu políčka všedního dne, v němž se nevyskytuje žádná událost, měsíce s rokem a názvů dní. 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.: Pokud tuto vlastnost neuvedete, bude barva textu bílá (FFFFFF).
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 zjednodušenu.
Příklad
<param name="flashvars" value="dayTextColor=FFFFFF">
flashvars.dayTextColor = "FFFFFF";
dayBackgroundColor
Barva pozadí políčka všedního dne, v němž se nevyskytuje žádná událost, a názvů dní. 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.: Pokud tuto vlastnost neuvedete, bude barva pozadí tmavě šedá (222222).
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 zjednodušenu.
Příklad
<param name="flashvars" value="dayBackgroundColor=222222">
flashvars.dayBackgroundColor = "222222";
borderDayColor
Barva rámečku políčka dne a názvů dní. 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.: Pokud tuto vlastnost neuvedete, bude barva rámečku černá (000000).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="borderDayColor=000000">
flashvars.borderDayColor = "000000";
todayTextColor
Barva textu aktuálního dne. 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.: Pokud tuto vlastnost neuvedete, bude barva textu světle zelená (E0FFE0).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="todayTextColor=E0FFE0">
flashvars.todayTextColor = "E0FFE0";
todayBackgroundColor
Barva pozadí aktuálního dne. 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.: Pokud tuto vlastnost neuvedete, bude barva pozadí tmavě zelená (003C00).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="todayBackgroundColor=003C00">
flashvars.todayBackgroundColor = "003C00";
sundayTextColor
Barva textu neděle. 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.: Pokud tuto vlastnost neuvedete, bude barva textu neděle červená (FF6666).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="sundayTextColor=FF6666">
flashvars.sundayTextColor = "FF6666";
sundayBackgroundColor
Barva pozadí neděle. 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.: Pokud tuto vlastnost neuvedete, bude barva pozadí neděle tmavě červená (330000).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="sundayBackgroundColor=330000">
flashvars.sundayBackgroundColor = "330000";
controlColor
Barva ovládacích prvků pro změnu měsíce, resp. roku. 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.: Pokud tuto vlastnost neuvedete, bude barva ovládacích prvků bílá (FFFFFF).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="controlColor=FFFFFF">
flashvars.controlColor = "FFFFFF";
backgroundColor
Barva pozadí kalendáře. 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.: Pokud tuto vlastnost neuvedete, bude barva pozadí kalendáře tmavě šedá (222222).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="backgroundColor=222222">
flashvars.backgroundColor = "222222";
borderColor
Barva ohraničovacího rámečku kalendáře. 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.: Pokud tuto vlastnost neuvedete, bude barva ohraničení kalendáře tmavě šedá (222222).
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 značně zjednodušenu.
Příklad
<param name="flashvars" value="borderColor=222222">
flashvars.borderColor = "222222";