shortcodes

Créer des shortcodes

Qu’est ce qu’un shortcode ?

Depuis la Version 2.5 de WordPress, le CMS supporte les Shortcodes. Ils ont été introduits pour créer des macros utilisées dans le contenu d’articles, de pages , de costum post types …

Vous utilisez ceux-ci sans vraiment vous poser de questions et sans vous en rendre compte, en effet les insertions d’images avec légende, les insertions de vidéo ou de galerie d’images sont des Shortcodes intégrés do’ffice à WordPress.

Comment créer un shortcode ?

Pour illustrer les shortcodes, regardons ensemble le shortcode galerie images de WordPress, le simple fait de placer ce shortcode dans un article, aura pour effet d’afficher une galerie de toutes les images associées à ce dernier.

[ gallery ]

On peut également définir des paramètres dans le but de personnaliser l’affichage, dans l’exemple ci-dessous, le shortcode affichera votre galerie d’images en taille moyenne sur 2 colonnes :

[ gallery columns= »2″ size= »medium » ]

Pour créer votre propre shortcode, vous allez devoir passer par le fichier functions.php et faire un ajout de quelques lignes par shortcode. Dans le cas présent nous allons afficher une « carte de Visite » maison via un shortcode.

[pastacode lang= »php » message= » » highlight= » » provider= »manual »]

function CarteDeVisite_mon_shortcode( ) {
   $codehtml = '<h4 class='CDV'>Jonathan ANDRE - Création de site Web<br>Contact : <a href=&#034;mailto:contact@creazo.fr&#034;>contact@creazo.fr</a> </h4>';
   return $codehtml;
}
 
add_shortcode( 'CarteDeVisite', 'CarteDeVisite_mon_shortcode' );

[/pastacode]

Afficher votre shortcode

Aprés avoir intégré votre nouveau shortcode dans functions.php, il ne vous plus qu’a appelez celui-ci via cette ajout dans votre page ou article (sans espaces):

[ CarteDeVisite ]

Et voilà le résultat :

[CarteDeVisite]

Utiliser un shortcode en dehors de la loop

Vous pouvez aussi l’intégrer dans un modèle de page ou un autre fichier de wordpress (single.php par exemple) via cette ajout :

[pastacode lang= »php » message= » » highlight= » » provider= »manual »]

 <?php echo do_shortcode('[CarteDeVisite]'); ?>

[/pastacode]

Cela vous permettra de le faire fonctionner en dehors de la loop de WordPress.

Faire apparaître un fonction get_the_XXX

Vous pouvez aussi faire apparaître le titre de votre article ou page via cet ajout de shortcode :

[pastacode lang= »php » message= » » highlight= » » provider= »manual »]

function the_title_shortcode($atts, $content = null) {
  return get_the_title();
}
add_shortcode('the_title', 'the_title_shortcode');

[/pastacode]

Il ne manque plus qu’à ajouter [the_title] dans votre contenu !

Autoriser les shortcodes dans le widget texte

Tutoriel WordPress

Les widgets textes de WordPress n’interprètent pas par défaut les shortcodes, pour cela il suffit d’ajouter le code suivant à votre fichier functions.php :

[pastacode lang= »php » message= » » highlight= » » provider= »manual »]

//Autoriser les shortcodes dans le widget texte
if ( !is_admin() ) {
    add_filter('widget_text', 'do_shortcode', 11);
}

[/pastacode]

Dans le cas où vous souhaitez ajouter des shortcodes à d’autres endroits, vous allez devoir gérer la sortie HTML avec un apply_filters et faire un add_filter( ‘nom_de_votre_filtre’, ‘do_shortcode’ );