Installare modulo PrestaShop da un file ZIP: passo per passo e cosa fare quando non va
Installare un modulo PrestaShop da un file ZIP richiede tre clic in Moduli → Gestione moduli: il pulsante di caricamento, la scelta del file e la configurazione. Un errore di solito dipende dal pacchetto, da un limite di dimensione dei file sul server o da una versione del modulo non adatta al negozio. Prima fai un backup e controlla da dove arriva il pacchetto.
Autore: Il team TellMyShop. Una guida per i titolari di negozi PrestaShop: la causa, la correzione a mano e lo stesso lavoro in una conversazione in chat.
Ultimo aggiornamento: · 6 min di lettura
Cosa controllare prima di installare un modulo
Un modulo è codice che gira sul tuo server e ha accesso al database del negozio. Cinque minuti di controlli prima dell'installazione costano meno delle riparazioni dopo.
- Origine. Scarica il modulo dal suo autore, da Addons o dalla release dell'autore su GitHub. Le copie gratuite di moduli a pagamento da siti a caso sono un modo comune con cui codice dannoso entra in un negozio.
- Compatibilità con la versione del tuo negozio. La descrizione del modulo indica le versioni di PrestaShop e di PHP con cui funziona. La versione del tuo negozio la vedi in Parametri avanzati → Informazioni.
- Se hai già un modulo che fa la stessa cosa. Due moduli di recensioni o due moduli di consegna sono una causa comune di conflitti.
- Backup. Un backup di file e database dal tuo hosting o da un modulo di backup. Senza, ogni errore costa caro.
- Momento. Installa quando il negozio è tranquillo. I moduli di pagamento e di consegna provali prima su una copia di prova.
Come installare un modulo da un file ZIP
Il pannello di PrestaShop 8 e 9 ha un modulo apposito in Gestione moduli. La guida di PrestaShop ai moduli descrive la schermata dei moduli in generale.
- Vai in Moduli → Gestione moduli.
- Clicca il pulsante per caricare un modulo in cima alla pagina.
- Trascina il file ZIP nel riquadro o sceglilo dal computer. Non decomprimerlo prima.
- Aspetta il messaggio di installazione. Con i moduli più grandi ci vogliono alcune decine di secondi.
- Clicca Configura e imposta il modulo seguendo le istruzioni dell'autore.
- Apri il negozio in una finestra privata. Controlla la home page, una pagina di prodotto e il carrello.
- Guarda in Parametri avanzati → Log se dopo l'installazione sono comparsi nuovi errori.
L'aggiornamento da uno ZIP funziona allo stesso modo: carichi una versione più recente dello stesso modulo. PrestaShop riconosce che il modulo c'è già, sostituisce i file ed esegue gli script di aggiornamento.
A cosa fare attenzione quando aggiorni un modulo
Un aggiornamento è più di uno scambio di file. Una nuova versione può cambiare le tabelle del database, aggiungere nuovi punti nella pagina o cambiare le impostazioni predefinite.
- Leggi l'elenco delle modifiche dell'autore. Cerca le frasi sulla versione di PHP richiesta, sulle nuove impostazioni e sulle modifiche ai template.
- Controlla se il tuo tema ha una copia del template del modulo. Se ce l'ha, la nuova versione del modulo può apparire diversa dalla descrizione dell'autore, o non mostrare affatto i nuovi elementi.
- Aggiorna i moduli di pagamento e di consegna fuori dagli orari di acquisto. Dopo l'aggiornamento fai un ordine di prova.
- Non saltare più versioni in un colpo senza backup. Gli script di aggiornamento spesso sono scritti pensando alla versione precedente.
Gli errori più comuni nell'installazione di un modulo
| Messaggio o sintomo | Causa | Cosa fare |
|---|---|---|
| il modulo non è valido, o il file non sembra uno zip di modulo valido | lo ZIP non ha una cartella del modulo con un file dello stesso nome | decomprimilo sul computer; dentro deve esserci una sola cartella, es. miomodulo/miomodulo.php |
| lo stesso errore con un pacchetto da Addons | lo ZIP scaricato contiene modulo, documentazione e licenza in un solo archivio | decomprimilo e carica solo lo ZIP interno del modulo |
| il caricamento finisce con un errore senza descrizione | il file è più grande del limite di caricamento del server | alza il limite con il tuo hosting o carica il modulo via FTP |
| il modulo non è compatibile con la versione del tuo negozio | l'autore ha impostato nel modulo un intervallo di versioni di PrestaShop | scarica la versione del modulo per il tuo PrestaShop |
| una pagina bianca o un errore 500 dopo l'installazione | il modulo richiede un'altra versione di PHP o va in conflitto con un altro modulo | disattiva il modulo, leggi il log degli errori |
| nessun permesso di scrittura | il server non permette di scrivere nella cartella modules | chiedi al tuo hosting di impostare i permessi corretti della cartella |
La documentazione di PrestaShop sulla struttura dei moduli descrive com'è costruito un pacchetto corretto: la cartella del modulo ha lo stesso nome del modulo, e il modulo nello ZIP deve stare in una sottocartella. Gli sviluppatori di PrestaShop hanno descritto il problema dei pacchetti troppo grandi nella specifica degli avvisi di Gestione moduli, insieme alle impostazioni di PHP che ne sono responsabili.
Se dopo l'installazione il negozio non si vede, parti dall'articolo sull'errore 500 di PrestaShop. Se il modulo funziona ma rompe qualcosa, disattivalo invece di disinstallarlo, come spieghiamo nell'articolo su come disattivare un modulo.
Come installare o aggiornare un modulo tramite la chat
Dai alla tua chat (Claude o ChatGPT) un link https diretto al file ZIP, per esempio a una release su GitHub o a un file dell'autore. La chat prima scarica il pacchetto per un'anteprima e lo controlla prima che arrivi qualcosa al negozio: nome e versione del modulo, origine, checksum SHA-256 e struttura del pacchetto. Così non puoi caricare un file dal tuo computer; serve un link.
Tu: Aggiorna il modulo di pagamento alla 2.4.1 da questo link alla release su GitHub. Controlla il negozio prima e dopo.
La tua chat: Anteprima del pacchetto: modulo di pagamento, versione installata 2.3.0, versione del pacchetto 2.4.1. Origine: la release dell'autore su GitHub. Struttura corretta, una sola cartella del modulo. Il checksum SHA-256 è nell'anteprima, così puoi confrontarlo con quello pubblicato dall'autore.
Prima dell'aggiornamento faccio un backup dei file del modulo. Le modifiche al database fatte dallo script di aggiornamento non posso annullarle dalla cronologia; per questo c'è il backup del database di oggi. In questo momento il log non ha errori di questo modulo. Aggiorno?
Tu: Sì.
La tua chat: Aggiornato alla 2.4.1. Il carrello e la pagina dell'ordine rispondono correttamente, e nel log non ci sono nuovi errori.
Stato della scheda: in attesa del tuo «sì»versione precedente: versione 2.3.0
nuova versione: versione 2.4.1
I numeri di versione dell'esempio sono illustrativi. Una richiesta di esempio è nel caso d'uso installare o aggiornare un modulo da un pacchetto ZIP, e se dopo la modifica qualcosa smette di funzionare, nel caso d'uso disattivare un modulo che rompe il carrello.
TellMyShop Pro installa e aggiorna moduli quando l'interruttore Moduli è acceso nel pannello del modulo. L'interruttore dura 24 ore e richiede un backup del database fatto lo stesso giorno. La chat non installa niente senza un'anteprima e il tuo consenso, e ti sconsiglierà un modulo di origine incerta. La disinstallazione di un modulo non si può annullare, quindi la chat propone prima la disattivazione. Nella versione gratuita TellMyShop Free vedi l'elenco dei moduli con le loro versioni e i punti in cui vengono mostrati. Un confronto delle versioni è nella pagina prezzi, e della pulizia dei vecchi moduli parliamo nell'articolo sui moduli inutilizzati.
Domande e risposte
Dove installo in PrestaShop un modulo da un file ZIP?
Nel menu Moduli, in Gestione moduli. In cima alla pagina c'è un pulsante per caricare un modulo, dove trascini il file ZIP o lo scegli dal computer. Dopo il caricamento PrestaShop installa il modulo e propone di configurarlo.
Cosa significa il messaggio che il modulo non è valido?
Il più delle volte PrestaShop non ha trovato nel pacchetto una cartella del modulo con un file dello stesso nome. Potresti aver scaricato un pacchetto con la documentazione invece del modulo, un archivio con più moduli dentro, o uno ZIP impacchettato dentro un altro ZIP. Decomprimi il pacchetto sul computer e controlla cosa c'è dentro.
Aggiornare un modulo da uno ZIP ne cancella le impostazioni?
Di solito no. Quando carichi una versione più recente dello stesso modulo, PrestaShop sostituisce i file ed esegue gli script di aggiornamento del modulo. Le impostazioni restano, ma gli script possono cambiare il database. Quindi fai un backup del negozio prima dell'aggiornamento, e meglio ancora provalo su una copia di prova.
L'installazione di un modulo si può annullare?
Puoi disattivare o disinstallare un nuovo modulo. La disinstallazione di solito cancella i suoi dati e le impostazioni, quindi non si può annullare. Con un aggiornamento i file si possono ripristinare da un backup, ma le modifiche al database fatte dallo script di aggiornamento non le annulli senza un backup del database.
TellMyShop Free può installare un modulo?
No. La versione gratuita TellMyShop Free legge soltanto i report del negozio, compreso l'elenco dei moduli con le loro versioni. TellMyShop Pro installa e aggiorna moduli da un pacchetto ZIP quando l'interruttore Moduli è acceso per 24 ore.
PrestaShop è un marchio registrato di PrestaShop SA. Claude è un marchio di Anthropic PBC. ChatGPT e OpenAI sono marchi di OpenAI. TellMyShop non è affiliato a queste aziende.