---
title: "Installation"
weight: 10
description: "Téléchargement, installation et activation du module CapTODO pour Dolibarr."
---

# Installation

## Prérequis

- Dolibarr 18 ou supérieur
- PHP 7.0 ou supérieur
- Les modules **Projets**, **Tiers**, **Catégories/Tags** et **Agenda** doivent être activés

## Téléchargement

Téléchargez le module depuis le [DoliStore](https://www.dolistore.com/product.php?id=358&l=fr) ou depuis la [boutique CAP-REL](https://shop.cap-rel.fr/product/MOD-Dolibarr-CapTODO).

## Installation du module

1. Connectez-vous en tant qu'administrateur Dolibarr
2. Allez dans **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**
3. Sélectionnez le fichier zip téléchargé et cliquez sur **Envoyer**
4. Une fois le déploiement terminé, un message de confirmation s'affiche

![Page de déploiement d'un module externe dans Dolibarr avec le bouton Envoyer](screenshots/deploiement-module.webp)

## Activation

1. Allez dans **Accueil > Configuration > Modules/Applications**
2. Recherchez "CapTODO" dans la liste ou naviguez dans la catégorie "Autres"
3. Cliquez sur le bouton d'activation

![Page d'activation du module CapTODO dans la liste des modules Dolibarr avec le bouton d'activation](screenshots/activation-module.webp)

À l'activation, le module crée automatiquement les menus et les champs supplémentaires nécessaires à son fonctionnement.

## Vérification

Après activation, un sous-menu **Todo** apparaît dans le menu principal **Projets** du menu latéral gauche. Si vous ne le voyez pas, vérifiez que le module Projets est bien activé.

## Menus

Le module ajoute les entrées suivantes dans le menu **Projets** :

| Menu | Description | Condition d'affichage |
|------|-------------|----------------------|
| **TodoList** | Page d'accueil avec la liste des projets TODO | Toujours visible |
| **Messages** | Messages internes liés aux tâches | Toujours visible |
| **Logbook** | Journal de temps | Visible uniquement si le logbook est activé dans la configuration |

## Permissions

Trois niveaux de permissions sont disponibles :

| Permission | Description | Activée par défaut |
|------------|-------------|-------------------|
| **Lire** | Consulter les listes TODO, les tâches et les messages | Oui |
| **Créer/Modifier** | Créer et modifier des tâches, messages et entrées logbook | Oui |
| **Supprimer** | Supprimer des tâches et entrées | Non |

Les permissions se configurent dans **Accueil > Utilisateurs & Groupes > Permissions** ou via les groupes d'utilisateurs.

## Premier paramétrage

Rendez-vous dans **Accueil > Configuration > Modules > CapTODO** (onglet **Réglages**) pour effectuer le paramétrage initial. Consultez la page [Configuration](/captodo/configuration) pour le détail de toutes les options.

Le paramètre le plus important est la **catégorie de projet** qui identifie les projets utilisés comme listes TODO. Sans cette catégorie, le module ne sait pas quels projets afficher.

## Mise à jour

1. Téléchargez la nouvelle version du module
2. Déployez-la via **Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe**
3. **Désactivez puis réactivez** le module dans la liste des modules

La désactivation/réactivation est nécessaire pour appliquer les mises à jour de base de données et enregistrer les nouveaux menus et permissions.

## Désinstallation

Désactivez le module depuis **Accueil > Configuration > Modules/Applications**. Les données créées (projets, tâches) restent en base de données et sont toujours accessibles via le module Projets de Dolibarr.
