About this plugin
ai optimization API. Smaller images mean faster load times, reduced bandwidth, and better Core Web Vitals.
Optimization is off by default: the plugin makes no remote requests and no image data leaves your site until you explicitly enable it in the settings.
The plugin hooks into the standard WordPress upload flow, so it works with anything that creates media library attachments — the Media Library itself, WooCommerce product images, page builders, and so on.
Features
- Opt-in by design: optimization is disabled until you turn it on; nothing is sent anywhere by default.
- Automatic optimization on upload: once enabled, the original file and every generated thumbnail size are compressed through the API.
- Thumbnail control: limit optimization to the original upload from the settings if you prefer.
- Quality target (SSIM) mode: instead of a fixed quality value, the API picks the best quality automatically — the smallest file that still meets your visual similarity target. Costs slightly more per image; already-optimized images are returned untouched and free. Applies to JPEG, WebP and AVIF; other formats keep fixed quality.
- Safe by design: an optimized file is only kept when it is actually smaller than the input, and the pristine original_image WordPress keeps for regeneration is never touched.
- Regeneration friendly: if you regenerate thumbnails, the new sizes are re-optimized while the main file is never compressed twice (no generation loss).
- Dashboard: real accumulated savings (bytes and percentage) and live API health, right in wp-admin.
- Debug mode: optional logging to a protected, non-guessable file for troubleshooting.
- Configuration via constants: define PICTOMANCER_API_KEY (and optionally PICTOMANCER_API_URL ) in wp-config.php to keep secrets out of the database.
- Developer hooks: pictomancer_log action and pictomancer_debug_logging_enabled filter for custom workflows.
External services
ai image optimization API. This is the core service that performs the actual compression; without it the plugin cannot optimize your media.
No data is sent until you explicitly enable optimization in the plugin settings; it is off by default. While disabled, the plugin makes no remote requests at all.
ai by default, or the URL you configure in the settings) together with your API key, if you have set one, and the selected compression quality. The API returns the optimized image, which is saved in place. No data about your site’s visitors is collected or sent.
ai. By using the plugin you agree to its terms and privacy policy:
- Terms of Service: https://pictomancer.ai/terms
- Privacy Policy: https://pictomancer.ai/privacy
Source code
js) is compiled from React and TypeScript sources with Vite. The complete, human-readable source and the build tooling are publicly available at:
com/pictomancer/plugin-wordpress
To rebuild the bundle from source:
- Install dependencies: yarn install
- Build: yarn build
js.