FasterFy — AI Media Optimizer

=== FasterFy — AI Media Optimizer === Contributors: fasterfy Tags: webp, avif, image optimization, compression, ai, alt text, seo, media, performance, core web vitals Requires at least: 6.0 Tested up to: 6.5 Requires PHP: 8.0 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Optimización masiva, inteligente y retroactiva de activos visuales: conversión a WebP/AVIF, compresión PNG, sanitización SVG, reconocimiento de imagen e inyección de Alt Text con IA, colas asíncronas no bloqueantes y arquitectura no destructiva (rollback).

== Description ==

FasterFy actúa directamente sobre el sistema de archivos y la base de datos de WordPress para optimizar el rendimiento técnico (Web Core Vitals) y enriquecer el SEO mediante visión artificial.

Características principales

• Pipeline por tipo MIME
  • JPG/JPEG → transcodificación a WebP o AVIF con compresión inteligente con pérdida.
  • PNG → compresión por cuantización de color conservando el canal alfa (estilo TinyPNG).
  • SVG → sanitización del XML (elimina scripts, manejadores on*, javascript: y metadatos de diseño). Sin compresión de mapa de bits.
• Optimización retroactiva y mutación nativa: escanea la tabla wp_posts (post_type = 'attachment'), reemplaza el archivo, regenera miniaturas y reescribe las referencias en post_content y postmeta (incluyendo datos serializados).
• Inyección nativa de Alt Text SEO: la IA multimodal genera descripciones denotativas y actualiza _wp_attachment_image_alt.
• Gobierno de IA: temperatura baja (anti-alucinación), moderación de contenido NSFW previa. Si un activo es sensible, se optimiza técnicamente pero no se envía al modelo generativo (protege las cuentas de API).
• Arquitectura no destructiva (rollback): respaldo del original en un directorio aislado y restauración con un clic.
• Colas asíncronas no bloqueantes: usa Action Scheduler si está disponible, con respaldo en WP-Cron. Throttling (tamaño de lote, concurrencia, enfriamiento) y control de cuotas/créditos.
• Panel SaaS premium: dashboard en tiempo real, vistas Lite y Pro, tracker de rendimiento, gestión de cola, biblioteca y registros.

== Installation ==

1. Copia la carpeta fasterfy en wp-content/plugins/.
2. (Opcional) Ejecuta composer install dentro de la carpeta para cargar el autoloader optimizado. No es obligatorio: el plugin incluye su propio autoloader.
3. (Recomendado) Instala el plugin "Action Scheduler" o WooCommerce para colas robustas.
4. Activa FasterFy — AI Media Optimizer desde el menú Plugins.
5. Abre el menú FasterFy en el panel de administración.

Requisitos del servidor

• PHP 8.0 o superior.
• Extensión Imagick (recomendada) o GD con soporte WebP/AVIF.
• Para IA: una API Key de un proveedor compatible con OpenAI (o el endpoint de FasterFy Cloud).

== Frequently Asked Questions ==

= ¿Es seguro? Modifica mis archivos originales = Sí. Antes de cualquier mutación, FasterFy crea un respaldo del original en wp-content/uploads/fasterfy-backups. Puedes revertir cualquier activo con un clic.

= ¿Dónde se guarda la API Key? = Cifrada en reposo (AES-256-CBC) usando las llaves de seguridad de tu instalación de WordPress. Nunca se expone al frontend.

= ¿Funciona sin IA? = Sí. La optimización técnica (WebP/AVIF, compresión, SVG) funciona sin configurar IA. La IA es opcional para Alt Text y SEO.

== Developer Hooks ==

• fasterfy_ai_provider (filter): registra un proveedor de IA personalizado.
• fasterfy_moderation_verdict (filter): integra un servicio de moderación externo (p.ej. Google Cloud Vision SafeSearch).
• fasterfy_booted (action): se dispara cuando el plugin termina de arrancar.

== REST API (namespace: fasterfy/v1) ==

Todas las rutas requieren capacidad manage_options y nonce wp_rest.

• GET /summary — resumen de biblioteca, cola y cuota.
• GET /capabilities — motores de imagen y formatos soportados.
• GET /settings, POST /settings — leer/guardar configuración.
• GET /media — listado paginado (status=all|pending|optimized).
• POST /optimize — optimiza un adjunto ({ id, mode }).
• POST /rollback — revierte un adjunto ({ id }).
• GET /queue/status, POST /queue/start|pause|resume|cancel — control de la cola.
• GET /logs, DELETE /logs — registros.
• POST /ai/test — prueba la conexión con el proveedor de IA.
• POST /ai/item — aplica IA a un adjunto ({ id }).

== Changelog ==

= 1.0.17 =

• Rendimiento rediseñado: tarjetas KPI, donut animado de progreso, gráfico de composición por tipo de archivo y comparativa antes/después con barras animadas y métricas de ROI.
• UI: corregido el título de la ficha de detalle que chocaba con el botón de cerrar.

= 1.0.16 =

• Biblioteca: vista de detalle por imagen (clic en la miniatura o en "Detalles"): muestra formato, dimensiones, tamaños, ahorro y %, conversión, textos generados (alt/título/leyenda/descripción), respaldo y enlace a WP.
• Biblioteca: nuevo orden "Tipo de archivo"; corrección del "Seleccionar todo / Limpiar".
• Resumen: banner con slider de beneficios (rotación automática + puntos de navegación).
• UI: inputs y selects con bordes redondeados (consistencia con el diseño).

= 1.0.15 =

• UI: el panel ocupa exactamente 100vh (barra lateral a altura completa, sin recuadro sobrante) y el scroll queda solo dentro del contenido. Se oculta el pie de WP en la página del plugin para eliminar el scroll de página en escritorio.
• UI: corregido el hover de los botones (ya no se pierde el fondo ni el texto queda ilegible); ahora usa un realce de brillo.

= 1.0.14 =

• UI: el panel ocupa todo el bloque de pantalla y se elimina el doble scroll (un único scroll de página). Barra lateral fija (sticky) y botón de tema flotante. Ajustes responsive para tablet y móvil.

= 1.0.13 =

• Branding: identidad visual FasterFy aplicada (paleta #1F1F1F / #33EE33 / #ffffff). Nuevo logo (escudo hexagonal con rayo y chispa) en la barra lateral, pantalla de carga e ícono del menú de WordPress; botones, anillo de progreso, toggles, toasts y acentos en verde de marca.

= 1.0.12 =

• IA en imágenes AVIF ya existentes: el plugin lee el AVIF guardado y crea una copia JPEG al vuelo para el análisis (no requiere re-subir las fotos). Respaldo robusto Imagick/GD para garantizar la conversión AVIF/WebP → JPEG.

= 1.0.11 =

• CORRECCIÓN IA (importante): los modelos de visión no leen AVIF. Ahora el plugin envía una copia JPEG redimensionada para el análisis, así la generación de texto funciona con imágenes AVIF/WebP/cualquier formato.
• AVIF: la conversión de PNG usa el "Formato objetivo" elegido (WebP o AVIF, ambos conservan transparencia).

= 1.0.10 =

• CORRECCIÓN PNG: la compresión ahora reduce de verdad. Si comprimir el PNG no ahorra (común en hosts con GD), se convierte a WebP conservando transparencia y se elige el resultado más pequeño.
• UX: acciones masivas unificadas con las de selección y por imagen (Optimizar / Generar IA / Revertir), para no confundir.
• Galería: "Seleccionar todo" (marca/desmarca toda la página) para elegir muchas y descartar pocas.
• "Revertir todo" masivo con confirmación.
• UI: títulos y números con menos peso y más interlineado en las tarjetas del resumen; desplegable de orden con texto legible al desplegarse.

= 1.0.9 =

• Resiliencia: bloqueo de concurrencia (lock con auto-expiración) que evita doble procesamiento si hay varias pestañas o WP-Cron activos.
• Resiliencia: presupuesto de tiempo (~20s) por lote para evitar timeouts en hosts compartidos.
• Documentación: docs/RESILIENCE.md (escenarios de fallo y prevención) y plantillas legales en español (legal/es/).

= 1.0.8 =

• Cumplimiento: divulgación de IA dentro del panel (transparencia) y carpeta legal/ con plantillas de Términos, Privacidad, divulgación de IA y checklist de cumplimiento SaaS adaptado.

= 1.0.7 =

• Seguridad: la reescritura de datos serializados usa unserialize con allowed_classes=false (previene PHP object injection).
• Seguridad: el endpoint de rollback valida que el ID sea un adjunto.

= 1.0.6 =

• CORRECCIÓN IA: el modo "Optimizar + IA" ahora también genera textos en imágenes ya optimizadas (antes terminaba sin hacer nada si la optimización ya estaba completa).
• Selección de imágenes: casillas en la galería (lista y cuadrícula) para optimizar, generar IA o revertir SOLO las fotos elegidas.
• Notificaciones rediseñadas: más visibles, con icono y colores de alto contraste, en la esquina superior derecha.
• Filtros (buscador y orden) rediseñados para ser consistentes con el estilo del panel.
• Evita re-consumir cuota de IA en imágenes que ya tienen texto generado.

= 1.0.5 =

• UX acciones masivas: en modo Lite, un único botón "Procesar toda la biblioteca"; en modo Pro, las 3 acciones (comprimir / textos IA / ambas) con descripción.
• Lite vs Pro ahora se diferencian de verdad: el modo Lite simplifica el menú y oculta opciones avanzadas (temperatura, renombrado semántico, moderación, throttling, exclusiones).
• Biblioteca: buscador por nombre y ordenamiento (recientes, antiguas, mayor ahorro, A-Z) para gestionar bibliotecas grandes sin borrar archivos.
• Botón de tema claro/oscuro movido a la esquina superior derecha como icono.

= 1.0.4 =

• IMPORTANTE: las imágenes ya convertidas a WebP/AVIF vuelven a aparecer en la biblioteca del plugin (antes desaparecían y no se les podía aplicar IA ni revertir).
• Procesamiento masivo fiable: ahora lo conduce el navegador por lotes (run_batch), sin depender de WP-Cron, que en muchos hosts no se ejecuta. Las acciones globales ya funcionan.
• Nueva vista en cuadrícula en la biblioteca (además de la lista), ideal para pantallas pequeñas. Se recuerda la preferencia.
• UI: títulos legibles en tema oscuro (se forzaba el color oscuro de wp-admin).

= 1.0.3 =

• Acciones masivas en la Biblioteca: "Optimizar todo", "Optimizar + IA (todo)" y "Generar textos IA (todo)".
• Nueva cola de IA independiente que detecta y reprocesa los activos sin texto, con reintentos automáticos (hasta 3) para tolerar límites de velocidad de la API.
• Barra de progreso de la cola visible también en la Biblioteca, con pausar/reanudar/detener.
• Indicador del estado de IA (✓ / ✕ / bloqueado) en cada fila de la tabla.

= 1.0.2 =

• IA: nueva generación del campo "Descripción" del adjunto (post_content).
• IA: nueva opción "Título con guiones (SEO)" que separa las palabras del título con guiones.
• Ambas opciones son configurables desde la pestaña IA & SEO.

= 1.0.1 =

• UI: corregidos los interruptores (toggles) que se mostraban rotos por un conflicto de especificidad CSS.
• UI: el panel ahora es un contenedor flotante con márgenes (ya no queda pegado al borde) y esquinas redondeadas.

= 1.0.0 =

• Versión inicial: pipeline WebP/AVIF/PNG/SVG, IA multimodal con moderación, colas asíncronas, rollback y panel SPA.