iMoon Studio MarketplaceDocs
Moonsweep Media Cleaner
WordPress pluginsPlugins de WordPress · FAQ

Moonsweep Media Cleaner

Answers about scanning with Moonsweep, what it finds, how the trash and restore work, settings and updates.

Respuestas sobre el análisis de Moonsweep, lo que encuentra, cómo funcionan la papelera y la restauración, los ajustes y las actualizaciones.

Version 1.1.0WordPress 5.8+PHP 7.4+Elementor · WPBakery · Block editor · Divi · WooCommerce · ACF

Safety firstLo primero, la seguridad

Will Moonsweep delete anything on its own?¿Moonsweep borra algo por su cuenta?

No. Never. Scanning only reads and changes nothing. Moonsweep removes a file only when you select it and press a button, and even then it goes to the Moonsweep trash first. It never empties the trash on its own.

No. Nunca. El análisis solo lee y no cambia nada. Moonsweep solo quita un archivo cuando tú lo seleccionas y pulsas un botón, y aun así va primero a la papelera de Moonsweep. Nunca vacía la papelera por su cuenta.

What happens when I press “Move to trash”?¿Qué pasa cuando pulso «Move to trash»?

The files move to a protected folder, /uploads/moonsweep-trash/, together with their thumbnails. For Media Library items, Moonsweep also saves the entry: title, caption, alt text, categories and its ID. The items disappear from your site and the Media Library, but nothing is erased.

Los archivos se mueven a una carpeta protegida, /uploads/moonsweep-trash/, junto con sus miniaturas. En los elementos de la biblioteca de medios, Moonsweep guarda también la entrada: título, leyenda, texto alternativo, categorías y su ID. Los elementos desaparecen de tu web y de la biblioteca, pero no se borra nada.

What if I select a file that is in use?¿Y si selecciono un archivo que está en uso?

Moonsweep warns you before moving it. Those pages will show a broken image or link until you restore the file. To go ahead you must tick I understand, move them anyway.

Moonsweep te avisa antes de moverlo. Esas páginas mostrarán una imagen o un enlace roto hasta que restaures el archivo. Para seguir tienes que marcar I understand, move them anyway.

How do I put a file back?¿Cómo recupero un archivo?

Open the Trash tab and press Restore, or select several and press Restore selected. The files go back to their original folder and the Media Library entry is rebuilt as it was, with the same ID. If that ID has been taken in the meantime, the item comes back with a new ID and Moonsweep tells you.

Abre la pestaña Trash y pulsa Restore, o selecciona varios y pulsa Restore selected. Los archivos vuelven a su carpeta original y la entrada de la biblioteca se rehace como estaba, con el mismo ID. Si ese ID se ha ocupado mientras tanto, el elemento vuelve con un ID nuevo y Moonsweep te lo indica.

When are files really erased?¿Cuándo se borran de verdad los archivos?

Only when you press Delete permanently or Empty trash in the Trash tab and type DELETE to confirm. This cannot be undone, so make a backup of your site before a big clean-up.

Solo cuando pulsas Delete permanently o Empty trash en la pestaña Trash y escribes DELETE para confirmar. No se puede deshacer, así que haz una copia de seguridad de tu web antes de una limpieza grande.

I moved files to the trash but my disk space is the same.He movido archivos a la papelera pero el espacio en disco sigue igual.

That’s expected. The trash is a folder on your own server, so the files still take up space while they wait there. Space is freed when you delete them permanently or empty the trash.

Es normal. La papelera es una carpeta de tu propio servidor, así que los archivos siguen ocupando espacio mientras esperan ahí. El espacio se libera cuando los borras definitivamente o vacías la papelera.

ScanningAnálisis

How do I start?¿Cómo empiezo?
  1. Go to Media › Moonsweep Cleaner.
  2. Press Scan now.
  3. Review each tab, select what you want to remove and press Move to trash.
  1. Ve a Media › Moonsweep Cleaner.
  2. Pulsa Scan now.
  3. Revisa cada pestaña, selecciona lo que quieras quitar y pulsa Move to trash.
What does Moonsweep find?¿Qué encuentra Moonsweep?
  • Unused: Media Library items no page, post, page-builder layout, widget, menu or theme setting uses.
  • Not in library: files inside /uploads that WordPress doesn’t list, left over by deleted plugins, failed uploads or FTP copies.
  • Duplicates: identical files uploaded more than once.
  • Broken: library entries whose file no longer exists, which show as blank images.
  • Unused: elementos de la biblioteca que no usa ninguna página, entrada, diseño de constructor, widget, menú ni ajuste del theme.
  • Not in library: archivos dentro de /uploads que WordPress no tiene en la lista, restos de plugins borrados, subidas fallidas o copias por FTP.
  • Duplicates: archivos idénticos subidos más de una vez.
  • Broken: entradas de la biblioteca cuyo archivo ya no existe y que se ven como imágenes en blanco.
How does Moonsweep decide that a file is used?¿Cómo decide Moonsweep que un archivo está en uso?

It reads posts, pages, custom post types, page-builder data (Elementor, WPBakery, Gutenberg, Divi…), custom fields such as ACF and Meta Box, WooCommerce galleries and category images, menus, widgets, theme settings, and term and user fields. A file counts as used if its Media ID or its file name appears anywhere there. When in doubt, it counts as used.

Lee entradas, páginas, tipos de contenido personalizados, datos de constructores (Elementor, WPBakery, Gutenberg, Divi…), campos personalizados como ACF y Meta Box, galerías e imágenes de categoría de WooCommerce, menús, widgets, ajustes del theme y campos de términos y usuarios. Un archivo cuenta como usado si su ID de medio o su nombre de archivo aparece en cualquiera de esos sitios. En caso de duda, cuenta como usado.

Is there anything Moonsweep can’t detect?¿Hay algo que Moonsweep no pueda detectar?

Yes. It can’t see images written directly inside theme files (PHP or CSS) or used by other websites. That’s why everything goes to the restorable trash first. Check your pages after a clean-up and empty the trash only when you are sure.

Sí. No ve las imágenes escritas directamente en archivos del theme (PHP o CSS) ni las que usan otras webs. Por eso todo va primero a la papelera restaurable. Revisa tus páginas después de una limpieza y vacía la papelera solo cuando estés seguro.

Will the scan time out on my shared hosting?¿El análisis se cortará en mi hosting compartido?

No. The scan runs in short steps, so it never hits the server’s time limit, even with thousands of files. You can keep working in another tab. If you leave the page, the scan pauses and continues when you come back. Press Stop to end it.

No. El análisis va por pasos cortos, así que nunca agota el tiempo límite del servidor, aunque haya miles de archivos. Puedes seguir trabajando en otra pestaña. Si sales de la página, el análisis se pausa y sigue al volver. Pulsa Stop para terminarlo.

What happens if I scan again?¿Qué pasa si vuelvo a analizar?

Scan again replaces the current results. Your ignored list and the trash are kept.

Scan again sustituye los resultados actuales. Tu lista de ignorados y la papelera se conservan.

Working with resultsTrabajar con los resultados

How do I clean up duplicates safely?¿Cómo limpio los duplicados sin riesgo?

In the Duplicates tab, each coloured group holds files with exactly the same content. Press Select extra copies: it selects the copies nobody uses and always keeps at least one per group.

En la pestaña Duplicates, cada grupo de color reúne archivos con exactamente el mismo contenido. Pulsa Select extra copies: selecciona las copias que nadie usa y siempre deja al menos una por grupo.

Can I keep a loose file instead of removing it?¿Puedo conservar un archivo suelto en lugar de quitarlo?

Yes. In Not in library, select it and press Add to Media Library. The file stays where it is and becomes a normal Media Library item. Files marked Linked appear in your content, so removing them may break a link.

Sí. En Not in library, selecciónalo y pulsa Add to Media Library. El archivo se queda donde está y pasa a ser un elemento normal de la biblioteca. Los archivos marcados como Linked aparecen en tu contenido, así que quitarlos puede romper un enlace.

How do I stop a file from being suggested again?¿Cómo evito que un archivo se vuelva a sugerir?

Select it and press Ignore. It moves to the Ignored tab and won’t be suggested in future scans until you press Don’t ignore.

Selecciónalo y pulsa Ignore. Pasa a la pestaña Ignored y no se volverá a sugerir en próximos análisis hasta que pulses Don’t ignore.

Does removing a broken entry delete a file?¿Quitar una entrada rota borra algún archivo?

No. A broken entry points to a file that no longer exists. Removing it only takes the empty entry out of the Media Library, and it also goes to the trash.

No. Una entrada rota apunta a un archivo que ya no existe. Quitarla solo saca la entrada vacía de la biblioteca de medios, y también va a la papelera.

Which tools help me review long lists?¿Qué herramientas me ayudan a revisar listas largas?

Grid and list views, search by file name, filters by type, and sorting by size, date or name. Select a page, a range with Shift + click, or all results. Export CSV saves any list. In Media › Library, list view, a Moonsweep column shows what the last scan found for each item.

Vista de cuadrícula y de lista, búsqueda por nombre de archivo, filtros por tipo y orden por tamaño, fecha o nombre. Selecciona una página, un rango con Mayús + clic o todos los resultados. Export CSV guarda cualquier lista. En Media › Library, vista de lista, la columna Moonsweep muestra lo que encontró el último análisis en cada elemento.

Settings & troubleshootingAjustes y solución de problemas

What can I change in the settings?¿Qué puedo cambiar en los ajustes?

In the Settings tab:

  • Safe mode for loose files: only looks for loose files in the year/month folders WordPress creates. Recommended.
  • Folders never scanned: one folder per line, relative to /uploads. Page-builder, cache and backup folders are already listed.
  • Count attached media as used: safer, but finds less.
  • Look for duplicates: makes the scan a little slower on large libraries.

Settings apply to the next scan.

En la pestaña Settings:

  • Safe mode for loose files: solo busca archivos sueltos en las carpetas de año/mes que crea WordPress. Recomendado.
  • Folders never scanned: una carpeta por línea, relativa a /uploads. Las carpetas de constructores, caché y copias de seguridad ya vienen en la lista.
  • Count attached media as used: más seguro, pero encuentra menos.
  • Look for duplicates: hace el análisis un poco más lento en bibliotecas grandes.

Los ajustes se aplican en el siguiente análisis.

A restore says a file “already exists”.Al restaurar dice que un archivo «already exists».

A new file with the same name now sits in the original folder. Moonsweep never overwrites it. Rename or remove that file first, then press Restore again.

Ahora hay un archivo nuevo con el mismo nombre en la carpeta original. Moonsweep nunca lo sobrescribe. Cambia de nombre o quita ese archivo primero y vuelve a pulsar Restore.

Moonsweep says the trash folder could not be created.Moonsweep dice que no se pudo crear la carpeta de la papelera.

Your server doesn’t let WordPress create folders inside /uploads. Ask your hosting to check the folder permissions. Until then, nothing is moved, so nothing is lost.

Tu servidor no deja a WordPress crear carpetas dentro de /uploads. Pide a tu hosting que revise los permisos de la carpeta. Mientras tanto no se mueve nada, así que no se pierde nada.

What happens if I uninstall Moonsweep?¿Qué pasa si desinstalo Moonsweep?

Scan results, settings and the ignored list are removed. If the Moonsweep trash still holds files, the trash is kept so nothing is lost. Reinstall Moonsweep to restore or erase them.

Se eliminan los resultados del análisis, los ajustes y la lista de ignorados. Si la papelera de Moonsweep aún tiene archivos, se conserva para que no se pierda nada. Reinstala Moonsweep para restaurarlos o borrarlos.

Updates & licenceActualizaciones y licencia

How do I get updates?¿Cómo recibo las actualizaciones?

Once, go to Settings › iMoon Updates, enter the email you used to buy Moonsweep and press Save email. From then on, new versions appear in Dashboard › Updates like any other plugin. Updates are free for life.

Una sola vez, ve a Settings › iMoon Updates, escribe el email con el que compraste Moonsweep y pulsa Save email. A partir de ahí, las versiones nuevas aparecen en Dashboard › Updates como cualquier otro plugin. Las actualizaciones son gratis para siempre.

I bought version 1.0.0 and I don’t see updates.Compré la versión 1.0.0 y no me salen actualizaciones.

Version 1.0.0 used an older update system. Download the latest zip from your account in the store and install it once from Plugins › Add New › Upload Plugin. If WordPress asks, choose Replace current with uploaded. Your settings, ignored list and trash are kept. After that, updates arrive on their own.

La versión 1.0.0 usaba un sistema de actualizaciones antiguo. Descarga el último zip desde tu cuenta en la tienda e instálalo una vez desde Plugins › Add New › Upload Plugin. Si WordPress pregunta, elige Replace current with uploaded. Tus ajustes, tu lista de ignorados y la papelera se conservan. Desde ahí, las actualizaciones llegan solas.

Is it a subscription?¿Es una suscripción?

No. You pay once and Moonsweep is yours, with every future update included. Your order comes with a licence certificate.

No. Pagas una vez y Moonsweep es tuyo, con todas las actualizaciones futuras incluidas. Tu pedido incluye un certificado de licencia.

Didn’t find your answer?¿No encuentras tu respuesta?

Email us with your order number and the version you use. We answer every message.

Escríbenos con tu número de pedido y la versión que usas. Respondemos todos los mensajes.