Eric.seigne: CapAgenda 1.0.0

2026-10-27T10:12:04Z

CapAgenda 1.0.0

New page

[[en:Module_CapAgenda]]
[[Category:Modules complémentaires]]
[[Category:CRM]]
[[Category:CAP-REL]]
{{TemplateDocDevFr}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=Capagenda
|editor=CAP-REL
|web=[https://www.cap-rel.fr www.cap-rel.fr]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=capagenda}}
|status=stable
|prerequisites=Module Agenda
|minversion=18.0.0
|note=Une autre vue pour votre agenda Dolibarr : une page unique et moderne avec les vues jour, semaine, mois, liste et planning par collaborateur, le glisser-déposer et des filtres mémorisés, sans rien changer à vos événements.
}}

=Fonctionnalités=

L'agenda natif de Dolibarr fait le travail, mais il demande beaucoup de clics pour déplacer un rendez-vous, changer de vue ou retrouver les événements d'un collègue. CapAgenda le remplace par une seule page, rapide et lisible, dans l'esprit des agendas en ligne que tout le monde connaît.

==En bref==

* '''Pour qui''' : toute équipe qui organise ses rendez-vous, appels, interventions et réunions dans Dolibarr, du commercial au technicien en passant par l'assistante.
* '''Ce que fait le module''' : il affiche et modifie les événements du module Agenda dans une interface moderne, avec les vues, les filtres et les raccourcis d'un agenda en ligne.
* '''Ce qu'il ne fait pas''' : il ne crée aucune table et ne copie aucun événement ; les rappels, les triggers et les modules branchés sur l'agenda continuent de fonctionner. Il n'appelle aucun service extérieur : la bibliothèque de calendrier est embarquée dans le module.

==Liste des fonctionnalités==

* '''Une page, toutes les vues''' - jour, semaine, mois, liste et planning par collaborateur ; la dernière vue utilisée est mémorisée pour chaque utilisateur.
* '''Pleine largeur''' - le menu gauche de Dolibarr est masqué sur l'agenda (option active par défaut), un panneau latéral repliable regroupe le bouton Créer, un mini calendrier et les filtres.
* '''Glisser-déposer''' - déplacer un rendez-vous, changer sa durée par le bord inférieur, le réassigner en le glissant d'une ligne à l'autre du planning.
* '''Création rapide''' - sélection d'un créneau, recherche du tiers et du projet par nom ou référence, puis passage à la fiche native pour les notes, rappels et contacts.
* '''Collaborateurs en cases colorées''' - chaque collègue a sa case, de la couleur de ses événements, avec les raccourcis Moi, Mon équipe et Tous.
* '''Couleurs douces''' - événements en teintes pastel, par collaborateur ou par type d'événement, reprises des fiches utilisateur et du dictionnaire des types.
* '''Filtres mémorisés''' - calendriers (mes événements, ceux des autres, congés, anniversaires, calendriers iCal, autres modules), types, statut, tiers, projet et ressource.
* '''Statuts et annulation''' - statut 0, 50 ou 100 % depuis le panneau de détail, annulation de la dernière modification pendant quelques secondes, protection contre les modifications simultanées.
* '''Raccourcis clavier''' - navigation, changement de vue, création, filtres et annulation au clavier.
* '''Mode sombre, mobile et impression''' - le thème suit Dolibarr, l'affichage s'adapte au téléphone, l'impression retire les barres d'outils.
* '''Remplacement de l'agenda natif''' - en option, les pages de calendrier natives redirigent vers CapAgenda ; la vue liste native reste accessible.
* '''Sept langues''' - français, anglais, allemand, espagnol, italien, néerlandais et portugais (Brésil).

==Captures d'écran==

<gallery widths="300px" heights="200px">
File:CapAgenda vue-semaine.png|Vue semaine : panneau latéral, mini calendrier et collaborateurs en cases colorées
File:CapAgenda vue-mois.png|Vue mois : une pastille de couleur par rendez-vous, les congés en barre
File:CapAgenda vue-jour.png|Vue jour
File:CapAgenda vue-planning.png|Planning par collaborateur
File:CapAgenda panneau-detail.png|Panneau de détail d'un événement
File:CapAgenda vue-mobile.png|Affichage sur téléphone
</gallery>

=Liens=

* [https://doc.cap-rel.fr/capagenda/ Documentation du module]
* [https://doc.cap-rel.fr/capagenda/nouveautes-1-0-0 Nouveautés de la version 1.0.0]
* [https://dolinews.com/fr/projets/capagenda Recevoir les notifications de mise à jour]
* [https://cap-rel.fr/sav-module-dolibarr/ Formulaire de SAV]
* [https://tests.cap-rel.fr/projects/30/quality Rapport des tests automatiques]
* [https://dolitest.fr/capagenda/ Démonstration en ligne] : un Dolibarr avec un agenda d'équipe déjà rempli sur tout le mois, 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
|-
| Module Dolibarr || Agenda activé
|-
| Droits || un compte administrateur pour installer, activer et configurer le module
|}

Les modules Congés, Projets et Ressources sont facultatifs : quand ils sont activés, leurs données apparaissent dans les filtres et dans l'agenda.

=Installation=

{{InstallModuleDoliStoreFr|keyword=capagenda}}

==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 enregistre les nouvelles permissions et les nouvelles options.

Les événements ne sont pas touchés, et les préférences de chaque utilisateur sont conservées.

==Désinstallation==

Désactivez le module depuis '''Accueil > Configuration > Modules/Applications'''. Le module ne stocke aucun événement : l'agenda natif retrouve exactement son état d'origine.

=Configuration=

{{ActivationModuleFr}}

La configuration se trouve dans '''Accueil > Configuration > Modules > Agenda moderne'''.

{| class="wikitable"
! Paramètre !! Rôle !! Valeur par défaut
|-
| Rediriger l'agenda natif vers l'agenda moderne || les pages de calendrier natives (mois, semaine, jour, par utilisateur) ouvrent CapAgenda ; la vue liste native n'est jamais redirigée || non
|-
| Masquer le menu gauche de Dolibarr sur l'agenda || l'agenda occupe toute la largeur de l'écran ; le menu reste sur les autres pages || oui
|-
| Vue par défaut || vue proposée à un utilisateur qui n'a pas encore choisi || semaine
|-
| Couleur des événements par défaut || couleur du collaborateur propriétaire ou du type d'événement || collaborateur
|-
| Granularité par défaut des créneaux || 15, 30 ou 60 minutes || 30 minutes
|-
| Couleur des congés et des anniversaires || couleurs de ces deux calendriers || bleu gris et orange doux
|-
| Nombre maximal d'événements par requête || au-delà, la période est tronquée et un bandeau invite à affiner les filtres || 5000
|-
| Durée de la notification d'annulation || temps pendant lequel l'annulation reste proposée après une modification || 8 secondes
|}

Les heures et jours ouvrés, le premier jour de la semaine et les calendriers iCal se règlent comme d'habitude dans la configuration du module Agenda natif : CapAgenda les reprend.

=Permissions=

Le module ajoute une seule permission, '''Utiliser l'agenda moderne''', accordée à l'activation à tous les utilisateurs qui lisent déjà l'agenda. Pour le reste, CapAgenda applique exactement les droits du module Agenda : lire, créer et supprimer ses propres événements ou ceux de tout le monde.

=Utilisation=

Après activation, l'entrée '''Agenda moderne''' apparaît dans le menu Agenda.

==Se déplacer==

Le bouton à trois traits affiche ou masque le panneau latéral. '''Aujourd'hui''' et les flèches changent de période, le mini calendrier ouvre directement un jour, et le menu en haut à droite change de vue.

==Créer et modifier==

Sélectionnez un créneau à la souris pour ouvrir la création rapide, ou utilisez le bouton '''Créer'''. Glissez un événement pour le déplacer, tirez son bord inférieur pour changer sa durée. Une notification permet d'annuler chaque modification pendant quelques secondes.

==Filtrer==

Cochez ou décochez les collaborateurs dans le panneau latéral ; les autres filtres (groupe, couleur, types, statut, tiers, projet, ressource) sont réunis sous '''Plus de filtres'''. Les choix sont mémorisés pour chaque utilisateur.

Le détail de chaque vue et de chaque raccourci est décrit dans le [https://doc.cap-rel.fr/capagenda/utilisation guide d'utilisation].

=FAQ=

'''Mes événements ont-ils été convertis ou copiés ?''' 
Non. Le module ne crée aucune table : il affiche et modifie les événements du module Agenda, à travers les mêmes classes que la fiche native.

'''Les rappels et les notifications continuent-ils de fonctionner ?''' 
Oui : toute écriture passe par le cœur de Dolibarr, les triggers et les rappels se déclenchent comme depuis la fiche de l'événement.

'''Un collègue a modifié un événement pendant que je le déplaçais.''' 
Le déplacement est refusé, un message explique le conflit et la vue est actualisée : personne n'écrase le travail de l'autre sans le savoir.

'''La vue planning n'affiche pas tous les utilisateurs.''' 
Les lignes du planning suivent les collaborateurs cochés et vos droits : sans le droit de lire tous les événements, vous ne voyez que votre propre ligne.

'''Comment revenir à l'agenda natif ?''' 
Ajoutez <code>capagenda_native=1</code> à l'adresse de la page native, décochez l'option de redirection, ou utilisez l'entrée '''Agenda classique''' du menu à trois points.

Toutes les questions : [https://doc.cap-rel.fr/capagenda/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 CapAgenda FR - Revision history

Eric.seigne: CapAgenda 1.0.0