Lingue: English – Italiano – 日本語 Português do Brasil – Русский – (Add your language)

La funzione Gallery ti permette di aggiungere una o più gallerie di immagini ai tuoi post e pagine usando un semplice Shortcode. Da WordPress 2.5 e fino alla 3.5, lo shortcode della galleria era comunemente usato nella sua forma più elementare:

Dopo la 3.5, lo shortcode della galleria include gli ID delle immagini per default. Come questo:

È importante notare che questo stile di shortcode di galleria non è nuovo alla 3.5, prima si poteva usare l’attributo include. Tuttavia è molto più facile da generare e gestire con il nuovo Media Workflow introdotto nella 3.5.

Specificare gli ID nel tuo shortcode ti permette di includere nella tua galleria immagini che non sono necessariamente “allegate” al tuo post – cioè non caricate dall’interno del tuo post o pagina. Questa flessibilità ti permette di creare e incorporare qualsiasi numero di gallerie contenenti qualsiasi numero di immagini!

Nota: Se scegli di usare solo la versione “barebones” dello shortcode nel tuo post o pagina, solo le immagini che sono “allegate” a quel post o pagina saranno visualizzate.

Usage

Ci sono diverse opzioni che possono essere specificate usando questa sintassi:

Puoi anche stampare una galleria direttamente in un template in questo modo:

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

Anche questo funziona:

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

Options

Le seguenti opzioni di base sono supportate:

orderby specifica come ordinare le miniature visualizzate. Il valore predefinito è “menu_order”. Opzioni:

• menu_order – puoi riordinare le immagini nella scheda Gallery del pop-up Add Media
• title – ordina in base al titolo dell’immagine nella Media Library
• post_date – ordina per data/ora
• rand – ordina in modo casuale
• ID

order specifica l’ordine utilizzato per visualizzare le miniature. ASC o DESC. Per esempio, per ordinare per ID, DESC:

colonne specificare il numero di colonne. La galleria includerà un tag di interruzione alla fine di ogni riga e calcolerà la larghezza della colonna come appropriato. Il valore predefinito è 3. Se columns è impostato su 0, non saranno incluse interruzioni di riga. Ad esempio, per visualizzare una galleria a 4 colonne:

id specifica l’ID del post. La galleria visualizzerà le immagini che sono allegate a quel post. Il comportamento predefinito, se nessun ID è specificato, è quello di visualizzare le immagini allegate al post corrente. Per esempio, per visualizzare le immagini allegate al post 123:

size specifica la dimensione dell’immagine da usare per la visualizzazione delle miniature. I valori validi includono “thumbnail”, “medium”, “large”, “full” e qualsiasi altra dimensione aggiuntiva dell’immagine che è stata registrata con add_image_size(). Il valore predefinito è “thumbnail”. Le dimensioni delle immagini per “thumbnail”, “medium” e “large” possono essere configurate nel pannello di amministrazione di WordPress sotto Settings > Media. Ad esempio, per visualizzare una galleria di immagini di medie dimensioni:

Sono disponibili alcune opzioni avanzate:

itemtag il nome del tag XHTML utilizzato per racchiudere ogni elemento della galleria. Il valore predefinito è “dl”. icontag il nome del tag XHTML usato per racchiudere ogni icona di miniatura nella galleria. Il valore predefinito è “dt”. captiontag il nome del tag XHTML usato per racchiudere ogni didascalia. Il valore predefinito è “dd”. Per esempio, per cambiare il markup della galleria per usare i tag div, span e p:

link Specifica dove vuoi che l’immagine sia collegata. Il valore predefinito rimanda al permalink dell’allegato. Opzioni:

• file – Link direttamente al file immagine
• none – Nessun link

include gli ID degli allegati separati da virgola per mostrare solo le immagini di questi allegati.

escludi ID allegati separati da virgola esclude le immagini di questi allegati. Si prega di notare che include ed exclude non possono essere usati insieme.

Sviluppatori – Cose da considerare

Il comportamento predefinito previsto per una galleria che non ha ID espliciti dichiarati è quello di aggiungere tutte le immagini che hanno il post come post padre assegnato. In altre parole, aggiungere tutte le immagini che sono state caricate usando il pulsante/link “Add media” nella schermata di modifica del post. Tieni presente che questo significa anche che ogni allegato aggiunto a quel post in seguito sarà interpretato come parte della galleria. Non importa se è stato visualizzato come semplice allegato o meno.

Questo dovrebbe essere il fallback predefinito se non viene fornito alcun argomento: …lorem ipsum…

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

E smettete di usare extract() su shortcode_atts() (o altrove). Gli IDE non sono in grado di rintracciarlo.