Documentazione KSIDol > Moduli KSIDol > Trascina e rilascia documenti
Guida del modulo: Trascina e rilascia documenti
Guida d'uso non tecnica: a cosa serve il modulo, come utilizzarlo e come si integra con Dolibarr.
CompatibilitàDolibarr da 18 a 24
Opzioni di configurazione3 impostazioni on/off
Impatto sul databaseNessuna tabella creata
AmbitoTutte le schede con la scheda Documenti
1. Panoramica del modulo
Il modulo «Trascina e rilascia documenti» aggiunge la comodità del trascinamento alle schede di Dolibarr. Invece di fare clic sul pulsante +, aprire una finestra, sfogliare il disco e poi confermare, afferri un file (o un link) e lo rilasci direttamente su un'area dedicata che compare sotto il titolo del blocco «File e documenti allegati» o «File e documenti collegati». Il documento viene così allegato alla scheda con una sola azione.
Il modulo non sostituisce nulla: si limita ad aggiungere uno strato visivo sopra i blocchi di documenti esistenti di Dolibarr. Il caricamento riutilizza in modo identico il form nativo di Dolibarr e tutti i suoi controlli (token di sicurezza, identificativo e tipo dell'oggetto, permessi dell'utente, dimensione massima di invio, verifiche). Nessun file del core di Dolibarr viene modificato e nulla viene memorizzato altrove rispetto a dove Dolibarr conserva abitualmente i tuoi allegati.
- Si installa come modulo esterno e si attiva dall'elenco dei moduli di Dolibarr
- Funziona ovunque una scheda disponga della scheda / del blocco «Documenti» (terzi, fatture, preventivi, ordini, prodotti, progetti, ecc.)
- Non crea alcuna tabella, alcun menu né alcuna operazione pianificata: è un semplice miglioramento dell'interfaccia
- Passa attraverso i form di invio nativi di Dolibarr: stessi permessi, stessi limiti, stessi controlli di sicurezza
- Interfaccia disponibile in francese, inglese, italiano, tedesco e spagnolo, a seconda della lingua dell'utente
2. Rilasciare file con il trascinamento
Su ogni scheda dotata del blocco «File e documenti allegati», viene aggiunta un'area di rilascio sotto il titolo del blocco, con l'invito «Trascina e rilascia qui i tuoi file».
- Trascina un file dal tuo computer e rilascialo sull'area: viene allegato automaticamente alla scheda
- È supportato il rilascio di più file contemporaneamente (un messaggio indica «Invio di X file in corso…»)
- L'invio passa attraverso il form di invio nativo di Dolibarr: il file viene salvato esattamente dove lo avrebbe salvato il pulsante +
- Durante l'invio viene visualizzato un messaggio di avanzamento; se nel rilascio non viene rilevato alcun file, un messaggio di errore lo segnala
3. Rilasciare un link (URL) con il trascinamento
Sulle schede dotate del blocco «File e documenti collegati», compare una seconda area di rilascio con l'invito «Trascina e rilascia qui un link», per collegare un indirizzo web anziché un file.
- Trascina un link (dalla barra degli indirizzi, un preferito, un'e-mail o una pagina web) e rilascialo sull'area
- Il modulo riconosce gli indirizzi che iniziano con http, https, ftp o mailto; un indirizzo non valido viene segnalato con un messaggio
- Un'etichetta viene ripresa automaticamente quando il link trascinato ne contiene una (il testo del link della pagina di origine)
- Il link viene salvato tramite il form dei link nativo di Dolibarr; se viene rilasciato senza un URL utilizzabile, compare il messaggio «Nessun URL rilevato»
4. Fare clic invece di rilasciare (soluzione di ripiego)
Se preferisci fare clic, o se il trascinamento non è pratico (tablet, gesto mancato), le aree di rilascio sono anche cliccabili.
- Un clic sull'area dei file apre il consueto selettore di file per scegliere un documento sul tuo dispositivo
- Un clic sull'area dei link fa comparire il campo nativo e vi posiziona il cursore per digitare l'indirizzo a mano
- Se il tuo browser non consente il rilascio diretto, il modulo mostra automaticamente il form classico di Dolibarr per completare l'operazione senza blocchi
5. Accessibilità da tastiera
Le aree di rilascio sono utilizzabili senza mouse, per le persone che navigano con la tastiera.
- Le aree sono raggiungibili con il tasto Tabulazione
- I tasti Invio e Spazio attivano l'area: apertura del selettore di file o passaggio al campo del link
6. Riscontri visivi e messaggi guidati
Il modulo accompagna ogni gesto con un riscontro visivo chiaro, per eliminare ogni ambiguità su ciò che sta accadendo.
- L'area cambia aspetto al passaggio del mouse durante il trascinamento («Rilascia per depositare»)
- Viene mostrato uno stato di successo (contorno verde) o di errore (contorno rosso) a seconda del risultato
- I messaggi (invio in corso, aggiunta del link, file mancante, browser non compatibile…) si adattano alla lingua dell'utente
7. Configurazione e adattamento
Il modulo dispone di una pagina di configurazione accessibile dall'elenco dei moduli, con tre semplici interruttori (attivato / disattivato). Tutti sono attivati per impostazione predefinita.
- Nascondere i pulsanti + nativi: nasconde i pulsanti + dei blocchi file e link per mettere in risalto il trascinamento (i form nativi restano utilizzati in background); disattiva questa impostazione per far riapparire i pulsanti consueti
- Confermare automaticamente i link rilasciati: un link rilasciato viene salvato immediatamente; se disattivato, viene precompilato ma lasciato alla tua conferma
- Confermare automaticamente il selettore di file di ripiego: quando passi dal clic e dal selettore di file, l'invio parte automaticamente dopo la scelta del file
- La pagina di configurazione ricorda che non viene effettuata alcuna modifica al core di Dolibarr
8. Collegamenti con Dolibarr
Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.
- Documenti e file allegati : Il modulo si innesta sul blocco nativo «File e documenti allegati» presente sulle schede di Dolibarr. Il rilascio di un file utilizza il form di invio nativo, così che il file viene memorizzato ed elencato esattamente come con il consueto pulsante +.
- Link / documenti collegati : Si appoggia allo stesso modo sul blocco nativo «File e documenti collegati» per collegare un indirizzo web alla scheda, tramite il form dei link standard di Dolibarr.
- Schede native (terzi, fatture, preventivi, ordini, prodotti, progetti…) : Poiché punta ai blocchi di documenti generici di Dolibarr, funziona automaticamente su tutte le schede che possiedono questi blocchi: terzi, fatture, preventivi, ordini, prodotti, progetti e altri oggetti dotati della scheda Documenti.
- Sicurezza, permessi e limiti di Dolibarr : Nulla aggira Dolibarr: il modulo riutilizza il token di sicurezza (CSRF), l'identificativo e il tipo dell'oggetto, i permessi dell'utente e la dimensione massima di invio definiti in modo nativo. Non crea alcun permesso, alcuna tabella né alcun punto di ingresso specifico.
