WebToDate/Extenze/Extenze pro výpis seznamu příloh

Funkcionalita

Touto extenzí lze v seznamu zpráv zobrazit u každé zprávy několik vybraných příloh ke zprávám. Modelovým nasazením je zobrazení seznamu fotogalerií. Každá fotogalerie je WebToDate zpráva, standardními prostředky WebToDate lze jednoduše zobrazit seznam takovýchto zpráv - galerií a u každé zprávy např. jeden náhled fotografie. Náhledy všech fotografií se pak zobrazí až po kliku na detail zprávy. Pokud ale chceme už v seznamu fotogalerií zobrazit např. první tři náhledy, lze to řešit např. pomocí této extenze.

Dále extenze podporuje možnost u zprávy (v seznamu či detailu) vybrat a vložit jeden z obrázků připojených ke zprávě (ať už samostatně nebo např. ke galerii), který je rozměrově nejvhodnější.

Instalace

Chcete-li tuto funkci aktivovat ve staticky generovaných stránkách, do souboru config/_genmodules_inc.php vložte následující kód:

// - extenze attachmlist
$$arrModules[] = 'nobjects/_attachmlist_inc.php';

Chcete-li funkci aktivovat v dynamicky vložených seznamech na stránkách, vložte stejný kód do souboru config/_modules_inc.php.

Ujistěte se, že v instalaci WebToDate existuje soubor /scripts/modules/nobjects/_attachmlist_inc.php.

Reference

Extenze používá klíčové slovo

<!--WTD_ATTACHMLIST(ID zprávy, ID druhu seznamu, ID stylu pro zobrazení, max. počet položek)-->

ID druhu seznamu je zde ID, které lze zjistit v seznamu položek v nabídce Administrace - Druhy seznamů (viz Druhy seznamů příloh).

V praxi se tedy použije např.

<!--WTD_ATTACHMLIST(<!--WTD_F(ID)-->,2,16,3)-->

Za <!--WTD_F(ID)--> se při sestavování HTML kódu seznamu dosadí ID zprávy. Dále 2 je zde ID druhu seznamu (většinou druh používaný pro fotogalerie), 16 je ID stylu (jedná se o styl pro zdroje, kterým se formátuje seznam příloh - fotografií), zobrazují se max. 3 položky.

Jednoduchý WebToDate styl, který se v tomto příkladu dá použít pro zobrazení několika obrázků z galerie je

Hlavička

<div class="fotogal">

Tělo

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

Patička

</div>

Výsledek pak může (pro jednu položku seznamu zpráv) vypadat cca následovně:

Druhé klíčové slovo které extenze podporuje je

<!--WTD_IMGFIT(ID_zprávy, šířka_obrázku, procenta_možného_zmenšení, class, alt)-->

Význam parametrů je následující:

• ID_zprávy - ID zprávy u níž se hledají připojené obrázky - vyberou se všechny připojené obrázky které jsou ve zdrojích ve stavu publikováno nebo archivováno; jaké přípony jsou platné pro obrázky se určuje podle funkce Typy souborů
• šířka obrázku - vybere se obrázek s nejbližší zde zadanou šířku, buď touto nebo větší, nebo v případě že žádný takový neexistuje, tak menší, ale jen maximálně dle dalšího parametru
• procenta_možného_zmenšení - např. 70%, znamená, že pokud se bude vkládat menší šířka obrázku, nesmí být menší než zde zadaná procenta, tj. pokud předchozí parametr bude 1000, skutečný obrázek nesmí být na šířku menší než 700
• class - hodnota se vkládá do atributu class obrázku
• alt - hodnota se vkládá do atributu alt obrázku

Za klíčové slovo se dosazuje celý img tag, pokud se nenajde žádný obrázek dle uvedených kritérií, tak prázdný řetězec.