=== Media Date Cleaner ===
Contributors:      seostar
Tags:              media, library, bulk delete, attachments, cleanup, images, media cleaner
Requires at least: 5.0
Tested up to:      6.9.4
Requires PHP:      7.4
Stable tag:        3.0.0
License:           GPL-2.0+
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Borra imágenes de la biblioteca de medios en lote filtrando por mes y año. Exactamente igual que hacerlo desde la biblioteca, pero sin límites.

== Description ==

**Media Date Cleaner** es un plugin desarrollado por [Seostar Agency](https://www.seostar.es) que permite borrar imágenes de la biblioteca de medios de WordPress en lote, filtrando por mes y año, de forma ilimitada y sin timeouts.

Hace exactamente lo mismo que seleccionar imágenes en la biblioteca y pulsar "Borrar permanentemente":

* ✅ Elimina el registro de la base de datos (`wp_posts`)
* ✅ Elimina todos los metadatos asociados (`wp_postmeta`)
* ✅ Elimina el fichero físico original del disco
* ✅ Elimina todas las miniaturas generadas por WordPress
* ✅ Elimina el directorio del mes si queda vacío
* ✅ Procesa en lotes AJAX para evitar timeouts
* ✅ Muestra una barra de progreso en tiempo real
* ✅ Log detallado de cada operación
* ✅ Resumen final con espacio liberado

**¿Para qué sirve?**

WordPress limita cuántas imágenes puedes borrar a la vez desde la biblioteca porque todo se procesa en una sola petición HTTP. Con muchas imágenes o imágenes grandes, el servidor agota el tiempo o la memoria y solo borra unas pocas.

Media Date Cleaner resuelve esto procesando el borrado en lotes pequeños mediante AJAX, de forma que puedes borrar cientos de imágenes de un mes/año concreto sin ningún problema.

**Desarrollado por [Seostar Agency](https://www.seostar.es)**

Seostar Agency es una agencia de SEO y desarrollo WordPress especializada en rendimiento web, posicionamiento y soluciones a medida.

== Installation ==

1. Sube la carpeta `media-date-cleaner` al directorio `/wp-content/plugins/`
2. Activa el plugin desde el menú "Plugins" en WordPress
3. Ve a **Medios → 🗑️ Limpiar por Fecha**

== Frequently Asked Questions ==

= ¿Esto borra solo los ficheros o también los registros de la base de datos? =

Hace lo mismo que borrar desde la biblioteca de medios: elimina el registro de BD, todos los metadatos y todos los ficheros físicos (original + miniaturas). Es un borrado completo.

= ¿Puedo deshacer el borrado? =

No. El borrado es permanente, exactamente igual que desde la biblioteca. Usa la vista previa antes de confirmar y haz una copia de seguridad si tienes dudas.

= ¿Las imágenes siguen apareciendo en la biblioteca después de borrarlas? =

No, al usar `wp_delete_attachment()` los registros se eliminan de la base de datos, por lo que desaparecen de la biblioteca inmediatamente.

= ¿Funciona con imágenes almacenadas en CDN o servicios externos? =

El plugin usa la función estándar de WordPress `wp_delete_attachment()`, que respeta los hooks de plugins de offload (WP Offload Media, etc.). Si tienes un plugin de offload activo, debería borrar también la copia en la nube.

= ¿Qué pasa si una imagen está siendo usada como imagen destacada? =

El plugin lo indica en la vista previa con el badge "En uso". Las borrará igualmente si confirmas, por lo que revisa la vista previa antes de proceder.

= ¿Afecta al rendimiento del servidor? =

No. El proceso se realiza en lotes pequeños (3, 5 o 10 imágenes) mediante AJAX. Cada lote es una petición independiente, evitando timeouts y sobrecarga.

== Screenshots ==

1. Panel principal con selector de mes/año y barra de progreso
2. Vista previa de imágenes a eliminar con indicador de uso
3. Log en tiempo real durante el borrado
4. Resumen final con espacio liberado

== Changelog ==

= 3.0.0 =
* Reescritura completa
* Usa `wp_delete_attachment()` igual que la biblioteca de medios
* Borra BD + metadatos + ficheros físicos en una sola operación
* Log detallado por imagen
* Resumen final con espacio liberado y directorios eliminados
* Sin recarga automática al finalizar
* Indicador de imágenes en uso en la vista previa

= 2.0.0 =
* Añadido modo diagnóstico de rutas
* Mejorado el sistema de progreso
* Corregido el problema de recarga automática

= 1.0.0 =
* Versión inicial

== Upgrade Notice ==

= 3.0.0 =
Versión recomendada. Ahora borra correctamente BD, metadatos y ficheros físicos igual que la biblioteca de medios nativa de WordPress.

== Additional Info ==

Desarrollado con ❤️ por **Seostar Agency**
🌐 [https://www.seostar.es](https://www.seostar.es)
