Installare un modulo PrestaShop sembra semplice in teoria. In pratica, tra i moduli scaricati dall’addon store, quelli acquistati su marketplace di terze parti, quelli sviluppati internamente e i vincoli specifici del multi-negozio, si incontrano rapidamente casi particolari. Questa guida copre i tre metodi di installazione validi nel 2026, gli errori più frequenti e le buone pratiche per non rompere un negozio in produzione.
Prima di iniziare: salvare il tuo negozio
Questo passaggio non è negoziabile. Prima di qualsiasi aggiunta di modulo su un negozio in produzione, devi disporre di un backup recente del database e dei file. Se utilizzi un hosting serio (o2switch, OVH, Cloudways), un backup giornaliero automatico esiste già — verifica che sia recente e che sia ripristinabile.
L’ideale resta testare su un ambiente di pre-produzione identico alla produzione, per poi replicare l’installazione. Se non hai uno staging, un export rapido tramite lo strumento PrestaShop di esportazione del database è meglio di niente.
Metodo 1: installazione tramite back-office
È il metodo più comune e sicuro. Funziona per tutti i moduli forniti come file ZIP — che provengano dall’addon store ufficiale, da un marketplace di terze parti o da uno sviluppatore indipendente.
- Accedi al back-office PrestaShop
- Vai su Moduli → Gestore dei moduli
- Clicca su Installa un modulo (in alto a destra)
- Trascina il tuo file ZIP nella zona di drop, o clicca per selezionarlo
- Attendi il messaggio di conferma
- Clicca su Configura per accedere ai parametri del modulo
Se l’upload fallisce con un messaggio di errore di dimensione, le tue direttive PHP sono troppo restrittive. Bisogna aumentare upload_max_filesize, post_max_size e memory_limit nel tuo php.ini o tramite un file .htaccess alla radice di PrestaShop. Valori ragionevoli: 64M per i primi due, 256M per la memoria.
Caso particolare: modulo bloccato da PrestaShop Marketplace
Se hai acquistato il tuo modulo su addons.prestashop.com, lo ZIP è talvolta protetto da una firma che richiede una connessione al tuo account PrestaShop. In questo caso, l’installazione passa obbligatoriamente da Moduli → Selezione e dal pulsante di installazione associato al tuo acquisto. È volontario — PrestaShop impedisce così la ridistribuzione non autorizzata.
Metodo 2: installazione tramite FTP
Questo metodo è utile in due casi: il tuo file ZIP è troppo grande per i limiti PHP del tuo hosting, oppure stai installando più moduli contemporaneamente e vuoi andare più veloce.
- Decomprimi lo ZIP del modulo sul tuo computer
- Devi ottenere una cartella che porta il nome del modulo (per esempio
miomodulo/) - Carica questa cartella in
/modules/alla radice del tuo PrestaShop tramite FTP o SFTP - Torna su Moduli → Gestore dei moduli
- Cerca il modulo nella lista e clicca su Installa
Attenzione: non decomprimere uno ZIP che contiene già /modules/miomodulo/ nella radice del tuo PrestaShop — rischi di sovrascrivere file esistenti. Verifica sempre l’albero del file ZIP prima dell’estrazione.
Alternativa: Explorer FTP direttamente nel back-office
Se utilizzi Explorer FTP, puoi caricare i file dei tuoi moduli direttamente dal back-office, senza client FTP esterno. Pratico quando lavori in mobilità o quando non hai accesso a FileZilla.
Metodo 3: installazione tramite Composer (PrestaShop 9)
Questo metodo riguarda esclusivamente i moduli moderni sviluppati secondo gli standard Symfony — per ora, principalmente i moduli ufficiali e alcuni moduli per sviluppatori. Composer scarica automaticamente il modulo e le sue dipendenze PHP.
cd /percorso/verso/prestashop
composer require prestashop/module-namePoi lo attivi tramite il back-office come un modulo classico. La documentazione ufficiale PrestaShop elenca i moduli compatibili Composer. Per i moduli di terze parti (marketplace, sviluppatori indipendenti), il metodo 1 resta la norma.
Configurare un modulo dopo l’installazione
Una volta installato, un modulo resta disattivato finché non lo hai configurato. Clicca su Configura accanto al nome del modulo per accedere ai suoi parametri.
I moduli seri forniscono una pagina di configurazione chiara con i parametri essenziali. I moduli amatoriali ti lasciano da solo davanti a un file config.xml da modificare — è un segnale d’allarme.
Molti moduli richiedono inoltre l’attivazione di uno o più hook. Un hook è un punto nella pagina dove il modulo inietta il suo contenuto. Per esempio, un modulo slider deve agganciarsi all’hook displayHome per apparire sulla homepage. Verifica in Moduli → Posizioni che gli hook attesi siano attivati.
Testare in ambiente di staging
Su un negozio ad alto traffico, mai installazione diretta in produzione. La sequenza da rispettare:
- Duplicare il negozio in pre-produzione (stesse versioni PrestaShop, PHP, MySQL)
- Installare il modulo sullo staging
- Testare per 24-48 ore i percorsi critici: aggiunta al carrello, checkout completo, pagamento, multi-negozio se applicabile
- Verificare i log (Symfony, Apache, PHP) — un modulo può funzionare in superficie ma generare errori silenziosi in background
- Se tutto è verde, replicare l’installazione in produzione fuori dagli orari di punta
Gli errori più frequenti e le loro soluzioni
«Il modulo non appare nella lista»
Tre cause possibili: lo ZIP è stato decompresso nella cartella sbagliata (verifica che sia in /modules/nomemodulo/), i permessi dei file sono errati (i file PHP devono essere in 644 e le cartelle in 755), oppure la cache del back-office è obsoleta. Per svuotare la cache, vai su Parametri avanzati → Performance e clicca su Svuota la cache.
«Errore 500 dopo l’attivazione»
Il modulo è probabilmente incompatibile con la tua versione di PrestaShop o di PHP. Disattivalo eliminando la cartella del modulo tramite FTP, poi verifica le versioni sulla sua scheda prodotto. La compatibilità PrestaShop 1.7 vs 8 è la causa numero uno di incompatibilità.
«Il modulo funziona ma non si visualizza»
Hook non attivato. Vai in Moduli → Posizioni, trova il tuo modulo nella lista e verifica gli hook agganciati. Se non c’è nulla di selezionato, agganciatelo agli hook raccomandati dalla sua documentazione.
«Conflitto con un altro modulo»
Sintomo tipico: un modulo funziona da solo, ma si rompe quando attivi un secondo. La risoluzione passa dai log Symfony (in var/logs/) e dalla disattivazione alternata per identificare il colpevole. I conflitti più frequenti coinvolgono moduli che modificano gli stessi hook o gli stessi template.
Buone pratiche dopo l’installazione
Una volta installato e configurato il tuo modulo, due riflessi:
- Documentare — conserva un file che elenca i moduli installati, le loro versioni, le loro licenze. In caso di migrazione o di supporto, guadagni ore.
- Aggiornare regolarmente — la maggior parte delle falle di sicurezza PrestaShop documentate proviene da moduli di terze parti obsoleti. Attiva le notifiche di aggiornamento in Moduli → Notifiche.
E dopo?
Per andare oltre, esplora il nostro catalogo di moduli PrestaShop 8 per categoria: SEO, checkout, marketing e altro. Ogni modulo DataFirefly è fornito con una documentazione di installazione dettagliata e un supporto tecnico.