Description
NinjaWeb Smart Media Optimizer is a local media optimization engine for WordPress site owners, maintainers, and agencies who want controlled image processing without relying on an external optimization service.
The plugin runs inside WordPress using the image tools available on your server. There are no API keys, no credits, no monthly image caps, no required CDN, and no subscription gate for the core workflow. You control when images are scanned, queued, optimized, retried, and restored.
The workflow is designed for transparency. Instead of hiding the process behind a remote service, the plugin provides a real-time Media Engine panel with progress, current job details, live activity logging, pause/resume/stop controls, failed-item retry, and clear restore options when backups are available.
Key features:
- Local optimization using your WordPress/server image tools
- No external API, no credits, no CDN dependency, and no required subscription
- Real-time bulk optimizer with progress, pause, resume, stop, retry, and live activity log
- Optimize used images, all pending images, the full Media Library, or selected images
- Usage-aware scanner for featured images, galleries, common content embeds, and upload URLs
- Local WebP generation for JPEG and PNG images when supported by the server
- Search and filter Media Library images from one screen
- Oversized-image detection based on your configured maximum width
- Compression presets with simple guidance
- Custom quality mode for advanced control
- Maximum-width resizing for large uploads
- Optional minimum file-size threshold so tiny images can be skipped
- Optional PNG to JPG conversion modes for non-transparent PNG files, disabled by default
- Transparent PNG protection
- Backup originals before changes
- Restore selected images or restore all originals when backups exist
- Original Kept status when optimization would not reduce the file size
- Regenerate WordPress attachment metadata after changes
- Preserves attachment IDs instead of replacing posts or breaking relationships
- Global dashboard stats for total images, optimized images, pending images, backups, and optimized media size saved
NinjaWeb Smart Media Optimizer is intentionally built for a deliberate, auditable workflow rather than remote black-box processing.
Official documentation, updates, and support:
Smart Media Optimizer by NinjaWeb
Screenshots
Installation
- Upload the plugin folder to
/wp-content/plugins/, or upload the ZIP through Plugins > Add New > Upload Plugin. - Activate the plugin through the WordPress plugins screen.
- Go to Media > NinjaWeb Smart Media Optimizer.
- Choose your compression mode and optimization settings.
- Scan, filter, and optimize selected, used, pending, or full-library images.
FAQ
-
Does it use an external API?
-
No. The plugin uses the image processing tools available in your WordPress/server environment.
-
Does it require image credits, a CDN, or a subscription?
-
No. The core optimizer runs locally. It does not require credits, an external CDN, or an account with a third-party image service.
-
Does it replace image URLs in posts?
-
No. It preserves the existing attachment ID and optimizes the underlying attached file. This keeps the normal WordPress media relationship intact.
-
What does Optimize Used Images do?
-
It builds a queue from images that appear to be used in content, including featured images, common content references, galleries, and upload URLs. This helps process the images that matter first.
-
Can I undo an optimization?
-
Yes. If backups are enabled and a backup exists for that image, you can restore selected originals or restore all originals from the plugin screen.
-
What does Original Kept mean?
-
It means the image was processed, but the optimized result did not produce a smaller file. The plugin kept or restored the original based on your settings.
-
Can it convert PNG files to JPG?
-
Yes, but PNG to JPG conversion is disabled by default. If enabled, transparent PNG files are protected, the attachment ID is preserved, and the plugin does not rewrite existing post URLs or misuse the attachment GUID.
-
Does it generate WebP files?
-
Yes. The plugin can generate local WebP versions for JPEG and PNG images when the server image library supports WebP generation.
-
Is it safe for existing sites?
-
The plugin is intentionally conservative. Backups are enabled by default, attachment IDs are preserved, and optimizations are controlled from the admin screen.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“NinjaWeb Smart Media Optimizer” is open source software. The following people have contributed to this plugin.
Contributors
Translate “NinjaWeb Smart Media Optimizer” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.2
- Fixed Smart Media Optimizer admin filter handling for Not Optimized and Failed views.
- Limited optimizer filters to supported JPEG, PNG, and WebP attachments to avoid non-image query overload.
- Avoided expensive usage scans during admin page load; used-image scans now run only when requested.
- Improved persisted failed-status handling and optimized media size saved wording.
- Corrected plugin package generation to include only runtime files in the WordPress upload ZIP.
- Added transactional optimizer commits with temporary files, generated-image validation, and rollback when metadata regeneration fails.
- Disabled PNG to JPG conversion by default for new installs and stopped GUID updates during conversion/restore paths.
- Migrated the old implicit PNG to JPG default to off on existing installs that had not recorded a settings version.
- Changed queue discovery to paged batches instead of loading entire attachment/content sets in one request.
1.0.1
- Fixed Media Library optimization filter handling.
- Added safe handling for legacy smo-* Media Library filter parameters.
- Scoped admin CSS to prevent WordPress admin Media Library display issues.
- Hardened admin filter request parsing and MIME/status validation.
1.0.0
- First public release.
- Local image optimization with no external API, no credits, and no CDN dependency.
- Added real-time Media Engine with progress, pause, resume, stop, retry, and live activity logging.
- Added Optimize Used Images, Optimize All Pending, Optimize Full Library, selected optimization, and failed-item retry workflows.
- Added local WebP generation for JPEG and PNG images when supported by the server.
- Added original backups, selected restore, and restore-all-originals workflows.
- Added compression presets, custom quality mode, maximum-width resizing, PNG to JPG options, and transparent PNG protection.
- Added usage-aware scanning for featured images, galleries, content references, and upload URLs.
- Added global dashboard stats for total images, optimized images, pending images, backups, and optimized media size saved.