Pictomancer Image Optimizer

Pictomancer Image Optimizer automatically compresses the images you upload to WordPress using the Pictomancer.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.
• 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

This plugin relies on one external service to function: the Pictomancer.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.

What is sent and when: once optimization is enabled, each time an image is optimized (on upload or when WordPress generates thumbnail sizes), the image bytes are sent to the API endpoint (https://api.pictomancer.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.

This service is provided by Pictomancer.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

The admin interface bundle (build/pictomancer-admin.js) is compiled from React and TypeScript sources with Vite. The complete, human-readable source and the build tooling are publicly available at:

https://github.com/pictomancer/plugin-wordpress

To rebuild the bundle from source:

1. Install dependencies: yarn install
2. Build: yarn build

This regenerates build/pictomancer-admin.js.