Statamic : après l’installation — tableau de bord, contenu et fichiers
Une fois Statamic installé et le tableau de bord accessible, la question suivante est vite : par où commencer pour structurer le site ?
Cet article fait le tour des grands blocs du panneau : collections, navigations, taxonomies, conteneurs d’assets et globales. On relie tout ça aux fichiers que Statamic génère dans le projet (YAML, Markdown) — le tout illustré en vidéo.
Statamic : après l’installation — tableau de bord, contenu et fichiers
Dans la continuité de la série, on suppose Statamic déjà installé et un compte permettant d’accéder au Control Panel. L’objectif ici est de comprendre à quoi servent les sections principales à gauche, et ce que ça produit côté disque dans votre projet Laravel.
Les notions ci‑dessous renvoient à la documentation Statamic (chapitres Collections, Navigation, Taxonomies, Assets, Globals, Blueprints).
Collections : vos « types » de contenu
Une collection, c’est l’endroit où vous stockez des entrées d’un même type : articles, produits, témoignages, etc. On peut la voir mentalement comme une table en base de données, sauf qu’en mode flat file (par défaut), ce sont surtout des dossiers et fichiers sous content/collections/.
Sur une installation classique, une collection pages existe souvent déjà, avec au minimum une page d’accueil. Vous ajoutez autant de collections que nécessaire — par exemple une collection products pour un catalogue.
Chaque collection a des réglages (routes des URLs, dates, ordre, profondeur d’arborescence…) : la doc Collections détaille routes, dates, structures et comportements.
Navigations : les menus du site
La section Navigations sert à définir des menus réutilisables dans les vues : par exemple un menu header et un menu footer.
Les entrées de menu peuvent être des liens directs, des liens vers des pages ou des liens vers des entrées d’une collection. Côté front, vous récupérez une structure cohérente pour les boucles Antlers. Voir Navigation.
Taxonomies : étiqueter le contenu
Les taxonomies permettent de classer ou étiqueter le contenu (tags, catégories simples, etc.).
Cas d’usage : pour des produits, si une « catégorie » se résume à un libellé, une taxonomie peut suffire. Si vous avez besoin d’un modèle plus riche (sous‑catégories, champs dédiés, relations), une collection à part reliée via un champ du type Entries dans le blueprint est souvent plus adapté. Voir Taxonomies.
Assets : fichiers et conteneurs
Les assets regroupent images, PDF et autres médias. Ils vivent dans des conteneurs (containers), chacun pouvant être branché sur un disque Laravel (config/filesystems.php) : disque public, local privé, S3 ou autre.
C’est utile pour séparer, par exemple, les médias publics (logos, visuels du site) des fichiers sensibles (PDF générés côté facturation) sur un disque non exposé.
Statamic permet aussi d’appliquer des traitements à l’upload (limite de poids, redimensionnement max, etc.) pour éviter des images trop lourdes déposées depuis le back‑office. Voir Assets.
Globales : données présentes sur tout le site
Les globales servent aux informations répétées sur plusieurs pages : nom du site, logo, e‑mail de contact, liens réseaux, texte de pied de page, etc.
En pratique, on crée souvent un jeu de champs regroupé sous une global du type general (ou équivalent), structuré par un blueprint — comme pour une collection, mais sans entrées multiples : une seule « fiche » par global. Voir Globals.
Blueprints : la structure des formulaires
Collections, taxonomies et globales s’appuient sur des blueprints : ils décrivent quels champs apparaissent dans le CP (texte, nombre, asset, lien, etc.).
Exemple rapide pour une collection produits : champs titre, contenu, prix, photo (type Asset avec choix du conteneur, éventuellement max_files: 1 et validation). Une fois le blueprint enregistré, la création d’entrée reflète exactement ces champs.
Le prochain volet de la série pourra zoomer sur les types de champs et les bonnes habitudes de modélisation. En attendant, la référence complète est ici : Blueprints.
Le code à droite : content/ et resources/blueprints/
Quand vous créez une collection ou une entrée, Statamic matérialise le tout en fichiers :
-
sous
content/collections/: un fichier YAML de configuration par collection, puis un dossier du même nom pour les entrées (Markdown avec front‑matter) ; -
sous
resources/blueprints/: la définition des champs (souvent un YAML par contexte : collection, global, etc.).
Vous pouvez donc versionner le contenu avec Git, éditer certains fichiers à la main ou depuis le CP — les deux approches coexistent. Les utilisateurs du CP ont aussi leur représentation côté fichiers selon votre configuration (voir la doc Users).
Vidéo : parcours du tableau de bord
Conclusion
Après l’installation, le fil conducteur est simple : collections pour les contenus structurés, navigations pour les menus, taxonomies pour le classement léger, assets pour les médias (avec bons disques Laravel), globales pour ce qui est transversal — le tout piloté par des blueprints et reflété dans content/ et resources/blueprints/.
Suite de la série : Statamic : blueprints et fieldsets (cas concret page « Ressources »).