ID Optimizador AVIF self-updates
Plugin de WordPress: convierte la mediateca a AVIF reemplazando referencias y limpia imágenes sin uso. Instituto Duartiano.
by Instituto Duartiano · github.com/freddyaquinoportes/id-optimizador-avif · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/freddyaquinoportes/id-optimizador-avif/archive/refs/heads/main.zipShips its own WordPress updater (built-in updater), so new versions show up under Dashboard → Updates.
Readme
ID Optimizador AVIF
Plugin de WordPress del Instituto Duartiano con dos funciones:
- Conversión de la mediateca a AVIF reemplazando todas las referencias para que ninguna imagen desaparezca de las páginas.
- Detección y borrado en lote de imágenes sin uso (a la papelera, recuperable).
Requisitos
- WordPress 6.0+ y PHP 8.1+ con GD compilado con libavif, o ImageMagick con soporte AVIF. La página del plugin avisa si el servidor no puede generar AVIF.
- Respaldo completo del sitio antes del primer uso (WPvivid o similar).
Instalación
Comprimir la carpeta con tar -a -cf id-optimizador-avif.zip -C <carpeta-padre> --exclude "id-optimizador-avif/.git" id-optimizador-avif y subirla en Plugins → Añadir plugin → Subir plugin. (No usar Compress-Archive de PowerShell: genera zips corruptos para WordPress.)
El panel queda en Medios → Optimizador AVIF.
Cómo funciona la conversión
Por cada imagen (JPG, PNG, GIF estático, WebP):
- Genera el AVIF a partir del archivo original con la calidad configurada (75 por defecto). Si el AVIF sale más pesado que el original, se omite.
- Conmuta el adjunto al nuevo archivo manteniendo el mismo ID: las imágenes destacadas, galerías por ID y cualquier referencia por ID siguen funcionando solas.
- Regenera todos los tamaños intermedios en AVIF.
- Reemplaza las URL antiguas por las nuevas en: contenido de entradas/páginas, postmeta (Avada/builders, con manejo seguro de datos serializados), opciones del sitio y termmeta.
- Conserva los archivos antiguos en disco como respaldo purgable y registra el ahorro potencial.
Casos que se omiten automáticamente: GIF animados (perderían la animación), el icono del sitio (favicon), formatos no convertibles y archivos faltantes en disco.
El espacio se libera en el paso "Purgar respaldos", pensado para ejecutarse después de verificar visualmente el sitio. Esa purga sí es irreversible.
Tras una conversión masiva, vaciar cachés: Avada → Performance → Reset Fusion Caches, y el plugin de caché si existe.
Cómo funciona la detección de imágenes sin uso
El análisis marca una imagen como usada si aparece en cualquiera de estos lugares:
- Imagen destacada de cualquier contenido no descartado.
- Su nombre de archivo en el contenido de entradas/páginas/CPT, en postmeta de otros contenidos, en opciones del sitio o en termmeta.
- Referencias por ID:
wp-image-N, galerías[gallery ids="..."], postmeta de claves relacionadas con imágenes, logo/icono del sitio y mods del tema.
Todo lo demás queda como candidata y se muestra en una galería con casillas. El borrado en lote envía a la papelera de medios (MEDIA_TRASH), recuperable durante 30 días desde Medios → Papelera.
Limitaciones que hay que conocer
- No puede detectar usos fuera de la base de datos: imágenes referenciadas en CSS personalizado de archivos, en plantillas PHP del tema hijo, enlazadas desde otros sitios web (hotlinking) o usadas en correos/documentos externos.
- Los nombres de archivo de menos de 4 caracteres se consideran siempre usados (búsqueda poco fiable).
- Recomendación: revisar visualmente las candidatas antes de enviarlas a la papelera, y vaciar la papelera solo después de unos días de comprobar que nada se rompió.
Auto-actualización
Igual que ID Rotador de Banners: el plugin compara su versión con la cabecera Version: de id-optimizador-avif.php en la rama main de GitHub y ofrece el botón Actualizar estándar. "Comprobar de nuevo" en Escritorio → Actualizaciones fuerza la consulta.