WebP AVIF Pro — Guía completa

WebP AVIF Pro convierte y comprime las imágenes de tu biblioteca de medios a WebP o AVIF, en local, sin suscripción ni cuota. Esta guía cubre la instalación, los dos modos de entrega, la generación de texto alt por IA, el SEO de imágenes, el procesamiento por lotes, el segundo plano WP-Cron y WP-CLI, además de la copia de seguridad y la resolución de problemas.

Requisitos del servidor

El plugin funciona con uno de los dos motores de imagen de PHP:

• Imagick compilado con libheif (AVIF) y soporte WebP — recomendado;
• GD con las funciones imagewebp() e imageavif() (PHP 8.1 o superior).

La página de Ajustes del plugin muestra indicadores con los motores y formatos realmente disponibles en tu alojamiento (Imagick, GD, WebP, AVIF).

Instalación

1. Sube la carpeta df-webp-avif-pro a /wp-content/plugins/ (o instala el ZIP desde Plugins y luego Añadir nuevo).
2. Activa el plugin desde el menú Plugins.
3. Ve a WebP AVIF Pro y luego Ajustes para configurar el formato, el modo de entrega, el renombrado y la IA.
4. Ejecuta un análisis (simulación) y luego la optimización desde la página Optimización.

Formato de salida y compresión

Elige WebP (máxima compatibilidad) o AVIF (mejor compresión). Opciones principales:

• Cambio automático a WebP: si se solicita AVIF pero no está disponible, el plugin produce WebP en lugar de fallar.
• Calidad: de 1 a 100, recomendado entre 78 y 85.
• Redimensionado: limita el lado más largo a un valor en píxeles (0 = desactivado). Solo en modo reemplazar.
• Eliminación de EXIF/ICC: quita los metadatos para aligerar los archivos.
• Ignorar GIF animados: evita romper las animaciones.

Modos de entrega

WebP AVIF Pro ofrece dos estrategias, a elegir según tu contexto.

Reemplazar

El archivo original se convierte, se renombra opcionalmente, y todas las referencias (contenido de las entradas, metadatos) se reescriben hacia el nuevo archivo. Los originales se respaldan para permitir la restauración.

Conservar el original (no destructivo)

Se genera un archivo next-gen junto al original (por ejemplo photo.jpg y photo.jpg.webp). En la visualización, el plugin sirve la versión next-gen solo a los navegadores que la aceptan, mediante la cabecera Accept; los demás reciben el original. No se requiere ninguna regla htaccess.

Renombrado SEO

Hay cuatro modos de renombrado de archivos: ninguno, nombre del producto (WooCommerce), plantilla personalizada o base64 (anonimización). El modo plantilla acepta tokens:

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

Ejemplo: {product}-{cat}-{n} produce un nombre de archivo como alfombra-personalizada-entrada-a1b2c3.webp. El renombrado no se aplica en modo conservar.

Texto alt por IA

WebP AVIF Pro genera atributos alt descriptivos con IA, en varios idiomas, a partir de la imagen y del contexto del producto.

1. Activa la IA en Ajustes, elige un proveedor (Anthropic, OpenAI, Gemini, Mistral con análisis visual, o DeepSeek solo por contexto) e introduce tu clave API.
2. Selecciona los idiomas deseados. El primer idioma marcado alimenta el alt principal; los demás se sincronizan con las traducciones de Polylang cuando existen.
3. Genera el alt desde la página ALT IA (por lotes), automáticamente al subir, o imagen por imagen mediante la acción «Generar alt (IA)» de la biblioteca de medios.

SEO front-end

• Dimensiones anti-CLS: añade los atributos width y height a las imágenes del contenido que carecen de ellos, para reducir el desplazamiento de diseño (Core Web Vitals).
• Schema ImageObject: emite un bloque JSON-LD en las páginas y fichas de producto (imagen destacada y galería de WooCommerce).

Optimización por lotes

Desde la página Optimización:

• Analizar (simulación): estima el ahorro sobre una muestra, sin modificar nada.
• Optimizar toda la biblioteca: procesa las imágenes por lotes sin bloquear el servidor. Puedes salir de la página y reanudar más tarde; el procesamiento continúa desde las imágenes restantes.

Las tarjetas de estadísticas muestran el número de imágenes convertidas, el espacio ahorrado y un historial mensual.

Segundo plano (WP-Cron) y WP-CLI

Para bibliotecas grandes, activa el procesamiento en segundo plano: el plugin optimiza un lote cada 5 minutos mediante WP-Cron, sin mantener una pestaña abierta. Las agencias también pueden controlar el plugin desde la línea de comandos:

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

Copia de seguridad, purga y restauración

En modo reemplazar, los originales se copian en /wp-content/uploads/df-wap-backups/ (carpeta protegida). Puedes:

• Restaurar una imagen (acción de la biblioteca de medios) o toda la biblioteca (botón «Restaurar todo»).
• Purgar automáticamente las copias después de un número de días definido, para recuperar espacio en disco.

En modo conservar, la restauración simplemente elimina los archivos next-gen, ya que los originales nunca se modificaron.

Diagnósticos

La página Optimización muestra avisos contextuales: presencia de un plugin de externalización de medios (S3/CDN), maquetadores detectados, AVIF solicitado pero no disponible, o poco espacio en disco. Sigue estas recomendaciones antes de un procesamiento masivo.

Resolución de problemas

• AVIF no disponible: activa el cambio a WebP, o pon el formato de salida en WebP. La página Ajustes muestra los motores disponibles.
• Imágenes no reemplazadas dentro de un maquetador: algunas URLs almacenadas por los maquetadores escapan a la reescritura. Prefiere el modo conservar.
• Alt no generados: comprueba que la IA está activada, que la clave API es válida y que queda crédito con el proveedor.
• El procesamiento por lotes parece lento: baja el número de imágenes por lote (AVIF es exigente), o usa el segundo plano / WP-CLI.