04 ‐ Structure du thème
Le dossier assets va contenir des fichiers d'exports d'extensions tierces comme ACF (Advanced Custom Fields), Gravity Forms WP Grid Builder afin de versioner, de sauvegarder des données qui serviront sur différents environnements de votre projet.
Il existe aussi un sous-dossier conf-img qui sont utiles pour l'extension Advanced Responsive Images qui a pour but de cropper des images à la demande et de générer un markup HTML spécifique pour les images en front-office.
Note
Pour plus d'information sur la gestion des dimensions d'image et l'utilisation de l'extension, veuillez vous rendre à la section XX - Utiliser Advanced Responsive Images (WIP)
Ce dossier contient des parties de template (template parts) catégorisés dans des sous-dossiers.
Ce sous-dossier contiendra le rendu HTML des blocs dynamiques développés pour l'éditeur Gutenberg.
Note
Pour plus d'information sur la création d'un bloc dynamique Gutenberg avec ACF, veuillez accéder à cette documentation.
Ce sous-dossier contiendra le rendu HTML template parts qui se répètent à travers une boucle d'une requête WordPress (WP Query).
<?php
if ( have_posts() ) :
while ( have_posts() ) :
the_post();
get_template_part( 'components/loops/card-post' );
endwhile;
endif;
?>Ce sous-dossier contient les rendus HTML qui ne rentrent pas dans les deux premières catégories. Vous êtes libre d'organiser comme vous souhaitez ce dossier. Par défaut, il y a un dossier common contenant un fichier breadcrumb.php; ce dossier a pour principe de contenir les template part qui sont communs à plusieurs modèles de pages.
Sans rentrer dans les détails, ce dossier contient les fichiers de configuration pour le bon fonctionnement du module bundler Webpack.
Ce dossier contient des outils, des helpers et des services dans le but de simplifier le développement.
Note
Pour plus d'information sur l'utilisation des services, helpers ou outils, veuillez vous rendre aux sections
- XX - Les helpers (WIP)
- XX - Les services (WIP)
- XX - Les outils (WIP)
Ce dossier contient les fichiers de traductions de votre thème si vous souhaitez avoir plusieurs langues dans votre thème.
Note
Pour plus d'information sur la gestion des traductions, veuillez vous rendre à la section XX - Gestion des traductions (WIP)
Ce dossier contient les fichiers PHP des compositions qui apparaissent dans l'éditeur Gutenberg.
Note
Pour plus d'information sur la création d'une composition, veuillez vous rendre à la section XX - Création d'une composition (WIP)
Ce dossier contient toutes les resources du thème (images, typographies, feuilles de styles, scripts) qui servent le rendu graphique du projet.
Ce sous-dossier contient d'autres sous-dossier contenant eux même des icônes SVG. À la compilation, ces icônes seront concaténés en un seul fichier SVG appelé "Sprite SVG" et qui pourront être utilisé avec le helper <?php the_icon(); ?>. Par défaut, nous avons un dossier social et sprite et à la compilation sera généré un fichier social.svg et sprite.svg dans le dossier dist/icons/
Note
Pour plus d'information sur la gestion et l'utilisation des sprites SVG, veuillez vous rendre à la section XX - Afficher des icônes (WIP)
Ce sous-dossier est dédié aux images statiques du thème, c'est-à-dire aux ressources graphiques qui ne sont pas modifiables par les utilisateurs via l'interface d'administration WordPress. Ces images font partie intégrante du design du thème et restent constantes, comme les éléments de design ou les images de fond.
Accéder à 05 - Gérer les assets ➡️