WordPress 2.5 regorge de nouveautés au niveau de l’interface graphique du gestionnaire mais également au niveau des fonctionnalités pour les développeurs de thèmes et de plugins. Une des plus intéressantes de ces nouveautés à mon avis est l’introduction d’une API pour les Shortcodes.
Le but de cette API est de proposer un ensemble de fonctions pour faciliter l’insertion de macro-commandes dans le contenu d’un billet. Ok j’en conviens, dis comme ça c’est assez abstrait, alors nous allons illustrer cela en codant une première petite fonction parfaitement inutile : un shortcode pour insérer un « Hello World » (histoire de faire original).
Il faut tout d’abord savoir qu’on peut programmer le code « exécutable » associé à un shortcode aussi bien au niveau du thème en éditant le fichier « functions.php » que dans un plugin. Pour se facilier la tâche, nous allons travailler dans le fichier « functions.php » de notre thème.
Dans votre fichier « functions.php » donc, ajoutez le code suivant :
// function associée au shortcode [hello]
function hello_func(){
echo "Hello World !";
}
add_shortcode('hello', 'hello_func'); // ajout du shortcode hello appellant la fonction hello_func()
La fonction hello_func()
représente le code qui sera exécuté lorsqu’on insérera le shortcode [hello] dans nos billets. La fonction add_shortcode
quand à elle sert à définir le shortcode qui sera utilisé dans nos billets. Elle a deux arguments obligatoires, le premier étant le tag qui sera utilisé dans nos billets et le deuxième la fonction à exécuter : add_shortcode('tag_à_insérer', 'fonction_à_exécuter')
Donc si maintenant vous écrivez un nouveau billet, tapez dans votre texte le shortcode [hello] (notez bien l’utilisation des crochets pour délimiter le nom de la commande) et publiez votre billet.
Comme vous pouvez le constater, le shortcode [hello] a bien été remplacer par le texte « Hello World ! » dans notre billet.
Voilà pour cette introduction aux shortcodes dans WordPress 2.5. Nous verrons dans un prochain billet des exemples de shortcodes plus complexes et les applications un peu plus concrètes que l’on pourra en faire.
12 commentaires
Très pratique pour les créateurs de plugins ça! Je pense notamment à l’insertion facilitée d’audio ou de vidéos.
Il existe un moyen d’envoyer des paramètres à ces fonctions créées?
Clairement oui ! D’autant que, on le verra par la suite, ce système supporte les paramètres, du contenu et l’imbrication… Bref, c’est que du bonheur !
Juste trois mots : burningHat, mon héro Excellent, j’ai hâte de lire la suite !!!
Roooh tu me flattes Bruno ! j’essayerais d’être à la hauteur de tes attentes dans la suite alors… Je découvre juste la puissance du joujou mais ça me donne 1000 idées ce truc franchement !
C’est le principe du pointeur de fonction, bien connu des développeurs et rudement efficace… Après, j’espère que c’est bien sécurisé…
Yep en fait c’est une nouvelle fonctionnalité dans les hooks filters de l’API WordPress… Celle-ci est nouvelle mais le principe est très largement utilisé dans le core de WordPress depuis un moment donc j’espère pour eux que c’est la moindre sécurisé aussi
Merci pour la fonction, vraiment bien pensé ça
Bah de rien, c’est pas de moi… Je me suis contenté d’explorer la doc, de faire des tests et de les partager dans cette suite d’articles (qui ne fait que commencer )
Tiens, je ne connaissais pas les shortcodes de WordPress et ça a l’air carrément sympa, puisqu’ils font partie du thème. Or, justement, quand on essaye de fournir des fonctionnalités particulières aux thèmes, on se demande comment les fournir, sachant que thèmes et plugins ne sont pas dans les mêmes dossiers. Bien vu ! Merci !
En fait ils font partie du core même de WordPress et sont donc utilisables indifféremment dans les thèmes et dans les plugins. (donc c’est encore plus fort ! :p)
excellente cette astuce, wordpress regorge des petites functions et c’est sympa de partager. j’essaye ça bientot
De rien Mathias, c’est tout naturel
8 trackbacks
WordPress 2.5 et les ShortCodes #1 – Présentation…
Présentation de l’API Shortcode de WordPress 2.5…
WordPress 2.5 et les ShortCodes #1 – Prsentation…
Prsentation de l’API Shortcode dans WordPress 2.5…
[...] 2.5 et les ShortCodes # 1-Présentation by Burninghat.net [...]
[...] y a quelques jours, je vous présentais brièvement les shortcodes de WordPress 2.5. Nous allons aujourd’hui voir comment passer des paramètres à nos shortcodes et afficher [...]
[...] dernier article de ma suite sur les shortcode dans WordPress 2.5. Nous avons vu précédemment ce qu’était un shortcode et comment lui passer des paramètres. Dans cet article, nous allons voir comment les utiliser pour [...]
[...] l’explication en détail, je vous invite fortement à lire WordPress 2.5 et les ShortCodes et à vous abonner au flux RSS de burningHat, vous ne le regretterez pas [...]
[...] (fr) WordPress 2.5 et les ShortCodes #1: Présentation – BurningHat.net [...]
[...] même sous forme de ShortCode si vous en êtes tellement fan que vous voulez pouvoir les afficher un peu [...]