Créer un shortcode Shortcode

Utiliser directement la fonction n’est pas pratique pour les novices. Mettez, en plus de la fonction, un shortcode à la disposition des utilisateurs.

Appliquez ce que vous avez appris au chapitre WordPress et PHP, section Les shortcodes.

Ajoutez le code suivant :

add_shortcode( 'mybreadcrumb', 'fil_ariane'); 

Vous pouvez désormais utiliser le shortcode [mybreadcrumb] dans les pages et articles du site.

Appeler un shortcode directement dans un fichier PHP est impossible. Il faut utiliser la fonction do_shortcode() (si vous voulez ajouter le shortcode dans le fichier header.php par exemple) :

<?php 
if( shortcode_exists(mybreadcrumb)){  
   echo do_shortcode('[mybreadcrumb]'); 
} 
?> 

Mettez les instructions d’utilisation à jour dans le fichier readme.txt ou dans la description.

De même, si vous voulez insérer un shortcode dans un widget, le shortcode ne fonctionnera pas, il faut utiliser soit une extension lisant les shortcodes dans les widgets, soit une extension permettant d’utiliser du PHP dans les widgets (voir le chapitre Les extensions et les widgets).

Dans ce cas précis, utiliser un shortcode n’est pas vraiment utile, mais cela vous permet de discerner les différentes possibilités que WordPress offre, pour afficher la même fonction.