# Cestino Prodotti — Guida completa

> Panoramica Il modulo Cestino Prodotti trasforma ogni eliminazione di prodotto in un backup reversibile. Subito prima che un prodotto venga cancellato — manualmente, in un'azione di massa, da un'importazione o…

- Pagina: <https://www.datafirefly.com/it/documentation/dfproducttrash/>
- Lingua: it
- Aggiornato il: 2026-06-27
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfproducttrash/index.md), [en](https://www.datafirefly.com/en/documentation/dfproducttrash/index.md), [es](https://www.datafirefly.com/es/documentation/dfproducttrash/index.md), [de](https://www.datafirefly.com/de/documentation/dfproducttrash/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfproducttrash/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfproducttrash/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproducttrash/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Panoramica

Il modulo Cestino Prodotti trasforma ogni eliminazione di prodotto in un backup reversibile. Subito prima che un prodotto venga cancellato — manualmente, in un'azione di massa, da un'importazione o da uno script — il modulo ne esegue uno snapshot completo e lo colloca in un cestino. Puoi poi ripristinare il prodotto identico con un clic, con il suo ID originale, il che preserva i suoi URL e il suo SEO.

La cattura copre i dati del database (scheda, traduzioni, combinazioni, prezzi, giacenze, categorie, caratteristiche, ecc.) oltre ai file immagine sul disco. Il modulo è compatibile con PrestaShop 8 e 9, in mono e multi-negozio, e multilingua.

## Installazione

1. Dal back office, apri **Moduli > Gestore dei moduli**.
2. Clicca su **Carica un modulo** e rilascia l'archivio ZIP del modulo.
3. A installazione completata, clicca su **Configura**.

All'installazione, il modulo crea una tabella di backup dedicata, una cartella di backup protetta per le immagini e una nuova scheda **Cestino prodotti** nel menu **Catalogo**. Il monitoraggio delle eliminazioni è attivo immediatamente, senza configurazione preliminare.

## Accedere al cestino

Il cestino è accessibile in due modi: tramite il menu **Catalogo > Cestino prodotti**, o tramite il pulsante **Apri il cestino** presente nella pagina di configurazione del modulo. L'elenco mostra i prodotti salvati e non ancora ripristinati, con il loro ID prodotto originale, il nome, il riferimento, il numero di immagini salvate, chi ha eliminato e quando.

## Come funziona il backup

Il modulo si aggancia all'hook `actionObjectProductDeleteBefore`, attivato da PrestaShop subito prima di cancellare un prodotto, nel momento in cui tutti i suoi dati sono ancora presenti nel database. Questo hook è utilizzato sia dalla pagina prodotto classica sia dalla nuova pagina Symfony di PrestaShop 8 e 9, oltre che dalle eliminazioni di massa: ogni prodotto eliminato viene quindi salvato individualmente.

Lo snapshot catturato comprende:

- la scheda prodotto, le sue versioni per negozio e le sue traduzioni per tutte le lingue;
- le combinazioni, i loro attributi e le loro versioni per negozio;
- i prezzi specifici, le giacenze e le associazioni di categoria;
- le caratteristiche, i tag, i fornitori e i corrieri;
- gli allegati, i prodotti correlati, i pacchetti e i prodotti virtuali scaricabili;
- i campi di personalizzazione e le loro traduzioni;
- i file immagine, in tutte le dimensioni generate, copiati in una cartella di backup protetta.

La cattura è silenziosa e non blocca mai l'eliminazione. Se un passaggio del backup fallisce per qualsiasi motivo, PrestaShop prosegue l'eliminazione normalmente: il modulo non perturba il funzionamento del negozio.

## Ripristinare un prodotto

1. Apri **Catalogo > Cestino prodotti**.
2. Individua il prodotto da ripristinare nell'elenco (puoi filtrare e ordinare le colonne).
3. Clicca sul pulsante verde **Ripristina** e conferma.

Il modulo reinserisce allora tutte le tabelle collegate in un'unica transazione, mantenendo gli ID originali, ricopia i file immagine nella loro posizione esatta e poi riesegue l'indicizzazione della ricerca. Il prodotto riappare nel tuo catalogo proprio com'era prima dell'eliminazione, e la sua voce scompare dal cestino. L'HTML delle descrizioni è preservato carattere per carattere.

**Anti-conflitto.** Il ripristino verifica prima che l'ID del prodotto sia libero. Se un altro prodotto usa già quell'ID, il ripristino viene annullato e un messaggio te lo segnala, per non sovrascrivere mai una scheda esistente. In pratica, PrestaShop non riutilizza gli ID eliminati, quindi questo caso è raro.

## Eliminazione definitiva e svuotamento del cestino

Per liberare spazio, puoi eliminare definitivamente un singolo backup con il pulsante rosso della colonna **Azioni**. Questa azione elimina lo snapshot e i file immagine associati; è irreversibile.

Il pulsante **Svuota cestino**, in cima all'elenco, elimina definitivamente tutti i backup non ripristinati in un'unica operazione.

## Configurazione

### Salvare i file immagine

Quando questa opzione è attivata (predefinito), il modulo copia i file immagine in tutte le dimensioni all'eliminazione e li rimette al loro posto al ripristino. Disattivala se desideri salvare solo i dati e risparmiare spazio su disco; in tal caso, le righe immagine restano nello snapshot ma i file non vengono ripristinati.

### Conservazione (giorni)

Definisci il numero di giorni oltre il quale i backup vengono eliminati automaticamente. Il valore **0** conserva i backup senza limite di tempo. La pulizia viene eseguita man mano che si verificano nuove eliminazioni.

## Multi-negozio e multilingua

Lo snapshot cattura tutte le lingue e tutti i negozi associati al prodotto, e il ripristino li reimposta integralmente. Il modulo funziona sia su un singolo negozio sia su un multi-negozio PrestaShop.

## Buone pratiche e casi particolari

- **Cataloghi grandi:** ogni eliminazione crea un backup. Definisci una conservazione adeguata per evitare un accumulo inutile se elimini frequentemente molti prodotti (importazioni di sostituzione, per esempio).
- **Cartella di backup:** è protetta da un `.htaccess` e un `index.php`, quindi non è accessibile pubblicamente. Deve restare accessibile in scrittura dal server.
- **Importazioni:** un'importazione che elimina e poi ricrea prodotti riempie il cestino con le versioni eliminate. È intenzionale e utile in caso di importazione fallita; ricordati di svuotare il cestino una volta convalidata l'importazione.

## Disinstallazione

La disinstallazione del modulo elimina la tabella di backup, la scheda del menu e l'intera cartella di backup (snapshot e file immagine). I prodotti già ripristinati e presenti nel catalogo non sono interessati.

## FAQ

### Il cestino funziona con l'eliminazione di massa e la nuova pagina prodotto?

Sì. La cattura si basa su un hook utilizzato dalla pagina prodotto classica, dalla nuova pagina Symfony di PrestaShop 8 e 9 e dalle eliminazioni di massa. Ogni prodotto eliminato viene salvato individualmente.

### Il ripristino mantiene lo stesso ID prodotto?

Sì. Il prodotto viene ripristinato con il suo ID originale, il che preserva i suoi URL, i suoi reindirizzamenti e il suo SEO. Se l'ID è già occupato, il ripristino viene bloccato.

### Le immagini vengono ripristinate, file compresi?

Sì, quando l'opzione di backup delle immagini è attivata. I file in tutte le dimensioni vengono copiati all'eliminazione e rimessi al loro posto al ripristino, poi la ricerca viene reindicizzata.

### Il modulo è compatibile con PrestaShop 9?

Sì, il modulo è compatibile con PrestaShop 8.x e 9.x, in mono e multi-negozio.
