Forum & Communauté

Ajoutez un forum communautaire complet à votre site Larapen avec des discussions en fil, des réponses imbriquées, un système de votes positifs/négatifs, la sélection de meilleure réponse et la modération de contenu.

Cas d’utilisation

Forum de support produit

Vous vendez des logiciels et avez besoin d’un forum communautaire où les clients peuvent poser des questions et s’entraider.

• Créez une catégorie de forum pour chaque produit.
• Activez la « Meilleure réponse » pour que les auteurs de fils puissent marquer la réponse la plus utile.
• Utilisez l’intégration Envato pour exiger un achat vérifié avant de publier (voir Intégration Envato).
• Les notifications administrateur vous alertent des nouveaux fils nécessitant votre attention.

Base de connaissances communautaire

Vous gérez un site communautaire et souhaitez que les membres partagent leurs connaissances à travers des discussions.

• Organisez les sujets en catégories et sous-catégories.
• Utilisez les votes pour mettre en avant le contenu le plus utile.
• Épinglez les fils importants (annonces, guides) en haut des listes.
• Activez le signalement pour que la communauté puisse s’auto-modérer.

Forum interne d’équipe

Vous avez besoin d’un espace de discussion privé pour votre équipe ou organisation.

• Désactivez la consultation par les visiteurs : seuls les utilisateurs authentifiés peuvent accéder au forum.
• Désactivez la création et les réponses par les visiteurs : exigez la connexion pour toutes les interactions.
• Utilisez les catégories pour organiser les discussions par département ou projet.

Prérequis

• Larapen CMS v1.0.0 ou ultérieur
• PHP 8.3+
• MySQL 8.0+

Installation

Étape 1 : Placer l’add-on

Copiez ou créez un lien symbolique du dossier forum dans le répertoire « extensions/addons » de votre Larapen :

Étape 2 : Activer l’add-on

Allez dans Admin → Add-ons → Add-ons installés et activez Forum & Communauté.

Étape 3 : Exécuter les migrations

Cela crée 5 tables : forum_categories, forum_threads, forum_replies, forum_votes et forum_reports.

Étape 4 : Définir les permissions

L’add-on enregistre 12 permissions (voir Permissions). Assignez-les aux rôles administrateur via Admin → Utilisateurs → Rôles & Permissions.

Étape 5 : Créer des catégories

Naviguez vers Admin → Forum → Catégories et créez vos premières catégories de forum. Le forum nécessite au moins une catégorie avant de pouvoir créer des fils.

Étape 6 : Configurer

Naviguez vers Admin → Forum → Paramètres pour configurer le contrôle d’accès, les votes, la modération, les notifications et les options d’affichage. Voir Configuration.

Configuration

Tous les paramètres sont gérés dans Admin → Forum → Paramètres (stockés dans la table settings, groupe forum). Les valeurs par défaut proviennent de config/forum.php.

Contrôle d’accès

Paramètre	Description	Défaut
forum_guests_can_view	Permettre aux visiteurs non connectés de parcourir les fils et réponses.	true
forum_guests_can_create	Permettre aux visiteurs non connectés de créer de nouveaux fils.	false
forum_guests_can_reply	Permettre aux visiteurs non connectés de poster des réponses.	false

Votes

Paramètre	Description	Défaut
forum_voting_enabled	Activer les votes positifs/négatifs sur les fils et réponses.	true

L’option allow_self_vote se trouve uniquement dans config/forum.php (défaut : false).

Meilleure réponse

Paramètre	Description	Défaut
forum_best_answer_enabled	Activer la sélection de meilleure réponse sur les fils.	true
forum_author_can_select	L’auteur du fil peut marquer une réponse comme meilleure réponse.	true
forum_admin_can_select	Les administrateurs peuvent marquer une réponse comme meilleure réponse sur n’importe quel fil.	true

Modération

Paramètre	Description	Défaut
forum_require_approval	Les nouveaux fils et réponses nécessitent l’approbation d’un administrateur avant d’apparaître publiquement.	false
forum_allow_reporting	Les utilisateurs peuvent signaler les réponses inappropriées pour examen par un administrateur.	true
forum_max_reports_auto_hide	Masquer automatiquement une réponse après ce nombre de signalements (1–50).	5

Notifications

Paramètre	Description	Défaut
forum_notify_admin_on_new_thread	Envoyer un e-mail aux administrateurs lorsqu’un nouveau fil est créé.	true
forum_notify_author_on_reply	Envoyer un e-mail à l’auteur du fil lorsque quelqu’un poste une réponse.	true
forum_notify_on_reply_to_reply	Envoyer un e-mail à l’auteur d’une réponse lorsque quelqu’un répond à sa réponse.	true
forum_notify_on_best_answer	Envoyer un e-mail à l’auteur de la réponse lorsque sa réponse est marquée comme meilleure réponse.	true
forum_notify_admin_on_report	Envoyer un e-mail aux administrateurs lorsqu’un contenu est signalé.	true

Affichage

Paramètre	Description	Défaut
forum_threads_per_page	Nombre de fils affichés par page dans la liste du forum.	15
forum_replies_per_page	Nombre de réponses affichées par page sur la page de détail d’un fil.	20

CAPTCHA

Paramètre	Description	Défaut
forum_captcha_enabled	Exiger une vérification CAPTCHA lors de la création de fils ou de la publication de réponses.	false

Valeurs par défaut du fichier de configuration

Le fichier config/forum.php contient des valeurs par défaut supplémentaires qui ne sont pas exposées dans le panneau de paramètres de l’administration :

Clé	Description	Défaut
voting.allow_self_vote	Permettre aux utilisateurs de voter sur leurs propres fils/réponses.	false
threads.allow_editing	Permettre aux auteurs de fils de modifier leurs fils.	true
threads.edit_time_limit	Minutes après la publication pendant lesquelles la modification est autorisée (0 = illimité).	30
threads.allow_deleting	Permettre aux auteurs de fils de supprimer leurs fils.	true
threads.min_title_length	Longueur minimale en caractères pour les titres de fils.	5
threads.max_title_length	Longueur maximale en caractères pour les titres de fils.	200
threads.min_content_length	Longueur minimale en caractères pour le contenu des fils.	10
replies.allow_editing	Permettre aux auteurs de réponses de modifier leurs réponses.	true
replies.edit_time_limit	Minutes après la publication pendant lesquelles la modification est autorisée (0 = illimité).	30
replies.allow_deleting	Permettre aux auteurs de réponses de supprimer leurs réponses.	true
replies.min_content_length	Longueur minimale en caractères pour le contenu des réponses.	2

Admin : Paramètres

La page de paramètres (Forum → Paramètres) est organisée en six sections :

Accès & Permissions

• Permettre aux visiteurs de consulter le forum : interrupteur à bascule
• Permettre aux visiteurs de créer des fils : interrupteur à bascule
• Permettre aux visiteurs de répondre aux fils : interrupteur à bascule

Fonctionnalités

• Votes : activer/désactiver le système de votes positifs/négatifs
• Meilleure réponse : activer/désactiver la sélection de meilleure réponse, avec des sous-options pour déterminer si l’auteur du fil et/ou les administrateurs peuvent sélectionner la meilleure réponse

Modération

• Exiger l’approbation pour les nouvelles publications : interrupteur à bascule
• Permettre aux utilisateurs de signaler les réponses : interrupteur à bascule
• Masquage automatique après signalements : champ numérique (1–50)

Notifications

Cinq interrupteurs à bascule indépendants contrôlant les notifications par e-mail pour divers événements du forum (nouveau fil, réponse, réponse à une réponse, meilleure réponse, signalement de contenu).

Protection CAPTCHA

• Activer le CAPTCHA pour les fils et réponses : nécessite qu’un fournisseur CAPTCHA soit configuré au préalable dans les paramètres principaux.

Affichage

• Fils par page : champ numérique (5–100)
• Réponses par page : champ numérique (5–100)

Admin : Fils de discussion

Liste des fils

La page des fils (Forum → Tous les fils) affiche un tableau paginé (20 par page) avec :

• Titre (traduisible)
• Catégorie
• Auteur
• Statut : ouvert, fermé ou verrouillé (avec badges colorés)
• Nombre de réponses
• Nombre de vues
• Épinglé / Mis en avant indicateurs
• Meilleure réponse indicateur (résolu/non résolu)
• Dernière activité date

Filtrable par catégorie et statut via des sélecteurs déroulants.

Création & Modification

Le formulaire de fil comprend :

• Titre : champs texte traduisibles par langue active (requis pour la langue par défaut, min 5, max 200 caractères)
• Slug : traduisible, généré automatiquement à partir du titre si laissé vide
• Contenu : texte riche traduisible (requis pour la langue par défaut, min 10 caractères)
• Catégorie : sélection parmi les catégories actives
• Statut : ouvert / fermé / verrouillé (modification uniquement)
• Épinglé : case à cocher (modification uniquement)
• Mis en avant : case à cocher (modification uniquement)

Statuts des fils

Statut	Description
open	Le fil est actif. Les utilisateurs peuvent poster des réponses.
closed	Le fil est fermé. Aucune nouvelle réponse autorisée. Le contenu reste visible.
locked	Le fil est verrouillé par un administrateur. Aucune nouvelle réponse autorisée.

Admin : Catégories

La page des catégories (Forum → Catégories) gère la hiérarchie des catégories du forum.

Liste des catégories

Affiche les catégories parentes avec leurs enfants, incluant le nombre de fils. Ordonnées par le champ position.

Création & Modification

Le formulaire de catégorie comprend :

• Nom : traduisible (requis pour la langue par défaut, max 100 caractères)
• Slug : traduisible, généré automatiquement si vide (max 120 caractères)
• Description : traduisible (max 500 caractères)
• Couleur : code couleur hexadécimal (ex. #0891b2) pour l’identification visuelle
• Classe d’icône : classe Bootstrap Icon (ex. bi-chat-dots)
• Catégorie parente : optionnel, pour l’imbrication (un niveau de profondeur)
• Position : ordre de tri (entier)
• Active : interrupteur à bascule

Admin : Réponses signalées

La page des réponses signalées (Forum → Réponses signalées) affiche toutes les réponses signalées par les utilisateurs, classées par nombre de signalements (le plus élevé en premier).

Tableau des réponses signalées

Chaque entrée affiche :

• Contenu de la réponse (aperçu)
• Fil lien
• Auteur
• Nombre de signalements
• Signalements : liste dépliable avec le nom du signaleur, la raison et les détails
• Statut masqué

Actions de modération

Action	Effet
Masquer la réponse	Définit is_hidden = true sur la réponse. Marque tous les signalements en attente comme « examinés ». La réponse n’est plus visible côté public.
Afficher la réponse	Définit is_hidden = false et réinitialise le nombre de signalements à 0. La réponse redevient visible.
Rejeter les signalements	Marque tous les signalements en attente comme « rejetés » et réinitialise le nombre de signalements à 0. La réponse reste visible.
Supprimer la réponse	Supprime définitivement la réponse. Si c’était la meilleure réponse, efface la meilleure réponse du fil. Met à jour le nombre de réponses du fil.
Marquer comme meilleure réponse	Marque la réponse comme meilleure réponse pour son fil (depuis le panneau d’administration).
Retirer la meilleure réponse	Retire la désignation de meilleure réponse de la réponse.

Front-end : Liste du forum

La page principale du forum est disponible à /{locale}/forum (ou /forum pour la langue par défaut).

Mise en page

La liste du forum comprend :

• Barre latérale/filtre de catégories : toutes les catégories parentes actives avec leurs enfants, cliquables pour filtrer les fils
• Options de tri : Récents, Populaires, Plus de réponses, Anciens, Non résolus, Résolus
• Liste des fils : paginée, avec les fils épinglés affichés en premier. Chaque carte de fil affiche : titre, badge de catégorie, auteur, nombre de réponses, nombre de vues, dernière activité, indicateur résolu/non résolu
• Barre latérale de statistiques : total des fils, total des catégories, fils ouverts, fils résolus
• Fils récents barre latérale : les 5 fils les plus récemment actifs
• Fils populaires barre latérale : les 5 fils les plus vus
• Bouton « Démarrer une discussion » : redirige vers la page de création de fil

Options de tri

Valeur de tri	Comportement
latest (défaut)	Tri par date de dernière activité, le plus récent en premier. Les fils épinglés apparaissent toujours en premier.
popular	Tri par nombre de vues, le plus élevé en premier.
replies	Tri par nombre de réponses, le plus élevé en premier.
oldest	Tri par date de création, le plus ancien en premier.
unsolved	Uniquement les fils sans meilleure réponse, triés par dernière activité.
solved	Uniquement les fils avec une meilleure réponse, triés par dernière activité.

Front-end : Détail du fil

La page de détail du fil est disponible à /{locale}/forum/{slug}.

Contenu de la page

• En-tête du fil : titre, informations sur l’auteur, badge de catégorie, date de création, nombre de vues
• Corps du fil : contenu HTML complet (traduisible)
• Contrôles de vote : boutons vote positif/négatif avec score actuel (AJAX)
• Badge meilleure réponse : affiché si une meilleure réponse est sélectionnée
• Liste des réponses : paginée, avec la meilleure réponse épinglée en haut. Chaque réponse affiche : contenu, auteur, contrôles de vote, horodatage, réponses enfants imbriquées
• Formulaire de réponse : zone de texte pour poster une nouvelle réponse (avec CAPTCHA optionnel)
• Avis de fil verrouillé : si le fil est fermé/verrouillé, un message remplace le formulaire de réponse

Nombre de vues

Chaque fois qu’un utilisateur visite la page de détail du fil, le view_count est incrémenté. Ce compteur n’est pas dédupliqué par session : chaque chargement de page est comptabilisé.

Front-end : Création de fils

Le formulaire de création de fil est disponible à /{locale}/forum/create.

Contrôle d’accès

• Si guests_can_create est désactivé (par défaut), les utilisateurs non authentifiés sont redirigés vers la page de connexion.
• Si l’add-on Envato est actif et que envato_forum_require_purchase est activé, le formulaire inclut un sélecteur déroulant d’achats.

Champs du formulaire

• Catégorie : requis, sélection parmi les catégories actives
• Titre : traduisible (requis pour la langue par défaut, 5–200 caractères)
• Contenu : traduisible (requis pour la langue par défaut, min 10 caractères)
• CAPTCHA : affiché si le CAPTCHA est activé pour le forum

Après soumission réussie, l’utilisateur est redirigé vers la page de détail du nouveau fil.

Front-end : Réponses

Poster une réponse

Les utilisateurs authentifiés peuvent poster des réponses via le formulaire en bas de la page de détail du fil. Le formulaire de réponse prend en charge :

• Contenu : texte brut (2–10 000 caractères)
• Réponse parente : optionnel, pour les réponses imbriquées (cliquer sur « Répondre » sur une réponse existante définit le parent_id)
• CAPTCHA : affiché si le CAPTCHA est activé pour le forum

Arborescence des réponses

Les réponses supportent un niveau d’imbrication. Les réponses racines sont affichées dans l’ordre (meilleure réponse en premier, puis par date de création). Les réponses enfants (réponses à une réponse) sont affichées imbriquées sous leur parent.

Après la publication

Lorsqu’une réponse est postée :

1. La réponse est créée dans la base de données.
2. Le reply_count du fil est mis à jour.
3. L’horodatage last_activity_at du fil est mis à jour.
4. Les notifications sont envoyées (si activées) : à l’auteur du fil, et à l’auteur de la réponse parente (pour les réponses imbriquées).

Front-end : Votes

Lorsque les votes sont activés (forum_voting_enabled), les utilisateurs peuvent voter positivement (+1) ou négativement (-1) sur les fils et réponses via AJAX.

Comportement des votes

• Nouveau vote : crée un enregistrement de vote avec la valeur +1 ou -1.
• Même vote à nouveau : supprime le vote (bascule). Cliquer deux fois sur vote positif supprime le vote positif.
• Vote différent : change le vote existant (ex. vote positif devient vote négatif).
• Auto-vote : empêché par défaut (allow_self_vote = false). Les utilisateurs ne peuvent pas voter sur leur propre contenu.

Réponse de l’API de vote

Front-end : Meilleure réponse

Lorsque la meilleure réponse est activée (forum_best_answer_enabled), les utilisateurs autorisés peuvent marquer une réponse comme la réponse définitive à un fil.

Qui peut sélectionner

• Auteur du fil : si forum_author_can_select est activé.
• Administrateurs : si forum_admin_can_select est activé.

Comportement

• Une seule réponse par fil peut être la meilleure réponse à la fois.
• Marquer une nouvelle réponse comme meilleure réponse retire automatiquement la désignation de la précédente.
• Le best_reply_id du fil est mis à jour pour pointer vers la réponse sélectionnée.
• Les meilleures réponses sont affichées en haut de la liste des réponses sur la page de détail du fil.
• Les fils avec une meilleure réponse sont affichés comme « Résolu » dans la liste du forum.
• Si une meilleure réponse est supprimée, la meilleure réponse est automatiquement effacée du fil.

Front-end : Signalement

Lorsque le signalement est activé (forum_allow_reporting), les utilisateurs authentifiés peuvent signaler les réponses inappropriées.

Formulaire de signalement

• Raison : requis, parmi : Spam, Contenu offensant, Hors sujet, Autre
• Détails : champ de texte libre optionnel (max 1 000 caractères)

Flux de signalement

1. L’utilisateur clique sur « Signaler » sur une réponse.
2. Si l’utilisateur a déjà signalé cette réponse, l’action est rejetée.
3. Un enregistrement forum_reports est créé avec le statut pending.
4. Le report_count de la réponse est incrémenté.
5. Si le nombre de signalements atteint le seuil max_reports_auto_hide, la réponse est automatiquement masquée.
6. Une notification par e-mail est envoyée aux administrateurs (si activée).

Front-end : Recherche

La recherche du forum est disponible à /{locale}/forum/search?q={query}.

La recherche utilise la fonction JSON_SEARCH de MySQL pour trouver des correspondances dans les colonnes JSON traduisibles title et content dans toutes les langues. Les résultats sont paginés et triés par date de dernière activité.

Notifications

L’add-on forum inclut 5 classes de notification par e-mail, toutes étendant BaseNotification et envoyées via le canal mail.

Notification	Déclencheur	Destinataire	Paramètre
NewThreadNotification	Un nouveau fil est créé	Tous les utilisateurs administrateurs	forum_notify_admin_on_new_thread
NewReplyNotification	Une réponse est postée sur un fil	Auteur du fil (ignore l’auto-réponse)	forum_notify_author_on_reply
ReplyToReplyNotification	Une réponse imbriquée est postée	Auteur de la réponse parente (ignore l’auto-réponse, évite la double notification avec l’auteur du fil)	forum_notify_on_reply_to_reply
BestAnswerNotification	Une réponse est marquée comme meilleure réponse	Auteur de la réponse (ignoré si celui qui marque est l’auteur)	forum_notify_on_best_answer
ContentReportedNotification	Une réponse est signalée	Tous les utilisateurs administrateurs	forum_notify_admin_on_report

Protection CAPTCHA

Lorsque forum_captcha_enabled est défini sur true, les formulaires de création de fils et de réponses incluent une vérification CAPTCHA en utilisant le fournisseur CAPTCHA configuré dans les paramètres principaux de Larapen.

Intégration Envato

Lorsque l’add-on Envato Market Integration est installé, actif et que envato_forum_require_purchase est activé, l’add-on forum intègre un contrôle d’accès basé sur l’achat :

• Le formulaire de création de fil affiche un sélecteur d’achats listant les achats Envato vérifiés de l’utilisateur.
• La validation StoreThreadRequest exige un champ envato_purchase_id qui doit référencer un achat validé et vérifié appartenant à l’utilisateur authentifié.
• Le contrôle par catégorie est géré par le EnvatoPurchaseValidator de l’add-on Envato : si des articles Envato sont liés à une catégorie de forum, seuls les utilisateurs ayant un achat vérifié de l’un de ces articles peuvent créer des fils dans cette catégorie.

Mise à jour

Étape 1 : Remplacer les fichiers

Remplacez le répertoire de l’add-on par la nouvelle version.

Étape 2 : Exécuter les migrations

Étape 3 : Vider les caches

Étape 4 : Vérifier

Visitez Admin → Forum → Tous les fils pour confirmer que le forum fonctionne correctement. Vérifiez la page Paramètres pour examiner les nouvelles options de configuration.

Dépannage

Les pages du forum renvoient 403 : « Veuillez vous connecter pour accéder au forum »

Le paramètre forum_guests_can_view est désactivé. Soit :

• Activez-le dans Admin → Forum → Paramètres → Accès & Permissions, ou
• Assurez-vous que les utilisateurs sont connectés avant d’accéder au forum.

La création de fil redirige vers la connexion

Par défaut, guests_can_create est false. Les utilisateurs non authentifiés sont redirigés vers la page de connexion. C’est le comportement attendu. N’activez la création par les visiteurs dans les paramètres que si nécessaire.

Les votes ne fonctionnent pas : « Le vote n’est pas disponible »

• Assurez-vous que forum_voting_enabled est défini sur true dans les paramètres.
• Si vous essayez de voter sur votre propre contenu, l’auto-vote est désactivé par défaut (allow_self_vote = false dans config/forum.php).
• Le vote nécessite l’authentification : les visiteurs ne peuvent pas voter.

Impossible de marquer la meilleure réponse : 403 Interdit

• Vérifiez que forum_best_answer_enabled est true.
• L’utilisateur doit être soit l’auteur du fil (si forum_author_can_select est activé) soit un administrateur (si forum_admin_can_select est activé).

Impossible de supprimer une catégorie : « Impossible de supprimer une catégorie avec des fils existants »

Les catégories contenant des fils ne peuvent pas être supprimées. Réassignez d’abord tous les fils de la catégorie à une autre catégorie (via l’éditeur de fils admin), ou supprimez les fils individuellement.

Les signalements ne masquent pas automatiquement les réponses

• Vérifiez que forum_allow_reporting est activé.
• Vérifiez le seuil forum_max_reports_auto_hide : le report_count de la réponse doit atteindre ce nombre avant que le masquage automatique ne se déclenche.
• Remarque : un seul utilisateur ne peut signaler une réponse qu’une seule fois. Le seuil nécessite des signalements de différents utilisateurs.

Le CAPTCHA n’apparaît pas sur les formulaires de fil/réponse

• Assurez-vous que forum_captcha_enabled est défini sur true.
• Un fournisseur CAPTCHA doit être configuré dans les paramètres principaux (Admin → Paramètres → Général). Sans fournisseur, les champs CAPTCHA ne s’afficheront pas.

Le sélecteur d’achats Envato n’apparaît pas à la création de fil

• L’add-on Envato doit être installé et actif.
• Le paramètre envato_forum_require_purchase doit être activé dans les paramètres Envato.
• L’utilisateur doit être authentifié.
• L’utilisateur doit avoir au moins un achat vérifié. S’il n’a aucun achat, le sélecteur sera vide.

Les notifications ne sont pas envoyées

• Vérifiez que le toggle de notification concerné est activé dans Forum → Paramètres.
• Vérifiez que le courrier est correctement configuré dans Admin → Paramètres → Courrier.
• Les auto-notifications sont supprimées par conception : les auteurs de fils ne sont pas notifiés de leurs propres réponses, et les auteurs de réponses ne sont pas notifiés lorsqu’ils marquent leur propre meilleure réponse.

La recherche ne renvoie aucun résultat malgré un contenu correspondant

La recherche utilise la fonction JSON_SEARCH de MySQL pour chercher dans les colonnes JSON traduisibles. Assurez-vous :

• Le contenu du fil est stocké dans le format JSON attendu (via spatie/laravel-translatable).
• MySQL 8.0+ est utilisé (les versions antérieures peuvent avoir un support JSON limité).
• La requête de recherche fait au moins quelques caractères : les requêtes très courtes peuvent ne pas correspondre dans les valeurs JSON.