1. 功能说明 (Feature Description)
本插件专为“特色图片”提供手术刀式的外链方案,实现“外链即附件”的深度集成。
-
零存储占用:图片通过远程 URL 映射,完全不下载到本地服务器,不消耗磁盘空间。
-
原生 UI 同步:保存外链地址后,插件会利用
wp.media.featuredImage.set自动同步更新 WordPress 右侧原生的“特色图片”面板,无需刷新页面。 -
双重路径拦截:同时拦截
wp_get_attachment_url(网页显示)和get_attached_file(系统路径),确保所有主题和 SEO 插件都能正确识别图片。 -
增强型探测:内置
getimagesize与wp_safe_remote_get双重探测逻辑,即使在限制严苛的服务器环境下也能准确抓取图片尺寸和类型。 -
智能查重:通过
_eezz_external_url标识进行数据库校验,防止同一个 URL 被重复导入而产生垃圾数据。 
2. 安装说明 (Installation Instructions)
-
文件部署:将插件文件夹上传至 WordPress 的
/wp-content/plugins/目录。 -
环境检查:建议使用 PHP 8.4+。确保服务器支持通过 PHP 访问外部网络地址。
-
激活插件:在 WordPress 后台“插件”菜单中找到 EEZZ URL 置顶 Image 并点击激活。
-
目录结构确认:
-
eezz-url-featured-image.php(入口) -
eezz-hooks.php(拦截器) -
eezz-processor.php(处理器) -
eezz-meta-box.php(控制器) -
eezz-admin.js(交互脚本)
-
3. 使用说明 (Usage Instructions)
A. 设置外链特色图片
-
在编辑“文章”或“页面”时,找到侧边栏下方的 “EEZZ 外链特色图片” 面板。
-
在输入框内粘贴图片的直连地址(URL)。
-
预览验证:粘贴后下方预览区域会立即显示图片(如果无防盗链限制)。
-
点击 “保存” 按钮。
-
同步反馈:保存成功后,WP 原生的“特色图片”面板会同步显示该图片,且上方会有“保存成功”的提示。
B. 移除外链特色图片
-
点击面板上的 “删除” 按钮。
-
安全提示:系统会提示确认,防止误操作。
-
一键解绑:确认后,系统会解除该附件与文章的关联,并同步清空原生特色图片面板。
C. 注意事项
-
探测失败:如果提示“图片探测失败”,请检查 URL 是否为真实的图片直连,或检查服务器是否存在防火墙拦截。
-
本地保护:如果当前文章已经设置了本地图片作为特色图片,使用本插件删除功能时会提示前往原生面板移除,以保护本地数据不被误操作。