KXNotes 图片粘贴优化器

描述

KXNotes 图片粘贴优化器可简化 WordPress 教程作者、独立博客作者和内容发布者的图片处理流程。

它解决了写作中的重复步骤:保存截图、调整大小、转换为适合网页的格式、重命名、上传到媒体库、添加替代文本,并插入文章。

启用后,你可以直接将图片粘贴或拖入 Gutenberg 编辑器。插件可以:

  • 识别剪贴板截图和本地图片文件。
  • 按照设置的最大宽度缩放图片,默认最大宽度为 1200 像素。
  • 默认输出 WebP,也可选择 AVIF、JPEG 或保持原始格式。
  • 通过统一的服务器端管线处理使用 WordPress 核心上传或侧载流程的新 JPEG、PNG、WebP 和 AVIF 文件;GIF 文件保持不变。
  • 覆盖特色图片按钮上传、媒体库上传,以及画廊、封面、媒体与文本等使用核心媒体 API 的区块。
  • 在创建附件元数据、缩略图或下游存储集成之前,完成尺寸调整和格式转换。
  • 遵循 WordPress 默认的中间图片策略,或仅生成选定的已注册尺寸。
  • 启用优化时,让 WordPress 7.1 编辑器上传继续走服务器端媒体路径,使格式转换、源文件备份和尺寸选择保持一致。
  • 在公开 Web 根目录之外保存随机命名的源文件备份,并为每个已处理附件记录带版本的处理状态。
  • 从源文件备份恢复附件,同时保持其当前 URL 和输出格式不变。
  • 根据文章标题或前面最近的小标题生成易读的文件名。
  • 自动填写图片替代文本。
  • 在编辑器当前光标位置插入图片。
  • 支持将图片拖放到“特色图片”控件。
  • 处理通过图片区块上传的本地图片。
  • 仅在编辑者明确确认后,才将远程图片区块的 URL 导入媒体库。

适用人群

  • 经常撰写软件、网站、插件或工作流教程的作者。
  • 经常截取管理后台、网站、工具或应用程序界面的博客作者。
  • 希望减少手动压缩图片、重命名和填写替代文本工作的内容发布者。
  • 希望在不依赖第三方云服务的情况下进行本地处理的站点所有者。

隐私与外部服务

插件默认不会将图片发送到第三方服务器,也不会调用 AI 服务、执行远程遥测,或收集站点 URL、文章标题、图片内容及使用数据。

剪贴板图片和本地文件会上传到您自己的 WordPress 站点,并在创建附件前于站内处理。启用源文件备份时,文件默认存放在公开 Web 根目录之外。再次选择媒体库中的现有项目时,不会重复处理。

远程图片区块绝不会自动发起网络请求,编辑者必须先确认导入操作。浏览器读取和服务器端回退下载都有严格的字节限制;服务器下载在进入图片处理管线前还会应用按用户锁定和速率限制。

文件名与替代文本

插件提供两种文件名模式:

  • 拼音别名:适用于中文文章标题,结果稳定且完全离线。
  • 本地英文别名:使用内置术语表;无法可靠匹配时回退到拼音。

替代文本默认使用文章标题或前面最近的小标题,并包含图片序号。

安装

  1. 在 WordPress 管理后台中,前往“插件”>“安装插件”>“上传插件”。
  2. 上传 kxnotes-image-paste-optimizer.zip
  3. 启用 KXNotes 图片粘贴优化器。
  4. 前往“设置”>“KXNotes 图片粘贴优化器”,检查默认配置。
  5. 在 Gutenberg 中新建或编辑一篇文章。
  6. 复制一张截图,然后将其粘贴到文章正文中。

常见问题

插件会把我的图片发送到第三方服务器吗?

不会。默认的粘贴、拖放和本地上传流程只在浏览器与 WordPress 站点之间运行,不使用第三方压缩、AI 或分析服务。

AVIF 是否始终可用?

不一定。AVIF 支持取决于浏览器、WordPress 版本和服务器图像库。如果 AVIF 处理失败,插件可以回退到 WebP、JPEG 或原始格式。

是否支持经典编辑器、Elementor 或 Divi?

当前版本专注于 Gutenberg,0.1.x 系列暂不考虑兼容第三方编辑器。

为什么有些文件名是拼音,有些是英文?

拼音是默认模式。你可以在设置中切换到“本地英文别名”。本地英文模式仅使用插件自带的术语表和谨慎的本地规则;无法可靠生成英文名称时,会回退到拼音。

卸载插件时会删除什么?

uninstall.php 文件会移除插件设置,但不会删除已上传的图片、处理元数据或受保护的源文件备份,以避免不可逆的数据丢失。

评价

此插件暂无评价。

贡献者及开发者

「KXNotes 图片粘贴优化器」是开源软件。 以下人员对此插件做出了贡献。

贡献者

「KXNotes 图片粘贴优化器」插件已被翻译至 1 种本地化语言。 感谢所有译者为本插件所做的贡献。

帮助将「KXNotes 图片粘贴优化器」翻译成简体中文。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

0.1.7

  • 为设置页面、上传管线、REST 错误和 Gutenberg 通知新增标准 WordPress 国际化支持。
  • 新增内置的 PHP 和 JavaScript 简体中文翻译,使中文站点不再依赖硬编码的界面文本。
  • 将源字符串改为英语,使 WordPress.org 能够为每个语言区域提取和管理翻译。

0.1.6

  • 启用优化时保留本插件统一的服务器端处理路径,从而兼容 WordPress 7.1 新增的客户端媒体处理管线。
  • 将 JavaScript 单元测试发现范围限定为源文件,避免本地发布副本或 WordPress.org SVN 副本遮蔽正在测试的软件包。

0.1.5

  • 导入任何远程图片区块前,必须由编辑者明确确认。
  • 为远程图片下载新增有界流式传输、按用户锁定、速率限制和批量限制。
  • 将新的源文件备份移到公开 Web 根目录之外,并拒绝使用公开备份路径。
  • 为 0.1.4 预发布开发版本创建的源文件备份新增经校验和验证的迁移流程。
  • 创建附件失败时移除已侧载的文件。
  • 新增发布时版本一致性检查,确保每个软件包只包含一个明确版本。

0.1.4

  • 将插件重命名为 KXNotes Image Paste Optimizer,并使用新的 kxnotes-image-paste-optimizer 发布别名。
  • 将通用的 PHP、JavaScript、设置、脚本、过滤器、错误码和 REST 标识符替换为独有的 kxipo 前缀。
  • 移除未使用的 WordPress 媒体依赖,并仅在需要相关函数时加载核心文件。

0.1.3

  • 修复现代 Gutenberg iframe 画布中的粘贴和本地图片拖放处理。
  • 新增可靠的剪贴板文件回退,并避免原生粘贴被重复处理。
  • 新增通过拖放替换现有图片区块。
  • 将粘贴图片插入段落时,精确保留 RichText 光标位置。

0.1.2

  • 准备首次发布所需的 WordPress.org 元数据和目录结构。
  • 将直接删除临时文件改为使用 WordPress 文件 API。
  • 新增直接访问保护,并使用 WordPress 原生文本清理函数。
  • 将 License 和 readme 文件加入 WordPress.org 提交包。

0.1.1

  • 新增在 Gutenberg 中粘贴并优化截图。
  • 新增将本地图片拖放到文章正文。
  • 新增将图片拖放到“特色图片”控件的支持。
  • 新增通过图片区块上传本地图片。
  • 新增远程图片区块 URL 导入。
  • 新增 WebP、AVIF、JPEG 和保持原始格式输出。
  • 新增根据中文标题和小标题生成拼音文件名。
  • 新增本地英文别名模式。
  • 新增自动替代文本。
  • 新增远程 URL 导入的权限、文件大小和 MIME 类型验证。