WP Manifestindependent plugin directory
manifest / media / media-orphan-cleaner

Media Orphan Cleaner

Analiza y limpia archivos huérfanos en uploads desde una sola pantalla en Herramientas.

by SoyProgramador · github.com/soyprogramadorpe/media-orphan-cleaner

★ 1stars
0forks

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/soyprogramadorpe/media-orphan-cleaner/archive/refs/heads/main.zip
Readme github.com/soyprogramadorpe/media-orphan-cleaner ↗

Plugin para WordPress que detecta archivos huérfanos en wp-content/uploads y los limpia con un flujo organizado por pantallas en el admin.

Qué hace

  • Analiza disco vs Media Library (_wp_attached_file en postmeta).
  • Mantiene el flujo completo en una sola pantalla dentro de Herramientas.
  • Cambia textos automáticamente en español o inglés según el idioma de WordPress.
  • Ejecuta el análisis por AJAX con barra de progreso visual mientras carga.
  • Muestra resumen de huérfanos por carpeta (cantidad + espacio).
  • Permite seleccionar archivos huérfanos uno por uno o todos a la vez para eliminar.
  • Incluye validaciones de permisos y nonce para seguridad básica.

Estructura del plugin

  • media-orphan-cleaner.php: bootstrap principal del plugin.
  • includes/class-moc-plugin.php: inicialización y ensamblado de servicios.
  • includes/class-moc-admin.php: pantallas admin y acciones (admin_post).
  • includes/class-moc-orphan-scanner.php: lógica de escaneo de huérfanos.
  • includes/class-moc-orphan-deleter.php: lógica de eliminación por carpetas.

Instalación

  1. Copia la carpeta media-orphan-cleaner dentro de wp-content/plugins/.
  2. Entra a Plugins en WordPress.
  3. Activa Media Orphan Cleaner.

Uso

  1. Ve a Herramientas > Media Orphan Cleaner.
  2. En la misma pantalla, ejecuta Analizar (AJAX con barra de progreso).
  3. Revisa la lista de archivos detectados.
  4. En la sección de limpieza, marca archivos individuales o usa seleccionar todo.
  5. Haz clic en Eliminar seleccionados.

Recomendación importante (STG primero)

Antes de usar eliminación en producción:

  • Prueba siempre primero en un entorno staging (STG).
  • Realiza backup completo de archivos + base de datos.
  • Verifica que tus plugins/tema no estén usando archivos fuera de Media Library.
  • Tras eliminar en STG, valida frontend, productos, sliders y contenido multimedia.

Notas

  • El análisis se guarda temporalmente por 1 hora.
  • Después de eliminar, conviene ejecutar un nuevo análisis para confirmar el estado final.
  • El plugin omite carpetas comunes de sistema: cache, wc-logs, woocommerce_uploads.