WebP AVIF Pro — Guida completa

WebP AVIF Pro converte e comprime le immagini della tua libreria media in WebP o AVIF, in locale, senza abbonamento né quota. Questa guida copre l’installazione, le due modalità di consegna, la generazione di testo alt con IA, il SEO delle immagini, l’elaborazione in lotti, il background WP-Cron e WP-CLI, oltre al backup e alla risoluzione dei problemi.

Requisiti del server

Il plugin funziona con uno dei due motori di immagine di PHP:

• Imagick compilato con libheif (AVIF) e supporto WebP — consigliato;
• GD con le funzioni imagewebp() e imageavif() (PHP 8.1 o superiore).

La pagina Impostazioni del plugin mostra delle pastiglie che indicano i motori e i formati effettivamente disponibili sul tuo hosting (Imagick, GD, WebP, AVIF).

Installazione

1. Carica la cartella df-webp-avif-pro in /wp-content/plugins/ (oppure installa lo ZIP da Plugin e poi Aggiungi nuovo).
2. Attiva il plugin dal menu Plugin.
3. Vai su WebP AVIF Pro e poi Impostazioni per configurare il formato, la modalità di consegna, la rinomina e l’IA.
4. Esegui un’analisi (simulazione) e poi l’ottimizzazione dalla pagina Ottimizzazione.

Formato di output e compressione

Scegli WebP (massima compatibilità) o AVIF (compressione migliore). Opzioni principali:

• Fallback automatico a WebP: se l’AVIF è richiesto ma non disponibile, il plugin produce WebP invece di fallire.
• Qualità: da 1 a 100, consigliato tra 78 e 85.
• Ridimensionamento: limita il lato più lungo a un valore in pixel (0 = disattivato). Solo in modalità sostituisci.
• Rimozione EXIF/ICC: rimuove i metadati per alleggerire i file.
• Ignora i GIF animati: evita di rompere le animazioni.

Modalità di consegna

WebP AVIF Pro offre due strategie, da scegliere in base al tuo contesto.

Sostituisci

Il file originale viene convertito, eventualmente rinominato, e tutti i riferimenti (contenuto degli articoli, metadati) vengono riscritti verso il nuovo file. Gli originali vengono salvati per consentire il ripristino.

Conserva l’originale (non distruttivo)

Un file next-gen viene generato accanto all’originale (per esempio photo.jpg e photo.jpg.webp). Alla visualizzazione, il plugin serve la versione next-gen solo ai browser che la accettano, tramite l’intestazione Accept; gli altri ricevono l’originale. Non è richiesta alcuna regola htaccess.

Rinomina SEO

Sono disponibili quattro modalità di rinomina dei file: nessuna, nome del prodotto (WooCommerce), modello personalizzato o base64 (anonimizzazione). La modalità modello accetta token:

• {product} {title} {sku} {cat} {alt} {id} {date} {n}

Esempio: {product}-{cat}-{n} produce un nome di file del tipo tappeto-personalizzato-ingresso-a1b2c3.webp. La rinomina non si applica in modalità conserva.

Testo alt con IA

WebP AVIF Pro genera attributi alt descrittivi con l’IA, in più lingue, a partire dall’immagine e dal contesto del prodotto.

1. Attiva l’IA nelle Impostazioni, scegli un fornitore (Anthropic, OpenAI, Gemini, Mistral con analisi visiva, o DeepSeek solo per contesto) e inserisci la tua chiave API.
2. Seleziona le lingue desiderate. La prima lingua selezionata alimenta l’alt principale; le altre vengono sincronizzate con le traduzioni Polylang quando esistono.
3. Genera l’alt dalla pagina ALT IA (in lotti), automaticamente al caricamento, o immagine per immagine tramite l’azione «Genera alt (IA)» della libreria media.

SEO front-end

• Dimensioni anti-CLS: aggiunge gli attributi width e height alle immagini del contenuto che ne sono prive, per ridurre lo spostamento del layout (Core Web Vitals).
• Schema ImageObject: emette un blocco JSON-LD sulle pagine e sulle schede prodotto (immagine in evidenza e galleria WooCommerce).

Ottimizzazione in lotti

Dalla pagina Ottimizzazione:

• Analizza (simulazione): stima il risparmio su un campione, senza modificare nulla.
• Ottimizza l’intera libreria: elabora le immagini in lotti senza bloccare il server. Puoi lasciare la pagina e riprendere più tardi; l’elaborazione continua dalle immagini rimanenti.

Le schede statistiche mostrano il numero di immagini convertite, lo spazio risparmiato e una cronologia mensile.

Background (WP-Cron) e WP-CLI

Per le librerie di grandi dimensioni, attiva l’elaborazione in background: il plugin ottimizza un lotto ogni 5 minuti tramite WP-Cron, senza tenere una scheda aperta. Le agenzie possono anche controllare il plugin dalla riga di comando:

wp df-wap status
wp df-wap optimize --batch=20
wp df-wap optimize --dry-run
wp df-wap alt --batch=10
wp df-wap restore --yes

Backup, pulizia e ripristino

In modalità sostituisci, gli originali vengono copiati in /wp-content/uploads/df-wap-backups/ (cartella protetta). Puoi:

• Ripristinare una singola immagine (azione della libreria media) o l’intera libreria (pulsante «Ripristina tutto»).
• Eliminare automaticamente i backup dopo un numero di giorni definito, per recuperare spazio su disco.

In modalità conserva, il ripristino elimina semplicemente i file next-gen, dato che gli originali non sono mai stati modificati.

Diagnostica

La pagina Ottimizzazione mostra avvisi contestuali: presenza di un plugin di esternalizzazione dei media (S3/CDN), page builder rilevati, AVIF richiesto ma non disponibile, o poco spazio su disco. Segui questi consigli prima di un’elaborazione massiva.

Risoluzione dei problemi

• AVIF non disponibile: attiva il fallback a WebP, o imposta il formato di output su WebP. La pagina Impostazioni mostra i motori disponibili.
• Immagini non sostituite in un page builder: alcuni URL memorizzati dai builder sfuggono alla riscrittura. Preferisci la modalità conserva.
• Alt non generati: verifica che l’IA sia attiva, che la chiave API sia valida e che ci sia credito residuo presso il fornitore.
• L’elaborazione in lotti sembra lenta: abbassa il numero di immagini per lotto (l’AVIF è impegnativo), o usa il background / WP-CLI.