DevDome Media Cleaner abilities, governed through the Bridge

An agent can run a Media Library or disk scan, read the results, health summary, job progress, settings and error log, move or clean unused and orphan files to the Recycle Bin, restore or permanently delete batches, protect or ignore attachments, and create, restore or delete backup zips.

Abilities
2311 read2 write10 destructive
Active installs
200+
Rating
100% (2 ratings)
Version
1.1.1
Requires
WP 6.0+, PHP 7.4+
Last updated
2026-09-22

What has to be true first

Requires WordPress 6.0 or newer for the plugin itself; the Abilities API needs WordPress 6.9+. Every ability checks the manage_options capability by default (filterable via devdsame_capability), and irreversible actions such as permanent delete or a protection downgrade require an explicit confirm flag.

  • The WordPress Abilities API functions (wp_register_ability, wp_register_ability_category) must exist (WordPress 6.9+)

The 23 DevDome Media Cleaner abilities

Grouped by what each one can change. Every one starts off until you enable it.

Read 11

  • Read

    Get media health summary

    Returns the media health summary from the latest scans, including counts, cleanable bytes and job status.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-get-media-summary
  • Read

    List scan results

    Lists the files found by a media scan with filtering, sorting and pagination.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-list-scan-items
  • Read

    Get scan filter options

    Returns the upload months, mime types and folders present in a scan for use as filters.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-get-scan-filter-options
  • Read

    Get job progress

    Returns the progress of the currently running scan, cleanup, restore, delete or backup job.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-get-job-progress
  • Read

    List Recycle Bin batches

    Lists Recycle Bin batches with their source, file count, bytes and restore status.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-list-trash-batches
  • Read

    List files of a Recycle Bin batch

    Lists the files inside one Recycle Bin batch with their status and paths.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-list-trash-items
  • Read

    List media backups

    Lists backup zip archives with their scope, file count and size.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-list-backups
  • Read

    Get protected and ignored media

    Returns the attachments marked protected or ignored.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-get-protected-media
  • Read

    Get Safe Media Cleaner settings

    Returns every plugin setting, including protection rules, scan schedule and notification settings.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-get-settings
  • Read

    Get the error log

    Returns the last 50 errors recorded by media jobs.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-get-error-log
  • Read

    Get DevDome connection

    Returns whether the site is connected to a DevDome account, its plan, and which DevDome plugins are installed.

    Permission
    manage_optionsAdministrators
    MCP tool
    aafm-bridge-devdome-tools-get-connection

Write 2

  • Write

    Run a media scan

    Starts a Media Library or disk scan in the background without moving or deleting anything.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-run-media-scan
  • Write

    Create a media backup

    Creates a zip backup of Media Library images or orphan disk files in the background.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-create-backup

Destructive 10

  • Destructive

    Pause, resume or cancel the job

    Pauses, resumes or cancels the running media job, or dismisses the last error.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-control-job
  • Destructive

    Move chosen files to the Recycle Bin

    Moves chosen scan items to the Recycle Bin as one restorable batch.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-trash-media-items
  • Destructive

    Clean all unused media or all orphans

    Moves every item the latest scan classified as unused or orphan to the Recycle Bin in one batch.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-clean-unused-media
  • Destructive

    Restore a Recycle Bin batch

    Restores every file of one Recycle Bin batch to its original location and back into the Media Library.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-restore-trash-batch
  • Destructive

    Permanently delete a Recycle Bin batch

    Permanently deletes every file of one Recycle Bin batch and removes their attachment records; requires confirm true.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-delete-trash-batch
  • Destructive

    Clear the Recycle Bin batch list

    Removes finished (restored, deleted or empty) batches from the Recycle Bin list.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-clear-trash-history
  • Destructive

    Protect, ignore or release attachments

    Marks attachments as protected or ignored, or clears an existing mark.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-protect-media
  • Destructive

    Update Safe Media Cleaner settings

    Changes any plugin setting such as protection rules, scan schedule or notification settings.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-update-settings
  • Destructive

    Restore a media backup

    Restores missing files from a backup zip without overwriting files that already exist.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-restore-backup
  • Destructive

    Delete a media backup

    Deletes one backup zip and its record; requires confirm true.

    Permission
    Custom checkmanage_options (filterable)
    MCP tool
    aafm-bridge-devdome-safe-media-cleaner-delete-backup

How to switch these on

Four steps from two active plugins to a governed connection.

  1. Install DevDome Media Cleaner and Agent Abilities for MCP

    Both plugins need to be active on the same WordPress site. DevDome Media Cleaner registers its own abilities; this plugin discovers and governs them.

  2. Open the Other plugins screen

    In Agent Abilities for MCP, open the Bridge tab (labeled "Other plugins" in the admin). Abilities from every registered plugin appear there, grouped by the plugin that registered them.

  3. Enable one ability at a time

    Every ability from DevDome Media Cleaner starts off. Turn on only the ones you want an agent to reach, or enable the whole set in one click.

  4. Connect as a least-privilege user

    Approve the connection as a WordPress account scoped to what you actually want the agent to do. Each call still re-checks that account’s capability before it runs.

Read more in how bridging works or the full documentation.

Frequently asked questions

Does DevDome Media Cleaner work with the Bridge?

Yes. The plugin registers 22 fixed abilities covering every scan, Recycle Bin, backup and settings action, plus one read-only DevDome suite connection-status ability from its bundled shared core, all on the WordPress Abilities API init hook.

What has to be true for DevDome Media Cleaner's abilities to register?

The WordPress Abilities API functions (wp_register_ability, wp_register_ability_category) must exist (WordPress 6.9+).

Does DevDome Media Cleaner need anything special to work with the Bridge?

Requires WordPress 6.0 or newer for the plugin itself; the Abilities API needs WordPress 6.9+. Every ability checks the manage_options capability by default (filterable via devdsame_capability), and irreversible actions such as permanent delete or a protection downgrade require an explicit confirm flag.

More Media plugins

An agent can check an image's optimization status, quota and account plan, optimize or restore a specific media item, kick off a bulk optimization run, read or update Imagify's settings, and queue missing WebP/AVIF generation.

Media1M+ active installs
5 read2 write3 destructive
View abilities

An agent can list and read galleries, list gallery layouts and their setting schemas, search the media library for attachments, create a new gallery from attachment IDs, and update an existing gallery's settings, layout, or attachment list.

Media100K+ active installs
5 read1 write2 destructive
View abilities

An agent can add YouTube, Vimeo, or self-hosted videos to the media library, look up, update, or delete existing video records and their shortcodes, manage chapter markers, and read or change Presto Player's global settings.

Media100K+ active installs
6 read5 write2 destructive
View abilities

Verified from DevDome Media Cleaner's own free wordpress.org code on 28 September 2026, not from its marketing claims. Not every ability listed here has been run end to end against a live site. Plugin authors change their code, so a name, a capability, or a condition can be different in a later release. This site is not affiliated with, or endorsed by, DevDome or DevDome Media Cleaner. Back to the full directory.

Back to the plugin directory

Bridge DevDome Media Cleaner, keep the same control.

Every ability starts off, is scoped to the user you connect, and is written to the same audit log as core. Turn on only what you need.

Off by default. Capability checked on every call.