Comment ajouter en toute sécurité du code personnalisé aux sites Web WordPress

Les utilisateurs recherchent souvent des moyens de modifier leurs sites Web, leurs plugins et leurs thèmes, ou d'ajouter des modifications à une fonctionnalité existante. Dans la plupart de ces cas, vous pouvez le faire en ajoutant du code personnalisé à votre site Web WordPress.

Il n'y a rien de mal à ajouter du code personnalisé à votre site Web. Cependant, vous devez faire attention à certaines choses lorsque vous apportez ces modifications à votre site Web WordPress.

Cet article met en évidence ce qu'il faut rechercher et les meilleures pratiques pour ajouter du code personnalisé à votre site Web WordPress.

Que rechercher avant d'ajouter des extraits de code personnalisés dans WordPress

Le moyen le plus simple d'ajouter des extraits de code suggérés par les auteurs dans leurs didacticiels consiste à ajouter l'extrait de code au fichier functions.php du thème. Cependant, il existe un certain nombre de restrictions et d'inconvénients lorsque vous ajoutez des extraits de code au fichier functions.php du thème.

Chaque fois que vous mettez à jour votre thème, les extraits de code personnalisés que vous avez ajoutés à votre fichier functions.php seront écrasés, sauf si vous mettez à jour manuellement le thème ou copiez manuellement les extraits de code d'un fichier functions.php à l'autre. Sachant que la plupart des développeurs publient des mises à jour assez fréquemment, en particulier lors de l'utilisation de thèmes premium, l'ajout d'extraits de code au fichier functions.php du thème devient très difficile à maintenir.

De plus, si vous souhaitez modifier le thème, vous devez également migrer le code, ce qui n'est certainement pas bon à long terme.

Un autre inconvénient est que les fichiers de thème sont exécutés sur chaque page et en ajoutant les extraits de code au fichier functions.php du thème, les risques de casser l'ensemble de votre site Web sont beaucoup plus élevés.

Découvrons les meilleures pratiques sur la façon d'ajouter des extraits de code personnalisés à votre site WordPress, afin que vous n'ayez plus à vous soucier de manquer un extrait de code, d'oublier de le migrer ou de casser une fonctionnalité lors de la mise à niveau de votre thème.

Ajout d'extraits de code personnalisés aux sites WordPress

Le code personnalisé peut être ajouté à l'aide de l'une des méthodes suivantes :

• Utiliser un plugin (reportez-vous à notre introduction aux plugins WordPress pour en savoir plus sur ce que sont les plugins WordPress)
• Création d'un plugin personnalisé
• Créer un thème enfant

Maintenant, discutons en détail de chacune des méthodes.

1. Utilisation du plug-in d'extraits de code

Les extraits de code ¹ Le plugin est un excellent moyen d'ajouter du code personnalisé au site WordPress, et si vous n'êtes pas fan de l'écriture de code vous-même, cette méthode est plus simple que de créer votre propre plugin.

Après avoir installé le plugin, une nouvelle section Snippets est ajoutée à votre menu WordPress, ce qui vous permet d'ajouter de nouveaux extraits. Chaque extrait aura un espace pour le code et une description pour des informations supplémentaires sur ce que fait le code.

Conseil : Si vous utilisez un extrait de code utile d'un site, ajoutez l'URL dans la description, afin de vous rappeler d'où provient le code.

Tout comme les plugins, vous pouvez activer et désactiver vos extraits de code personnalisés ainsi que les exporter dans des fichiers PHP. Dans certains cas, les extraits de code personnalisés provoquent des conflits avec d'autres plugins ou thèmes, donc la désactivation de tout le code personnalisé est utile pour cibler les problèmes.

2. Créer votre propre plugin spécifique au site

La création de votre propre plugin personnalisé spécifique au site est le meilleur moyen d'ajouter du code personnalisé aux sites WordPress, car vous avez un contrôle total sur le code.

Qu'est-ce qu'un plugin WordPress spécifique à un site ?

Un plugin WordPress spécifique au site est utilisé pour ajouter un code de personnalisation à un site Web qui ne dépend pas du thème. Cela signifie que quel que soit le thème que vous utilisez, ou si vous passez d'un thème à l'autre, le code personnalisé de votre plugin fonctionnera toujours, bien sûr tant que le plugin est activé.

Pourquoi est-il préférable de créer un plugin WordPress spécifique au site ?

Si vous ajoutez le code personnalisé au fichier de fonctions de votre thème, il disparaîtra si vous mettez à jour ou changez de thème.

Un plugin WordPress spécifique au site vous permet d'ajouter facilement des extraits de code personnalisés à votre site WordPress et de vous assurer qu'ils sont indépendants du thème. Il s'agit d'un plugin WordPress autonome, ce qui signifie qu'il ne dépend pas de votre thème, ce qui signifie que vous pouvez librement mettre à jour ou changer de thème sans perdre le code personnalisé.

Vous n'avez pas besoin d'être un gourou PHP pour créer un plugin WordPress spécifique au site. Suivez simplement les étapes ci-dessous.

1. Créez le répertoire du plugin

Tout d'abord, vous devrez créer un répertoire pour le plugin et le nommer. Il peut s'agir de n'importe quel nom, tel que le site Web du site. Le répertoire du plugin doit être créé dans le répertoire /wp-content/plugins/ de votre site Web. Pour cet exemple, nous appelons le plugin wpwhitesecurity-shortcodes . Remarque : utilisez toujours des tirets et non des espaces dans les noms de répertoire.

2. Créez le fichier du plug-in

Ensuite, vous aurez besoin d'un fichier principal pour votre plugin. Bien qu'il n'y ait pas de règles concernant le nom du fichier, la meilleure pratique consiste à ce que le nom du fichier soit le même que le nom du plug-in. Ainsi, dans notre exemple, le nom de fichier du plugin est wpwhitesecurity-shortcodes.php .

Ce fichier doit au moins comporter un titre et une description.

Créez ce fichier à l'aide d'un éditeur de texte, tel que NotePad ++ ou TextEdit. N'utilisez pas Microsoft Word ou des éditeurs similaires, car cela ajoute des données de mise en forme au texte et cela pourrait gâcher votre fichier. Tous les éditeurs listés ci-dessus sont gratuits.

Voici tout ce que vous devez ajouter au fichier :

<?php
/*
* Plugin Name: WP White Security Shortcodes
* Plugin URL: https://www.wpwhitesecurity.com
* Description: Site-specific plugin for custom code snippets in wpwhitesecurity.com
*/

C'est tout. Il est maintenant temps d'ajouter le code personnalisé.

3. Ajoutez les extraits de code personnalisés

Vous pouvez maintenant copier et coller les extraits de code des didacticiels, etc. dans ce fichier. Si vous avez créé le fichier du plugin hors ligne, compressez le dossier du plugin en tant que fichier .zip et téléchargez-le sur votre site Web à partir du tableau de bord WordPress.

À partir de maintenant, vous n'avez plus à vous soucier de manquer un extrait de code, d'oublier de le migrer ou de casser certaines fonctionnalités lors de la mise à niveau de votre thème ou de votre WordPress. La prochaine fois que vous rencontrerez un extrait de code WordPress et que vous souhaitez l'ajouter à votre site Web, ajoutez-le au fichier de plug-in spécifique au site.

4. Ajoutez un fichier index.php (facultatif)

Ceci est une étape optionnelle. Pour éviter la liste des répertoires, vous devez ajouter un fichier d'index dans le répertoire du plugin. Tout ce que vous avez à faire est de :

Créez un fichier appelé index.php
Ajoutez-y le contenu suivant :

<?php
/**
* Nothing to see here.

3. Utilisez les fonctions du thème enfant.php

Plus tôt, nous avons dit de ne pas utiliser le fichier functions.php de votre thème. Cependant, c'est une bonne alternative pour certains changements, par exemple, pour des changements spécifiques à un thème. De cette façon, le code personnalisé spécifique au thème est sorti lorsque votre thème l'est, car il ne sera plus nécessaire.

Néanmoins, les changements de thème doivent toujours être ajoutés au thème enfant, et non au thème parent, il est donc sûr pour la mise à jour.

Si vous ajoutez du code à votre functions.php , assurez-vous toujours de rechercher les balises PHP fermantes. Voici à quoi ils ressemblent : ?> . Si votre fichier de thème se termine par l'un d'entre eux, vous devez placer le code personnalisé au-dessus.

Conclusion

Comme nous venons de le voir, il existe plusieurs façons d'ajouter du code personnalisé à votre site Web WordPress, mais toutes ne sont pas bonnes à long terme. Cependant, certains d'entre eux sont meilleurs que d'autres dans des domaines spécifiques. Par exemple, pour les modifications spécifiques au thème (apparence et convivialité du site Web), ajoutez un code personnalisé au fichier functions.php . Pour toute autre modification, vous devriez idéalement créer votre plugin personnalisé spécifique au site

Assurez-vous simplement que vous ajoutez du code personnalisé à WordPress de manière sûre et facilite le débogage en cas de problème.
Nous espérons que cet article vous a aidé à apprendre comment ajouter facilement des extraits de code personnalisés dans vos sites WordPress.