Nyelvek: (Add a nyelved)

A Galéria funkció lehetővé teszi, hogy egy vagy több képgalériát adj hozzá a bejegyzéseidhez és oldalaidhoz egy egyszerű rövidkód segítségével. A WordPress 2.5 óta és egészen a 3.5-ig a galéria rövidkódot általában a legalapvetőbb formájában használták:

A 3.5 után a galéria rövidkódok alapértelmezés szerint tartalmazzák a képazonosítókat. Például így:

Fontos megjegyezni, hogy a galéria rövidkódnak ez a stílusa nem új a 3.5-ben, korábban is használhattuk az include attribútumot. Azonban sokkal könnyebb létrehozni és kezelni a 3.5-ben bevezetett új Média munkafolyamat segítségével.

A rövidkódban szereplő azonosítók megadása lehetővé teszi, hogy olyan képeket is felvegyünk a galériába, amelyek nem feltétlenül “csatolva” vannak a poszthoz – vagyis nem a posztból vagy az oldalról töltöttük fel őket. Ez a rugalmasság lehetővé teszi, hogy tetszőleges számú képet tartalmazó galériákat hozzon létre és ágyazzon be!

Figyelem: Ha úgy dönt, hogy csak a rövidkód “csupasz” változatát használja a posztban vagy az oldalon, csak az adott poszthoz vagy oldalhoz “csatolt” képek fognak megjelenni.

Használat

Ezzel a szintaxissal több opció is megadható:

Egy galériát közvetlenül egy sablonban is kinyomtathatod, így:

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

Ez is működik:

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

Options

A következő alapvető opciók támogatottak:

orderby megadja, hogy a megjelenített miniatűrök hogyan legyenek rendezve. Az alapértelmezett beállítás a “menu_order”. Opciók:

• menu_order – átrendezheti a képeket a Média hozzáadása felugró ablak Galéria lapján
• title – a kép címe szerinti rendezés a Médiatárban
• post_date – dátum/idő szerinti rendezés
• rand – véletlenszerű rendezés
• ID

order adja meg a miniatűrök megjelenítéséhez használt rendezést. ASC vagy DESC. Például az ID szerinti rendezéshez DESC:

oszlopok adja meg az oszlopok számát. A galéria minden sor végén egy töréscímkét fog szerepeltetni, és az oszlopszélességet ennek megfelelően számítja ki. Az alapértelmezett érték 3. Ha az oszlopok értéke 0, a rendszer nem tartalmaz sortöréseket. Például egy 4 oszlopos galéria megjelenítéséhez:

id adja meg a bejegyzés azonosítóját. A galéria az adott bejegyzéshez csatolt képeket fogja megjeleníteni. Ha nincs azonosító megadva, az alapértelmezett viselkedés az aktuális bejegyzéshez csatolt képek megjelenítése. Például a 123. bejegyzéshez csatolt képek megjelenítéséhez:

size adja meg a miniatűrök megjelenítéséhez használandó képméretet. Az érvényes értékek a következők: “thumbnail”, “medium”, “large”, “full” és bármely más, az add_image_size() funkcióval regisztrált képméret. Az alapértelmezett érték a “thumbnail”. A “thumbnail”, “medium” és “large” képek méretét a WordPress admin panelen a Settings > Media alatt lehet beállítani. Például egy közepes méretű képekből álló galéria megjelenítéséhez:

Elérhető néhány speciális beállítás:

itemtag a galéria egyes elemeihez használt XHTML tag neve. Az alapértelmezett érték “dl”. icontag a galéria minden egyes miniatűr ikonjának bezárására használt XHTML-tag neve. Az alapértelmezett érték a “dt”. captiontag az egyes képaláírásokhoz használt XHTML-tag neve. Az alapértelmezett érték “dd”. Például a galéria jelölésének megváltoztatása div, span és p címkék használatára:

link Adja meg, hogy a kép hova legyen linkelve. Az alapértelmezett érték a csatolmány hivatkozási hivatkozására hivatkozik. Lehetőségek:

• file – Közvetlenül a képfájlra való hivatkozás
• none – Nincs hivatkozás

include comma separated attachment IDs to show only the images from these attachments.

exclude comma separated attachment IDs kizárja a képeket ezekből a mellékletekből. Felhívjuk a figyelmet, hogy az include és exclude nem használható együtt.

Developers – Things to consider

Az alapértelmezett elvárt viselkedés egy olyan galéria esetében, ahol nincsenek explicit ID-k megadva, az összes olyan kép hozzáadása, amelyhez a post as post parent van hozzárendelve. Más szóval, hozzáadja az összes olyan képet, amelyet a “Média hozzáadása” gomb/link segítségével töltöttek fel ezen a poszt szerkesztési képernyőn. Ne feledje, hogy ez azt is jelenti, hogy a későbbiekben az adott bejegyzéshez hozzáadott minden mellékletet a galéria részeként fog értelmezni. Nem számít, hogy egyszerű csatolmányként jelent meg vagy sem.

Ez legyen az alapértelmezett visszaesés, ha nem adtunk meg argumentumot: …lorem ipsum…

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

És ne használd az extract() funkciót a shortcode_atts() esetén (vagy bárhol máshol). Az IDE-k nem képesek ezt visszakövetni.