Ninja Media – Media Library Folders

Description

Ninja Media is a Media Library Folder Management Plugin. It gives you the power to create an unlimited folder tree, drag and drop files to organize them, search and paginate through thousands of files, and manage everything from your traditional media library, not need to jump anywhere.

Folder Management

🔗 Official Website Link: Official Website
🔗 Join Our FB Community: Plugininja Facebook Group

• Create, rename, and organize folders in Media Library.
• Drag and drop files between folders.
• Move folders to any position in the tree.
• Sort folders by name, date, or custom order
• Visual tree with breadcrumb navigation and expand/collapse
• The Uncategorized view collects all files not yet assigned to a folder

Media Browser

• Browse media organized by folder with pagination (up to 200 files per page)
• Search media and folders by name
• Bulk-select files for batch operations
• Context menu — right-click any file or folder for quick actions

SVG Support

• SVG upload support
• Automatic sanitization strips potentially harmful markup before saving

Upload & Image Controls

• Set a custom maximum upload file size, independent of the server default
• Configure WordPress’s large-image scaling threshold
• Automatically generate all registered thumbnail sizes on upload

Settings

• Export and import your full configuration as a JSON file
• Auto-save — changes are saved automatically as you make them

Developer & Integration

• Full REST API for all folder and media operations
• Filter and action hooks around every significant operation
• Properly enqueued assets, nonces, capability checks, and sanitized I/O throughout

Pro Version

WebP Conversion (Pro)

• Automatically convert JPEG and PNG uploads to WebP format
• Reduces file size and improves page-load performance

Post-Type Folders (Pro)

• Organize posts, pages, and any public custom post type into their own independent folder trees
• Works alongside the media folder system — each post type has its own sidebar and folder tree
• Assign posts to folders from the standard WordPress admin list screens
• Supports third-party post types (Tutor LMS courses and more)
• Control which post types show folder panels from the Settings screen

Download Folders as ZIP (Pro)

• Export any folder (or multiple folders) as a ZIP archive
• Preserves original folder structure inside the archive
• Download link is returned immediately for direct browser download

Replace Media (Pro)

• Swap any attachment with a new file
• Preserves the original attachment ID, URL, metadata, folder assignments, and all post relationships — existing links and embeds keep working

Watermarks (Pro)

• Apply text or image watermarks automatically on upload or in bulk to existing media
• Text watermarks: choose font family (including custom uploaded fonts), size, color, bold/italic, rotation, and opacity; supports {site_name} placeholder
• Image watermarks: set position, scale percentage, opacity, and tile pattern (horizontal/vertical spacing, diagonal)
• Restore original files at any time from the built-in backup stored in /uploads/pnpnm-originals/
• Apply to all registered thumbnail sizes, full size only, or a custom selection
• Advanced conditions: filter by image dimensions, file size, allowed extensions, user role, and post type

Custom Watermark Fonts (Pro)

• Upload your own TTF, OTF, WOFF, or WOFF2 font files
• Manage and delete uploaded fonts from the Watermark settings panel

Favorites (Pro)

• Star any media item to add it to your personal Favorites collection
• Favorites are per-user and persist across sessions

Duplicate Media (Pro)

• Create an exact copy of any media file with a single click
• Auto-generates a unique filename (filename-copy.ext, filename-copy-1.ext, etc.)
• Carries over all post meta to the new attachment

Trash & Restore (Pro)

• Send media to a soft-delete Trash bin instead of deleting permanently
• Browse all trashed files in the dedicated Trash view
• Restore files to their original folder at any time
• Permanently delete individual or all trashed files when ready

Unused Media Detection (Pro)

• Automatically identifies media files not referenced in any post or page
• The Dedicated Unused Files view lists every orphaned attachment
• Remove unused files in bulk, with an option to move them to Trash first

Dynamic Folders (Pro)

• Smart virtual folders that group media automatically by file type/extension
• No manual sorting required — files appear in their dynamic folder the moment they are uploaded

Theme Selection (Pro)

• Choose from four visual styles: Default, Bold, Plugininja, or Beautiful

Media Details on Hover (Pro)

• Show file name, type, and size as a tooltip when hovering over a media item in the grid

Show Folder ID (Pro)

• Display the numeric folder ID in the topbar and More menu for developer reference

Folder Color Picker (Pro)

• Assign a custom hex color to any folder for visual organization in the tree

Third Party / External Services

This plugin uses Freemius (https://freemius.com) as its licensing and update management platform. Freemius may collect and transmit data to its servers in the following situations:

Free version: When the plugin is activated, Freemius displays an optional opt-in dialog. If the site administrator opts in, the following data may be sent to Freemius servers:

• Site URL and admin email address
• WordPress version, PHP version, and server environment
• Plugin version and activation status

Opting in is not required to use the plugin. If you skip or decline, no data is sent.

Pro version: When a Pro license is active, Freemius communicates with its servers to validate the license and check for updates. The following data is sent:

• License key and activation status
• Site URL
• WordPress and plugin version
• Freemius Website: https://freemius.com
• Freemius Terms of Service: https://freemius.com/terms/
• Freemius Privacy Policy: https://freemius.com/privacy/

Privacy Policy

This plugin integrates Freemius for license management and optional usage tracking. If the site administrator opts in to sharing data during plugin activation, non-personal diagnostic information is transmitted to Freemius. No visitor or user data is ever collected.

For full details, see the Third Party / External Services section above
and the Freemius Privacy Policy at https://freemius.com/privacy/

Contributors

This plugin is developed and maintained by:

• Plugininja — Lead development and architecture
• Abdullah Arham — Core development and feature implementation

Contributions, bug reports, and feature suggestions are welcome on GitHub: https://github.com/plugininja/ninja-media