Il sistema di override di PrestaShop consente di personalizzare il comportamento del core senza toccare i file originali. Tuttavia, se utilizzato senza attenzione, crea negozi fragili che si bloccano durante gli aggiornamenti. Questa guida di Knowband spiega come funzionano gli override, quando utilizzarli e tre accorgimenti critici che ogni sviluppatore dovrebbe conoscere.
Che cos’è il sistema di override?
PrestaShop utilizza l’ereditarietà PHP per permetterti di sostituire la tua versione di qualsiasi classe core senza modificare gli originali. Ogni classe core ha un nome con il suffisso Core, ad esempio ProductCore. Se crei /override/classes/Product.php con una classe chiamata Product che estende ProductCore, PrestaShop caricherà la tua versione. Lo stesso vale per i controller.
Sovrascrivi solo i metodi specifici che devi modificare, senza mai copiare un intero file di classe. In questo modo, l’override sarà più snello e molto meno soggetto a conflitti con aggiornamenti futuri.
Esempio, esponendo il nome del controller corrente al modello di intestazione:
Dove posizionare i file di override
Gli override possono risiedere in due posizioni. La directory globale /override/ alla radice dell’installazione è attiva immediatamente dopo la cancellazione della cache. L’approccio migliore è raggruppare gli override all’interno di un modulo.
Inserire un override all’interno di un modulo (ad esempio /modules/mymodule/override/classes/Product.php) fa sì che PrestaShop lo copi in /override/ durante l’installazione e lo rimuova in modo pulito durante la disinstallazione. Questo è l’approccio consigliato.
Un rapido esempio di override di classe. Supponiamo di voler esporre il nome del controller corrente al modello di intestazione:
// /override/classes/controllers/FrontController.php classe FrontController estende FrontControllerCore { funzione pubblica initHeader() { self::$smarty->assign('currentController', get_class($this)); restituisci parent::initHeader(); }} Chiama sempre il metodo padre, a meno che tu non abbia una ragione specifica per non farlo. Saltarlo comprometterà silenziosamente le funzionalità principali.
Sovrascrittura di classi di moduli e controller
A partire da PrestaShop 1.6, è possibile sovrascrivere anche le classi dei moduli. Aggiungere “Override” al nome della classe (ad esempio, BlockUserInfoOverride che estende BlockUserInfo) e posizionarlo in /override/modules/. Lo stesso schema si applica ai controller dei moduli. Dopo ogni sovrascrittura, svuotare la cache, in particolare eliminare /cache/class_index.php, altrimenti non avrà effetto.
Quando NON utilizzare gli override
Gli override sono esclusivi: ne può esistere solo uno per classe. Sono inoltre vietati nei moduli del marketplace e dovrebbero essere riservati alle personalizzazioni degli store privati. Prima di ricorrere a un override, valuta una di queste alternative:
- ganci: PrestaShop attiva eventi hook a ogni caricamento di pagina: puoi sfruttarli da un modulo per eseguire codice personalizzato o caricare contenuti nella pagina senza avvicinarti a una classe principale.
- Override del servizio Symfony: Le parti di PrestaShop migrate a Symfony offrono un percorso più chiaro all’interno del contenitore dei servizi. È possibile decorare o sostituire un servizio anziché intervenire sulla classe stessa.
- Modello oggetto personalizzato: Devi aggiungere campi a un’entità principale? Crea il tuo ObjectModel con una tabella dedicata, invece di modificare quello esistente.
Mantenere gli override sicuri tramite aggiornamenti
Gli aggiornamenti di PrestaShop possono modificare silenziosamente le firme dei metodi, lasciando l’override in esecuzione su presupposti obsoleti. Tratta ogni override come qualcosa da rivedere dopo ogni aggiornamento. Commenta cosa hai modificato e perché, controlla il changelog e mantieni l’override il più breve possibile. Un override ristretto e ben commentato che chiama correttamente i metodi padre sopravvive agli aggiornamenti. Una copia completa della classe è un bug in attesa di emergere.
La cache “fantasma”: perché il tuo override sembra invisibile
Il motivo principale per cui gli sviluppatori pensano che il loro override sia errato: PrestaShop non analizza /override/ a ogni richiesta. Compila una mappa di classi in /cache/class_index.php e, finché quel file non viene eliminato e rigenerato, l’override è invisibile, indipendentemente da quanto sia corretto il codice. Svuotare la cache di Smarty non è sufficiente. Eliminate class_index.php manualmente tramite FTP/SSH, tramite Parametri Avanzati > Prestazioni nel back office o tramite la console di Symfony.
Figura 1: Flusso del sistema di override di PrestaShop e ruolo di /cache/class_index.php.
Il muro di Symfony: gli override legacy non funzionano per i controller moderni
Questo sistema PHP legacy funziona solo sul vecchio layer ObjectModel di PrestaShop. A partire dalla versione PS 1.7, le aree chiave del back office, tra cui le nuove schermate Pagina Prodotto e Ordini, sono state riscritte in Symfony. Il sistema di override PHP non influisce su questi controller Symfony. Per quelli, usa Decorazione del servizio, avvolgendo o sostituendo un servizio tramite il file services.yml del modulo. Se un override non ha effetto anche dopo aver cancellato class_index.php, è probabile che il controller sia stato migrato a Symfony.
Risoluzione dei conflitti: quando due moduli vogliono la stessa classe
Quando due moduli sovrascrivono entrambi la stessa classe, PrestaShop genera un errore durante la seconda installazione e lascia il suo override inattivo. La soluzione è manuale: apri entrambi i file, unisci tutti i metodi in un unico file /override/ che estende la classe Core, quindi elimina class_index.php. Aggiungi commenti che identificano quale modulo ha contribuito a ciascun metodo. Questo è il motivo per cui gli override sono vietati nei moduli del marketplace: i conflitti diventano un problema per il commerciante. Se si sviluppa per altri, utilizzare gli hook.
Figura 2: Come si verificano i conflitti di override quando due moduli hanno come target la stessa classe e la risoluzione manuale dell’unione.
Informazioni su Knowband
Knowband è un fornitore affidabile di plugin ed estensioni per l’e-commerce con anni di esperienza nell’aiutare i commercianti online a creare negozi più veloci, intelligenti e ricchi di funzionalità. Che tu gestisca il tuo negozio su PrestaShop, OpenCart, Shopify, WooCommerce, Magentoo qualsiasi altra piattaforma importante, Knowband offre un’ampia gamma di plugin ed estensioni pronti all’uso che ti aiutano a migliorare le funzionalità, le prestazioni e a offrire un’esperienza di acquisto migliore, senza dover partire da zero.