Languages: English – Italiano – 日本語 Português do Brasil – Русский – (Adaugă limba ta)

Funcția Gallery vă permite să adăugați una sau mai multe galerii de imagini la postările și paginile dvs. folosind un simplu Shortcode. Începând cu WordPress 2.5 și până la versiunea 3.5, codul scurt al galeriei a fost utilizat în mod obișnuit în forma sa cea mai elementară:

După versiunea 3.5, shortcode-urile de galerie includ în mod implicit ID-urile imaginilor. Astfel:

Este important de reținut că acest stil de shortcode de galerie nu este nou la 3.5, anterior puteam folosi atributul include. Cu toate acestea, este mult mai ușor de generat și de gestionat cu noul Media Workflow introdus în 3.5.

Specificarea ID-urilor în codul scurt vă permite să includeți în galeria dvs. imagini care nu sunt neapărat „atașate” la postarea dvs. – adică nu sunt încărcate din interiorul postării sau paginii dvs. Această flexibilitate vă permite să creați și să încorporați orice număr de galerii care conțin orice număr de imagini!

Nota: Dacă alegeți să utilizați doar versiunea „barebones” a codului scurt în postarea sau pagina dumneavoastră, vor fi afișate doar imaginile care sunt „atașate” la acea postare sau pagină.

Utilizare

Există mai multe opțiuni care pot fi specificate folosind această sintaxă:

De asemenea, puteți imprima o galerie direct într-un șablon, astfel:

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

Acesta funcționează și el:

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

Opțiuni

Sunt acceptate următoarele opțiuni de bază:

orderby specificați modul de sortare a miniaturilor afișate. Opțiunea implicită este „menu_order”. Opțiuni:

order specifică ordinea de sortare utilizată pentru afișarea miniaturilor. ASC sau DESC. De exemplu, pentru a sorta după ID, DESC:

columns (coloane) specifică numărul de coloane. Galeria va include o etichetă de întrerupere la sfârșitul fiecărui rând și va calcula lățimea coloanelor în mod corespunzător. Valoarea implicită este 3. Dacă coloana este setată la 0, nu va fi inclusă nicio întrerupere de rând. De exemplu, pentru a afișa o galerie cu 4 coloane:

id specificați ID-ul postului. Galeria va afișa imaginile care sunt atașate la acea postare. Comportamentul implicit, în cazul în care nu se specifică niciun ID, este de a afișa imaginile atașate la postul curent. De exemplu, pentru a afișa imagini atașate la postul 123:

size specifică dimensiunea imaginii care trebuie utilizată pentru afișarea miniaturilor. Valorile valide includ „thumbnail”, „medium”, „large”, „full” și orice altă dimensiune suplimentară a imaginii care a fost înregistrată cu add_image_size(). Valoarea implicită este „thumbnail”. Dimensiunea imaginilor pentru „thumbnail”, „medium” și „large” poate fi configurată în panoul de administrare WordPress, la Settings > Media. De exemplu, pentru a afișa o galerie de imagini de dimensiuni medii:

Sunt disponibile câteva opțiuni avansate:

itemtag numele tag-ului XHTML utilizat pentru a îngloba fiecare element din galerie. Valoarea implicită este „dl”. icontag numele tag-ului XHTML utilizat pentru a îngloba fiecare pictogramă de miniatură din galerie. Valoarea implicită este „dt”. captiontag numele tag-ului XHTML utilizat pentru a include fiecare legendă. Valoarea implicită este „dd”. De exemplu, pentru a modifica marcajul galeriei pentru a utiliza etichete div, span și p:

link Specificați unde doriți ca imaginea să fie legată. Valoarea implicită face legătura cu permalink-ul atașamentului. Opțiuni:

include ID-uri de atașament separate prin virgulă pentru a afișa numai imaginile din aceste atașamente.

exclude comma separated attachment IDs exclude imaginile din aceste atașamente. Vă rugăm să rețineți că include și exclude nu pot fi utilizate împreună.

Dezvoltatorii – Lucruri de luat în considerare

Comportamentul implicit așteptat pentru o galerie care nu are ID-uri explicite declarate este acela de a adăuga toate imaginile care au atribuit postul ca părinte al postului. Cu alte cuvinte, adaugă toate imaginile care au fost încărcate cu ajutorul butonului/legăturii „Add media” din ecranul de editare a acestei postări. Rețineți că acest lucru înseamnă, de asemenea, că fiecare atașament adăugat ulterior la acea postare va fi interpretat ca făcând parte din galerie. Nu contează dacă a fost afișat ca atașament simplu sau nu.

Aceasta ar trebui să fie soluția de rezervă implicită dacă nu a fost furnizat niciun argument: …lorem ipsum…

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

Și nu mai folosiți extract() pe shortcode_atts() (sau oriunde altundeva). IDE-urile nu sunt capabile să facă backtrace în acest sens.

.