A Wiki in Doli capdoliwiki

Étapes: ouvrir la configuration du module (admin/setup.php), modifier une constante (ex. durée du verrou, largeur max des images, rétention corbeille) et enregistrer. Attendu: les constantes CAPDOLIWIKI_* sont persistées et prises en compte; aucune erreur à l'enregistrement.

Étapes: ouvrir la page à propos (admin/about.php); envoyer un message de feedback. Attendu: l'encart infos module (version, éditeur, licence, versions min Dolibarr/PHP), le formulaire de feedback, l'encart de don et les liens utiles s'affichent; l'envoi du feedback fonctionne (ou journalise l'erreur le cas échéant).

Précondition: installation sans CAPDOLIWIKI_ALLOW_DEMO_DATA, MAIN_FEATURES_LEVEL inférieur à 2 et sans DEMO_INSTANCE. Étapes: tenter de générer puis de purger les données de démonstration. Attendu: les deux actions sont refusées avec un message ; aucune page ni aucun compte n'est créé ou supprimé.

Précondition: une page en corbeille. Étapes: ouvrir la corbeille et restaurer la page. Attendu: la page revient à l'état publié et réapparaît dans l'arborescence; les champs de suppression sont réinitialisés.

Précondition: une page en corbeille, utilisateur avec droit delete. Étapes: supprimer définitivement la page depuis la corbeille. Attendu: la page, toutes ses versions, ses verrous et son répertoire de fichiers sont supprimés définitivement; l'opération est journalisée.

Étapes: tenter de supprimer la page racine "index". Attendu: aucune action de suppression n'est proposée pour la page index; une tentative directe est refusée. La page d'accueil du wiki reste toujours disponible.

Précondition: CAPDOLIWIKI_TRASH_RETENTION_DAYS > 0, une page en corbeille depuis plus longtemps que ce délai. Étapes: exécuter la tâche cron de purge (cron/purge_trash.php). Attendu: les pages en corbeille au-delà du délai de rétention sont supprimées définitivement; avec la valeur 0, aucune purge n'a lieu.

Étapes: ouvrir edit.php sur une page contenant du Markdown varié (titres, listes, gras, code). Attendu: l'éditeur Milkdown se charge et affiche le rendu WYSIWYG du Markdown; la saisie met à jour le champ caché wiki_content; l'enregistrement conserve le Markdown.

Étapes: dans l'éditeur, tester chaque bouton de la toolbar: gras, italique, titres, listes, lien, code, ligne horizontale, plein écran. Attendu: chaque bouton applique le formatage attendu sur la sélection ou à la position du curseur.

Étapes: modifier une page sans enregistrer, quitter/recharger la page d'édition. Attendu: un brouillon est sauvegardé périodiquement en localStorage; au retour, une proposition de restauration du brouillon est offerte; après enregistrement réel, le brouillon est effacé.

Étapes: dans l'éditeur, tester Ctrl+S (enregistrer), Ctrl+Shift+F (plein écran), Échap (quitter le plein écran). Attendu: Ctrl+S soumet le formulaire; Ctrl+Shift+F bascule en plein écran; Échap en sort.

Étapes: depuis une page, lancer l'export PDF de la page seule (export_pdf.php). Attendu: un PDF (TCPDF) est généré avec le titre et le contenu Markdown converti en HTML mis en forme; les images et la mise en page sont correctes.

Précondition: une page ayant des sous-pages. Étapes: lancer l'export PDF de la branche (page + sous-pages). Attendu: le PDF contient la page et toutes ses sous-pages collectées récursivement, dans l'ordre hiérarchique.

Étapes: modifier une page et l'enregistrer plusieurs fois, éventuellement avec un commentaire de version. Attendu: chaque enregistrement crée une nouvelle entrée de version (numéro incrémenté); l'historique (history.php) liste toutes les versions avec auteur, date et commentaire.

Étapes: dans l'éditeur, coller une image depuis le presse-papier (capture d'écran). Attendu: l'image est uploadée via ajax/upload_image.php, redimensionnée côté serveur (GD) selon CAPDOLIWIKI_IMAGE_MAX_WIDTH et CAPDOLIWIKI_IMAGE_QUALITY, puis insérée dans le contenu; le fichier est rangé dans le répertoire de la page.

Étapes: glisser-déposer un fichier image dans l'éditeur. Attendu: même comportement que le collage (upload + redimensionnement + insertion), sans erreur.

Étapes: consulter une page contenant des images; vérifier l'URL de service des images (ajax/viewimage.php ou document.php). Attendu: les images s'affichent; l'accès au fichier respecte le contrôle de permission du wiki (pas d'accès direct sans droit de lecture).

Étapes: ouvrir l'onglet Pièces jointes d'une page, envoyer un fichier, consulter la liste, supprimer le fichier (droit d'écriture). Attendu: le fichier est rangé dans le répertoire de la page et listé avec sa taille ; la suppression fonctionne avec le droit d'écriture ; les images collées dans l'éditeur apparaissent aussi dans cet onglet.

Étapes: coller une image dans l'éditeur ; dans la fenêtre qui s'ouvre, choisir originale, grande (800 px), moyenne (480 px) puis petite (160 px) sur quatre collages. Attendu: chaque image est insérée à la taille choisie et la garde après enregistrement ; en lecture, un clic l'affiche en plein écran.

Précondition: module capDoliWiki non activé. Étapes: Accueil > Configuration > Modules/Applications, rechercher capDoliWiki, cliquer pour l'activer. Attendu: le module passe à l'état actif sans erreur; une entrée de menu "Wiki" apparaît; les tables llx_capdoliwiki_page, _page_version, _page_lock, _page_link et _categorie_capdoliwiki_page sont créées; une page racine "index" existe et n'est pas supprimable.

Étapes: désactiver le module puis le réactiver. Attendu: aucune erreur; les pages existantes et leur historique sont conservés; les migrations (colonne content_plain, index FULLTEXT sur MySQL, backfill) se rejouent sans casse; la constante CAPDOLIWIKI_MODULE_VERSION reflète la version active.

Précondition: page avec un bloc ```mermaid (ex. flowchart). Étapes: consulter la page. Attendu: le bloc mermaid est remplacé par un SVG rendu; le chunk Mermaid (~3 Mo) est chargé dynamiquement uniquement si un diagramme est présent.

Précondition: page avec des blocs :::info, :::tip, :::warning, :::danger. Étapes: consulter la page. Attendu: chaque bloc est rendu en encart stylisé avec la couleur/icône correspondant au type.

Précondition: page avec plusieurs titres (h2/h3). Étapes: consulter la page. Attendu: une table des matières est générée dans la sidebar sticky; les liens pointent vers les sections; comportement responsive correct.

Étapes: survoler un titre; consulter une image ayant un texte alternatif. Attendu: un lien d'ancre (#) apparaît au survol des titres et copie l'URL de la section; les images avec alt sont enveloppées dans figure/figcaption affichant la légende.

Étapes: cliquer sur une image; tester les raccourcis E (éditer), H (historique), flèches (navigation). Attendu: le clic ouvre l'image en lightbox (GLightbox, zoom); E ouvre l'édition, H l'historique, les flèches naviguent entre pages.

Précondition: plusieurs pages pointant (via wikilink) vers la page cible C. Étapes: consulter la page C. Attendu: la liste des backlinks (pages qui référencent C) est affichée et chaque entrée est cliquable.

Précondition: au moins une page qu'aucune autre ne référence. Étapes: ouvrir la page de maintenance (maintenance.php). Attendu: la page orpheline apparaît dans la liste des pages orphelines; un message s'affiche s'il n'y en a aucune.

Étapes: dans l'éditeur, déclencher la recherche de page (ajax/pages_search.php) en saisissant quelques lettres du titre. Attendu: la liste des pages correspondantes est proposée; la sélection insère un wikilink correct vers la page choisie.

Étapes: ouvrir la page de maintenance (maintenance.php). Attendu: la page liste les pages orphelines et les wikilinks cassés, avec des liens cliquables vers les pages concernées; des messages dédiés s'affichent quand il n'y a ni orphelines ni liens cassés.

Étapes: ouvrir la page d'accueil du wiki (index.php) avec plusieurs pages parent/enfant. Attendu: l'arborescence hiérarchique s'affiche avec indentation par niveau; la page index apparaît; les dates de modification et auteurs sont corrects.

Précondition: une page imbriquée sur plusieurs niveaux. Étapes: ouvrir la page enfant la plus profonde (page.php). Attendu: le fil d'ariane affiche le chemin complet de la racine jusqu'à la page courante, chaque niveau étant cliquable.

Précondition: utilisateur avec uniquement le droit "Lire les pages wiki". Étapes: ouvrir le wiki, consulter une page. Attendu: la consultation fonctionne; aucun bouton Créer/Modifier/Supprimer n'est proposé; l'accès direct à edit.php est refusé.

Précondition: utilisateur avec droits read + write (sans delete). Étapes: créer une page, la modifier, l'enregistrer. Attendu: création et modification possibles; le bouton de suppression et l'accès à la corbeille restent indisponibles.

Précondition: utilisateur avec droit delete. Étapes: supprimer une page, ouvrir la corbeille, forcer le déverrouillage d'une page verrouillée par un autre utilisateur. Attendu: accès à la corbeille, à la restauration, à la suppression définitive et au forçage de verrou.

Précondition: utilisateur sans aucun droit capdoliwiki. Étapes: tenter d'ouvrir index.php du wiki. Attendu: accès refusé par restrictedArea (message d'erreur Dolibarr), pas de fuite de contenu.

Étapes: rechercher un terme introuvable; puis rechercher un mot accentué (ex. déploiement). Attendu: un message dédié "aucun résultat" s'affiche quand rien ne correspond; les termes accentués sont correctement trouvés et surlignés.

Étapes: inspecter les liens de suppression de la liste des pages et les liens de restauration et de suppression définitive de la corbeille ; rejouer une action sans jeton. Attendu: chaque lien porte le jeton de session ; une action soumise sans jeton valide est refusée.

Étapes: éditer une page, renseigner des tags dans le champ dédié et/ou utiliser des #tags en ligne dans le contenu, enregistrer. Attendu: les tags saisis et les #tags détectés dans le contenu sont fusionnés puis associés à la page (catégories de type capdoliwiki_page); les tags s'affichent sur la fiche en lecture.

Étapes: ouvrir la page des tags (tags.php); cliquer sur un tag. Attendu: un nuage de tags s'affiche avec les libellés existants; le clic sur un tag liste toutes les pages portant ce tag.

Étapes: dans le champ de tags en édition, commencer à saisir quelques lettres. Attendu: l'autocomplétion (ajax/tags.php) propose les tags existants correspondants; la sélection ajoute le tag sans doublon.

Précondition: page ouverte en édition par l'utilisateur A. Étapes: l'utilisateur B tente d'éditer la même page. Attendu: B est averti que la page est verrouillée par A et ne peut pas écraser; il peut consulter en lecture.

Précondition: page verrouillée par un autre utilisateur. Étapes: un utilisateur avec droit delete force le déverrouillage. Attendu: le verrou est supprimé; l'admin peut éditer; une trace est journalisée (dol_syslog).