Configuration
Variables d'environnement, permissions, entrée d'admin et tâche planifiée du module Rétroaction.
Variables d'environnement
| Variable | Défaut | Rôle |
|---|---|---|
FRAZA_MODULE_FEEDBACK | Active le module (true / false). Requise. | |
FRAZA_MODULE_FEEDBACK_RETENTION_DAYS | 365 | Jours pendant lesquels un rapport terminé, ou jamais traité depuis sa réception, garde son courriel, son adresse réseau, son contexte, son lien de suivi et ses captures. Un rapport fermé comme indésirable les perd un jour après sa fermeture. De 0 à 3650, 0 les garde tous. Voir Conservation. |
FRAZA_MODULE_FEEDBACK_ATTACHMENTS | true | Propose de joindre des captures d'écran, si le stockage du core est configuré. |
FRAZA_MODULE_FEEDBACK_PUBLIC_PATH | /za/feedback | L'adresse du formulaire et du suivi quand le site les construit dans son design, par exemple /feuille-de-route : le formulaire est alors /feuille-de-route/nouveau. Les liens des courriels et du formulaire y mènent, et les pages /za/feedback y redirigent. Voir Intégrer au site. |
FRAZA_MODULE_FEEDBACK_CRON | true | Enregistre la tâche feedback-retention. |
Une valeur hors des bornes reprend la valeur par défaut. FRAZA_MODULE_FEEDBACK_PUBLIC_PATH doit commencer par / et ne contenir que des minuscules, des chiffres, -, _ et /, sans / final : autre chose reprend /za/feedback.
La feuille de route et son vote se règlent dans le module Projets. Voir Configuration de Projets.
Plusieurs projets
Le module range tout dans des projets, sans variable pour les activer. fraza-db init crée le projet « Principal » : c'est le projet principal, celui des adresses sans slug de projet. Tant que le site n'a que lui, la notion reste invisible : l'admin ne montre aucun sélecteur, et ni les pages publiques ni les notifications ne nomment le projet principal.
Le deuxième projet se crée dans la carte Projets de Rétroaction › Options, toujours présente sans le module Projets. Dès qu'il existe :
- l'admin montre un sélecteur de projet en haut à droite de la Boîte de réception et des Options ;
- le projet principal garde les adresses publiques du module,
/za/feedback/…. Chaque autre projet public a les siennes sous/za/feedback/<projet>/…. Voir Pages publiques ; - un rapport ou une étiquette d'un projet ne sert qu'à ce projet ;
- les pages et les notifications nomment le projet d'un rapport, sauf pour le projet principal.
Un paramètre de requête qui nomme un projet est toujours lu, même avec un seul projet. Voir API.
Avec le module Projets
Quand le module Projets est installé et activé, les projets de la rétroaction suivent les siens. Chaque projet de Projets a son projet dans la rétroaction, avec le même nom, la même visibilité et le même archivage. Le projet mis en avant dans Projets est le projet principal de la rétroaction, celui de /za/feedback/nouveau. Le projet principal n'est jamais archivé : il reste ouvert jusqu'à ce qu'un autre projet soit mis en avant.
Les projets se créent, se renomment et s'archivent dans Projets. Les Options de la rétroaction ne montrent plus la carte Projets, sauf pour les projets de la rétroaction qui ne correspondent à aucun projet de Projets : la carte « Projets sans équivalent dans Projets » les liste, pour déplacer leurs rapports puis les supprimer. Voir Avec le module Projets.
Permissions
| Permission | Donne |
|---|---|
feedback.view | Lire la boîte de réception, les rapports et leurs captures. Avec Projets, voir les rapports liés sur la page d'une fiche. |
feedback.manage | Répondre, noter, classer, fermer, rouvrir, déplacer et supprimer un rapport, seul ou par sélection dans la boîte de réception. Avec Projets, le lier à une fiche ou l'en détacher. Reçoit la notification d'un nouveau rapport et d'un message de l'auteur. |
feedback.options | Gérer les projets et les étiquettes. Avec Projets, les étiquettes, et les projets qui ne correspondent à aucun projet de Projets : les autres se gèrent dans Projets. |
fraza-db init les attribue au rôle admin. Pour une personne qui trie sans tout gérer, créer un rôle avec feedback.view et feedback.manage. Voir Permissions et rôles.
Entrée d'admin
La section « Rétroaction » est rangée dans le groupe des outils, avec deux entrées : Boîte de réception (/admin/feedback) et Options (/admin/feedback/options). La page d'un rapport est sous la boîte de réception, à /admin/feedback/rapports/<id>. La feuille de route a sa propre section, celle du module Projets.
Tâche planifiée
feedback-retention tourne chaque heure, à la 23e minute, verrouillée entre les instances. Elle enchaîne, dans l'ordre :
- Avec le module Projets, elle relit la liste de ses projets et met les projets de la rétroaction à jour. Ce passage rattrape un enregistrement ou une suppression manqués.
- Avec le module Projets, elle renvoie dans la boîte de réception les rapports dont la fiche n'existe plus dans Projets :
item_idrepasse àNULL, et un rapport lié redevient nouveau. - Elle efface les données personnelles des rapports terminés depuis plus de
FRAZA_MODULE_FEEDBACK_RETENTION_DAYSjours, des rapports encore nouveaux reçus depuis plus longtemps que ce délai, et des rapports fermés comme indésirables depuis plus d'un jour. - Elle retire du stockage les captures qui attendent leur suppression.
Un échec des deux premières étapes est journalisé et n'empêche pas les suivantes. FRAZA_MODULE_FEEDBACK_CRON=false coupe aussi ce rattrapage. Comme toute tâche du core, elle demande un serveur qui reste allumé. Voir Planifier des tâches et Conservation.
Limites de débit
| Préréglage | Sur | Valeur |
|---|---|---|
public_form (core) | L'envoi d'un rapport | Dix par adresse toutes les dix minutes. |
feedback_receipt | L'accusé de réception | Trois par adresse courriel par heure. Au-delà, le rapport est enregistré, seul l'accusé ne part pas. |
feedback_author_message | Le message de l'auteur, depuis la page de suivi ou l'espace client | Dix par adresse réseau toutes les dix minutes, même pour un compte client : chaque message notifie l'équipe. |