Qu’est-ce que le fichier theme.json dans WordPress?

Utilisez-vous un thème de bloc et voyez-vous le fichier theme.json dans WordPress? Peut-être vous demandez-vous quel est le but de ce fichier et si vous devez le modifier.

Le fichier theme.json joue un rôle crucial dans l’expérience d’édition complète de site proposée par WordPress. Pour tirer pleinement partie des thèmes de blocs, il est donc important de comprendre ce que fait le fichier theme.json et comment l’éditer correctement.

C’est pourquoi nous avons élaboré ce guide complet. Dans cet article, nous vous expliquerons ce qu’est un fichier theme.json et comment l’utiliser pour personnaliser votre site WordPress.

Qu’est-ce que le fichier WordPress theme.json?

Le fichier theme.json est un fichier de thème spécial introduit dans la version 5.8 de WordPress. Il joue un rôle clé dans l’expérience d’édition de site complet (Full Site Editing). Il contribue à vous permettre de personnaliser visuellement chaque aspect de votre thème de bloc WordPress.

Essentiellement, le fichier theme.json agit comme un plan directeur. Il contrôle le style et la fonctionnalité de votre thème de bloc.

Il contient du code qui indique à WordPress comment les différents éléments doivent se comporter Cela inclut notamment les couleurs, la typographie, les mises en page et les modèles.

Pourquoi les thèmes de bloc WordPress ont-ils besoin d’un fichier theme.json?

L’édition d’un thème de bloc dans WordPress fonctionne de manière différente de l’édition d’un thème classique. Nous allons rapidement résumer pour vous les différences techniques entre les deux.

Les thèmes classiques utilisent le fichier functions.php pour activer des fonctionnalités avec la fonction add_theme_support(). Celles-ci incluent notamment des éléments comme des menus personnalisés ou des images.

Il est aussi possible de personnaliser le style de ces fonctionnalités. Pour ce faire, il suffit de définir des règles CSS dans le fichier style.css.

Dans les thèmes de bloc, tout ce qui définit l’apparence du thème se trouve dans le fichier theme.json, qui agit comme un pôle central.

Il vous permet de définir des éléments tels que les polices, les couleurs et les options de mise en page. Et tout cela, à partir du même endroit. Plus besoin d’utiliser add_theme_support() dans functions.php.

Le fichier functions.php des thèmes de blocs donc est souvent moins volumineux que son équivalent dans les thèmes classiques.

Les avantages du fichier theme.json de WordPress

Le fichier theme.json offre de grands avantages par rapport au système de thème classique précédent.

Tout d’abord, il fonctionne main dans la main avec l’éditeur de site WordPress complet. Cela vous permet de personnaliser facilement les styles et les paramètres de votre thème directement dans l’éditeur. Il n’est plus nécessaire de toucher un code.

De plus, theme.json permet de créer une expérience cohérente pour les développeurs et les utilisateurs. Grâce à lui, changer de thème est devenu un processus plus fluide, car tout est organisé de manière similaire.

Le fichier theme.json permet finalement aux développeurs et aux utilisateurs de plus facilement sauvegarder leur travail.

Où trouvez-vous le fichier WordPress theme.json?

Le fichier theme.json se trouve dans le répertoire de votre thème WordPress sur votre serveur web. Le chemin d’accès typique est public_html » wp-content » themes » votre-thème » theme.json.

Pour y accéder, vous devez d’abord vous connecter à votre site via FTP ou le Gestionnaire de fichiers de cPanel.

Une fois que vous l’avez trouvé, vous pouvez afficher le fichier theme.json en utilisant un éditeur de texte ou de code.

À quoi ressemble le fichier theme.json ?

Le fichier theme.json a une structure spécifique qui organise tous les paramètres globaux pour votre thème de bloc WordPress.

Le fichier peut parfois être très court, d’autres fois beaucoup plus long, La longueur varie beaucoup en fonction de la complexité ou la simplicité de votre thème.

Le contenu du fichier peut toutefois facilement diviser ce fichier en 7 sections de haut niveau. Voici un résumé de ces éléments :

{
"$schema": "https://schemas.wp.org/trunk/theme.json",
"version": 2,
"settings": {},
"styles": {},
"customTemplates": {},
"templateParts": {},
"patterns": []
}

Schéma

Cette première partie est en fait facultative pour les thèmes de bloc. Vous pouvez donc la voir ou pas dans votre fichier.

La propriété schema relie l’URL au schéma JSON WordPress qui lui est associé. Celui-ci définit les paramètres globaux, les styles et les autres configurations du thème.

Version

Cette section spécifie quelle version API du format theme.json est utilisée par le fichier. Elle permet d’assurer qu’il suit une structure correcte et appropriée. À l’heure actuelle, la version valide de l’API est 2.

Paramètres (settings)

Cette propriété définit les options et les contrôles disponibles aux utilisateurs pour personnaliser leur thème. Ceux-ci incluent des préréglages pour les divers paramètres, comme la palette de couleurs, la typographie, l’espacement, les bordures, etc.

Le langage et la syntaxe utilisés sont généralement assez facile à comprendre. Il n’est pas compliqué d’identifier quels paramètres définissent les couleurs, les familles de polices et autres paramètres.

Au besoin, vous pouvez consulter la référence officielle des paramètres WordPress. Ceux-ci seront utiles pour créer vos propres préréglages.

Styles

La section Paramètres vu précédemment définit les options de personnalisation par défaut du thème. C’est toutefois la section Styles qui les applique au thème.

Vous pouvez appliquer les paramètres personnalisés à l’ensemble du site web ou au niveau des blocs en utilisant des préréglages. Ils utilisent les valeurs définies dans la section des paramètres.

Modèles personnalisés (custom templates)

Les développeurs de thème de bloc peuvent créer des mises en page prédéfinies pour divers éléments. Ils peuvent s’appliquer pour des pages, des publications ou des types d’éléments pouvant être utilisés. Vous pouvez bien sûr les utiliser pour créer votre site web et son contenu.

Une chose à noter est que le fichier theme.json ne fait référence aux modèles que par leur nom. Il fournit aussi des métadonnées à leur sujet, dont leur titre et les types de publications auxquels ils sont destinés.

Cependant, l’apparence et les fonctionnalités réelles des modèles personnalisés sont définies ailleurs. LA magie s’opère plutôt dans des fichiers de modèle distincts à l’intérieur du dossier de thème.

Pour les voir, vous pouvez aller à l’emplacement: public_html » wp-content » themes » votre-thème » templates.

Pièces de modèle (template parts)

Les parties de modèle sont des zones réutilisables que vous pouvez appliquer à vos modèles personnalisés. Il s’agit d’éléments comme les en-têtes, les pieds de page, les barres latérales, etc.

Comme les modèles personnalisés, le fichier theme.json ne fait référence qu’aux noms des modèles. Leur apparence réelle est définie dans leurs propres fichiers de pièces de modèle. Ceux-ci se retrouvent dans le répertoire des pièces.

Motifs (patterns)

Les modèles sont des collections prédéfinies de blocs qui vous permettent de créer des mises en page personnalisées sur vos pages, vos publications ou ailleurs dans votre thème.

Dans l’éditeur de site complet de WordPress, vous trouverez un menu Motifs ou Patterns. C’est là que vous pouvez trouver tous les modèles disponibles pour votre thème de bloc Gutenberg.

Grâce à theme.json, les développeurs peuvent référencer des modèles directement à partir du répertoire public de motifs. Cela donne accès à plus d’options de personnalisation sans avoir à créer ses propre blocs réutilisables.

Quoi faire avant de modifier le fichier theme.json de WordPress?

Theme.json est un fichier de thème important. L’éditer directement sur votre site WordPress actif comporte donc certains risques.

La moindre erreur ou le moindre faux pas pourraient potentiellement casser votre thème ou votre site WordPress. il vaut donc mieux prendre des précautions

Utiliser un thème enfant: une approche sûre

Un thème enfant hérite de tous les styles et fonctionnalités de votre thème parent. Il permet toutefois de personnaliser les choses sans modifier le thème parent lui-même.

De cette façon, si le thème parent reçoit des mises à jour, les personnalisations appliquées ne seront pas écrasées par le nouveau contenu.

Vous pouvez lire notre guide sur la façon de créer un thème enfant dans WordPress si vous avez besoin de plus d’informations

Sauvegarder votre contenu

Pour assurer une expérience d’édition fluide et éviter à votre site d’être indisponible, nous vous recommandons également de sauvegarder le contenu de votre site WordPress.

Ainsi, si un problème survient, vous pouvez facilement restaurer votre site à son état précédent.

Pour ce faire, vous pouvez utiliser un plugin comme Duplicator. Il s’agit une solution de sauvegarde rapide et fiable.

Il est également recommandé de travailler dans un environnement de développement WordPress local ou un site de développement. Vous pourrez ainsi tester les modifications en toute sécurité sans risquer d’affecter vos visiteurs.

D’autres conseils à garder à l’esprit :

• Commencez avec des modifications mineures dans votre fichier theme.json. Testez-les avec soin avant de passer à des changements plus complexes.
• N’hésitez pas à demander l’aide de l’équipe de support du développeur du thème si vous rencontrez des problèmes.
• Si vous n’êtes pas sûr d’une propriété ou d’un paramètre spécifique dans le fichier theme.json, consultez la documentation officielle de WordPress.

Pour conclure sur le fichier theme.json de WordPress

Le fichier theme.json joue un rôle central dans la configuration et la personnalisation des thèmes de bloc WordPress.

Depuis la version 5.8 du CMS, ce fichier est révélé un outil essentiel pour un nombre sans cesse croissant de développeurs et d’utilisateurs.

Nous espérons que cet article vous a aidé à découvrir le fichier theme.json dans WordPress. Si c’est le cas, nous vous invitons à consulter nos autres autres articles et tutoriels.

N’hésitez pas non plus à consulter notre base de connaissance. Vous y trouverez une foule d’articles détaillés pouvant répondre à toutes vos questions web.

Si vous êtes à la recherche d’un hébergement web pour votre site WordPress, nous vous invitons à consulter les offres d’Ex2. Nos plans d’hébergement WordPress vert sont très complètes et performantes, incluant tout ce dont votre site a besoin pour réussir.