Documentacion KSIDol > Modulos KSIDol > Arrastrar y soltar documentos
Guia del modulo: Arrastrar y soltar documentos
Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se integra con Dolibarr.
CompatibilidadDolibarr 18 a 24
Opciones de configuración3 ajustes activado/desactivado
Impacto en la base de datosNinguna tabla creada
AlcanceTodas las fichas con pestaña Documentos
1. Descripcion del modulo
El módulo «Arrastrar y soltar documentos» añade la comodidad de arrastrar y soltar a las fichas de Dolibarr. En lugar de hacer clic en el botón +, abrir una ventana, examinar su disco y luego validar, agarra un archivo (o un enlace) y lo suelta directamente sobre una zona específica que aparece bajo el título del bloque «Archivos y documentos adjuntos» o «Archivos y documentos vinculados». El documento queda entonces adjuntado a la ficha en una sola acción.
El módulo no sustituye nada: simplemente añade una capa visual sobre los bloques de documentos existentes de Dolibarr. La subida reutiliza tal cual el formulario nativo de Dolibarr y todos sus controles (token de seguridad, identificador y tipo del objeto, permisos del usuario, tamaño máximo de envío, verificaciones). No se modifica ningún archivo del núcleo de Dolibarr, y nada se almacena en un lugar distinto de donde Dolibarr guarda habitualmente sus archivos adjuntos.
- Se instala como módulo externo y se activa desde la lista de módulos de Dolibarr
- Funciona en todas partes donde una ficha dispone de la pestaña / el bloque «Documentos» (terceros, facturas, presupuestos, pedidos, productos, proyectos, etc.)
- No crea ninguna tabla, ningún menú ni ninguna tarea programada: es una simple mejora de la interfaz
- Pasa por los formularios de envío nativos de Dolibarr: mismos permisos, mismos límites, mismos controles de seguridad
- Interfaz disponible en francés, inglés, italiano, alemán y español, según el idioma del usuario
2. Soltar archivos con arrastrar y soltar
En cada ficha que dispone del bloque «Archivos y documentos adjuntos», se añade una zona de depósito bajo el título del bloque, con la indicación «Arrastre y suelte sus archivos aquí».
- Arrastre un archivo desde su ordenador y suéltelo sobre la zona: se adjunta automáticamente a la ficha
- Se admite soltar varios archivos a la vez (un mensaje indica «Enviando X archivos…»)
- El envío pasa por el formulario de envío nativo de Dolibarr: el archivo se guarda exactamente donde lo habría guardado el botón +
- Durante el envío se muestra un mensaje de progreso; si no se detecta ningún archivo en el depósito, un mensaje de error lo señala
3. Soltar un enlace (URL) con arrastrar y soltar
En las fichas que disponen del bloque «Archivos y documentos vinculados», aparece una segunda zona de depósito con la indicación «Arrastre y suelte un enlace aquí», para vincular una dirección web en lugar de un archivo.
- Arrastre un enlace (desde la barra de direcciones, un marcador, un correo electrónico o una página web) y suéltelo sobre la zona
- El módulo reconoce las direcciones que empiezan por http, https, ftp o mailto; una dirección no válida se señala con un mensaje
- Se recupera automáticamente una etiqueta cuando el enlace arrastrado incluye una (el texto del enlace de la página de origen)
- El enlace se guarda mediante el formulario de enlaces nativo de Dolibarr; si se suelta sin una URL utilizable, se muestra el mensaje «No se ha detectado ninguna URL»
4. Hacer clic en lugar de soltar (solución alternativa)
Si prefiere hacer clic, o si arrastrar y soltar no resulta práctico (tableta, gesto fallido), las zonas de depósito también son cliqueables.
- Un clic en la zona de archivos abre el selector de archivos habitual para elegir un documento en su dispositivo
- Un clic en la zona de enlaces hace aparecer el campo nativo y coloca el cursor dentro para escribir la dirección a mano
- Si su navegador no permite el depósito directo, el módulo muestra automáticamente el formulario clásico de Dolibarr para terminar la operación sin bloqueos
5. Accesibilidad con el teclado
Las zonas de depósito se pueden utilizar sin ratón, para las personas que navegan con el teclado.
- Las zonas son accesibles con la tecla Tabulador
- Las teclas Intro y Espacio activan la zona: apertura del selector de archivos o paso al campo de enlace
6. Retornos visuales y mensajes guiados
El módulo acompaña cada gesto con un retorno visual claro, para eliminar cualquier ambigüedad sobre lo que está ocurriendo.
- La zona cambia de aspecto al pasar por encima durante el arrastre («Suelte para depositar»)
- Se muestra un estado de éxito (contorno verde) o de error (contorno rojo) según el resultado
- Los mensajes (envío en curso, adición del enlace, archivo ausente, navegador no compatible…) se adaptan al idioma del usuario
7. Configuración y adaptación
El módulo dispone de una página de configuración accesible desde la lista de módulos, con tres interruptores sencillos (activado / desactivado). Todos están activados de forma predeterminada.
- Ocultar los botones + nativos: oculta los botones + de los bloques de archivos y enlaces para destacar el arrastrar y soltar (los formularios nativos se siguen utilizando en segundo plano); desactive este ajuste para que reaparezcan los botones habituales
- Validar automáticamente los enlaces soltados: un enlace soltado se guarda de inmediato; desactivado, se rellena previamente pero se deja a su validación
- Validar automáticamente el selector de archivos de reserva: cuando pasa por el clic y el selector de archivos, el envío se inicia automáticamente tras elegir el archivo
- La página de configuración recuerda que no se realiza ninguna modificación del núcleo de Dolibarr
8. Vinculos con Dolibarr
El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.
- Documentos y archivos adjuntos : El módulo se acopla al bloque nativo «Archivos y documentos adjuntos» presente en las fichas de Dolibarr. El depósito de un archivo utiliza el formulario de envío nativo, de modo que el archivo se almacena y se lista exactamente igual que con el botón + habitual.
- Enlaces / documentos vinculados : Se apoya de la misma manera en el bloque nativo «Archivos y documentos vinculados» para vincular una dirección web a la ficha, mediante el formulario de enlaces estándar de Dolibarr.
- Fichas nativas (terceros, facturas, presupuestos, pedidos, productos, proyectos…) : Como apunta a los bloques de documentos genéricos de Dolibarr, funciona automáticamente en todas las fichas que poseen estos bloques: terceros, facturas, presupuestos, pedidos, productos, proyectos y otros objetos equipados con la pestaña Documentos.
- Seguridad, permisos y límites de Dolibarr : Nada elude a Dolibarr: el módulo reutiliza el token de seguridad (CSRF), el identificador y el tipo del objeto, los permisos del usuario y el tamaño máximo de envío definidos de forma nativa. No crea ningún permiso, ninguna tabla ni ningún punto de entrada específico.
