Créer un shortcode dans WordPress

Il est extrêmement simple de créer un shortcode dans WordPress. Ces derniers se reconnaissent à leur structure rappelant le BBcode des forums de discussion : [valeur] et sont tout simplement remplacés par leur équivalent en code XHTML de sortie.

Pour créer votre shortcode, créez simplement une nouvelle fonction dans la page functions.php de votre thème :

function reafficheTitre()
{
    global $post,$posts;
    //contenu
    $html = '<h3><a href="' . the_permalink() . '">' . $post->post_title .'</a></h3>';
    //output
    return $html;
}
add_shortcode('titre', 'reafficheTitre');

Ceci insèrera un lien vers l’article (via the_permalink()) à l’endroit où vous aurez ajouté le shortcode [titre] dans votre texte.

Utiliser les shortcodes à l’extérieur du loop

Ceci peut devenir vraiment utile et puissant d’utiliser les shortcodes à l’extérieur du loop (dans vos thèmes ou encore dans vos widgets, par exemple). Pour ce faire, il suffit de parser votre contenu comme s’il était traité dans le loop :

$contenu = apply_filters('the_content', '[titre]');
echo $contenu ;

Ceci va donc utiliser le filtre qui traite habituellement le texte dans le loop de WordPress et l’appliquer à ce que vous avez passé en paramètre.

Mais on s’entend que le plus simple, dans ce cas précis, serait de faire un simple appel à votre fonction :

echo reafficheTitre();

Pour plus d’informations je vous invite à consulter cet excellent article.