WebToDate/Referenční/Styly

Co je WebToDate styl

Styl je určení HTML formátu, ve kterém bude zpráva či jiný typ objektu formátován na stránce. K definici stylu se používá kód HTML, do kterého lze pomocí klíčových slov vkládat umístění jednotlivých polí zpráv. Při generování stránky se pak na místo klíčových slov vloží konkrétní hodnota polí zpráv. Používáním stylů je zajištěno rychlé, snadné a jednotné formátování zpráv.

Vytvoření nového stylu

V systému WebToDate lze vytvářet libovolné množství stylů, přičemž jeden styl může být přiřazen jako výchozí k více oblastem najednou.

Vytvoření nového stylu

1. V hlavní nabídce klepněte na položku Styly. Zobrazí se seznam stylů.
2. Nad seznamem klepněte na odkaz Přidat. Zobrazí se dialog Nový styl.
3. Do pole Název napište název nového stylu.
4. Do pole Nápověda napište krátkou nápovědu, která ostatní uživatele informuje o vlastnostech nově vytvořeného stylu. Tato nápověda se objeví v seznamu stylů ve sloupci Nápověda.
5. Položka Zařazení umožňuje specifikovat, zda daný styl patří ke zprávám, diskusím, či jiným modulům. Každý styl lze řadit do právě jedné kategorie, kde seznam kategorií se shoduje se seznamem používaným pro kategorie předloh. Ve WebToDate a modulech pak jsou kontextově nabízeny pouze styly příslušné dané kategorii (při definování toho, který styl lze aplikovat na danou oblast, pouze styly pro zprávy, v modulu Diskuze pouze styly pro diskuse apod.).
6. Do pole Tělo napište definici nového stylu. Definice se skládá z HTML příkazů, do kterých lze vkládat dynamicky měnitelná pole. Seznam použitelných polí lze zobrazit klepnutím na tlačítko "?".
7. V záložce Oblasti naplňte pole Přiřazené oblasti těmi názvy oblastí, pro něž se má tento styl nabízet při vkládání na stránku (viz kapitola Oblasti). K přidávání či odebírání oblastí použijte šipky mezi poli.

Klepnutím na tlačítko Přidat zapíšete nově vytvořený styl do databáze.

Kromě těla jsou v definici stylu k dispozici ještě další pole, které umožňují přidávat hlavičky a patičky i dělit položky na stránce do sekcí. Jejich použití (tj. zda budou vůbec vloženy do stránky a v jaký moment) je závislé na typu formátovaného objektu, viz níže.

Následující seznam obsahuje odkazy na tabulky klíčových slov WebToDate a modulů používaných ve stylech a předlohách. WebToDate Klíčová slova použitelná ve stylech a předlohách pro zprávy Klíčová slova použitelná ve stylech a předlohách pro zdroje Podmíněné vkládání obsahu polí do stránek Klíčová slova použitelná ve stylech pro formátování seznamů Klíčová slova použitelná v definici stránkování seznamů Klíčová slova pro listování fotogaleriemi Klíčová slova pro vkládání navigací Klíčová slova pro formátování částí obsahu (platí nejen pro WebToDate, ale i pro moduly Poradny a rozhovory, Formuláře a katalogy, Výpisy zpráv, Kalendář akcí, Diskuze, Fulltext, Fulltext Google, Soutěže) Klíčová slova pro podporu vícejazyčných webů Moduly WebToDate Klíčová slova modulu Ankety Klíčová slova modulu Diskuze Klíčová slova modulu Formuláře a katalogy Klíčová slova modulu Fulltext Klíčová slova modulu Fulltext Google Klíčová slova modulu Kalendář akcí Klíčová slova modulu Poradny a rozhovory Klíčová slova modulu Publikace a vydání Klíčová slova modulu Registrace a personalizace Klíčová slova modulu Rozesílání e-mailem Klíčová slova modulu Soutěže Klíčová slova modulu Stránkování zpráv Klíčová slova modulu Veřejné zakázky Klíčová slova modulu Výpisy zpráv

Úprava stylu

Vlastnosti nadefinovaných stylů lze upravovat pomocí dialogu Úprava stylu. Vyvoláte jej klepnutím na příslušný název stylu v seznamu stylů.

Klepnutím na tlačítko Uložit se provedené změny uloží do databáze.

Klepnutím na tlačítko Smazat daný styl z databáze odstraníte.

Tip: pro úpravy stylů je výhodné používat zabudovaný celostránkový editor. Po jeho otevření (tlačítkem nalevo od pole Tělo) naleznete vpravo nahoře rozvírací nabídku Vložit pole; výběrem z ní můžete do definice stylu vložit některé z povolených polí zprávy.

Styly pro jednotlivé typy obsahu

Tato kapitola obsahuje ukázky kódů WebToDate stylů. Seznamy klíčových slov použitých ve stylech naleznete v kapitole Klíčová slova WebToDate.

Styly pro zprávy

Příklad 1

Následující kód lze použít jako tělo stylu pro zprávu umístěnou na stránce. Zpráva bude zobrazovat nadpis s odkazem, datum a popis (klíčová slova typu WTD_F).

<div>
<img src="/images/curview.gif" width="5" height="6" border="0"> <a href="<!--WTD_F(TITLELINK)-->"><strong><!--WTD_F(TITLE)--></strong></a> (<!--WTD_F(DATE)-->)
<br />
<!--WTD_F(DESCRIPTION)-->
</div>

Příklad 2

Následující kód opět formátuje jednu zprávu na stránce. Oproti předchozímu příkladu navíc vkládá jméno autora zprávy a obrázek ke zprávě, který ale vkládá podmíněně pouze v případě, že je pole Obrázek ve zprávě neprázdné (konstrukce WTD_IF(PICNOTNULL,"… ")).

<div class="zpr1">
<!--WTD_IF(PICNOTNULL,"<!--WTD_F(PIC)-->")-->
<a href="<!--WTD_F(TITLELINK)-->"><!--WTD_F(TITLE)--></a> (<!--WTD_F(DATE)-->, <!--WTD_F(SOURCE)-->)
<br />
<!--WTD_F(DESCRIPTION)-->
</div>

Styly pro seznamy

Styly pro seznamy zpráv jsou analogií stylů pro zprávy. Používají stejná klíčová slova, pouze často využívají další pole stylů jako Hlavička či Patička.

Příklad 1

Tento styl formátuje seznam zpráv obsahující jednoduchý výpisy zpráv se zvolenou hlavičkou, pro každou zprávu se zde zobrazí nadpis s odkazem, datum a popis.

Hlavička

<div>
<span style="background-color:#eeeedd;width:100%;font-size:medium;">
<a href="/zahranicni/"><strong>Zahraniční zprávy</strong></a>
</span>

Tělo

<div style="width:100%;background-color:#efefef; padding:6px;">
<div style="font-size:xx-small;"><!--WTD_F(DATE)--></div>
<b><a href="<!--WTD_F(TITLELINK)-->" class="poutaklink"><!--WTD_F(TITLE)--></a></b>
<div style="font-size:x-small;">
<!--WTD_F(DESCRIPTION)-->
</div>
</div>

Patička

</div>

Příklad 2

Tento příklad zobrazuje seznam zpráv ve formě HTML tabulky ve dvou sloupcích.

Hlavička

<table>

Tělo

<td valign="top">
<!--WTD_IF(ROWNOTEMPTY,"<img src="/images/curview.gif" width="5" height="6" border="0"> <a href="<!--WTD_F(TITLELINK)-->"><strong><!--WTD_F(TITLE)--></strong></a> (<!--WTD_F(DATE)-->)<br /><!--WTD_F(DESCRIPTION)-->")-->
</td>

Patička

</table>

Začátek sekce

<tr>

Konec sekce

<tr>

Styly pro instance souborů ze zdrojů ve zprávách

Ve všech následujících příkladech se jedná pouze o tělo stylu.

Příklad 1

Odkaz na soubor ke stažení v textu lze definovat např. následujícím stylem:

<a href="<!--WTD_ASSET(FILEURL)-->"><!--WTD_ASSET(TITLE)--></a>

Příklad 2

Obrázek vložený do těla zprávy může být definován např. následovně:

<img src="<!--WTD_ASSET(FILEURL)-->" alt="<!--WTD_ASSET(TITLE)-->" width="<!--WTD_ASSET(FILEWIDTH)-->" height="<!--WTD_ASSET(FILEHEIGHT)-->" align="left" border="0" hspace="6">

Příklad 3

Styl pro obrázek vložený do těla zprávy, na který lze kliknout a otevírá v novém okně master soubor vypadá např. následovně:

<a href="<!--WTD_ASSET(MASTERFILEURL)-->" target="_blank"><img src="<!--WTD_ASSET(FILEURL)-->" alt="<!--WTD_ASSET(TITLE)-->" width="<!--WTD_ASSET(FILEWIDTH)-->" height="<!--WTD_ASSET(FILEHEIGHT)-->" align="left" border="0" hspace="6"></a>

Příklad 4

Styl pro obrázek vložený do těla zprávy, na který lze kliknout a otevírá v novém okně HTML stránku s master souborem a textovými popisky podle příslušné předlohy vypadá např. následovně:

<a href="<!--WTD_ASSET(TITLELINK)-->" target="_blank"><img src="<!--WTD_ASSET(FILEURL)-->" alt="<!--WTD_ASSET(TITLE)-->" width="<!--WTD_ASSET(FILEWIDTH)-->" height="<!--WTD_ASSET(FILEHEIGHT)-->" align="left" border="0" hspace="6"></a>

Jak se styly aplikují na jednotlivé elementy WebToDate při sestavování stránky

Aplikace stylů při sestavování stránky je následující:

Tělo stylu se aplikuje na každou zprávu přiřazenou na stránku a na zprávu v seznamu.

Hlavička a patička se aplikují na každou zprávu přímo přiřazenou na stránku nebo na seznamy. V definici WebToDate seznamu lze nadefinovat dělení seznamů (např. podle data), tj. seznam je pak dělen na sekce (např. co jedno unikátní datum, to sekce), kde každá sekce má svůj vlastní formátovací kód. Hlavička se pak aplikuje na začátek seznamu a patička na konec (u všech druhů seznamů), na formátování začátku a konce sekce se používají pole Začátek sekce a Konec sekce. Z uvedeného vyplývá, že pole Hlavička a Patička jsou vhodná hlavně pro seznamy; pro jednotlivé zprávy umístěné na stránky nemají příliš význam. Kód, který se vkládá mezi jednotlivé záznamy seznamu, lze určit v poli Separátor.

Poznámka: Podrobný popis používání polí Hlavička, Patička, Začátek a Konec sekce i Separátor naleznete včetně příkladů v kapitole Seznamy.

Doporučení pro práci se styly

Pokud vytváříte styl, který je podobný již existujícími stylu a aplikuje se na stejné oblasti, využijte možnosti duplikace stylů. Ušetříte si tak přinejmenším potřebu nastavovat seznam oblastí na stránce, na které je styl použitelný.

Pečlivě zvažte při implementaci styly a jejich možné aplikace na oblasti. Je žádoucí, aby uživatelé - editoři týmů měli vždy k dispozici pouze omezený počet stylů, které jsou v daný moment skutečně aplikovatelné. Nastavte proto pro každý styl tyto aplikovatelné oblasti (resp.naopak, tato definice je v podstatě identická ve formuláři pro styl i ve formuláři pro oblast). Lepší než vytváření univerzálních oblastí, u kterých lze použít větší množství stylů ale ne každý styl na každé stránce, na které se oblast nachází, je nadefinovat více různých oblastí s menším množstvím aplikovatelných stylů.

Pokud plánujete vícejazyčnou prezentaci, preferujte vytváření stylů, které nemají žádné viditelné texty. Zabráníte tak nutnosti vytvářet styly pro každý jazyk zvlášť.

Styly a moduly WebToDate

V databázi stylů se ukládají styly, které jsou určeny nejen pro vlastní aplikaci (styly pro zprávy, seznamy a zdroje), ale i pro instalované moduly. Pro tyto styly používejte pečlivě kategorizaci pomocí Zařazení. Každý modul nabízí kontextově styly odpovídající jeho zařazení a ušetříte tak práci pří výběru stylu.

Naprostá většina modulů má svoje vlastní slovníky klíčových slov (značek), které se ve stylech používají, seznamte se proto vždy nejprve s dokumentací daného modulu.