FAQ — documentation Sillon

Ce qu'il fait

Questions fréquentes : questions/réponses réutilisables (réponse en texte riche), ordonnables, masquables et rangeables par SUJET (catégories scopées « faq », facultatives). Affichées sur le site via la prise views/faq.php (liste dépliable accessible, classes s-faq-*) — la prise se nourrit, un gabarit qui veut des groupes l'inclut une fois par sujet.

Questions dépliables, réordonnables
Rangement par sujet (facultatif)
Masquables sans être supprimées
Balisage FAQPage (Schema.org) pour les moteurs de recherche, activé pour la page de votre choix

Où le trouver

Les écrans que ce module ajoute à l'administration, une fois activé.

FAQ /admin/faq

Ses réglages

Ils se modifient depuis l'administration. La clé est donnée pour qui pilote le site en ligne de commande ou par l'API.

Réglage	Clé	Type	Par défaut
Slug de la page FAQ (JSON-LD)	`faq.jsonld_slug`	string	`(vide)`
URL publique de la page FAQ (recherche)	`faq.public_url`	string	`(vide)`

Ses droits

Ce que chaque rôle peut faire par défaut. Modifiable rôle par rôle depuis l'administration.

Droit	Clé	Administrateur	Éditeur
Voir les questions fréquentes	`faq.read`	✓	✓
Créer / modifier les questions	`faq.write`	✓	✓
Supprimer une question	`faq.delete`	✓	—

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

lister lecture seule

Liste les questions de la FAQ : id, question, réponse (HTML sanitizé), visibilité, ordre. Params : visible_only (optionnel, bool — ne retourner que les questions visibles).
creer écrit, annulable

Crée une question de la FAQ (question + réponse). Visible par défaut.

« ajoute une question sur les délais de livraison » « crée une FAQ : « Livrez-vous à l'étranger ? » avec la réponse « Oui, en Europe uniquement. » »
modifier écrit, annulable

Modifie une question existante : texte, réponse, visibilité. Annulable. Params : id (requis, via faq.lister) puis les champs à changer.

« corrige la réponse sur les délais de livraison » « masque la question sur les soldes »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 3

faq.created: Émis après création. Args: [array $faq]
faq.updated: Émis après update (édition, visibilité, réordonnancement). Args: [int $id, array $new, array $old]
faq.deleted: Émis après suppression. Args: [int $id, array $old]

Ce qu'il écoute 2

seo.jsonld: priorité 20
search.results: priorité 30

Ses prises front

Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.

views/faq.php 5 classes

s-faq
s-faq-answer
s-faq-item
s-faq-question
s-richtext

Ses données

Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.

Les tables 1

faqs