Modifier le numéro de version par défaut des ressources de WordPress

Numéro de version

Quand on regarde le code source généré par WordPress, vous pouvez remarquer que sur toutes les ressources (ou presque) est appliqué un numéro de version. Comme vous pouvez le voir sur cette capture :

En jaune la version de WordPress au moment ou j’ai écrit l’article

Cela permet au moment d’une mise à jour d’une ressource (css, script javascript, etc.), d’indiquer au serveur que le fichier n’est pas le même. Ca permet surtout de mettre à jour le cache du serveur afin de rafraîchir la donnée.

Quand on ajoute une ressource, il est important de noter la version de la bibliothèque, sinon il est appliqué par défaut la version de WordPress (4.7 dans notre exemple).

L’exemple suivant montre la méthode à utiliser avec WordPress avec wp_enqueue_scripts.

[pastacode lang= »php » manual= »%3C%3Fphp%0Afunction%20ctw_load_scripts()%7B%0A%09%2F%2F%20http%3A%2F%2Frickharrison.github.io%2Fvalidate.js%2F%0A%09wp_register_script(%20’validatejs’%2C%20%20CTW_PLUGIN_URL.’%2Flib%2Fvalidate%2Fvalidate.min.js’%20%2C%20array()%2C%20’2.0’%2C%20true)%3B%0A%09wp_enqueue_script(%20’validatejs’)%3B%0A%7D%0Aadd_action(‘wp_enqueue_scripts’%2C%20’ctw_load_scripts’%2C%2010)%3B%0A%3F%3E%0A%3F%3E » message= »Exemple d’enregistrement de ressources, la version de la ressource est 2.0  » highlight= » » provider= »manual »/]

Version en mode projet

Quand on travail sur un projet plus important qu’un simple blog, il peut être fastidieux de mettre à jour toutes ces versions, surtout pour des correctifs mineurs des ressources.

Alors plutôt que d’attendre la nouvelle version de WordPress pour mettre à jour le site 😉 ou évidemment d’incrémenter à chaque modification d’un fichier la version, c’est de remplacer la version par défaut de WordPress par un numéro de version de votre projet. Et permettre une mise à jour automatique de vos ressources à la mise à jour de la version de votre projet.

Voici une méthode simple pour le faire, il suffit de remplacer le numéro de version par défaut pour les variables globales $wp_styles et $wp_scripts :

[pastacode lang= »php » manual= »%3C%3Fphp%0A%2F%2F%20On%20d%C3%A9finit%20le%20num%C3%A9ro%20de%20version%2C%20dans%20une%20constante%20par%20exemple%0Adefine(‘CTW_VERSION’%2C%201.10)%3B%0A%0A%0A%0Afunction%20ctw_load_scripts()%7B%0A%0A%09%2F%2F%20On%20appelle%20les%20variables%20globales%20pour%20les%20ressources%0A%09global%20%24wp_styles%2C%20%24wp_scripts%3B%0A%0A%09%2F%2F%20On%20remplace%20la%20version%20WP%20par%20la%20version%20PTW%0A%09%24wp_styles-%3Edefault_version%20%20%3D%20CTW_VERSION%3B%0A%09%24wp_scripts-%3Edefault_version%20%3D%20CTW_VERSION%3B%0A%09%0A%09%2F*%20…%20Reste%20des%20scripts%20%0A%09wp_register_script(%20…)%3B%0A%09wp_enqueue_script(%20…)%3B%0A%09*%2F%0A%7D%0Aadd_action(‘wp_enqueue_scripts’%2C%20’ctw_load_scripts’%2C%2010)%3B%0A%0A%3F%3E » message= »Remplacer le numéro de version par défaut des ressources WordPress » highlight= » » provider= »manual »/]

Le numéro de version peut être définis dans le thème ou le plugin qu’importe.

Ne pas afficher la version sur les ressources

Petit bonus, si jamais vous ne voulez pas afficher ce numéro de version, comme préconisé par GtMetrix :

Il y a un moyen simple qui est de supprimer la version, seulement attention, le cache ne sera pas vidé à chaque mise à jour, il faudra vider le cache du serveur manuellement mais on ne pourra pas vider celui du navigateur du visiteur, c’es donc non recommandé.

[pastacode lang= »php » manual= »%3C%3Fphp%0A%0A%2F*%20Non%20recommand%C3%A9%20*%2F%0Aadd_filter(%20’script_loader_src’%2C%20’ctw_remove_script_ver’%2C%2012%2C%201%20)%3B%0Aadd_filter(%20’style_loader_src’%2C%20’ctw_remove_script_ver’%2C%2012%2C%201%20)%3B%0A%0A%2F*%20Non%20recommand%C3%A9%20*%2F%0Afunction%20ctw_remove_script_ver(%20%24src%20)%7B%0A%09%24parts%20%3D%20explode(%20’%3F’%2C%20%24src%20)%3B%0A%09return%20%24parts%5B0%5D%3B%0A%7D%0A%3F%3E » message= »Supprimer les numéro de version sur les ressources scripts et styles » highlight= » » provider= »manual »/]

Le mieux pour faire disparaître est de faire du cache busting décrit içi : https://www.screenfeed.fr/plugin-wp/sf-cache-busting/