El plugin comprime las imágenes de la biblioteca mediante la API de ANK. Esta guía explica la instalación, el procesamiento automático y por lotes, los formatos WebP y AVIF, las copias originales y la solución de problemas.
1. Qué hace el plugin
ANK Image Compress procesa archivos JPEG, PNG y WebP originales y los tamaños de WordPress que selecciones. Antes de sustituir un archivo, comprueba la respuesta de la API, el formato, las dimensiones y la reducción de tamaño. Los archivos comprimidos conservan su nombre y URL. Los bytes originales se guardan en una carpeta privada fuera del sitio.
Puedes comprimir nuevas subidas automáticamente, procesar una imagen, varias imágenes seleccionadas o toda la biblioteca, buscar por título o nombre de archivo, consultar 50 resultados por página, ver el ahorro y restaurar el original.
2. Instalación y clave API
- Instala el ZIP de ANK Image Compress en Plugins → Añadir nuevo → Subir plugin y actívalo.
- Crea una cuenta en ankpicpress.com y obtén la clave API en tu área personal. Las credenciales y el saldo se comparten con ank-tinypng.ru; debes iniciar sesión por separado en cada dominio.
- En WordPress abre Ajustes → ANK Compress, introduce la clave y guarda los ajustes.
- Comprueba el estado de la API y el saldo en el bloque de conexión. La clave guardada no vuelve a mostrarse.
En una red WordPress Multisite puedes definir ANKIC_API_KEY en wp-config.php para compartir una clave. Mantén privado ese archivo. Cuando se define la constante, la clave no se puede editar desde la administración.
3. Procesamiento automático
Activa la opción de procesar nuevas imágenes después de subirlas mediante WP-Cron y guarda los ajustes. WordPress pone cada imagen en la cola poco después de la subida. No hace falta mantener abierta la página de administración, pero WP-Cron debe ejecutarse con visitas al sitio o mediante una tarea del sistema.
Para comprobarlo, sube un JPEG, PNG o WebP estático y pequeño. Después de ejecutarse cron, busca la imagen en la tabla del plugin. «Completado» indica que se procesaron los archivos aptos. Si no comienza, revisa WP-Cron, la clave y el saldo.
4. Compresión manual y por lotes
Para una imagen, pulsa Comprimir en la tabla del plugin o en la vista de lista de la biblioteca de medios. También puedes seleccionar varias imágenes y usar la acción en lote de WordPress. La opción de procesar todas las imágenes de la página solo abarca los 50 resultados visibles.
Para toda la biblioteca, inicia el procesamiento por lotes. WP-Cron procesa un archivo en cada ejecución programada y guarda el progreso en el servidor. Puedes pausar y reanudar. Los contadores de completados y errores corresponden a la ejecución actual. Una nueva ejecución omite versiones ya procesadas salvo que solicites una recompresión.
5. Tamaños, WebP y AVIF
Elige qué tamaños generados por WordPress se envían a la API. La imagen original se procesa siempre. Cuantos más tamaños selecciones, más peticiones puede haber. Puedes limitar el ancho y el alto de nuevos JPEG y WebP grandes; 0 conserva el valor predeterminado de WordPress. Esta opción no reduce los PNG subidos.
El ajuste de formato crea los nuevos tamaños en WebP o AVIF mediante WordPress. No cambia las imágenes existentes ni el archivo original. Los tamaños WebP pueden comprimirse después con la API de ANK. WordPress crea los AVIF localmente; no se envían a la API. El editor de imágenes del servidor debe admitir el formato elegido.
6. Búsqueda, estadísticas y restauración
Busca por título o nombre de archivo; se muestran 50 resultados por página. La tabla indica los archivos procesados, el espacio ahorrado y el estado. El bloque de estadísticas suma las imágenes y los archivos optimizados y el ahorro total.
Restaurar original recupera los bytes de la copia privada; Volver a comprimir inicia un nuevo procesamiento. Consulta el saldo antes de recomprimir muchos archivos: un nuevo resultado válido puede consumir un crédito. WordPress necesita permisos de escritura en el directorio superior de la instalación para guardar las copias fuera del sitio público.
7. Créditos y límites actuales
La API de ANK acepta JPEG, PNG y WebP estáticos de hasta 5 MB y 20 megapíxeles. Si el resultado no es menor, no se sustituye el archivo ni se consume un crédito. Las peticiones idénticas repetidas están protegidas frente a cobros duplicados. El saldo aparece en el bloque de conexión.
8. Solución de problemas y ayuda
- API no disponible o clave incorrecta: revisa la conexión en Ajustes → ANK Compress, guarda una clave nueva si hace falta y actualiza la página.
- No se inicia el procesamiento automático: comprueba la opción y la ejecución real de WP-Cron. Sube un JPEG pequeño y revisa su estado.
- Se omite un archivo: verifica el tipo MIME, los límites de 5 MB y 20 MP y que no esté animado. AVIF requiere compatibilidad del editor y no se comprime en la API.
- No se puede guardar la copia: concede a WordPress permisos de escritura en el directorio superior de la instalación. El plugin no sustituye archivos sin una copia válida.
- El navegador muestra una imagen antigua: limpia la caché de la página o del CDN. El plugin añade una versión a las URL generadas de forma estándar por WordPress.
Si el error continúa, escribe a modules@ankpicpress.com con la versión del plugin, el tipo y tamaño del archivo, el mensaje de error y los pasos para reproducirlo. No envíes tu clave API ni imágenes privadas.