À la fin de ce guide, vous saurez lire n'importe quel écran de Sillon et vous saurez où chaque chose se règle. Une quinzaine de mots suffisent, et aucun n'est là pour faire savant : chacun désigne une pièce précise, à un endroit précis.
Trois étages, et tout en découle
Un site Sillon tient en trois étages. Comprendre lequel fait quoi règle la moitié des questions.
- Le socle : ce qui est là dans tous les cas. Les comptes, les réglages, les médias, les langues, les mises à jour, le contrôle de santé. Vous ne l'activez pas, il est le site.
- Les modules : les fonctions que vous choisissez. Le blog, la boutique, les projets, les formulaires, la FAQ, les avis. Un site qui ne vend rien n'a pas de boutique, tout simplement.
- Le layout : l'habit du site public. Les pages que voient vos visiteurs, leurs couleurs, leurs formes.
La règle qui tient l'ensemble : le module rend la donnée, le layout rend l'apparence. Aucun module ne décide de la tête de votre site, aucun habillage ne contient vos contenus. C'est ce qui permet de changer l'un sans casser l'autre.
Module, satellite
Un module est une fonction du site, avec ses écrans, ses données et sa propre version. Vous l'activez ou non depuis Réglages, Modules. Un module désactivé ne consomme rien et n'affiche rien.
Un satellite est un module qui se greffe sur un autre plutôt que de vivre seul. Les abonnements se greffent sur la boutique, les avis aussi, la douane sur les expéditions. Il ajoute des champs et des écrans au module parent sans le modifier, ce qui veut dire deux choses pour vous : vous n'avez que ce que vous avez demandé, et une mise à jour du parent ne casse pas le greffon.
Dans la liste des modules, un satellite apparaît sous son parent et ne s'active qu'après lui.
Prise, terminaison, et les classes en s
Voilà le mot le plus important, et le seul qui soit vraiment de la maison.
Une prise est un point de branchement entre un module et votre site public. C'est un petit fichier qui ne contient que la donnée, sans décoration : la liste de vos articles, la fiche d'un produit, le formulaire de contact. Votre layout l'inclut où il veut, et l'habille comme il veut.
Une terminaison est la méthode qui alimente cette prise, le robinet derrière le mur.
Et pour que l'habillage tienne dans le temps, chaque prise pose des classes commençant par s- sur ce qu'elle affiche. Ces noms sont un contrat : ils ne changent pas sans une version majeure du module. Votre feuille de style les vise, et une mise à jour ne vous repeint jamais le site.
La conséquence pratique est confortable : pour changer l'allure d'une liste d'articles, vous n'avez rien à copier ni à surcharger. Vous écrivez du style sur des classes qui ne bougeront pas.
Le module sait ce qu'il y a à dire. Le layout sait comment le dire. Une prise est le seul endroit où les deux se touchent, et c'est voulu.
Layout, habillage, gabarit
Trois mots qu'on confond souvent, et qui ne parlent pas de la même chose.
Le layout est l'habit complet du site public : ses pages, sa typographie, ses couleurs, ses composants. C'est une ambiance, pas un métier : un même layout habille aussi bien un restaurant qu'un cabinet, parce qu'il couvre tous les modules et pas une profession.
L'habillage est une teinte à l'intérieur du layout, portée par une rubrique. Vos guides en doré, vos comparatifs en rose, vos décryptages en terre cuite. Vous le choisissez sur la rubrique, et tout ce qui en dépend suit : la bande d'annonce, les articles, les encadrés, l'appel en bas de page. Changez l'habillage d'une rubrique, toute la rubrique change de couleur.
Le gabarit est la forme d'un contenu. Un article libre s'écrit en sections que vous empilez ; un article à gabarit propose des champs fixes, toujours les mêmes, faits pour que dix fiches se ressemblent. Le gabarit se choisit à la création et se change ensuite si vous vous êtes trompé.
Page, bloc, section
Ce que vous éditez au quotidien porte trois noms, du plus grand au plus petit.
Une page est un écran de votre site avec sa propre adresse, et un formulaire pour la modifier. Elle apparaît dans l'écran Pages, avec un bouton pour aller la voir.
Un bloc ressemble à une page dans l'éditeur, mais n'a pas d'adresse : c'est un morceau réutilisable, comme l'appel qui se répète au bas de tous les articles. Vous le modifiez au même endroit que les pages, il n'a simplement pas de bouton Voir, et il n'entre pas dans le plan du site.
Une section est une brique de contenu à l'intérieur d'une page ou d'un article : un texte, une image avec son texte, une galerie, une citation, un tableau, un encadré, un bout de code. Vous les empilez, vous les réordonnez, et le layout sait habiller chacune.
Le trousseau : trois clés, trois portées
Sillon distingue le propriétaire du site, qui ne peut pas être retiré, des administrateurs qu'il nomme. Et pour tout ce qui n'est pas un humain devant un écran, il y a trois clés, créées dans Réglages, Connexions.
- La clé maître ouvre tout : les actions des modules et les travaux sur les fichiers. C'est l'équivalent d'un accès au serveur.
- La clé invité ouvre les travaux seuls, dans un périmètre que vous fixez, et elle a une date de fin. C'est celle qu'on prête à un prestataire pour la durée d'un chantier.
- La clé application ouvre uniquement les actions que vous lui accordez. C'est celle qu'on donne à un autre logiciel.
L'administration affiche en permanence les clés encore ouvertes, et tout ce qui passe par elles est journalisé. Si vous voulez savoir ce qu'un agent peut faire avec ça, c'est le sujet de notre décryptage sur le vocabulaire de l'IA.
Battement, filet
Un site a des choses à faire quand personne ne regarde : purger ce qui a expiré, renouveler des abonnements, vérifier s'il existe une mise à jour.
Le battement est la ligne unique que vous posez chez votre hébergeur, une fois pour toutes. Toutes les dix minutes, elle réveille le site et lui demande ce qui est dû. Vous n'avez rien à ajouter quand vous activez un module de plus.
Le filet est ce qui se passe si vous ne l'avez pas posée : le site profite de la visite d'un internaute pour faire ce qui est dû, une fois toutes les dix minutes au plus, et toujours après avoir rendu la page. Le visiteur n'attend jamais. C'est un rattrapage, pas un remplacement : un site que personne n'ouvre ne fait rien, et le contrôle de santé continue de réclamer la ligne.
Le contrôle de santé
Une commande, php cli.php kit:doctor, et l'écran qui l'accompagne. Il passe en revue la base, les droits sur les dossiers, la configuration des modules actifs, les tâches attendues, les fichiers étrangers, l'état de la licence.
C'est le premier réflexe quand quelque chose semble étrange, et le seul moyen fiable de savoir qu'une tâche n'a jamais tourné : une tâche absente ne produit aucune erreur, par définition. Il distingue ce qui relève du logiciel de ce qui relève de votre hébergement, et il ne dit jamais « tout va bien » sans l'avoir vérifié.
Trois commandes suffisent à tenir un site : le battement qui l'entretient, le contrôle de santé qui l'ausculte, la mise à jour que vous seul déclenchez.
Le mémo en une minute
| Le mot | Ce que c'est |
|---|---|
| Socle | Ce qui est là dans tous les cas : comptes, réglages, médias, langues, mises à jour. |
| Module | Une fonction que vous activez : blog, boutique, projets, formulaires. |
| Satellite | Un module qui se greffe sur un autre au lieu de vivre seul. |
| Prise | Le point où un module donne sa donnée au site public, sans décoration. |
| Terminaison | La méthode qui alimente une prise. Le robinet derrière le mur. |
| Classes en s- | Les noms posés par les prises, stables, que votre style vise. |
| Layout | L'habit complet du site public. Une ambiance, pas un métier. |
| Habillage | La teinte d'une rubrique à l'intérieur du layout. |
| Gabarit | La forme d'un contenu : libre en sections, ou champs fixes. |
| Page | Un écran avec son adresse et son formulaire. |
| Bloc | Un morceau réutilisable, sans adresse à lui. |
| Section | Une brique de contenu : texte, image, tableau, encadré. |
| Trousseau | Le propriétaire, les administrateurs, et trois clés : maître, invité, application. |
| Battement | La ligne unique posée chez l'hébergeur, toutes les dix minutes. |
| Filet | Le rattrapage à la visite quand le battement manque. |
| Contrôle de santé | Le doctor : ce qui va, ce qui manque, et où. |
Où chaque chose se règle
Le corollaire du vocabulaire, et sans doute ce que vous chercherez le plus souvent.
- Ajouter une fonction : Réglages, Modules.
- Changer un texte du site : Pages, puis la page concernée.
- Changer la couleur d'une rubrique : la rubrique, son habillage.
- Changer l'allure du site : le layout, et le style qui vise les classes en
s-. - Ouvrir un accès à quelqu'un : Réglages, Connexions, et une clé invité datée.
- Savoir si tout tourne : le contrôle de santé.
- Coordonnées, mentions, réseaux : Réglages, jamais dans une page.
Cette dernière ligne évite l'erreur la plus fréquente : chercher son numéro de téléphone dans la page Contact, alors qu'il est aux Réglages et qu'il s'affiche à cinq endroits.
Ce qu'il faut retenir
Quinze mots, et un seul principe derrière : chaque chose a un endroit, et un seul. Le module tient la donnée, le layout tient l'apparence, la prise est leur point de contact, les réglages tiennent ce qui se répète, le contrôle de santé dit ce qui manque.
C'est ce qui permet de changer l'habit sans toucher au contenu, d'ajouter une fonction sans refaire le site, et de confier un chantier à quelqu'un sans lui donner les clés de tout.