Ecrire son propre shortcode WordPress

I. Présentation

Les shortcodes WordPress sont des petits raccourcis que l’on écrit entre accolades dans le contenu d’un article afin d’y inclure une fonction et un texte spécifique, nous allons ici voir comment écrire son propre shortcode.

Wordpress_987678

L’écriture d’un shortcode WordPress personnalisé peut avoir plusieurs buts, inclure une publicité adsense à un endroit précis d’un article, inclure un texte que l’on peut avoir à écrire souvent dans un article... Nous allons ici voir comment faire un simple shortcode qui affichera un texte pré-rempli.

Note : Ce tutoriel a été écrit par rapport à la version 4 de WordPress.

II. Écrire la fonction

La première chose à faire est bien sûr d’aller écrire la fonction correspondant. En effet, un shortcode est un raccourcie que l’on met dans le corps d’un article comme [shortcode1] et qui, lors de la lecture de l’article, va être remplacé par la fonction liée à ce shortcode. Pour écrire une nouvelle fonction, il faut se rendre dans le backoffice de WordPress puis dans "Apparence" et enfin "Éditeur" :

SHORTCODE_01
Accès à l'éditeur WordPress

On va ensuite aller sur la page "functions.php" :

SHORTCODE_02
Accès à l'édition du fichier functions.php

Tout en bas de ce fichier function.php, on pourra inclure le code suivant:

function shortcodeperso_1() {echo ' Texte à écrire ';}
add_shortcode('short1', 'shortcodeperso_1');

On fera ensuite "Mettre à jour le fichier" pour sauvegarder nos modifications. Nous avons ici deux éléments, la fonction qui est la première ligne et la déclaration du shortcode qui est la deuxième ligne.

Concernant la première ligne, il faut avoir quelques notions de codes PHP/HTML pour bien la manier correctement. Je fais ici un simple affichage de texte (tout ce qui sera entre les ' aprés "echo" sera affiché à l’endroit où le shortcode est déclaré).

Concernant la deuxième ligne, on fait ici la relation entre le nom de notre fonction "shortcodeperso_1" et le nom qu’aura le shortcode quand nous le déclarerons dans l’article.

III. Insérer le shortcode dans un article

Pour insérer le shortcode dans un article, il suffit donc d’aller ouvrir un article puis d’y insérer où on le souhaite le shortcode comme déclaré, ici :

[short1]

En enregistrant l’article et en l’affichant ensuite, vous remarquerez que le contenu de la fonction est maintenant affiché à la place du shortcode.

Partagez cet article Partager sur Twitter Partager sur Facebook Partager sur Linkedin Partager sur Google+ Envoyer par mail

Mickael Dorigny

Co-fondateur d'IT-Connect.fr. Auditeur/Pentester chez Orange Cyberdéfense.

Nombre de posts de cet auteur : 521.Voir tous les posts

2 thoughts on “Ecrire son propre shortcode WordPress

  • Bonjour,

    Je vous déconseille de procéder ainsi pour ajouter toute nouvelle fonction dans le fichier functions.php, car:
    – vous risquez de faire des erreurs et il ne sera pas facile de revenir en arrière, à moins d’avoir pris la peine de faire une sauvegarde préalable du fichier functions.php
    – vos nouvelles fonctions seront perdues lors d’un changement de thème ou de sa mise à jour
    Je vous conseille alors de plutôt opter pour l’utilisation d’un thème enfant ou la création d’un plugin/mu-plugin.

    Cordialement,

    Bruno

    Répondre
  • Comme l’a dit Bruno, créer un thème enfant c’est la base sue WordPress, les sauvegarde aussi (perso j’utilise updraft pour ça) sinon pour le reste rien á dire, apprendre á utiliser les shortcode c’est profiter de l’un des meilleurs atouts de WordPress

    Répondre

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Ce site utilise Akismet pour réduire les indésirables. En savoir plus sur comment les données de vos commentaires sont utilisées.