Centralisez vos bouts de code avec “Code Snippets”

On se sert souvent des bouts de code pour ajouter des fonctionnalités à WordPress, ou pour modifier le comportement de fonctionnalités génériques. Les placer dans le fichier functions.php est la norme, mais c'est aussi le meilleur moyen de les perdre lors d'une mise à jour ou d'un changement de thème. Une extension, Code Snippets, permet de les gérer en toute sécurité.

Cet article prend 4 minutes à lire et comporte 835 mots.

Plac­er vos bouts de code dans le fichi­er functions.php est devenu une norme, et pour­tant, ce n’est pas une bonne pra­tique.

Nous allons voir pourquoi il ne faut pas se servir de ce fichi­er pour vos bouts de code, et surtout, quelle solu­tion met­tre en œuvre.

Le fichier functions.php, les extensions et Code Snippets

À quoi sert exacte­ment le fichi­er functions.php ? À mod­i­fi­er le com­porte­ment du thème. Il peut être com­paré à une exten­sion dédiée au thème.

Tout ce qui con­cerne le thème, et unique­ment le thème, peut être ajouté dans ce fichi­er. Mais si c’est le com­porte­ment de Word­Press, indépen­dam­ment du thème, que vous voulez mod­i­fi­er, il faut utilis­er une exten­sion.

C’est d’ailleurs ce que dit le Codex dans un arti­cle (en anglais) con­cer­nant le développe­ment de thèmes :

Vous pou­vez con­stater que la même fonc­tion doit être disponible pour plus d’un thème par­ent. Si tel est le cas, la fonc­tion doit être créée dans une exten­sion plutôt que dans le fichi­er functions.php du thème. Cela peut inclure des balis­es de mod­èle et d’autres fonc­tions spé­ci­fiques. Les fonc­tions con­tenues dans les exten­sions seront vues par tous les thèmes.

Codex Word­Press

Pour autant, vous n’au­rez prob­a­ble­ment pas envie de créer une exten­sion pour chaque bout de code. Autant les cen­tralis­er, pour pou­voir les retrou­ver facile­ment au besoin.

Pre­mière solu­tion…

Développer sa propre extension

Créer une exten­sion n’est pas com­pliqué. Un sim­ple fichi­er PHP peut suf­fire, à con­di­tion de respecter cer­taines règles sim­ples.

Mais cette solu­tion implique quand même quelques con­nais­sances de base en pro­gram­ma­tion et n’est pas à la portée de tous les blogueurs.

Il existe bien heureuse­ment une solu­tion alter­na­tive, bien plus sim­ple à met­tre en œuvre…

Utiliser l’extension Code Snippets

Regrouper tous les bouts de code et les gér­er comme vos arti­cles ou vos pages… c’est exacte­ment ce à quoi sert l’ex­ten­sion Code Snip­pets.

Pour l’in­stal­la­tion et l’ac­ti­va­tion, je vous ren­voie à l’ar­ti­cle Installer, activ­er, met­tre à jour et sup­primer une exten­sion Word­Press.

Une fois l’ex­ten­sion activée, une entrée Snip­pets est insérée dans le menu latéral de l’in­ter­face d’ad­min­is­tra­tion de Word­Press.

Utiliser Code Snippets

Configurer l’extension

L’in­ter­face d’ad­min­is­tra­tion n’est pas traduite en français, pour autant, vous pou­vez vous servir de l’ex­ten­sion sans touch­er au moin­dre réglage.

Réglages - Code Snippets
Réglages — Code Snip­pets

Mais pour le moment, c’est une boîte vide qui n’at­tend que vos bouts de code pour les met­tre en action.

Ajouter un bout de code

Vous pou­vez cli­quer directe­ment dans le menu sur Add New, ou dans l’in­ter­face de ges­tion de l’ex­ten­sion, sur Add New ou sur En ajouter un →.

ajouter un bout de code
ajouter un bout de code

Voici à quoi ressem­ble l’in­ter­face dans laque­lle vous allez saisir votre bout de code :

interface de création d'un bout de code
inter­face de créa­tion d’un bout de code

Et voici la même inter­face, une fois la saisie ter­minée :

exemple de bout de code
exem­ple de bout de code

Si vous éditez un bout de code précédem­ment enreg­istré, vous n’au­rez plus deux mais qua­tre bou­tons : Enreg­istr­er les mod­i­fi­ca­tions, Enreg­istr­er et [dés]activer, Exporter et Sup­primer.

boutons d'enregistrement / export / suppression
bou­tons d’en­reg­istrement / export / sup­pres­sion

Le périmètre d’action du bout de code

Tous les bouts de code n’ont pas à être exé­cutés en per­ma­nence : cer­tains ne sont utiles que dans l’in­ter­face d’ad­min­is­tra­tion, d’autres sont néces­saires pour l’af­fichage du blog… autant ne pas gaspiller de ressources inutile­ment (dans un souci d’op­ti­mi­sa­tion).

Vous avez vos bouts de code, mais si vous voulez réin­staller votre blog dans son inté­gral­ité ? Inutile de vous tra­cass­er, Code Snip­pets a tout prévu pour…

Importer et exporter des bouts de code

Partager un bout de code, ou tous vos bouts de code, les trans­fér­er d’un blog à l’autre si vous changez d’hébergeur ou si vous voulez les réu­tilis­er sur un autre blog est un jeu d’en­fant.

Chaque bout de code peut être exporté indi­vidu­elle­ment ou par lots :

Exporter des bouts de code
Exporter des bouts de code

L’im­por­ta­tion est tout aus­si sim­ple : il suf­fit d’aller dans l’en­trée de menu Snip­pets > Import, de sélec­tion­ner le fichi­er XML à importer avant de cli­quer sur Trans­fér­er et Importer.

importer des bouts de code

Je vous pro­pose cinq bouts de code dont je me sers régulière­ment sur mes blogs, à dézip­per et à importer une fois Code Snip­pets instal­lé et activé (c’est le fichi­er json de l’archive qu’il faut importer, pas l’archive elle-même).

Ces bouts de code ser­vent à sup­primer les infor­ma­tions con­cer­nant la ver­sion de Word­Press util­isée, à per­me­t­tre l’u­til­i­sa­tion de l’e­space insé­ca­ble, à ne pas affich­er les mes­sages d’er­reur lors de ten­ta­tives de con­nex­ion infructueuses, à cal­culer et insér­er le temps de lec­ture et le nom­bre de mots d’un arti­cle, et à sup­primer l’at­trib­ut nofollow des liens dans les com­men­taires.

Voilà, vous avez (enfin !) une solu­tion sim­ple pour gér­er effi­cace­ment vos bouts de code 😉

Et vous, utilisez-vous Code Snip­pets pour vos bouts de code, ou envis­agez-vous de l’u­tilis­er ?

5 réflexions sur “Centralisez vos bouts de code avec “Code Snippets””

    1. L’e­space insé­ca­ble per­met par exem­ple d’écrire 10 000 et de ne pas le voir coupé en fin de ligne (10 en fin de ligne, 000 en début de ligne suiv­ante). C’est intéres­sant pour les nom­bres, pour les guillemets (‘«’ en fin de ligne, hum…), mais aus­si pour cer­taines expres­sions quand on veut leur don­ner plus d’im­pact.

  1. Bon­jour,
    Mer­ci pour cet excel­lent arti­cle.
    Le télécharge­ment des bouts de code ne fonc­tionne pas :
    Erreur 404 !!!

Les commentaires sont fermés.

Retour en haut
Les cookies que nous utilisons sont indispensables au bon fonctionnement de ce site. Il n'y a aucun pistage publicitaire et les données statistiques recueillies sont anonymisées.
J'ai compris