Lecteur Markdown
COMMENTS_DOCUMENTATION_FR
Fonctionnalité : Comments #
Système de commentaires associé à une page ou à un contenu. Les utilisateurs connectés peuvent poster des messages courts liés à un objet identifié par un hash.
---
Installation et Configuration #
Par FTP : Déposer le répertoire `comments/` dans `/plugins/`.
Par package manager : Sélectionner `comments` dans la liste des plugins disponibles.
Chemins :
- Plugin principal : `/plugins/comments/comments.php`
- Configuration : `/plugins/comments/conf/comments.conf.inc.php`
- Locales : `/plugins/comments/locale/`
Paramètres de configuration :
| Variable | Valeur par défaut | Description |
|---|---|---|
| `$basedatadisplay` | `'no'` | Masqué de l'interface de gestion |
| `$basedisplevel` | `BASE_LEVEL_USER` | Niveau requis pour commenter |
Table SQL requise : `comments`
Pagination par défaut : 25 commentaires par page.
---
Utilisation #
Le plugin est intégré dans d'autres pages via son appel direct. Le formulaire de saisie est affiché aux utilisateurs ayant le niveau `COMMENTS_LEVEL_USER`.
Sécurité anti-spam : chaque commentaire est identifié par un hash MD5 composé de l'objet commenté et d'une clé de configuration. Les doublons par utilisateur sont détectés et refusés.
Modération : des fichiers JSON de configuration dans `conf/` permettent de définir des listes de mots filtrés.
---
Hooks et Points d'entrée #
Soumission du formulaire via POST :
| Paramètre | Description |
|---|---|
| `cmtmessage` | Texte du commentaire |
| `cmtobj` | Identifiant de l'objet commenté |
?obj=comments.php — Liste des commentaires
?obj=comments.php&page=N — Page N
---
Dépendances #
- `Beamreactor\Database\SQL` — table `comments`
- `Beamreactor\Sanitizer\Parser`