Documentation KSIDol > Modules KSIDol > Glisser-deposer documents
Notice du module Glisser-deposer documents
Guide d'utilisation non technique : a quoi sert le module, comment l'utiliser et comment il s'articule avec Dolibarr.
CompatibilitéDolibarr 18 à 24
Options de réglage3 réglages on/off
Impact base de donnéesAucune table créée
PortéeToutes les fiches à onglet Documents
1. Presentation du module
Le module « Glisser-déposer de documents » ajoute le confort du glisser-déposer aux fiches de Dolibarr. Au lieu de cliquer sur le bouton +, d'ouvrir une fenêtre, de parcourir votre disque puis de valider, vous attrapez un fichier (ou un lien) et vous le déposez directement sur une zone dédiée qui apparaît sous le titre du bloc « Fichiers et documents joints » ou « Fichiers et documents liés ». Le document est alors rattaché à la fiche en une seule action.
Le module ne remplace rien : il pose simplement une couche visuelle par-dessus les blocs de documents existants de Dolibarr. Le dépôt réutilise à l'identique le formulaire natif de Dolibarr et tous ses contrôles (jeton de sécurité, identifiant et type de l'objet, droits de l'utilisateur, taille maximale d'envoi, vérifications). Aucun fichier du cœur de Dolibarr n'est modifié, et rien n'est stocké ailleurs que là où Dolibarr range habituellement vos pièces jointes.
- S'installe comme module externe et s'active depuis la liste des modules Dolibarr
- Fonctionne partout où une fiche possède l'onglet / le bloc « Documents » (tiers, factures, devis, commandes, produits, projets, etc.)
- Ne crée aucune table, aucun menu, aucune tâche planifiée : c'est une simple amélioration d'interface
- Passe par les formulaires d'envoi natifs de Dolibarr : mêmes droits, mêmes limites, mêmes contrôles de sécurité
- Interface disponible en français, anglais, italien, allemand et espagnol, selon la langue de l'utilisateur
2. Déposer des fichiers par glisser-déposer
Sur chaque fiche disposant du bloc « Fichiers et documents joints », une zone de dépôt s'ajoute sous le titre du bloc, avec l'invite « Glissez et déposez vos fichiers ici ».
- Faites glisser un fichier depuis votre ordinateur et lâchez-le sur la zone : il est joint automatiquement à la fiche
- Le dépôt de plusieurs fichiers à la fois est pris en charge (un message indique « Envoi de X fichiers en cours… »)
- L'envoi passe par le formulaire d'envoi natif de Dolibarr : la pièce est rangée exactement là où le bouton + l'aurait rangée
- Un message de progression s'affiche pendant l'envoi ; si aucun fichier n'est détecté dans le dépôt, un message d'erreur le signale
3. Déposer un lien (URL) par glisser-déposer
Sur les fiches disposant du bloc « Fichiers et documents liés », une seconde zone de dépôt apparaît avec l'invite « Glissez et déposez un lien ici », pour rattacher une adresse web plutôt qu'un fichier.
- Faites glisser un lien (depuis la barre d'adresse, un favori, un e-mail ou une page web) et déposez-le sur la zone
- Le module reconnaît les adresses commençant par http, https, ftp ou mailto ; une adresse non valide est signalée par un message
- Un libellé est repris automatiquement lorsque le lien glissé en comporte un (texte du lien de la page d'origine)
- Le lien est enregistré via le formulaire de liens natif de Dolibarr ; s'il est déposé sans URL exploitable, un message « Aucune URL détectée » s'affiche
4. Cliquer au lieu de déposer (solution de secours)
Si vous préférez cliquer, ou si le glisser-déposer n'est pas pratique (tablette, geste manqué), les zones de dépôt sont aussi cliquables.
- Un clic sur la zone de fichiers ouvre le sélecteur de fichiers habituel pour choisir un document sur votre appareil
- Un clic sur la zone de liens fait apparaître le champ natif et place le curseur dedans pour saisir l'adresse à la main
- Si votre navigateur n'autorise pas le dépôt direct, le module affiche automatiquement le formulaire Dolibarr classique pour terminer l'opération sans blocage
5. Accessibilité au clavier
Les zones de dépôt sont utilisables sans souris, pour les personnes qui naviguent au clavier.
- Les zones sont accessibles par la touche Tabulation
- Les touches Entrée et Espace activent la zone : ouverture du sélecteur de fichiers ou passage au champ de lien
6. Retours visuels et messages guidés
Le module accompagne chaque geste par un retour visuel clair, pour lever toute ambiguïté sur ce qui se passe.
- La zone change d'aspect au survol pendant le glisser (« Relâchez pour déposer »)
- Un état de succès (contour vert) ou d'erreur (contour rouge) s'affiche selon le résultat
- Les messages (envoi en cours, ajout du lien, fichier manquant, navigateur non compatible…) s'adaptent à la langue de l'utilisateur
7. Configuration et adaptation
Le module dispose d'une page de configuration accessible depuis la liste des modules, avec trois interrupteurs simples (activé / désactivé). Tous sont activés par défaut.
- Masquer les boutons + natifs : cache les boutons + des blocs fichiers et liens pour mettre en avant le glisser-déposer (les formulaires natifs restent utilisés en arrière-plan) ; désactivez ce réglage pour laisser réapparaître les boutons habituels
- Valider automatiquement les liens déposés : un lien déposé est enregistré immédiatement ; désactivé, il est pré-rempli mais laissé à votre validation
- Valider automatiquement le sélecteur de fichiers de secours : lorsque vous passez par le clic et le sélecteur de fichiers, l'envoi part automatiquement après le choix du fichier
- La page de configuration rappelle qu'aucune modification du cœur de Dolibarr n'est effectuée
8. Liaisons avec Dolibarr
Le module ne fonctionne pas en vase clos : il s'articule avec les briques natives de Dolibarr.
- Documents et fichiers joints : Le module se greffe sur le bloc natif « Fichiers et documents joints » présent sur les fiches Dolibarr. Le dépôt d'un fichier utilise le formulaire d'envoi natif, si bien que la pièce est stockée et listée exactement comme avec le bouton + habituel.
- Liens / documents liés : Il s'appuie de la même façon sur le bloc natif « Fichiers et documents liés » pour rattacher une adresse web à la fiche, via le formulaire de liens standard de Dolibarr.
- Fiches natives (tiers, factures, devis, commandes, produits, projets…) : Comme il cible les blocs de documents génériques de Dolibarr, il fonctionne automatiquement sur toutes les fiches qui possèdent ces blocs : tiers, factures, devis, commandes, produits, projets et autres objets équipés de l'onglet Documents.
- Sécurité, droits et limites Dolibarr : Rien ne contourne Dolibarr : le module réutilise le jeton de sécurité (CSRF), l'identifiant et le type de l'objet, les droits de l'utilisateur et la taille maximale d'envoi définis nativement. Il ne crée ni droit, ni table, ni point d'entrée spécifique.
