⋮ Obsah

Plugin Gallery

Parametr Výchozí hodnota Popis
<number>x<number> 150x150 Nastaví velikost náhledů. Pokud není aktivní volba oříznutí, jedná se o ohraničující rámeček, do kterého se náhled přizpůsobí při zachování poměru stran.
<number>X<number> 1600X1200 Nastaví maximální velikost obrázků při zobrazení v lightboxu. Jedná se o ohraničující rámeček, do kterého se obrázek přizpůsobí při zachování poměru stran. Pozor na velké X. Jedná se o maximum – lightbox automaticky zmenší obrázek podle velikosti obrazovky.
<number> 0 Počet obrázků na řádek v tabulce galerie. Pokud zadáte 0, obrázky se přizpůsobí automaticky.
=<number> =0 Omezí výstup na daný počet obrázků. 0 znamená všechny.
+<number> +0 Přeskočí prvních několik obrázků. Užitečné ve spojení s předchozí volbou.
~<number> ~0 Přidá stránkování náhledů s daným počtem obrázků na stránku. 0 stránkování vypne. Stránkování je přidáno pomocí JavaScriptu – pokud není JavaScript dostupný, zobrazí se všechny náhledy.
cache enabled Výstup vytvořené galerie se obvykle ukládá do mezipaměti. Pokud se obrázky ve vybraném jmenném prostoru změní, je třeba ručně vynutit aktualizaci stránky galerie (mezipaměť). Pro vypnutí mezipaměti nastavte volbu nocache.
crop enabled Vytvoří náhledy přesně ve zvolené velikosti, ořízne je podle potřeby.
direct disabled Propojí náhledy přímo s originálem místo s detailní stránkou.
lightbox enabled Zobrazí obrázky v elegantním JavaScriptovém modálním okně. Podrobnosti viz níže.
reverse disabled Obrátí pořadí zobrazených obrázků.
recursive enabled Vyhledá obrázky ve zvoleném jmenném prostoru a všech jeho podprostorech.
random disabled Seřadí obrázky náhodně. Doporučuje se použít i volbu nocache.
modsort disabled Seřadí obrázky podle data poslední úpravy souboru.
datesort disabled Seřadí obrázky podle data vytvoření z EXIF informací.
titlesort disabled Seřadí obrázky podle názvu z EXIF informací.
showname disabled Zobrazí název souboru pod náhledy.
showtitle disabled Zobrazí EXIF značku Headline jako titulek pod náhledy.
showcaption disabled Zobrazí EXIF značku Caption jako popisek pod náhledy.
cokoliv obsahující * (hvězdičku) Lze použít pro filtrování seznamu souborů ve zvoleném jmenném prostoru. * funguje jako jednoduchý zástupný symbol (wildcard).
full,left,center,right full Zarovnání jak je popsáno výše.

Gallery Plugin

Tento Syntax plugin umožňuje vložit automaticky vytvořenou galerii obrázků na stránku

screenshot_img:

—-

Tento plugin zobrazí seznam miniatur obrázků s odkazy na jejich větší verze.

Syntaxe

Obrázky lze vybírat ze tří různých zdrojů a lze použít různé zarovnání a options (volby).

Zdroj: Jmenný prostor / Obrázek

Galerii můžeš přidat zadáním jmenného prostoru takto: 

{{gallery>:jmenny_prostor}}

Všechny obrázky v tomto jmenném prostoru budou přidány do galerie. Nezapomeň na dvoutečku před jmenným prostorem.

Místo celého jmenného prostoru můžeš také specifikovat jeden obrázek: 

{{gallery>:jmenny_prostor:nazevobrazu.jpg}}

Options (viz níže) se přidávají za jmenný prostor / obrázek, oddělují se otazníkem ?. 

{{gallery>:jmenny_prostor:nazevobrazu.jpg?volby}}

Zdroj: Media Feed

Místo jmenného prostoru můžeš také uvést HTTP(s) URL na RSS nebo ATOM feed obsahující obrázky (když ho například vytvoří většina foto serverů jako Flickr): 

{{gallery>https://www.23hq.com/rss/schabloni}}

Poznámka: protože otazník se používá k oddělení options, nemůže URL obsahovat otazník (?). Pokud URL obsahuje, použij některý z URL zkracovačů, např. https://bit.ly.

Volby opět přidáváš za otazník ?. 

{{gallery>https://www.23hq.com/rss/schabloni?volby}}

Zdroj: Seznam obrázků

Jiný způsob přijímá seznam obrázků, každý na samostatném řádku. Obrázky mohou být lokální i externí. options patří do otevíracího tagu. 

<gallery volby>
:jmenny_prostor:obrazek.jpg
https://example.com/obrazek2.jpg
</gallery>

Tento režim dovoluje také manuální nastavení titulku a popisku obrázku. Titulek se odděluje mezerou od názvu obrázku, popisek oddělíš znakem |. 

<gallery volby>
:jmenny_prostor:obrazek.jpg Můj kůň | Podívej se na mého koně, je úžasný!
https://example.com/obrazek2.jpg Titulek jen
</gallery>

Zarovnání

Galerie může být zarovnána 4 způsoby:

Zarovnání se nastavuje buď výše uvedeným klíčovým slovem v options nebo mezerou (kromě režimu seznamu): 

{{gallery> jmenny_prostor?volby}} (zarovnáno vpravo)  
{{gallery>jmenny_prostor?volby }} (zarovnáno vlevo)  
{{gallery> jmenny_prostor?volby }} (zarovnáno na střed)

Volby

Parametry nastavuješ vypsáním za otazník v syntaxi, oddělují se znakem & nebo mezerou. Výchozí hodnoty lze nastavit v konfiguraci pluginu. Pokud je parametr aktivní ve výchozím nastavení, můžeš ho zakázat přidáním předpony no. Například parametr cache je normálně zapnutý a zakážeš ho pomocí nocache. Následuje seznam rozpoznaných parametrů:

Parameter Výchozí hodnota Popis
<číslo>x<číslo> 150x150 Nastaví velikost miniatur. Pokud není použito crop, miniatura se přizpůsobí do tohoto rámečku při zachování poměru stran.
<číslo>X<číslo> 1600X1200 Nastaví maximální velikost obrázků pro zobrazení v lightboxu. Jedná se o rámeček, do kterého se obrázek přizpůsobí s uložením poměru stran. Pozor na velké písmeno X. Lightbox automaticky zmenší obrázek, pokud je větší než obrazovka.
<číslo> 0 Počet obrázků na řádek v galerii. Pokud je zadáno 0, obrázky se automaticky přizpůsobí.
=<číslo> =0 Omezí výstup na daný počet obrázků. 0 znamená všechny.
+<číslo> +0 Přeskočí prvních daný počet obrázků. Užitečné s předchozím parametrem.
~<číslo> ~0 Přidá stránkování, které zobrazuje daný počet náhledů na stránku. 0 stránkování vypíná. Přidáno přes JavaScript - pokud je JavaScript vypnutý, zobrazí se všechny náhledy.
cache zapnuto Výstup galerie je obvykle cachován. Při změně obrázků v jmenném prostoru musíš ručně vyprázdnit cache galerie. Pro vypnutí cache na dané stránce použij nocache.
crop zapnuto Miniatury jsou přesně oříznuty na zadanou velikost.
direct vypnuto Link miniatur je směřován na originální obrázek místo na detailní stránku
lightbox zapnuto Obrázky se zobrazují ve fancy JavaScript okně (modal) - viz níže.
reverse vypnuto Obrátí pořadí obrázků v galerii
recursive zapnuto Hledá obrázky v daném jmenném prostoru a ve všech podprostorech
random vypnuto Náhodné řazení obrázků. Vhodné kombinovat s nocache.
modsort vypnuto Řazení obrázků podle data poslední změny
datesort vypnuto Řazení obrázků podle data EXIF vytvoření
titlesort vypnuto Řazení obrázků podle EXIF tagu Headline
showname vypnuto Zobrazení názvu souboru pod miniaturami
showtitle vypnuto Zobrazení EXIF tagu Headline jako titulku pod miniaturami
showcaption vypnuto Zobrazení EXIF tagu Caption jako popisku pod miniaturami
cokoli obsahující * (hvězdičku) Můžeš použít k filtrování souborů v daném jmenném prostoru. * je jednoduchý wildcard symbol.
full, left, center, right full Zarovnání jak je popsáno výše

Příklad

{{gallery>obrazky:dovolena?image_*.jpg&80x80&nocrop&showtitle}}

Zobrazí všechny obrázky začínající na image_ a končící na .jpg z jmenného prostoru obrazky:dovolena. Miniatury nebudou oříznuté a ve velikosti 80x80 pixelů. Titulky obrázků budou zobrazeny v galerii.

Příklad

{{gallery>?crop&lightbox}}

Zobrazí všechny obrázky v aktuálním jmenném prostoru s 2 parametry. Volby začínají otazníkem ? a jednotlivé odděluješ znakem &.

O lightbox režimu

Tento režim otevře kliknutý obrázek uvnitř aktuálního okna prohlížeče bez toho, aby stránku opustil.

Obrázek zavřeš kliknutím na tlačítko X v pravém horním rohu. Můžeš také přecházet na další nebo předchozí obrázek pomocí šipek v dolní liště. Navigaci lze dělat i klávesnicí:

Klávesa Akce
-> další obrázek
<- předchozí obrázek
ESC zavření zobrazení

Pro mobilní uživatele je podpora gesta potažení (swipe) a lze využít tlačítko zpět pro uzavření.

Zobrazované obrázky lze zvětšovat kolečkem myši nebo gesty na dotykových zařízeních.

Na titulky a popisky

U interních obrázků se titulky a popisky čtou z EXIF/IPTC tagů, což jsou metadata uvnitř souboru obrázku. Tento plugin čte metadata jen pro JPEG obrázky v UTF-8 kódování.

Metadata se dají upravit v fullscreen mediamanager.

Zdroj: Seznam obrázků dovoluje manuálně nastavit titulky a popisky u jednotlivých obrázků.

Cache

Výstup galerie je standardně cachován. Po přidání nových obrázků nemusí být vidět okamžitě. Buď počkej, až vyprší config:cachetime, nebo použij parametr purge=true v URL pro vyprázdnění cache.

Volitelně použij parametr nocache, ale obvykle se to nedoporučuje.