WordPress.org

Langues : Anglais – Français – 日本語 (Ajoutez votre langue)

Depuis la version 2.5, WordPress supporte ce qu’on appelle les Shortcodes. Ils ont été introduits pour créer des macros à utiliser dans le contenu d’un article. Pour des exemples de shortcodes et comment les utiliser, voir WordPress.com Shortcodes, bien que certains shortcodes qui y figurent soient exclusifs à WordPress.com.

Un shortcode trivial pour une galerie ressemble à ceci :

Les shortcodes peuvent également être utilisés avec des attributs supplémentaires, comme le montre l’exemple suivant :

Les deux exemples afficheront une galerie d’images, ce qui serait difficile à maintenir lorsqu’il s’agit d’écrire le balisage HTML pour celle-ci et de la garder en synchronisation avec les images téléchargées. En utilisant un shortcode, le balisage de la galerie sera créé dynamiquement et automatiquement.

Construit et shortcodes supplémentaires

WordPress propose certains des shortcodes par défaut (par exemple celui de la galerie) et les plugins peuvent ajouter les leurs également via l’API Shortcode.

Les shortcodes suivants sont inclus avec WordPress :

Escaping Shortcodes

Parfois, vous pouvez souhaiter utiliser le texte qui représente habituellement un shortcode dans vos posts. Pour ce faire, vous devez échapper le shortcode en utilisant deux jeux de parenthèses au lieu d’un seul. Ainsi, pour afficher ceci dans votre message :

Vous écrirez ceci :

]

Pour les shortcodes qui ont une balise de début et de fin, vous devez seulement échapper les toutes premières et toutes dernières parenthèses :

 ... ]

Notez que seuls les shortcodes actuellement disponibles peuvent être échappés de cette manière. L’utilisation de doubles crochets autour d’un texte qui n’est pas actuellement enregistré comme shortcode entraînera l’affichage des deux ensembles de crochets dans votre article, et non d’un seul comme lors de l’échappement des shortcodes enregistrés.

Shortcodes dans les widgets

Par défaut, WordPress ne prend pas en charge les shortcodes dans les widgets de la barre latérale avant la version 4.9. Il développe uniquement les shortcodes dans le contenu d’un article, d’une page ou d’un type de post personnalisé. Pour ajouter la prise en charge des shortcodes dans les widgets de la barre latérale, vous pouvez installer un plugin, utiliser le code ci-dessous ou consulter les améliorations apportées aux widgets dans la version 4.9:

add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );

Il est important que ces lignes soient ajoutées dans cet ordre. La première ligne empêche WordPress de transformer les sauts de ligne en balises de paragraphe, car cela empêche les shortcodes de fonctionner. La deuxième ligne est celle qui fait fonctionner les shortcodes.

Shortcodes pour les plugins manquants (noms non enregistrés)

En dehors des shortcodes intégrés, tous les autres sont ajoutés par des plugins. Si le plugin qui fournit un shortcode donné est manquant ou désactivé, WordPress traitera l’ensemble du shortcode, ses attributs et le contenu qu’il contient comme du texte brut normal et préservera les caractères spéciaux sur le HTML de sortie.

Yay!

<Yay>

<(^_^)>

<(^_^)> -- Yay!

<(^_^<) -- <Yay>

Yay!

<Yay>