TrashBin

# TrashBin - Manuale Utente

## Cos'è TrashBin?

TrashBin è un **cestino** per Dolibarr, proprio come quello sul tuo computer. Quando elimini per errore un elemento (un cliente, un prodotto, una fattura...), invece di perderlo definitivamente, viene inserito nel cestino. Puoi quindi ripristinarlo facilmente.

---

## 📋 Accedere al Cestino

1. Nel menu principale di Dolibarr, clicca su **"TrashBin"** (icona cestino)
2. Accedi all'elenco di tutti gli elementi eliminati

---

## 👁️ Visualizzare l'Elenco degli Elementi Eliminati

L'elenco mostra:
- **Tipo**: Il tipo di elemento (Terza Parte, Prodotto, Fattura, ecc.)
- **Riferimento**: Il nome o numero dell'elemento
- **Data di Eliminazione**: Quando l'elemento è stato eliminato
- **Eliminato Da**: Chi ha eliminato l'elemento

### Cercare un Elemento

Utilizza il campo di ricerca nella parte superiore della pagina per trovare rapidamente un elemento tramite il suo riferimento o nome.

---

## ♻️ Ripristinare un Elemento

### Ripristinare un Singolo Elemento

1. Nell'elenco, clicca sul **riferimento** dell'elemento che desideri ripristinare
2. Nella pagina dei dettagli, clicca sul pulsante **"Ripristina"**
3. Viene visualizzata una conferma: l'elemento è nuovamente disponibile in Dolibarr

> **💡 Suggerimento**: Gli elementi vengono ripristinati con tutte le loro informazioni (dettagli di contatto, prezzi, righe fattura, contatti associati, ecc.)

---

## 🗑️ Eliminare Definitivamente

Se sei sicuro di non aver più bisogno di un elemento, puoi eliminarlo definitivamente dal cestino.

### Eliminare un Elemento Definitivamente

1. Clicca sul riferimento dell'elemento
2. Clicca sul pulsante **"Elimina Definitivamente"**
3. ⚠️ **Attenzione**: Questa azione è irreversibile! L'elemento sarà perso per sempre.

### Svuotare l'Intero Cestino

1. Nella parte superiore dell'elenco, clicca su **"Svuota Cestino"**
2. Conferma l'azione
3. ⚠️ **Attenzione**: Tutti gli elementi nel cestino saranno eliminati definitivamente!

### Svuotare una Selezione

1. Seleziona le caselle degli elementi da eliminare definitivamente
2. Clicca su **"Svuota Selezione"**
3. Conferma: gli elementi selezionati saranno eliminati definitivamente

---

## 🔍 Visualizzare i Dettagli di un Elemento

Clicca sul riferimento di un elemento per visualizzare le sue informazioni dettagliate.

### Pulsante "Visualizza JSON"

Questo pulsante mostra tutte le informazioni tecniche dell'elemento in formato dati. È utile per:
- Verificare che un elemento contenga tutte le informazioni prima di ripristinarlo
- Condividere i dettagli con il supporto tecnico in caso di problemi

Clicca su **"Nascondi JSON"** per chiudere queste informazioni.

---

## ⚙️ Configurazione (per Amministratori)

### Accedere alla Configurazione

1. Vai su **Home → Configurazione → Moduli/Applicazioni**
2. Trova il modulo **TrashBin** nell'elenco
3. Clicca sull'icona **ingranaggio** (⚙️) sul lato destro del modulo

### Svuotamento Automatico

Puoi configurare uno **svuotamento automatico** per pulire automaticamente il cestino.

- **Periodo di Conservazione Automatica (giorni)**: Numero di giorni in cui gli elementi vengono conservati nel cestino
  - Esempio: Se imposti **30**, gli elementi eliminati da più di 30 giorni saranno automaticamente rimossi dal cestino
  - Imposta **0** per disabilitare lo svuotamento automatico (gli elementi rimangono indefinitamente)

**Raccomandazione**: 
- Per piccole organizzazioni: **90 giorni** (3 mesi)
- Per grandi organizzazioni: **30 giorni** (1 mese)

Lo svuotamento viene attivato automaticamente ogni volta che qualcuno apre la pagina del cestino.

---

## ❓ Domande Frequenti

### Tutti i miei elementi eliminati vanno nel cestino?

Sì, TrashBin cattura automaticamente l'eliminazione di tutti i tipi di elementi:
- Terze parti (clienti/fornitori)
- Contatti
- Prodotti e servizi
- Fatture
- Preventivi
- Ordini
- Progetti
- Interventi
- Ecc.

### Posso ripristinare un elemento eliminato diversi mesi fa?

Sì, purché l'elemento sia ancora nel cestino. Se è configurato uno svuotamento automatico, verifica il periodo di conservazione.

### I file allegati vengono conservati?

Le informazioni dell'elemento vengono conservate. I documenti collegati potrebbero richiedere un'attenzione particolare a seconda del contesto di eliminazione.

### Cosa succede se ripristino un cliente eliminato?

Il cliente viene ripristinato con:
- Tutti i dettagli di contatto
- Contatti associati
- Categorie
- Campi personalizzati
- Tutte le informazioni
- Documenti
- Immagini
- Extrafields

### Posso ripristinare una fattura con tutte le sue righe?

Sì, le fatture vengono ripristinate con tutte le loro righe, importi e dettagli.

---

## 🆘 Hai Bisogno di Aiuto?

Se hai eliminato per errore un elemento importante:

1. **Non farti prendere dal panico** 😊
2. Vai su **TrashBin**
3. Cerca l'elemento tramite il suo nome o riferimento
4. Cliccaci sopra per verificare che sia quello giusto
5. Clicca su **"Ripristina"**

Se non riesci a trovare l'elemento nel cestino, contatta il tuo amministratore di sistema: può verificare se lo svuotamento automatico era abilitato.

---

## 🔐 Permessi

Il tuo amministratore può definire chi può:
- **Leggere il cestino**: Visualizzare l'elenco degli elementi eliminati
- **Ripristinare oggetti**: Riportare elementi in Dolibarr
- **Svuotare oggetti**: Eliminare definitivamente dal cestino
- **Amministrare il cestino**: Accedere alla configurazione

Se non hai accesso a determinate funzioni, contatta il tuo amministratore.

---

**Modulo TrashBin - Versione 1.0.0**  
*Sviluppato da Goldoweb SL*  
*Supporto: goldoweb@gmail.com*