Eric.seigne: CapComments 1.0.28

2026-10-25T20:44:10Z

CapComments 1.0.28

New page

[[en:Module_CapComments]]
[[Category:Modules complémentaires]]
[[Category:CRM]]
[[Category:CAP-REL]]
{{TemplateDocDevFr}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=CapComments
|editor=CAP-REL
|web=[https://www.cap-rel.fr www.cap-rel.fr]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=capcomments}}
|status=stable
|prerequisites=
|minversion=18.0.0
|note=Fils de commentaires sur les fiches Dolibarr, avec mentions @collègue, rappels programmés et notifications qui respectent les droits de chaque utilisateur.
}}

=Fonctionnalités=

Les échanges sur un client, un devis ou un projet se perdent dans les emails et les messageries. CapComments les ramène là où se trouve le dossier : un onglet '''Commentaires''' sur les fiches Dolibarr, avec fils de discussion, mentions, rappels et notifications.

==En bref==

* '''Pour qui''' : toute équipe qui travaille à plusieurs sur les mêmes tiers, devis, commandes, projets ou tickets.
* '''Ce que fait le module''' : il ajoute un fil de commentaires sur chaque fiche prise en charge, prévient les collègues mentionnés et programme des rappels.
* '''Ce qu'il ne fait pas''' : il n'envoie aucun email, ne modifie aucune pièce commerciale et ne montre jamais un commentaire à quelqu'un qui ne peut pas ouvrir la fiche.

==Liste des fonctionnalités==

* '''Onglet Commentaires''' sur plus de vingt types de fiches : tiers, propositions, commandes, factures, commandes et factures fournisseur, projets, tâches, tickets, contrats, interventions, produits, notes de frais, congés, ordres de fabrication et d'autres.
* '''Fils de discussion''' avec réponses imbriquées.
* '''Mentions''' par @login, avec suggestion des noms pendant la saisie ; une mention ne notifie que les collègues qui peuvent ouvrir la fiche.
* '''Rappels programmés''' à une date donnée, envoyés par la tâche planifiée du module, et rappels personnels par @me, @moi ou @self.
* '''Notifications''' par cloche dans la barre supérieure ou par post-it, au choix.
* '''Commentaires privés''', réservés aux utilisateurs internes, ou '''publics''', visibles aussi par les comptes externes du tiers.
* '''Listes''' de tous les commentaires et de vos notifications, filtrées par auteur, tiers, message ou date.
* '''Widget''' des utilisateurs connectés sur le tableau de bord.
* '''Données de démonstration''' créées et retirées en un clic, sur les instances de démonstration et de développement.
* '''Neuf langues''' : français, anglais, allemand, espagnol, italien, néerlandais, polonais, portugais et portugais (Brésil).

==Captures d'écran==

<gallery widths="300px" heights="200px">
File:CapComments onglet-commentaires-fiche-tiers.png|L'onglet Commentaires sur une fiche tiers
File:CapComments fil-discussion-imbrique.png|Un fil de discussion avec réponses imbriquées
File:CapComments autocomplete-mentions.png|Suggestion des collègues pendant la saisie d'une mention
File:CapComments liste-commentaires.png|La liste des commentaires, filtrée par tiers
File:CapComments liste-notifications.png|La liste des notifications
File:CapComments page-configuration.png|Page de configuration du module
</gallery>

=Liens=

* [https://doc.cap-rel.fr/capcomments/ Documentation du module]
* [https://doc.cap-rel.fr/capcomments/nouveautes-1-0-28 Nouveautés de la version 1.0.28]
* [https://dolinews.com/fr/projets/capcomments Recevoir les notifications de mise à jour]
* [https://cap-rel.fr/sav-module-dolibarr/ Formulaire de SAV]
* [https://dolitest.fr/capcomments/ Démonstration en ligne] : un Dolibarr avec des fils de discussion, des mentions et des rappels déjà en place, créé pour vous en moins de 20 secondes et supprimé après la séance

=Prérequis=

{| class="wikitable"
! Élément !! Version ou condition
|-
| Dolibarr || 18.0 ou supérieur
|-
| PHP || 7.4 ou supérieur
|-
| Droits || un compte administrateur pour installer, activer et configurer le module
|}

L'onglet Commentaires apparaît sur les fiches des modules Dolibarr activés : un module absent n'a simplement pas d'onglet.

=Installation=

{{InstallModuleDoliStoreFr|keyword=capcomments}}

==Mise à jour==

# Installez la nouvelle version par '''Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe'''.
# Désactivez puis réactivez le module : la réactivation applique les mises à jour de la base de données et accorde une fois les droits de lecture et d'écriture aux utilisateurs internes.

Vos commentaires, notifications et réglages sont conservés.

==Désinstallation==

Désactivez le module depuis '''Accueil > Configuration > Modules/Applications'''. Les commentaires et les notifications restent en base de données : une réactivation ultérieure les retrouve.

=Configuration=

{{ActivationModuleFr}}

La configuration se trouve dans '''Accueil > Configuration > Modules > CapComments'''. Elle compte les onglets '''Paramètres''', '''Données de démonstration''' et '''À propos'''.

{| class="wikitable"
! Paramètre !! Rôle
|-
| Menu principal CapComments || affiche le menu du module dans la barre supérieure
|-
| Menu dans Outils || ajoute le menu du module au menu Outils
|-
| Style de notification || cloche dans la barre supérieure, ou post-it glissant
|}

Les rappels programmés sont envoyés par la tâche planifiée '''CapComments''' : vérifiez qu'elle est active dans '''Accueil > Outils d'administration > Tâches planifiées'''.

==Données de démonstration==

L'onglet '''Données de démonstration''' génère, puis purge, un jeu complet : tiers, proposition, projet, comptes de démonstration, fils de discussion, mentions et rappels. Il ne fonctionne que sur une instance de démonstration ou de développement ; ailleurs, posez la constante <code>CAPCOMMENTS_ALLOW_DEMO_DATA</code> à <code>1</code>, ou <code>MAIN_FEATURES_LEVEL</code> à <code>2</code>. Ne le lancez jamais sur une installation de production.

=Permissions=

{| class="wikitable"
! Permission !! Ce qu'elle permet
|-
| Lire les commentaires et les notifications || voir l'onglet Commentaires, la liste des commentaires et ses notifications
|-
| Écrire des commentaires || commenter, répondre et supprimer ses propres commentaires
|-
| Supprimer les commentaires des autres utilisateurs || modérer les commentaires d'une fiche
|}

Les droits du module s'ajoutent à ceux de la fiche : un commercial limité à ses clients ne voit que les commentaires de ses clients. Les comptes externes ne voient que les commentaires publics des fiches de leur propre tiers.

=Utilisation=

Ouvrez une fiche, cliquez sur l'onglet '''Commentaires''', écrivez votre message et cochez '''Privé''' si seuls les utilisateurs internes doivent le lire. Tapez <code>@</code> pour mentionner un collègue, choisissez une date pour programmer un rappel, et envoyez avec le bouton ou par <code>Ctrl+Entrée</code>. Le lien '''Répondre''' ouvre une réponse dans le fil.

Vos notifications apparaissent dans la barre supérieure ; la liste complète et la liste de tous les commentaires sont dans le menu du module.

Le détail est dans le [https://doc.cap-rel.fr/capcomments/utilisation guide d'utilisation].

=FAQ=

'''Je ne vois pas l'onglet Commentaires sur une fiche.'''<br>
Vérifiez que vous avez le droit de lire les commentaires et que le type de fiche est pris en charge.

'''Un collègue mentionné n'a pas reçu de notification.'''<br>
Une mention ne notifie que les personnes qui ont le droit de lire les commentaires et d'ouvrir la fiche ; un commentaire privé ne notifie jamais un compte externe.

'''Un rappel programmé n'est pas parti.'''<br>
Vérifiez que la tâche planifiée CapComments est active.

Toutes les questions : [https://doc.cap-rel.fr/capcomments/faq FAQ de la documentation].

=Développement=

Les développements et améliorations peuvent être proposés au responsable du projet par email (voir dans les entêtes des fichiers sources) ou par le [https://cap-rel.fr/sav-module-dolibarr/ formulaire de SAV].

Module CapComments FR - Revision history

Eric.seigne: CapComments 1.0.28