Risolvere i Problemi Comuni di Smush: Troubleshooting

Smush è uno dei plugin WordPress più affidabili e collaudati per l’ottimizzazione delle immagini, ma come qualsiasi software, può occasionalmente presentare problemi. Che si tratti di un errore durante il Bulk Optimize, di immagini che non si caricano dopo l’attivazione del lazy load, o di conflitti con altri plugin, sapere come diagnosticare e risolvere questi problemi è fondamentale per mantenere il tuo sito performante e funzionante.

In questa guida di troubleshooting esamineremo i problemi più frequenti riscontrati dagli utenti di Smush, le loro cause e le soluzioni passo per passo. Per ogni problema, forniremo sia la soluzione rapida per risolvere immediatamente il sintomo, sia l’analisi della causa per prevenire il problema in futuro.

Problema 1: Il Bulk Optimize si Blocca o si Interrompe

Uno dei problemi più comuni è il Bulk Optimize che si ferma a metà del processo, con la barra di avanzamento che smette di progredire o con un messaggio di errore generico. Questo problema è quasi sempre legato alle risorse del server.

Causa 1: Timeout del server. Il processo di compressione invia ogni immagine ai server di Smush per l’elaborazione. Se il server ha un max_execution_time basso (30 secondi è il valore predefinito su molti hosting), il processo viene interrotto prima del completamento.

Soluzione: aumenta il max_execution_time a 300 secondi. Puoi farlo aggiungendo set_time_limit(300); nel file wp-config.php o modificando il file php.ini (se hai accesso). In alternativa, contatta il tuo provider di hosting per richiedere l’aumento del timeout.

Causa 2: Memoria insufficiente. Immagini molto grandi (superiori a 10 MB) richiedono molta memoria RAM per essere elaborate. Se il memory_limit PHP è troppo basso, il processo si interrompe con un errore fatale.

Soluzione: aumenta il memory_limit PHP ad almeno 256 MB. Puoi farlo aggiungendo define(’WP_MEMORY_LIMIT’, ’256M’); in wp-config.php o modificando il file php.ini. Se l’hosting non permette di superare un certo limite, valuta un upgrade del piano o il passaggio a un hosting WordPress più performante.

Causa 3: Connessione interrotta. Il Bulk Optimize richiede che la finestra del browser rimanga aperta durante il processo. Se chiudi il browser, cambi tab (su hosting con risorse limitate) o la connessione internet si interrompe, il processo si ferma.

Soluzione: mantieni la finestra del browser aperta e attiva durante tutto il processo. Se il processo si interrompe, puoi riavviarlo cliccando nuovamente il pulsante Bulk Smush: le immagini già compresse non verranno riprocessate.

Problema 2: Le Immagini Non si Caricano Dopo l’Attivazione del Lazy Load

Dopo aver attivato il lazy load di Smush, alcune immagini potrebbero non caricarsi correttamente, rimanendo come placeholder vuoti o mostrando il simbolo dell’immagine rotta. Questo è tipicamente causato da conflitti con altri script o da incompatibilità con il tema.

Causa 1: Conflitto con un altro lazy load. Se il tuo tema, un page builder (Elementor, Divi) o un plugin di caching (WP Rocket) implementa già il lazy load, avere due implementazioni attive contemporaneamente può causare conflitti. Le immagini vengono processate due volte e il secondo script non riesce a trovare l’URL originale dell’immagine.

Soluzione: disabilita il lazy load in tutti i plugin/temi tranne uno. Verifica le impostazioni del tuo page builder (Elementor > Impostazioni > Prestazioni), del plugin di caching (WP Rocket > Media) e del tema (opzioni tema > Prestazioni). Mantieni attivo solo il lazy load di Smush o solo quello dell’altro plugin.

Causa 2: Immagini caricate tramite JavaScript. Alcuni temi e plugin caricano le immagini dinamicamente tramite JavaScript (ad esempio in slider, gallerie, popup). Il lazy load di Smush potrebbe non riconoscere queste immagini perché vengono aggiunte al DOM dopo il caricamento iniziale della pagina.

Soluzione: aggiungi le classi CSS degli elementi problematici alla lista di esclusione del lazy load in Smush > Lazy Load > Esclusioni. Per identificare le classi, ispeziona l’elemento con Chrome DevTools e cerca la classe CSS del contenitore dell’immagine.

Causa 3: Immagini di sfondo CSS. Il lazy load di Smush agisce sui tag <img> nell’HTML, ma non sulle immagini di sfondo definite in CSS con background-image. Se le immagini mancanti sono sfondi CSS, il lazy load non è la causa del problema.

Problema 3: Le Immagini WebP Non Vengono Servite

Hai attivato la conversione WebP in Smush, ma verificando con Chrome DevTools noti che le immagini vengono ancora servite in formato JPEG o PNG. Questo problema può avere diverse cause.

Causa 1: Regole .htaccess non applicate. Se utilizzi il metodo di consegna tramite regole server, Smush deve modificare il file .htaccess per aggiungere le regole di riscrittura. Se il file non è scrivibile o se un altro plugin sovrascrive le regole, la consegna WebP non funziona.

Soluzione: verifica che il file .htaccess nella root di WordPress contenga le regole WebP aggiunte da Smush. Se non sono presenti, vai su Smush > Bulk Smush > WebP e clicca su “Update .htaccess” o “Re-check”. Se il problema persiste, verifica che il file .htaccess sia scrivibile dal web server (permessi 644 o 664).

Causa 2: File WebP non generati. Se il server non ha la libreria libwebp installata (tramite GD o Imagick), Smush non può generare i file WebP. Il plugin mostra un avviso nella pagina delle impostazioni se la libreria è assente.

Soluzione: contatta il tuo hosting per richiedere l’installazione del modulo WebP per PHP. In alternativa, utilizza il CDN di Smush Pro, che gestisce la conversione WebP sui propri server senza richiedere librerie sul tuo hosting.

Causa 3: Cache non aggiornata. Se utilizzi un plugin di caching, la cache potrebbe servire la versione precedente della pagina (senza WebP) anche dopo l’attivazione della conversione.

Soluzione: svuota completamente la cache del sito (plugin di caching + CDN se presente) e verifica nuovamente. Svuota anche la cache del browser o usa una finestra in incognito per il test.

Problema 4: Errori su Immagini Specifiche

A volte il Bulk Optimize segnala errori su immagini specifiche, mentre la maggior parte delle immagini viene compressa correttamente. Le cause più comuni sono file corrotti, formati non supportati e immagini troppo grandi.

Causa 1: File corrotto. L’immagine potrebbe essere stata corrotta durante l’upload o salvata in un formato non standard. Un file JPEG con estensione .jpg ma contenuto non valido causa errori di elaborazione.

Soluzione: scarica l’immagine problematica, aprila in un editor di immagini (GIMP, Photoshop, anche l’anteprima del sistema operativo) e salvala nuovamente. Se non si apre, il file è corrotto e va sostituito con una nuova copia.

Causa 2: Immagine troppo grande. Smush ha un limite di dimensioni per le immagini elaborate tramite API (generalmente 5 MB per la versione free, fino a 32 MB per la Pro). Immagini che superano questo limite vengono rifiutate.

Soluzione: ridimensiona l’immagine prima del caricamento o attiva il resize automatico di Smush. Un’immagine web non dovrebbe mai superare i 2-3 MB come dimensione massima ragionevole.

Causa 3: Formato non supportato. Smush supporta JPEG, PNG e GIF. Se tenti di comprimere un file SVG, BMP, TIFF o un altro formato non supportato, il plugin restituirà un errore.

Soluzione: converti l’immagine in uno dei formati supportati prima del caricamento. Per le icone e i loghi, considera l’uso del formato SVG (che non necessita di compressione bitmap) con un plugin dedicato alla gestione SVG.

Problema 5: Il CDN Non Funziona Correttamente

Dopo aver attivato il CDN di Smush Pro, le immagini potrebbero non essere servite dal CDN, risultare lente o mostrare errori.

Causa 1: Propagazione non completata. Dopo l’attivazione, il CDN impiega da pochi minuti a qualche ora per propagare le immagini a tutti i nodi. Durante questo periodo, alcune immagini potrebbero non essere ancora disponibili sul CDN.

Soluzione: attendi fino a 24 ore dopo l’attivazione prima di considerare il CDN problematico. Verifica lo stato nella dashboard di Smush.

Causa 2: Firewall o WAF che blocca le connessioni. Alcuni plugin di sicurezza o firewall a livello di hosting possono bloccare le connessioni verso i server del CDN o le connessioni in ingresso dai nodi CDN verso il server di origine.

Soluzione: aggiungi i domini del CDN di Smush (*.smushcdn.com) alla whitelist del firewall. Se utilizzi Cloudflare o un altro proxy, assicurati che non interferisca con gli URL del CDN di Smush.

Causa 3: SSL Mixed Content. Se il tuo sito usa HTTPS ma le immagini CDN vengono servite via HTTP (o viceversa), il browser potrebbe bloccarle come “mixed content”.

Soluzione: il CDN di Smush serve sempre le immagini via HTTPS. Se noti problemi di mixed content, verifica che il tuo sito utilizzi HTTPS correttamente (URL di WordPress in Impostazioni > Generali con https://) e che non ci siano URL hardcoded con http://.

Problema 6: Conflitti con Plugin di Caching

Smush può interagire in modo imprevisto con i plugin di caching, causando problemi come immagini non aggiornate, lazy load non funzionante o errori di visualizzazione.

Causa: Minificazione HTML. Alcuni plugin di caching minificano l’HTML rimuovendo spazi e attributi, il che può interferire con gli attributi data-* usati dal lazy load di Smush.

Soluzione: nelle impostazioni del plugin di caching, disabilita la minificazione HTML o aggiungi esclusioni per gli attributi data-lazyloaded e data-src. Se usi WP Rocket, le versioni recenti sono compatibili con Smush senza modifiche, ma se usi il lazy load di entrambi, disabilita quello di uno dei due.

Causa: Ottimizzazione delle immagini integrata nel plugin di caching. Alcuni plugin di caching (come WP Rocket, LiteSpeed Cache) includono funzionalità di ottimizzazione immagini che possono sovrapporsi a Smush.

Soluzione: disabilita le funzionalità di ottimizzazione immagini nel plugin di caching e usa solo Smush, o viceversa. Non è consigliabile avere due plugin che tentano di ottimizzare le stesse immagini contemporaneamente.

Problema 7: Qualità delle Immagini Insoddisfacente

Dopo la compressione, alcune immagini potrebbero mostrare artefatti visibili, perdita di dettagli o colori alterati. Questo problema è più comune con la compressione lossy e Super-Smush.

Causa: Compressione troppo aggressiva. Se hai attivato Super-Smush su immagini che richiedono alta fedeltà (fotografie professionali, immagini di prodotti per e-commerce), il livello di compressione potrebbe essere eccessivo per le tue esigenze.

Soluzione: se hai attivato il backup delle immagini originali, puoi ripristinare le immagini compromesse e ricomprimerle con un livello inferiore (lossy invece di Super-Smush, o lossless per le immagini più critiche). Se non hai il backup, dovrai ricaricare le immagini originali e applicare la compressione desiderata.

Per prevenire questo problema in futuro, adotta una strategia differenziata: compressione lossless o lossy leggera per le immagini critiche (prodotti, portfolio) e Super-Smush per le immagini decorative e i contenuti editoriali dove la fedeltà assoluta non è essenziale.

Problema 8: Smush Non Comprime le Nuove Immagini

Le nuove immagini caricate nella Libreria Media non vengono compresse automaticamente, nonostante la compressione automatica sia attiva.

Causa 1: Compressione automatica disattivata. Verifica che l’opzione “Automatically optimize new uploads” sia attiva in Smush > Bulk Smush.

Causa 2: Conflitto con plugin di upload. Alcuni plugin che modificano il processo di upload di WordPress (plugin di importazione, plugin di ottimizzazione delle miniature, plugin di watermark) possono interferire con l’hook che Smush utilizza per la compressione automatica.

Soluzione: disattiva temporaneamente gli altri plugin uno alla volta per identificare il conflitto. Una volta identificato, contatta gli sviluppatori del plugin in conflitto per una soluzione di compatibilità.

Causa 3: Errore silenzioso del server. Il server potrebbe avere problemi di connessione con i server di Smush durante l’upload, causando un fallimento silenzioso della compressione.

Soluzione: verifica che il server possa raggiungere i server di Smush (smushpro.wpmudev.org) senza restrizioni firewall. Puoi farlo eseguendo wp_remote_get(’https://smushpro.wpmudev.org’) tramite un mu-plugin di test o chiedendo al provider di hosting.

Problema 9: Spazio su Disco Esaurito

Dopo aver attivato la conversione WebP locale e il backup delle immagini originali, lo spazio su disco del server potrebbe esaurirsi.

Causa: la conversione WebP locale genera un file aggiuntivo per ogni immagine, e il backup delle immagini originali conserva una copia integrale di ogni file prima della compressione. Per un sito con 5000 immagini, questo può facilmente raddoppiare o triplicare lo spazio occupato.

Soluzione: se lo spazio è limitato, disabilita il backup delle immagini originali (ma assicurati di avere un backup esterno). In alternativa, passa alla conversione WebP tramite CDN (che non genera file locali). Se hai bisogno di più spazio, valuta un upgrade del piano hosting.

Strumenti di Diagnostica

Per diagnosticare i problemi di Smush, utilizza questi strumenti. Smush > Dashboard mostra lo stato generale del plugin e segnala eventuali problemi di configurazione. Strumenti > Salute del Sito in WordPress mostra informazioni sulle risorse del server (memoria PHP, timeout, librerie disponibili) utili per identificare limitazioni hardware.

Chrome DevTools > Network permette di verificare se le immagini vengono servite nel formato corretto, se il lazy load funziona e se il CDN è attivo. Chrome DevTools > Console mostra eventuali errori JavaScript legati al lazy load o ad altri script di Smush.

Il log di debug di WordPress (attivabile con WP_DEBUG e WP_DEBUG_LOG in wp-config.php) può mostrare errori PHP causati da Smush o da conflitti con altri plugin. Controlla il file wp-content/debug.log dopo aver riprodotto il problema.

Quando Contattare il Supporto

Se hai provato tutte le soluzioni descritte in questo articolo senza successo, è il momento di contattare il supporto. Gli utenti di Smush Pro hanno accesso al supporto prioritario di WPMU DEV, disponibile 24/7. Per gli utenti della versione free, il forum di supporto su WordPress.org è la risorsa principale.

Quando contatti il supporto, fornisci più informazioni possibili: la versione di WordPress e di Smush, il tema e i plugin attivi, una descrizione dettagliata del problema, screenshot degli errori e il log di debug se disponibile. Queste informazioni aiutano il team di supporto a diagnosticare il problema più rapidamente.

Se preferisci un’assistenza diretta e personalizzata, il nostro team è a disposizione per aiutarti a risolvere qualsiasi problema legato a Smush o all’ottimizzazione delle immagini sul tuo sito WordPress. Contattaci per una consulenza dedicata.

Conclusioni

La maggior parte dei problemi di Smush ha soluzioni semplici e dirette. Timeout del server, conflitti con altri plugin e configurazioni errate sono le cause più comuni e possono essere risolti in pochi minuti con le indicazioni giuste. La chiave è diagnosticare correttamente la causa del problema prima di cercare la soluzione, evitando modifiche alla cieca che potrebbero creare problemi aggiuntivi.

Con Smush correttamente configurato e funzionante, il tuo sito beneficerà di immagini ottimizzate, tempi di caricamento rapidi e un’esperienza utente eccellente. E se qualcosa non funziona come previsto, questa guida di troubleshooting ti aiuterà a rimettere tutto in ordine rapidamente.