Description
KXNotes Image Paste Optimizer streamlines image preparation for WordPress tutorial writers, independent bloggers, and content publishers.
It focuses on a repetitive part of writing: saving a screenshot, resizing it, converting it to a web-friendly format, renaming it, uploading it to the Media Library, adding alt text, and inserting it into the post.
After activation, you can paste or drag images directly into the Gutenberg editor. The plugin can:
- Detect clipboard screenshots and local image files.
- Resize images to a configured maximum width, with a default of 1200 pixels.
- Output WebP by default, with optional AVIF, JPEG, or original-format output.
- Upload processed images to the WordPress Media Library.
- Generate readable file names from the post title or nearest preceding heading.
- Fill image alt text automatically.
- Insert the image at the current editor position.
- Accept image drops on the Featured Image control.
- Process local uploads from an Image block.
- Import a remote Image block URL into the Media Library.
Who is it for?
- Authors who regularly write software, website, plugin, or workflow tutorials.
- Bloggers who frequently capture administration screens, websites, tools, or applications.
- Publishers who want to reduce manual image compression, renaming, and alt-text work.
- Site owners who prefer local processing without a required third-party cloud service.
Privacy and external services
The plugin does not send images to a third-party server by default. It does not call an AI service, perform remote telemetry, or collect site URLs, post titles, image contents, or usage data.
Clipboard images and locally dragged files are processed in the current browser and then uploaded to your WordPress Media Library.
When you enter a remote image URL in an Image block and the browser cannot read that image directly, the plugin asks your own WordPress site to download and process the image through its REST endpoint. This request occurs only after you actively provide a remote image URL.
File names and alt text
The plugin provides two file-name modes:
- Pinyin slug: a predictable offline option for Chinese post titles.
- Local English slug: uses a bundled terminology map and falls back to Pinyin when it cannot make a reliable match.
Alt text uses the post title or nearest preceding heading and includes an image sequence number by default.
Installation
- In WordPress Admin, go to Plugins > Add Plugin > Upload Plugin.
- Upload
kxnotes-image-paste-optimizer.zip. - Activate KXNotes Image Paste Optimizer.
- Go to Settings > KXNotes Image Paste Optimizer and review the default configuration.
- Create or edit a post in Gutenberg.
- Copy a screenshot and paste it into the post content.
FAQ
-
Does the plugin send my images to a third-party server?
-
No. The default paste, drag-and-drop, and local upload workflows operate between your browser and your WordPress site. They do not use a third-party compression, AI, or analytics service.
-
Is AVIF always available?
-
No. AVIF support depends on the browser, WordPress version, and server image library. If AVIF processing fails, the plugin can fall back to WebP, JPEG, or the original format.
-
Does it support the Classic Editor, Elementor, or Divi?
-
The current version focuses on Gutenberg. Compatibility with third-party editors is outside the scope of the 0.1.x releases.
-
Why are some file names Pinyin while others are English?
-
Pinyin is the default mode. You can switch to Local English slug in the settings. Local English mode uses only its bundled terminology map and conservative local rules. It falls back to Pinyin when no reliable English mapping is available.
-
What does uninstalling the plugin delete?
-
The
uninstall.phpfile removes the plugin settings. It does not delete images that have already been uploaded to the Media Library.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“KXNotes Image Paste Optimizer” is open source software. The following people have contributed to this plugin.
Contributors
Translate “KXNotes Image Paste Optimizer” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.1.4
- Renamed the plugin to KXNotes Image Paste Optimizer with the new
kxnotes-image-paste-optimizerrelease slug. - Replaced generic PHP, JavaScript, settings, script, filter, error-code, and REST identifiers with the unique
kxipoprefix. - Removed an unused WordPress media dependency and limited core file loading to the functions that require it.
0.1.3
- Fixed paste and local-image drop handling inside the modern Gutenberg iframe canvas.
- Added reliable clipboard file fallback and prevented duplicate native paste handling.
- Added drag-and-drop replacement for existing Image blocks.
- Preserved the exact RichText caret position when inserting a pasted image into a paragraph.
0.1.2
- Prepared the initial WordPress.org release metadata and directory layout.
- Replaced direct temporary-file deletion with the WordPress file API.
- Added direct-access protection and WordPress-native text sanitization.
- Added the License and readme files to the WordPress.org submission package.
0.1.1
- Added optimized screenshot pasting in Gutenberg.
- Added local image drag-and-drop into post content.
- Added drag-and-drop support for the Featured Image control.
- Added local uploads from an Image block.
- Added remote Image block URL imports.
- Added WebP, AVIF, JPEG, and original-format output.
- Added Pinyin file names generated from Chinese titles and headings.
- Added a local English slug mode.
- Added automatic alt text.
- Added permission, file-size, and MIME validation for remote URL imports.