Introduit dans la version 2.5 de WordPress, les shortcodes est certainement l’une des fonctionnalités les plus puissantes de WordPress.
Ce sont des codes qui peuvent être insérer dans n’importe quel post d’un site sous ce CMS.
Utilisations des shortcodes
Il est très facile de les utiliser, il suffit de créer ou éditer une nouveau post, de basculer dans le mode HTML et d’écrire le nom du shortcode à inserer.
[helloworld]
Il est également possible de passer des paramètres. Par exemple si on veut ajouter le nom, on pourra ajouter le paramètre name.
[helloword name="Sylvain"]
A l’instar des balises, les shortcodes peuvent également contenir du contenu, par exemple : un shortcode pour les liens pourrait s’écrire :
[url href="http://truffo.fr/]Le blog de référence[/url]
La syntaxe est assez proche du BBCode
Ecrire un shortcode
Pour rajouter quelques shortcode dans son thème WordPress, il faut éditer le fichier functions.php pour rajouter la définition du shortcode.
Définition du shortcode
La fonction définissant un shortcode doit toujours suivre la signature suivante :
function myshortcodefunction($atts, $content = null)
- Le premier attribut contient les attributs que l’on passé en paramètre lors de l’appel : le name ou le href dans les exemples précédents.
- Le deuxième contient le contenu c’est à dire les éléments qui se trouvent entre la balise ouvrante et la balise fermantes.
function mytheme_helloworld($atts, $content = null) { return "Hello world " . $content; }
Enregistrer le shortcode
Il suffit de déclarer à WordPress notre shortcode.
add_shortcode('helloworld', 'mytheme_helloworld');