---
title: "FAQ"
weight: 50
description: "Questions fréquentes sur le module wiki capDoliWiki pour Dolibarr."
---

# FAQ

## Installation et activation

### Le module n'apparaît pas dans la liste des modules Dolibarr

Vérifiez que :

- Le dossier `capdoliwiki` est bien placé dans `htdocs/custom/` de votre installation Dolibarr
- La constante `$dolibarr_main_document_root_alt` dans le fichier `conf.php` de Dolibarr pointe vers le dossier `htdocs/custom` (ou le dossier contenant vos modules externes)
- Votre version de Dolibarr est 18.0 ou supérieure

### Le module s'active mais les tables ne sont pas créées

Consultez les logs Dolibarr dans **Accueil > Outils système > Journaux**. Les erreurs SQL liées à la création des tables y sont consignées. Vérifiez que votre utilisateur de base de données a les droits de création de tables.

## Éditeur

### L'éditeur ne s'affiche pas (page blanche à la place)

L'éditeur utilise des modules JavaScript ES (ES Modules). Vérifiez que :

- Votre navigateur est à jour (Chrome, Firefox, Edge ou Safari récent)
- Les fichiers JavaScript du module sont présents dans le dossier `js/` (`capdoliwiki-editor.min.js`, `capdoliwiki-readonly.min.js`)
- Aucun bloqueur de scripts ou extension de navigateur n'interfère avec le chargement

### Le collage d'image ne fonctionne pas

Le collage d'image nécessite que l'extension PHP GD soit activée sur votre serveur. Vérifiez sa présence avec `phpinfo()` ou la commande `php -m | grep gd`.

Vérifiez également que le dossier de données de Dolibarr est accessible en écriture par le serveur web.

### Mon brouillon a disparu

Le brouillon (sauvegarde automatique) est stocké dans le localStorage de votre navigateur. Il est lié au navigateur et au poste de travail utilisé. Si vous changez de navigateur, de poste de travail, ou si vous videz les données de navigation, le brouillon est perdu.

Le brouillon est également supprimé automatiquement après une sauvegarde réussie de la page.

## Édition collaborative

### Un message m'indique que la page est verrouillée

Un autre utilisateur est actuellement en train de modifier cette page. Vous devez attendre qu'il termine et sauvegarde (ou qu'il quitte la page d'édition) pour pouvoir la modifier à votre tour.

Si l'utilisateur a quitté sans sauvegarder et que le verrou n'a pas été libéré, le verrou expire automatiquement après la durée configurée (30 minutes par défaut).

Un administrateur (permission de suppression) peut forcer le déverrouillage.

### Deux utilisateurs peuvent-ils modifier la même page en même temps ?

Non. Le système de verrouillage empêche les modifications concurrentes. Un seul utilisateur à la fois peut ouvrir l'éditeur sur une page donnée.

## Contenu

### Les diagrammes Mermaid ne s'affichent pas

Les diagrammes Mermaid sont chargés dynamiquement via un fichier JavaScript volumineux (environ 3 Mo). Si votre connexion est lente, le rendu peut prendre quelques secondes.

Vérifiez que le fichier `js/capdoliwiki-mermaid.min.js` est bien présent dans le dossier du module.

### La coloration syntaxique du code ne fonctionne pas

Assurez-vous que le langage est spécifié après les trois backticks d'ouverture du bloc de code. Exemple : ` ```php ` pour du code PHP. Sans indication de langage, aucune coloration n'est appliquée.

Les 15 langages pris en charge sont : PHP, JavaScript, Python, Java, C, C++, CSS, HTML, SQL, Bash, JSON, YAML, XML, Markdown et TypeScript.

## Export PDF

### Les images n'apparaissent pas dans le PDF exporté

Seules les images stockées localement sur le serveur Dolibarr sont incluses dans le PDF. Les images provenant d'URL externes (http/https vers des serveurs tiers) ne sont pas téléchargées pour le PDF.

Les images collées dans l'éditeur via Ctrl+V sont stockées localement et apparaissent normalement dans le PDF.

### Le PDF ne contient pas les diagrammes Mermaid

Les diagrammes Mermaid sont rendus côté navigateur en JavaScript. L'export PDF utilise une conversion Markdown vers HTML simplifiée côté serveur qui ne prend pas en charge les diagrammes Mermaid.

## Corbeille

### Comment restaurer une page supprimée ?

1. Accédez à la liste des pages wiki (**ECM/GED > Wiki**)
2. Cliquez sur le lien **Voir la corbeille** en bas de page
3. Repérez la page à restaurer
4. Cliquez sur l'icône de restauration et confirmez

Cette action nécessite la permission de suppression/administration.

### Les pages de la corbeille disparaissent automatiquement

La tâche planifiée **PurgeWikiTrash** supprime définitivement les pages en corbeille dont la date de suppression dépasse la durée de rétention configurée (30 jours par défaut). Vous pouvez ajuster cette durée dans la [configuration](/view.php?path=capdoliwiki/configuration.md) ou la mettre à 0 pour désactiver la purge automatique.

## Support

Pour toute question non couverte par cette documentation :

- **Forum Dolibarr** : [https://www.dolibarr.fr/forum](https://www.dolibarr.fr/forum)
- **Support CAP-REL** : [https://cap-rel.fr/sav-module-dolibarr/](https://cap-rel.fr/sav-module-dolibarr/)
- **Contact** : [https://cap-rel.fr/contact/](https://cap-rel.fr/contact/)
