Configuration

Accès à la page de configuration

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans Accueil > Configuration > Modules/Applications
3. Sur la ligne du module CapComments, cliquez sur l'icône de configuration (roue dentée)

La page de configuration comporte deux onglets : Paramètres et À propos.

Paramètres disponibles

Menu principal CapComments

CAPCOMMENTS_MAIN_MENU_TOP -- Affiche un menu principal "CapComments" dans la barre de menu supérieure de Dolibarr.

Lorsque cette option est activée :

• Un menu CapComments apparaît dans la barre de navigation principale
• Le menu secondaire gauche propose deux entrées :
  • Commentaires : accès à la liste de tous les commentaires
  • Notifications : accès à la liste de vos notifications

Menu dans Outils

CAPCOMMENTS_MAIN_MENU_LEFT_TOOLS -- Ajoute les entrées CapComments dans le menu principal "Outils" en tant que sous-menu.

Lorsque cette option est activée :

• Dans le menu Outils, un sous-menu Commentaires apparaît dans le panneau gauche
• Une entrée Notifications est également ajoutée sous ce sous-menu

Attention : Vous pouvez activer les deux options simultanément. Le menu principal et le sous-menu dans Outils fonctionnent de manière indépendante.

Style de notification

CAPCOMMENTS_NOTIF_STYLE -- Détermine la manière dont vous êtes averti(e) lorsqu'un collègue vous mentionne dans un commentaire.

Deux styles sont disponibles :

Modifier les paramètres

1. Sur la page de configuration, cliquez sur le bouton Modifier
2. Ajustez les valeurs des paramètres
3. Validez pour enregistrer

Notifications programmées (tâche planifiée)

Depuis la version 1.0.23, CapComments permet de différer l'envoi des notifications à une date future. Pour que ce mécanisme fonctionne, une tâche planifiée Dolibarr doit s'exécuter régulièrement.

Vérifier le cron du module

1. Allez dans Accueil > Configuration > Modules/Applications et assurez-vous que le module Tâches planifiées (Cron) de Dolibarr est activé
2. Allez dans Accueil > Outils d'administration > Tâches planifiées
3. Vous devez voir une entrée intitulée CapComments : envoi des notifications programmées
4. Cette tâche est exécutée par défaut toutes les 5 minutes

Modifier la fréquence

Si vous souhaitez un envoi plus réactif ou au contraire moins fréquent :

1. Cliquez sur l'entrée CapComments : envoi des notifications programmées
2. Modifiez le champ Fréquence (en minutes)
3. Validez

Attention : Le cron Dolibarr lui-même doit être déclenché régulièrement par un cron système, soit via la planification serveur (crontab), soit via le déclencheur web intégré à Dolibarr. Reportez-vous à la documentation officielle Dolibarr pour la mise en place.

Utilisateurs connectés (widget) {#utilisateurs-connectes}

Le widget Utilisateurs connectés affiche sur la page d'accueil la liste des utilisateurs ayant une connexion récente.

Activation et placement

Le widget est activé par défaut lors de l'installation du module sur la page Accueil. Pour vérifier ou changer son emplacement :

1. Allez dans Accueil > Configuration > Boîtes / Widgets
2. Recherchez Utilisateurs connectés dans la liste
3. Cochez les pages sur lesquelles vous voulez afficher le widget

Paramétrer la fenêtre de temps

Par défaut, un utilisateur est considéré comme "connecté" si sa dernière connexion remonte à moins de 30 minutes. Pour modifier ce seuil :

1. Allez dans Accueil > Configuration > Autres paramètres
2. Créez ou modifiez la constante CAPCOMMENTS_CONNECTED_WINDOW_MINUTES
3. Saisissez la durée souhaitée en minutes (par exemple 60 pour une fenêtre d'une heure)
4. Validez

Note : La valeur n'a pas besoin d'être déclarée pour que le widget fonctionne. Tant que la constante n'existe pas, la valeur par défaut de 30 minutes est utilisée.

Droits d'accès {#droits}

Le module déclare trois droits, dans Accueil > Utilisateurs & Groupes, onglet Permissions de l'utilisateur ou du groupe, rubrique CapComments :

À la première activation, les droits de lecture et d'écriture sont accordés à tous les utilisateurs internes actifs. Les droits du module s'ajoutent à ceux de la fiche : un commercial qui ne voit que ses clients ne voit que les commentaires de ses clients, dans l'onglet comme dans la liste, et une mention ne notifie que les collègues qui peuvent ouvrir la fiche.

Les comptes externes (rattachés à un tiers) ouvrent l'onglet Commentaires des fiches de leur propre tiers. Ils n'y voient que les commentaires publics et n'écrivent que des commentaires publics ; la liste des commentaires leur reste fermée.

Données de démonstration {#demonstration}

L'onglet Données de démonstration de la page de configuration crée un jeu complet pour essayer le module : tiers, proposition commerciale, projet, comptes demo.commercial, demo.compta et demo.support, commentaires publics et privés, fils de discussion, mentions, notifications et rappels. Le mot de passe des comptes est tiré au hasard et affiché une seule fois, dans le compte rendu de la génération. Le bouton Purger retire tout ce que la génération a créé.

La génération et la purge ne fonctionnent que sur une instance de démonstration ou de développement. Sur une autre installation, posez l'une de ces constantes dans Accueil > Configuration > Autres paramètres :

• CAPCOMMENTS_ALLOW_DEMO_DATA à 1 ;
• ou MAIN_FEATURES_LEVEL à 2 (mode expert de Dolibarr).

Attention : ces données sont fictives. Ne les générez jamais sur une installation de production.

Page À propos

L'onglet À propos affiche :

• Un formulaire de retour d'expérience (notation et commentaire libre) envoyé à l'éditeur CAP-REL
• Un lien pour soutenir le développement du module
• Les statistiques d'utilisation du module (nombre de commentaires créés, nombre d'utilisateurs actifs)
• Des liens utiles : forum Dolibarr, support CAP-REL, contact