# Come installare un modulo PrestaShop 8: la guida completa 2026 > La guida completa per installare un modulo PrestaShop 8 nel 2026: tre metodi (back-office, FTP, Composer), errori frequenti, buone pratiche di messa in produzione. - Pagina: - Lingua: it - Pubblicato il: 2026-05-01 - Aggiornato il: 2026-10-10 - Altre lingue: [fr](https://www.datafirefly.com/2026/05/01/installer-module-prestashop-8-guide-complet/index.md), [en](https://www.datafirefly.com/en/2026/05/01/install-prestashop-8-module-complete-guide/index.md), [es](https://www.datafirefly.com/es/2026/05/01/instalar-modulo-prestashop-8-guia-completa/index.md), [de](https://www.datafirefly.com/de/2026/05/02/prestashop-8-modul-installieren-leitfaden-2026/index.md), [pl](https://www.datafirefly.com/pl/2026/05/01/jak-zainstalowac-modul-prestashop-8-kompletny-przewodnik/index.md), [nl](https://www.datafirefly.com/nl/2026/05/01/prestashop-8-module-installeren-complete-gids/index.md), [pt](https://www.datafirefly.com/pt/2026/05/01/instalar-modulo-prestashop-8-guia-completo/index.md) - Indice: 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. 1. Accedi al back-office PrestaShop 2. Vai su **Moduli → Gestore dei moduli** 3. Clicca su **Installa un modulo** (in alto a destra) 4. Trascina il tuo file ZIP nella zona di drop, o clicca per selezionarlo 5. Attendi il messaggio di conferma 6. 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. 1. Decomprimi lo ZIP del modulo sul tuo computer 2. Devi ottenere una cartella che porta il nome del modulo (per esempio `miomodulo/`) 3. Carica questa cartella in `/modules/` alla radice del tuo PrestaShop tramite FTP o SFTP 4. Torna su **Moduli → Gestore dei moduli** 5. 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](https://www.datafirefly.com/it/product/explorer-ftp-prestashop-8/), 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-name ``` Poi 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: 1. Duplicare il negozio in pre-produzione (stesse versioni PrestaShop, PHP, MySQL) 2. Installare il modulo sullo staging 3. Testare per 24-48 ore i percorsi critici: aggiunta al carrello, checkout completo, pagamento, multi-negozio se applicabile 4. Verificare i log (Symfony, Apache, PHP) — un modulo può funzionare in superficie ma generare errori silenziosi in background 5. 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: 1. **Documentare** — conserva un file che elenca i moduli installati, le loro versioni, le loro licenze. In caso di migrazione o di supporto, guadagni ore. 2. **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](https://www.datafirefly.com/it/categorie-produit/moduli-prestashop/) per categoria: [SEO](https://www.datafirefly.com/it/categorie-produit/moduli-prestashop/seo-indicizzazione/), [checkout](https://www.datafirefly.com/it/categorie-produit/moduli-prestashop/checkout-pagamento/), [marketing](https://www.datafirefly.com/it/categorie-produit/moduli-prestashop/marketing-promozioni/) e altro. Ogni modulo DataFirefly è fornito con una documentazione di installazione dettagliata e un supporto tecnico. Una volta installato il modulo: [tutte le nostre selezioni di moduli PrestaShop per obiettivo](https://www.datafirefly.com/it/solutions/prestashop/).