Comment utiliser wordpress do shortcode

Introduction

Imaginez que vous souhaitez afficher un formulaire de contact sur une page spécifique de votre site WordPress, mais vous ne savez pas comment intégrer le shortcode du plugin de formulaire. La fonction `do_shortcode` de WordPress est là pour vous aider. Ensemble, nous allons découvrir comment utiliser cette fonction pour insérer des shortcodes directement dans vos fichiers PHP, sans avoir à les ajouter manuellement dans l’éditeur de contenu. À la fin de ce tutoriel, vous serez capable d’utiliser `do_shortcode` avec confiance et efficacité.

Pré-requis et vision d’ensemble

Avant de commencer, assurez-vous d’avoir les éléments suivants :

• Un site WordPress installé et fonctionnel.
• Accès au fichier `functions.php` de votre thème ou à un plugin personnalisé.
• Connaissance de base en PHP.

Voici un tableau récapitulatif des outils et du temps nécessaire :

| Outils | Versions | Temps estimé | |——–|———-|————–| | WordPress | 5.0+ | 30-60 minutes | | Éditeur de code | VS Code, Sublime Text | | | Accès FTP/SFTP | FileZilla | |

Tutoriel pas-à-pas

Étape 1 : Comprendre le shortcode et do_shortcode

Objectif de l’étape : Comprendre ce qu’est un shortcode et comment la fonction `do_shortcode` fonctionne.

Procédure :

1. Un shortcode est un petit morceau de code entre crochets `[ ]` qui permet d’insérer des fonctionnalités dynamiques dans vos pages ou articles. Par exemple, `[contact-form-7 id= »1234″]` pour afficher un formulaire de contact.
2. La fonction `do_shortcode` permet d’exécuter un shortcode directement dans un fichier PHP.

Code :

php echo do_shortcode('[contact-form-7 id="1234"]') 

Vérification rapide : Pour vérifier que vous comprenez bien, essayez de trouver un shortcode sur votre site et notez-le.

Erreurs fréquentes :

• Confondre `do_shortcode` avec `shortcode_atts` qui est utilisé pour gérer les attributs des shortcodes.

Étape 2 : Ajouter do_shortcode dans functions.php

Objectif de l’étape : Intégrer un shortcode dans le fichier `functions.php` de votre thème.

Procédure :

1. Connectez-vous à votre site via FTP/SFTP et accédez au dossier de votre thème.
2. Ouvrez le fichier `functions.php`.
3. Ajoutez le code suivant pour exécuter un shortcode :

Code :

php function my_custom_shortcode() { return do_shortcode('[contact-form-7 id="1234"]') } add_shortcode('my_custom_shortcode', 'my_custom_shortcode') 

Vérification rapide : Enregistrez le fichier et vérifiez que votre site fonctionne toujours correctement.

Erreurs fréquentes :

• Oublier de fermer les balises PHP `?>`.
• Utiliser des guillemets incorrects dans le shortcode.

Étape 3 : Utiliser do_shortcode dans un fichier de template

Objectif de l’étape : Intégrer un shortcode directement dans un fichier de template PHP.

Procédure :

1. Accédez au dossier de votre thème et ouvrez le fichier de template où vous souhaitez ajouter le shortcode (par exemple, `page.php`).
2. Ajoutez le code suivant à l’endroit où vous souhaitez afficher le shortcode :

Code :

php 

Vérification rapide : Enregistrez le fichier et visitez la page correspondante pour vérifier que le shortcode s’affiche correctement.

Erreurs fréquentes :

• Oublier d’échapper les guillemets dans le shortcode.
• Placer le code au mauvais endroit dans le fichier de template.

Étape 4 : Créer un shortcode personnalisé

Objectif de l’étape : Créer un shortcode personnalisé et l’utiliser avec `do_shortcode`.

Procédure :

1. Ouvrez le fichier `functions.php` de votre thème.
2. Ajoutez le code suivant pour créer un shortcode personnalisé :

Code :

php function custom_shortcode_function() { return '
Ceci est un shortcode personnalisé
' } add_shortcode('custom_shortcode', 'custom_shortcode_function') 

1. Utilisez `do_shortcode` pour exécuter ce shortcode personnalisé dans un fichier de template :

Code :

php 

Vérification rapide : Enregistrez le fichier et visitez la page correspondante pour vérifier que le shortcode personnalisé s’affiche correctement.

Erreurs fréquentes :

• Oublier de déclarer la fonction avant d’utiliser `add_shortcode`.
• Utiliser un nom de shortcode déjà existant.

Bonnes pratiques / Optimisations

Performances

• Minimiser l’utilisation de `do_shortcode` : Utilisez `do_shortcode` uniquement lorsque nécessaire pour éviter des appels inutiles et améliorer les performances.
• Cache : Utilisez des plugins de cache pour stocker les résultats des shortcodes et réduire le temps de chargement.

Sécurité

• Échappement des données : Toujours échapper les données dynamiques pour éviter les injections de code malveillant.
• Permissions : Assurez-vous que les utilisateurs ont les permissions nécessaires pour exécuter des shortcodes.

SEO on-page

• Contenu dynamique : Assurez-vous que le contenu généré par les shortcodes est pertinent et bien structuré pour le SEO.
• Balises méta : Utilisez des plugins SEO pour gérer les balises méta et les descriptions des pages générées par les shortcodes.

FAQ ciblée

Que faire si `do_shortcode` ne fonctionne pas ?

Vérifiez que le shortcode est correctement écrit et que la fonction est appelée au bon endroit dans le fichier PHP.

Puis-je utiliser `do_shortcode` dans un widget ?

Oui, vous pouvez utiliser `do_shortcode` dans un widget en ajoutant le code PHP dans le fichier de widget personnalisé.

Comment puis-je passer des attributs à `do_shortcode` ?

Vous pouvez passer des attributs en les ajoutant directement dans le shortcode, par exemple : `do_shortcode(‘[shortcode attr1= »value1″ attr2= »value2″]’)`.

Est-ce que `do_shortcode` fonctionne avec tous les plugins ?

La fonction `do_shortcode` est conçue pour être utilisée avec tous les shortcodes enregistrés dans WordPress, qu’ils proviennent du cœur de WordPress, de thèmes ou de plugins. Cependant, il est important de noter que la compatibilité dépend de la manière dont le shortcode est implémenté par le plugin ou le thème.

En général, si un plugin enregistre correctement ses shortcodes en utilisant la fonction `add_shortcode`, alors `do_shortcode` devrait fonctionner sans problème. Cependant, certains plugins peuvent avoir des dépendances spécifiques ou des conditions d’utilisation qui doivent être respectées pour que le shortcode fonctionne correctement.

Pour vérifier si un shortcode spécifique fonctionne avec `do_shortcode`, vous pouvez tester le shortcode directement dans un article ou une page de WordPress. Si le shortcode fonctionne dans ces contextes, il devrait également fonctionner avec `do_shortcode` dans vos fichiers PHP.

Si vous rencontrez des problèmes avec un shortcode spécifique, il peut être utile de consulter la documentation du plugin ou de contacter le support technique du développeur du plugin. Ils pourront vous fournir des informations supplémentaires sur la manière d’utiliser le shortcode