Héberger Google Fonts localement sur WordPress avec WPMasterToolKit

Google Fonts est une solution très pratique pour ajouter facilement de nouvelles polices à un site WordPress. De nombreux thèmes, constructeurs de pages et extensions l’utilisent d’ailleurs automatiquement.

Le problème est que les polices sont généralement chargées depuis les serveurs de Google. Le navigateur du visiteur doit donc effectuer des requêtes vers des domaines externes comme fonts.googleapis.com et fonts.gstatic.com.

Le module Local Google Font de WPMasterToolKit permet de supprimer ces requêtes en hébergeant directement les polices Google Fonts sur votre site WordPress.

L’objectif est double : limiter les dépendances envers des services externes et faciliter une configuration dans laquelle les fichiers de polices sont servis directement depuis votre propre domaine.

Quel plugin le module Local Google Font peut remplacer ?

Il existe de nombreuses extensions WordPress dédiées exclusivement à l’hébergement local de Google Fonts.

Le module Local Google Font permet de couvrir ce besoin directement depuis WPMasterToolKit, sans avoir à installer une extension supplémentaire uniquement pour cette fonctionnalité.

Cela correspond à la philosophie de WPMasterToolKit : regrouper de nombreux petits outils WordPress dans une seule extension tout en ne chargeant que les modules réellement activés.

Comment fonctionne l’hébergement local de Google Fonts ?

Une intégration classique de Google Fonts fonctionne généralement en deux étapes.

WordPress charge d’abord une feuille de style depuis :

fonts.googleapis.com

Cette feuille CSS contient ensuite des déclarations @font-face faisant référence aux fichiers de polices hébergés notamment sur :

fonts.gstatic.com

Le module Local Google Font intercepte ces feuilles de style et peut créer une copie entièrement locale.

Lorsqu’une source Google Fonts est détectée, WPMasterToolKit récupère la feuille CSS correspondante, identifie les fichiers de polices nécessaires puis télécharge les fichiers WOFF2 sur votre serveur.

Une nouvelle feuille CSS est ensuite générée afin de pointer vers ces fichiers locaux.

Une fois cette version disponible et validée, WPMasterToolKit remplace automatiquement l’URL Google Fonts originale par l’URL de la feuille de style locale.

Le navigateur du visiteur n’a donc plus besoin de récupérer ces ressources directement depuis les serveurs Google.

Détection automatique des Google Fonts utilisées par WordPress

Le module s’intègre au système de chargement des feuilles de style de WordPress.

Lorsqu’une feuille de style provenant de fonts.googleapis.com est rencontrée, elle est automatiquement enregistrée comme une source Google Fonts connue du module.

Cela permet notamment de détecter les polices ajoutées avec les mécanismes standards de WordPress par un thème ou une extension.

Le module conserve également les handles WordPress associés lorsqu’ils sont disponibles. Ils peuvent ainsi être affichés dans l’administration afin d’aider à identifier l’origine d’une police.

Seules les feuilles de style HTTPS officielles provenant de fonts.googleapis.com/css ou fonts.googleapis.com/css2 sont acceptées.

Hébergement automatique des nouvelles polices détectées

L’option Automatic hosting permet d’héberger automatiquement une nouvelle source Google Fonts dès qu’elle est détectée.

Cette option est activée par défaut.

Lorsqu’une nouvelle feuille Google Fonts apparaît, WPMasterToolKit tente donc de récupérer immédiatement les fichiers nécessaires et de créer sa version locale.

Si la génération aboutit, les prochains chargements utilisent directement la feuille de style locale.

Si l’hébergement local échoue, le module conserve l’URL originale au lieu de remplacer la ressource par une feuille incomplète. Le site peut ainsi continuer à utiliser la source Google Fonts existante.

Scanner manuellement la page d’accueil

Certaines polices peuvent ne pas avoir encore été rencontrées depuis l’activation du module.

Pour faciliter leur détection, l’interface propose un bouton Scan homepage.

WPMasterToolKit effectue alors une requête vers la page d’accueil du site et recherche dans son contenu les URLs correspondant aux feuilles de style Google Fonts.

Les nouvelles sources trouvées sont enregistrées dans le module et peuvent ensuite être hébergées localement.

Cette fonction est particulièrement pratique juste après l’activation du module pour initialiser rapidement la liste des Google Fonts utilisées sur le site.

Gérer individuellement les sources Google Fonts

Toutes les sources détectées sont visibles dans l’administration de WPMasterToolKit.

Pour chaque source, le module peut notamment afficher son état, les familles de polices détectées, leurs variantes, le nombre de fichiers téléchargés, leur taille totale et la date de génération.

Trois états principaux permettent de savoir rapidement où en est une source :

Discovered signifie que la feuille Google Fonts a été détectée mais qu’aucune version locale valide n’est actuellement utilisée.

Hosted locally indique que les fichiers nécessaires ont été téléchargés et que la version locale est prête.

Hosting failed indique qu’une erreur s’est produite pendant la génération.

Lorsqu’une erreur est disponible, elle est également affichée dans l’interface.

Recharger une police locale

Google peut faire évoluer les fichiers associés à une feuille de style ou vous pouvez simplement souhaiter reconstruire les fichiers locaux.

Le bouton Reload fonts permet de relancer la génération d’une source déjà hébergée.

WPMasterToolKit télécharge alors à nouveau les ressources nécessaires et crée une nouvelle génération de la source.

Cette nouvelle version n’est utilisée qu’après avoir été entièrement générée.

Supprimer les fichiers locaux

Une source hébergée peut également être supprimée individuellement avec l’action Remove hosted files.

Les fichiers locaux correspondants sont alors effacés et la source revient à l’état découvert.

Il est également possible d’utiliser Remove all hosted data pour supprimer l’ensemble des fichiers locaux et des sources découvertes pour le site courant.

Le module repart alors avec une liste de sources vide.

Un changement de thème déclenche également un nettoyage de ces données. Cela évite de conserver les Google Fonts découvertes pour un thème qui n’est désormais plus actif.

URLs relatives ou absolues pour les polices

Le réglage Generated font URLs permet de choisir la manière dont les fichiers de polices sont référencés dans la feuille CSS générée.

Par défaut, WPMasterToolKit utilise des chemins relatifs.

Par exemple, la feuille CSS locale peut référencer un fichier situé dans le même dossier avec une URL de ce type :

./font-file.woff2

Lorsque cette option est désactivée, une URL complète vers le fichier local est utilisée.

Si ce réglage est modifié, WPMasterToolKit reconstruit les feuilles CSS des sources déjà disponibles afin qu’elles utilisent immédiatement le nouveau format d’URL.

Suppression des connexions devenues inutiles vers Google

Les thèmes ou extensions WordPress peuvent ajouter des indications de ressources telles que preconnect ou dns-prefetch vers Google Fonts.

Ces optimisations sont utiles lorsque les polices sont réellement téléchargées depuis Google, mais deviennent inutiles lorsque toutes les sources connues sont disponibles localement.

WPMasterToolKit peut donc retirer les indications preconnect et dns-prefetch pointant vers :

fonts.googleapis.com

et :

fonts.gstatic.com

Cette suppression est volontairement prudente : elle n’est effectuée que lorsque toutes les sources Google Fonts découvertes disposent d’une version locale valide.

Si une source doit encore être récupérée depuis Google, les indications de connexion sont conservées.

Comment utiliser le module Local Google Font ?

Commencez par activer Local Google Font depuis la liste des modules de WPMasterToolKit.

Vous pouvez ensuite ouvrir sa page de configuration.

Dans la majorité des cas, vous pouvez conserver Automatic hosting activé afin que les nouvelles Google Fonts détectées soient automatiquement téléchargées sur votre serveur.

Utilisez ensuite Scan homepage pour rechercher immédiatement les Google Fonts présentes sur votre page d’accueil.

Les différentes sources apparaîtront dans la liste. Vous pourrez vérifier leur état et, si nécessaire, utiliser Host locally pour déclencher manuellement leur téléchargement.

Une fois la source prête, WPMasterToolKit se charge automatiquement d’utiliser la feuille CSS locale à la place de celle hébergée par Google.

Où sont stockées les polices ?

Les fichiers générés sont enregistrés dans le répertoire wp-content de WordPress, dans un espace réservé à WPMasterToolKit.

Chaque site possède son propre répertoire et chaque source Google Fonts dispose ensuite de son propre dossier.

Cette séparation est également prévue pour les installations WordPress multisite : l’identifiant du site courant est intégré au chemin de stockage.

Chaque génération contient notamment les fichiers WOFF2 téléchargés, la feuille font.css utilisée par le site et un manifeste décrivant les ressources de cette génération.

Nos choix techniques pour fiabiliser l’hébergement local

Télécharger automatiquement des fichiers distants et modifier les ressources utilisées sur le frontend nécessite quelques précautions.

C’est pourquoi le module ne se contente pas de télécharger une police puis de remplacer immédiatement son URL.

Validation stricte des sources Google Fonts

Les feuilles de style acceptées doivent utiliser HTTPS et provenir précisément de fonts.googleapis.com, sur les endpoints /css ou /css2.

Les URLs contenant des identifiants, mots de passe ou ports personnalisés sont refusées.

Validation des fichiers de polices

Les fichiers téléchargés sont également contrôlés.

Le module travaille avec des fichiers WOFF2 et vérifie notamment leur réponse HTTP, leur type de contenu lorsqu’il est fourni, leur taille et leur signature de fichier.

La taille maximale acceptée pour un fichier de police est de 5 Mo, tandis qu’une source complète ne peut pas dépasser 50 Mo.

Ces limites permettent notamment d’éviter qu’une source inattendue provoque le téléchargement de quantités excessives de données.

Générations immuables

Lorsqu’une source est reconstruite, WPMasterToolKit crée une nouvelle génération dans un dossier temporaire.

Les polices, la feuille CSS et son manifeste sont préparés avant que cette génération ne devienne la version active.

Cela évite autant que possible de servir une génération partiellement construite pendant une mise à jour.

Le module conserve également un nombre limité d’anciennes générations et supprime les plus anciennes.

Vérification avant utilisation

Avant de remplacer une feuille Google Fonts distante, WPMasterToolKit vérifie la génération locale.

Le manifeste doit être valide, la feuille CSS doit être présente, les fichiers de polices attendus doivent exister et leur taille doit correspondre aux informations enregistrées.

La feuille CSS locale ne doit également plus contenir de référence vers fonts.gstatic.com.

Si ces vérifications échouent, la source locale n’est pas considérée comme prête.

Protection contre les opérations simultanées

Le module utilise également un système de verrouillage par source.

Il évite par exemple que deux requêtes tentent de reconstruire ou de supprimer simultanément les mêmes fichiers.

Ces verrous possèdent une durée d’expiration afin qu’un traitement interrompu ne puisse pas bloquer définitivement une source.

Filtres disponibles pour les développeurs

Le module expose deux filtres WPMasterToolKit qui permettent à d’autres parties du site ou à des développeurs d’utiliser son mécanisme de détection et de remplacement.

wpmastertoolkit/local_google_font/replace_url

Ce filtre permet de transmettre une URL susceptible d’être une feuille de style Google Fonts au module.

$url = apply_filters(
	'wpmastertoolkit/local_google_font/replace_url',
	$url,
	$handle
);

Le premier paramètre correspond à l’URL de la feuille de style et le second au handle optionnel associé.

Si l’URL n’est pas une feuille Google Fonts compatible, elle est retournée telle quelle.

Si elle correspond à une source Google Fonts, le module la découvre et retourne la version locale lorsqu’une génération valide est disponible. Avec l’hébergement automatique activé, le module peut également tenter de générer cette version locale.

wpmastertoolkit/local_google_font/replace_in_content

Ce filtre permet de rechercher les URLs Google Fonts présentes directement dans une chaîne de caractères :

$content = apply_filters(
	'wpmastertoolkit/local_google_font/replace_in_content',
	$content
);

WPMasterToolKit recherche alors les URLs correspondant à fonts.googleapis.com/css ou fonts.googleapis.com/css2 dans le contenu et les traite avec son système de remplacement.

Cela peut être utile lorsqu’une intégration ajoute directement une URL Google Fonts dans du HTML ou un autre contenu plutôt que de passer par le système classique d’enqueue des styles de WordPress.

Conclusion

Le module Local Google Font de WPMasterToolKit permet de transformer automatiquement les Google Fonts distantes utilisées par WordPress en ressources hébergées directement sur votre site.

Il détecte les feuilles de style Google Fonts, télécharge les fichiers WOFF2, génère le CSS local, vérifie l’intégrité de la génération puis remplace les URLs distantes lorsqu’une version locale fiable est disponible.

Le module propose également un scan manuel, une gestion détaillée des sources, le rechargement des polices, le nettoyage des fichiers et la suppression des connexions inutiles vers les serveurs Google.

Vous pouvez ainsi conserver les polices Google utilisées par votre thème ou vos extensions tout en réduisant les dépendances externes et en gardant davantage de contrôle sur la manière dont ces ressources sont servies aux visiteurs.