Normalement, les codes abrégés sont utilisés dans les zones de contenu telles que les articles, les pages ou les widgets de la barre latérale. Cependant, vous souhaiterez parfois ajouter un shortcode dans votre thème WordPress.
Dans cet article, nous allons vous montrer comment ajouter facilement des shortcodes à votre thème WordPress.
Qu’est-ce qu’un shortcode dans WordPress
Un shortcode dans WordPress est une balise spéciale qui vous permet d’ajouter des éléments dynamiques dans des zones de contenu telles que des articles, des pages, des widgets, etc.
Il est utilisé comme chaîne de texte entre crochets. Ils ressemblent généralement à ceci :
Qu’entendons-nous par « éléments dynamiques » ? Un shortcode peut être utilisé pour ajouter toutes sortes de fonctionnalités à votre site WordPress, telles que des galeries d’images, des formulaires, des flux de médias sociaux et bien plus encore.
WordPress est livré avec quelques shortcodes par défaut et de nombreux plugins WordPress populaires utilisent également des shortcodes.
Par exemple, WPForms a des blocs faciles à utiliser, mais il fournit également des codes courts que vous pouvez utiliser pour ajouter des formulaires n’importe où sur votre site.
Pour en savoir plus sur les shortcodes, consultez notre guide complet sur la façon d’ajouter un shortcode dans WordPress.
Pourquoi et quand ajouter des shortcodes dans votre thème WordPress ?
Les codes courts sont normalement utilisés dans les zones de contenu de votre site Web WordPress. Vous pouvez facilement les ajouter depuis la zone d’administration de WordPress lors de la modification de votre contenu.
Par exemple, vous pouvez ajouter un shortcode à l’aide de l’éditeur de blocs dans WordPress.
Cependant, certains utilisateurs avancés peuvent vouloir utiliser un shortcode dans leurs fichiers de thème WordPress. Maintenant, si vous avez ajouté le shortcode dans le même format que celui que vous utilisez dans les zones de contenu, cela ne fonctionnera pas.
Au lieu de voir la sortie de votre shortcode, vous verrez le shortcode lui-même imprimé à l’écran.
La raison en est que WordPress n’exécute pas de shortcodes dans les fichiers de modèle de thème. Pour exécuter le shortcode, vous devrez le dire explicitement à WordPress en utilisant le do_shortcode fonction.
Voici un exemple de code sur la façon de l’utiliser dans vos fichiers de thème WordPress.
echo do_shortcode('
');
N’oubliez pas de remplacer ‘gallery’ par le shortcode que vous souhaitez ajouter.
De plus, la syntaxe de ce code changera un peu si vous vouliez ajouter un shortcode avec des paramètres supplémentaires.
Voici un exemple du shortcode WPForms qui a l’ID de formulaire comme paramètre supplémentaire au shortcode.
echo do_shortcode("");
Que faire lorsque do_shortcode ne fonctionne pas dans WordPress ?
La plupart des shortcodes dépendent des plugins WordPress ou d’un code supplémentaire sur votre site Web.
Si la fonction do_shortcode ne fonctionne pas sur votre site Web, assurez-vous que le plugin fournissant le shortcode est installé et activé.
De même, si le shortcode est fourni par votre thème WordPress ou un autre extrait de code personnalisé, assurez-vous qu’il est disponible.
Un moyen simple de dépanner et de résoudre ces problèmes consiste à utiliser la fonction shortcode_exists(). Cette fonction vérifie simplement la disponibilité d’un shortcode.
Voici un exemple de la façon dont vous pouvez l’utiliser avec la fonction do_shortcode().
if ( shortcode_exists( 'wpforms' )) {
echo do_shortcode("");
}
Si vous ne parvenez toujours pas à voir la sortie du shortcode sur votre site Web, essayez de vider le cache WordPress pour vous assurer que vous ne visualisez pas une version obsolète de votre site Web.
Nous espérons que ce tutoriel vous a aidé à apprendre à utiliser les shortcodes dans vos thèmes WordPress. Vous voudrez peut-être également voir ces autres astuces, astuces et hacks WordPress utiles ou consulter ces astuces de code personnalisé pour le fichier de fonctions dans WordPress.
