Jazyky: (Přidejte svůj jazyk)

Funkce Galerie umožňuje přidat jednu nebo více galerií obrázků do příspěvků a stránek pomocí jednoduchého Shortcode. Od verze WordPress 2.5 a až do verze 3.5 se zkrácený kód galerie běžně používal ve své nejzákladnější podobě:

Od verze 3.5 zkrácené kódy galerií ve výchozím nastavení obsahují ID obrázků. Takto:

Důležité je poznamenat, že tento styl zkratky galerie není ve verzi 3.5 nový, dříve jsme mohli používat atribut include. Je však mnohem jednodušší jej generovat a spravovat pomocí nového Media Workflow zavedeného ve verzi 3.5.

Zadání ID ve zkráceném kódu umožňuje zahrnout do galerie obrázky, které nemusí být nutně „připojeny“ k příspěvku – to znamená, že nejsou nahrány z příspěvku nebo stránky. Tato flexibilita vám umožňuje vytvořit a vložit libovolný počet galerií obsahujících libovolný počet obrázků!

Poznámka: Pokud se rozhodnete ve svém příspěvku nebo stránce použít pouze „holou“ verzi zkratky, zobrazí se pouze obrázky, které jsou „připojeny“ k danému příspěvku nebo stránce.

Použití

Existuje několik možností, které lze zadat pomocí této syntaxe:

Můžete také vypsat galerii přímo v šabloně takto:

 <?php echo do_shortcode(''); ?>

Funguje to také:

 <?php $gallery_shortcode = ''; print apply_filters( 'the_content', $gallery_shortcode ); ?>

Možnosti

Podporovány jsou následující základní možnosti:

uspořádánípodle určete způsob řazení zobrazených miniatur. Výchozí je „menu_order“. Volby: V případě, že se jedná o obrázky, které se zobrazují na obrazovce, je možné použít následující volby:

• menu_order – můžete změnit pořadí obrázků na kartě Galerie ve vyskakovacím okně Přidat média
• title – seřadí podle názvu obrázku v knihovně médií
• post_date – seřadí podle data/času
• rand – seřadí náhodně
• ID

order určuje pořadí řazení použité pro zobrazení miniatur. ASC nebo DESC. Chcete-li například řadit podle ID, zvolte DESC:

sloupce zadejte počet sloupců. Galerie bude obsahovat značku zlomu na konci každého řádku a podle toho vypočítá šířku sloupce. Výchozí hodnota je 3. Pokud je hodnota sloupců nastavena na 0, nebudou zahrnuty žádné zalomení řádků. Chcete-li například zobrazit galerii se 4 sloupci:

id zadejte ID příspěvku. V galerii se zobrazí obrázky, které jsou připojeny k tomuto příspěvku. Pokud není zadáno žádné ID, zobrazí se ve výchozím nastavení obrázky připojené k aktuálnímu příspěvku. Například pro zobrazení obrázků připojených k příspěvku 123:

size zadejte velikost obrázku, která se má použít pro zobrazení miniatur. Platné hodnoty zahrnují „thumbnail“, „medium“, „large“, „full“ a jakoukoli další velikost obrázku, která byla zaregistrována pomocí funkce add_image_size(). Výchozí hodnota je „thumbnail“. Velikost obrázků pro „thumbnail“, „medium“ a „large“ lze nakonfigurovat v panelu správce WordPress v části Nastavení > Média. Chcete-li například zobrazit galerii obrázků střední velikosti:

Některé pokročilé možnosti jsou k dispozici:

itemtag název značky XHTML použité k uzavření každého prvku v galerii. Výchozí hodnota je „dl“. icontag název značky XHTML použité k uzavření každé ikony miniatury v galerii. Výchozí hodnota je „dt“. captiontag název tagu XHTML, který se používá k uzavření každého popisku. Výchozí hodnota je „dd“. Chcete-li například změnit značení galerie tak, aby používalo značky div, span a p:

link Určete, kam se má obrázek odkazovat. Výchozí hodnota odkazuje na trvalý odkaz přílohy. Možnosti:

• soubor – Odkaz přímo na soubor s obrázkem
• žádný – Žádný odkaz

zahrnout ID přílohy oddělené čárkou pro zobrazení pouze obrázků z těchto příloh.

exclude comma separated attachment IDs vyloučí zobrazení obrázků z těchto příloh. Upozorňujeme, že include a exclude nelze použít společně.

Vývojáři – věci ke zvážení

Výchozí očekávané chování pro galerii, která nemá uvedená explicitní ID, je přidání všech obrázků, které mají příspěvek přiřazen jako rodič příspěvku. Jinými slovy, přidat všechny obrázky, které byly nahrány pomocí tlačítka/odkazu „Přidat média“ na obrazovce úprav tohoto příspěvku. Mějte na paměti, že to také znamená, že každá příloha přidaná k tomuto příspěvku později bude interpretována jako součást galerie. Bez ohledu na to, zda byla zobrazena jako prostá příloha nebo ne.

Toto by mělo být výchozí nouzové řešení, pokud nebyl zadán žádný argument: …lorem ipsum…

$attachments = get_children( array('post_parent' => $attr,'post_status' => 'inherit','post_type' => 'attachment','post_mime_type' => 'image','order' => $attr,'orderby' => $attr,) );

A přestaňte používat extract() na shortcode_atts() (nebo kdekoli jinde). IDE to neumí zpětně dohledat.