⋮ 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
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:
full– plně responzivní rozložení využívající celou šířku stránky. Galerie se automaticky přizpůsobí. Toto je výchozí a doporučené nastavení.center– zarovná galerii na střed, využívá jen potřebnou šířku. Pravděpodobně budeš chtít nastavit počet sloupců ručně.left– zarovná galerii vlevo, následující obsah bude obtékat zprava. Pravděpodobně budeš chtít nastavit počet sloupců ručně.right– zarovná galerii vpravo, následující obsah bude obtékat zleva.
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.