- moduł został kompletnie przepisany pod PrestaShop 9.x
- dodano sporo nowych funkcji / opcji w module
- kasowanie procesem ajaxowym z pominięciem czasu exe kucji skryptów php
Funzionalità principali
Tre modi per creare l’elenco dei prodotti
- File CSV o TXT fino a 20 MB. Indichi il separatore (punto e virgola, virgola, tabulazione, barra verticale) e il numero della colonna con l’identificatore, contato da zero. Il separatore viene rilevato al caricamento e il modulo mostra la prima riga del file con i numeri delle colonne, così non devi contarli a memoria. Le altre colonne vengono ignorate, quindi un report esportato da qualsiasi strumento è utilizzabile senza elaborazioni.
- Elenco incollato — un identificatore per riga oppure separati da virgole o punti e virgola. Non richiede file né permessi di scrittura.
- Selettore prodotti — elenco creato da condizioni applicate al catalogo, descritto di seguito.
Selettore prodotti: elenco senza file CSV
La scheda “Seleziona prodotti” crea lo stesso elenco a partire da condizioni, invece che da un’esportazione. Criteri disponibili:
- assenza di stock,
- nessuna vendita per il numero di mesi indicato,
- prodotto disattivato nel negozio selezionato,
- assenza di immagine,
- assenza di categorie diverse da quella predefinita,
- prezzo base esattamente pari a zero,
- marca, fornitore, categoria (facoltativamente insieme alle sottocategorie) e valore della caratteristica,
- modello dell’indice, dove l’asterisco sostituisce qualsiasi sequenza di caratteri e il punto interrogativo esattamente uno.
Le condizioni selezionate devono essere soddisfatte contemporaneamente — sono collegate da AND, non da OR. Il pulsante “Conta” mostra il numero di corrispondenze prima della creazione dell’esecuzione, la loro quota nel catalogo e la soglia di sicurezza in vigore. Il contatore proviene dalla stessa query che riempie la coda, quindi mostra ciò che l’esecuzione toccherà davvero — non una stima. La modifica di qualsiasi condizione cancella subito il risultato precedente, così sullo schermo non resta mai un numero non coerente con il modulo. Il risultato del selettore entra nella stessa coda dell’elenco da file, quindi eredita esecuzione di prova, backup, report, cronologia e soglia percentuale.
Due criteri temporali sono descritti esattamente come funzionano: lo schema di PrestaShop non registra quando un prodotto ha esaurito lo stock né quando è stato disattivato, quindi il numero di giorni viene misurato dall’ultima modifica della riga del prodotto. La condizione è: “ora non c’è stock e nessuno ha toccato il prodotto da X giorni”.
Come il modulo riconosce i prodotti
- indice (reference), EAN-13, UPC e identificatore del prodotto (id_product),
- MPN e ISBN nelle versioni di PrestaShop il cui catalogo contiene queste colonne — il modulo lo verifica da solo e non propone un campo che non esiste,
- prefisso da rimuovere dall’inizio di ogni identificatore, una sola volta (con il prefisso
ABla rigaAB123viene cercata come123), - elaborazione di ogni identificatore una sola volta, quando l’elenco contiene duplicati,
- criterio per un identificatore che corrisponde a più prodotti: lascia e segnala, elabora tutti oppure elabora il primo.
Cosa fa il modulo con i prodotti
- Disattiva prodotti — operazione reversibile, il prodotto resta nel catalogo e può essere riattivato.
- Elimina prodotti — rimozione dal catalogo, irreversibile.
- Elimina solo combinazioni — cancella le varianti, ma lascia i prodotti stessi.
Protezione contro gli errori
- Esecuzione di prova, attivata per impostazione predefinita: legge l’intero elenco, segnala quanti identificatori sono stati trovati e quanti no, e non salva nulla nel catalogo.
- Soglia percentuale del catalogo — un’esecuzione che comprende una percentuale di prodotti superiore a quella impostata (30% per impostazione predefinita) viene rifiutata. Zero disattiva questa protezione. La soglia può essere aggirata consapevolmente con una selezione una tantum del campo; non si applica mai all’esecuzione di prova.
- Backup CSV salvato prima della modifica, con quindici colonne: id_product, id_product_attribute, reference, ean13, upc, name, link_rewrite, price, quantity, active, id_manufacturer, id_supplier, id_category_default, categories e azione eseguita.
- Prodotti presenti negli ordini — a scelta: disattiva invece di eliminare, lascia e segnala, oppure elimina comunque.
- Permessi letti dalla scheda Catalogo → Prodotti: il diritto di modifica consente di disattivare, il diritto di eliminazione — di cancellare. Quando non è possibile determinare i permessi, il modulo rifiuta invece di presumere il consenso.
- Domanda di conferma indica esattamente ciò che accadrà: diversa per l’esecuzione di prova, diversa per la disattivazione, diversa per l’eliminazione da un solo negozio e diversa per l’eliminazione da tutti i negozi dell’installazione.
- Limite massimo di 200 000 elementi per una singola esecuzione. Una selezione più ampia viene rifiutata con richiesta di restringerla, non tagliata silenziosamente.
Esecuzione in background, senza limite di tempo di esecuzione
- L’elenco viene inserito in una coda nel database e l’esecuzione la fa avanzare a piccoli passi tramite AJAX. La durata del passo è impostabile da 2 a 30 secondi; il modulo mostra accanto il
max_execution_timedichiarato dal server e quanto tempo intende realmente dedicare a un singolo passo. - La finestra di avanzamento mostra la barra, il numero di righe elaborate, la velocità, il tempo trascorso e il tempo rimanente.
- L’esecuzione può essere messa in pausa, ripresa e arrestata. Ciò che è stato elaborato resta elaborato.
- La chiusura della scheda interrompe l’esecuzione, ma non distrugge nulla — al nuovo accesso il modulo propone di riprendere dal punto di arresto e non elabora due volte la stessa riga.
- Due schede del browser non eseguono la stessa esecuzione in parallelo: il compito viene preso in carico da una di esse e l’altra ne viene informata.
- Con JavaScript disattivato, la schermata mette a disposizione il pulsante “Elabora un passo”, che fa avanzare l’esecuzione manualmente.
Report e cronologia
- Report CSV con una riga per identificatore e colonne: line, identifier, result, id_product, id_product_attribute, message.
- La colonna del risultato assume uno dei valori:
ok,not-found,skipped,errorependingper le righe che un’esecuzione interrotta non ha raggiunto. - La colonna del messaggio contiene codici inglesi fissi — oltre venti situazioni distinte, da
deletededetachedfino aambiguous,in-orders: skippedorefused-by-core. I codici non cambiano con la lingua del pannello, quindi il filtro nel foglio di calcolo funziona indipendentemente dalle impostazioni del back office. Tutti sono spiegati nella scheda Aiuto. - La cronologia delle esecuzioni mostra numero, data, negozio, azione, stato, numero di righe, eseguite, non trovate, saltate ed errate, nonché durata.
- Dalla cronologia puoi scaricare il report, il backup e l’elenco sorgente di una determinata esecuzione, e rimuovere una voce non necessaria.
- Le esecuzioni avviate dal selettore riportano nella cronologia la descrizione delle condizioni selezionate, con i nomi di marca, fornitore, categoria e valore della caratteristica — non solo i numeri.
Impostazioni
- soglia percentuale del catalogo,
- criterio predefinito per i prodotti presenti negli ordini,
- criterio predefinito per un identificatore che corrisponde a più prodotti,
- selezione predefinita dell’interruttore del backup,
- durata del passo in secondi,
- periodo di conservazione delle esecuzioni e dei file in giorni (zero significa “per sempre”) e pulizia eseguita subito al salvataggio,
- informazione se la cartella dei file del modulo è scrivibile.
Multistore e lavoro di più persone
- Il negozio in cui vengono cercati i prodotti si seleziona nella schermata dell’esecuzione.
- Ambito stabilisce cosa accade a un prodotto appartenente a più negozi: “solo questo negozio” lo scollega dal negozio corrente e lo lascia negli altri, “ogni negozio” lo elimina dall’intera installazione.
- Un account con accesso solo a una parte dei negozi vede soltanto i propri negozi e non può avviare un’esecuzione con ambito dell’intera installazione.
- L’elenco dei negozi viene congelato insieme all’esecuzione, quindi i passi successivi non andranno oltre l’account che ha creato l’esecuzione.
- Gli elenchi di marche, fornitori, categorie e valori delle caratteristiche nel selettore sono limitati al negozio selezionato.
A chi è destinato questo modulo
- negozi che riordinano il catalogo dopo un’importazione, una migrazione o un cambio di fornitore,
- negozi con assortimento stagionale, in cui dopo la stagione scompaiono diverse migliaia di articoli,
- persone che oggi eliminano i prodotti manualmente nell’elenco del pannello oppure con una query SQL direttamente nel database,
- installazioni multistore, dove occorre rimuovere un prodotto da un negozio senza toccare gli altri,
- negozi in cui sul catalogo lavorano più persone con permessi diversi.
Requisiti tecnici
- PrestaShop da 1.6.0.0 a 9.x,
- PHP da 7.0 a 8.5,
- MySQL 5.6+ oppure MariaDB 10.x+,
- cartella
modules/pdproductdelete/files/con permessi di scrittura — il modulo lo verifica da solo e lo segnala a schermo, - nessuna dipendenza esterna: nessun Composer, nessuna libreria esterna a PrestaShop,
- il modulo non registra hook e non aggiunge nulla al front office — funziona esclusivamente nel pannello di amministrazione,
- interfaccia in lingua polacca e inglese.
Cosa il modulo non fa
Onestamente, per evitare sorprese:
- Il backup è un’istantanea, non un pulsante di ripristino. Contiene dati sufficienti per ricreare il record del prodotto e per costruire reindirizzamenti 301 dai vecchi indirizzi, ma il modulo non dispone della funzione “annulla”.
- L’eliminazione del prodotto è irreversibile. PrestaShop lo cancella insieme a immagini, combinazioni, stock, prezzi e collegamenti. La disattivazione del prodotto resta reversibile.
- Il modulo non misura da quando il prodotto è senza stock né da quando è disattivato — PrestaShop non registra tali date. Le condizioni temporali si basano sulla data dell’ultima modifica del prodotto e questo è indicato esplicitamente accanto a ciascuna di esse.
- Non esiste un’attività CRON né una pianificazione. L’esecuzione viene avviata da una persona dal pannello.
- I collegamenti dei prodotti con le categorie non sono assegnati al negozio in PrestaShop, quindi la condizione “assenza di categorie diverse da quella predefinita” viene necessariamente letta per l’intera installazione. Il modulo lo indica nella sezione Aiuto.