Langues : Anglais – Italiano – 日本語 Português do Brasil – Русский – (Ajoutez votre langue)

La fonctionnalité Galerie vous permet d’ajouter une ou plusieurs galeries d’images à vos articles et pages en utilisant un simple Shortcode. Depuis WordPress 2.5 et jusqu’à 3.5, le shortcode gallery était couramment utilisé dans sa forme la plus basique :

Après la version 3.5, les shortcodes de galerie incluent les ID des images par défaut. Comme ceci:

Il est important de noter que ce style de shortcode de galerie n’est pas nouveau en 3.5, auparavant nous pouvions utiliser l’attribut include. Cependant, il est beaucoup plus facile à générer et à gérer avec le nouveau Media Workflow introduit dans la 3.5.

Spécifier les ID dans votre shortcode vous permet d’inclure dans votre galerie des images qui ne sont pas nécessairement « attachées » à votre article – c’est-à-dire non téléchargées depuis votre article ou votre page. Cette flexibilité vous permet de créer et d’intégrer n’importe quel nombre de galeries contenant n’importe quel nombre d’images !

Note : Si vous choisissez de simplement utiliser la version « barebones » du shortcode dans votre post ou page, seules les images qui sont « attachées » à ce post ou page seront affichées.

Usage

Il y a plusieurs options qui peuvent être spécifiées en utilisant cette syntaxe:

Vous pouvez également imprimer une galerie directement dans un modèle comme ceci:

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

Cela fonctionne aussi:

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

Options

Les options de base suivantes sont supportées:

orderby spécifier comment trier les vignettes d’affichage. La valeur par défaut est « menu_order ». Options :

• menu_order – vous pouvez réorganiser les images dans l’onglet Galerie de la pop-up Ajouter un média
• title – ordonner par le titre de l’image dans la bibliothèque de médias
• post_date – trier par date/heure
• rand – ordonner aléatoirement
• ID

order spécifier l’ordre de tri utilisé pour afficher les vignettes. ASC ou DESC. Par exemple, pour trier par ID, DESC :

columns spécifier le nombre de colonnes. La galerie inclura une balise de rupture à la fin de chaque ligne, et calculera la largeur des colonnes en conséquence. La valeur par défaut est 3. Si columns est fixé à 0, aucune rupture de ligne ne sera incluse. Par exemple, pour afficher une galerie à 4 colonnes :

id spécifier l’ID du post. La galerie affichera les images qui sont attachées à ce post. Le comportement par défaut, si aucun ID n’est spécifié, est d’afficher les images attachées à l’article courant. Par exemple, pour afficher les images attachées au post 123 :

size spécifier la taille de l’image à utiliser pour l’affichage des vignettes. Les valeurs valides incluent « thumbnail », « medium », « large », « full » et toute autre taille d’image supplémentaire qui a été enregistrée avec add_image_size(). La valeur par défaut est « thumbnail ». La taille des images pour « thumbnail », « medium » et « large » peut être configurée dans le panneau d’administration de WordPress sous Paramètres > Médias. Par exemple, pour afficher une galerie d’images de taille moyenne :

Certaines options avancées sont disponibles :

itemtag le nom de la balise XHTML utilisée pour enfermer chaque élément de la galerie. La valeur par défaut est « dl ». icontag le nom de la balise XHTML utilisée pour enfermer chaque icône de vignette dans la galerie. La valeur par défaut est « dt ». captiontag le nom de la balise XHTML utilisée pour contenir chaque légende. La valeur par défaut est « dd ». Par exemple, pour modifier le balisage de la galerie afin d’utiliser les balises div, span et p :

lien Spécifiez où vous voulez que l’image soit liée. La valeur par défaut établit un lien vers le permalien de la pièce jointe. Options :

• file – Lien direct vers le fichier image
• none – Aucun lien

include comma separated attachment IDs pour afficher uniquement les images de ces pièces jointes.

exclure les ID de pièces jointes séparés par des virgules pour exclure les images de ces pièces jointes. Veuillez noter que include et exclude ne peuvent pas être utilisés ensemble.

Développeurs – Choses à prendre en compte

Le comportement attendu par défaut pour une galerie qui n’a pas d’IDs explicites indiqués est d’ajouter toutes les images qui ont le post as post parent assigné. En d’autres termes, ajouter toutes les images qui ont été téléchargées en utilisant le bouton/lien « Add media » sur cet écran d’édition de post. Gardez à l’esprit que cela signifie également que toute pièce jointe ajoutée ultérieurement à ce message sera interprétée comme faisant partie de la galerie. Peu importe si elle a été affichée comme pièce jointe simple ou non.

Ce devrait être le fallback par défaut si aucun argument n’était fourni : …lorem ipsum…

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

Et arrêtez d’utiliser extract() sur shortcode_atts() (ou n’importe où ailleurs). Les IDE ne sont pas capables de backtracer cela.