Disponibles depuis la version 2.5 de WordPress, les shortcodes sont des petits “raccourcis” visant à faciliter l’intégration d’informations et / ou fonctionnalités dans vos articles et pages. Aussi simples à utiliser que les célèbres bbcode auxquels ils ressemblent beaucoup, les shortcodes permettent réellement d’améliorer votre WordPress et même d’en repousser les limites.
Comment ça marche ?
Très simplement. Une fois que vous aurez créé votre shortcode, l’intégration de celui-ci se fait directement dans un article ou une page de votre blog, à n’importe quel endroit de votre contenu. Il vous suffit de rajouter le nom de votre shortcode entre crochets et le CMS l’interprétera.
Implémentation d'une galerie d'image grâce au shortcode Gallery
Créer un shortcode
La création d’un shortcode s’effectue en deux étapes. Tout se déroule dans le fichier functions.php de votre thème.
1ère étape : écriture du code
Ici, il s’agit du code php qui sera interprété lors de l’appel de notre shortcode. Vous y mettez ce que vous voulez donc. Soyons fou, mettons un classique “Hello World!”.
|
1 2 3 |
function ma_fonction () { return “Hello World”; } |
2ème étape : déclaration du shortcode
|
1 |
add_shortcode( 'mon_shortcode', 'ma_fonction' ); |
Cette deuxième instruction nous permet de dire à WordPress qu’il doit prendre en compte notre shortcode. La première valeur correspond ici au nom de notre shortcode, la seconde à la fonction à laquelle il doit faire référence.
Afficher le shortcode
Il ne nous reste alors plus qu’à intégrer notre code dans un article ou une page, comme nous l’avons vu ci-dessus. En ajoutant la ligne [mon_shortcode] n’importe où dans votre contenu, comme par magie s’affichera notre magnifique “Hello World”. Elle est pas belle la vie ?
Un exemple pour comprendre
Afin de visualiser toutes les possibilités que peuvent nous offrir les shortcodes, je vous propose un exemple facile mais très intéressant. Nous allons écrire un code qui va nous permettre de récupérer puis afficher n’importe quelle information de notre blog.
|
1 2 3 4 5 |
function bloginfo_shortcode( $atts ) { extract( shortcode_atts(array( 'key' => '' ) , $atts ) ); return get_bloginfo( $key ); } add_shortcode( 'bloginfo' , 'bloginfo_shortcode' ); |
L’intérêt de vous montrer ce shortcode (que j’ai pompé chez blue-anvil.com) est de comprendre que nous pouvons même les programmer pour qu’ils acceptent un / des paramétre(s). Perspective très intéressante non ?
Les possibilités que nous offre l’implémentation de cette fonctionnalité sont quasiment infinies. Plusieurs plugins proposent des shortcodes à intégrer directement. Je pense par exemple au plugin de e-commerce WooCommerce ou, dans un autre registre, le plugin JetPack dont Rémy vous a fait la présentation la semaine passée (intégration de vidéo Youtube notamment).
Je vous invite donc à rester à l’écoute de the-loop.fr dans les jours prochains (vous pouvez vous inscrire à notre flux RSS par exemple) pour approfondir un peu plus cette fonctionnalité et découvrir aussi le shortcode natif de WordPress : Gallery.
Si vous voulez en savoir plus, il reste bien évidemment la documentation officielle à potasser sur le sujet : http://codex.wordpress.org/Shortcode_API.
Loading ...