v1.1.0 — 产品色卡标签与图片放大功能升级

本次更新在 v1.0.0 的基础上，新增产品色卡标签和图片点击放大功能，优化前端响应式展示效果，并解决与 WordPress 主题及 Elementor 环境的兼容问题。

一、新增功能

1. Surface Label 标签

• 后台新增可选的单行文本标签字段。
• 支持填写 NEW、HOT 等自定义标签。
• 标签显示在图片左上角，距离顶部和左侧各 10px。
• 未设置标签时不显示角标。
• 保留原有 Surface ID、标题及图片数据。

2. 图片点击放大

• 点击色卡图片可弹窗查看媒体库原图。
• 支持关闭按钮、Esc 和点击遮罩关闭。
• 黑色半透明遮罩，无白色背景容器。
• 弹窗显示图片标题。
• 使用独立的轻量级 JavaScript，不依赖 Elementor、Swiper 或 Fancybox。

3. 前端布局优化

• 默认采用两列响应式布局。
• 支持通过 columns 参数自定义桌面端列数。
• 图片保持原始比例，不进行强制裁切。
• 色卡标题在图片下方居中显示。
• 兼容电脑端及移动端。

二、问题修复

• 修复 Elementor 环境下重复触发图片弹窗的问题。
• 修复主题全局按钮样式对色卡图片的影响。
• 优化 CSS 和 JavaScript 的缓存版本管理。
• 改善图片弹窗与现有主题的兼容性。

三、兼容性

• 保留 [wem_surfaces] Shortcode。
• 保留 wem_render_surfaces() PHP 调用函数。
• 不修改已有色卡的 ID、标题和图片关联。
• 新增标签字段不需要数据库迁移。
• 使用 WordPress 原生 CPT 和 Post Meta 存储数据。

四、文档更新

• 更新 README.md 使用说明。
• 更新 CHANGELOG.md 版本记录。
• 更新 TESTING.md 测试清单。
• 完善后台 Usage 使用示例。

五、版本说明

• 当前版本：v1.1.0
• 上一个稳定版本：v1.0.0
• WordPress：6.0+
• PHP：7.4+
• 发布类型：功能增强与兼容性优化

本版本已在实际 WordPress 产品页面完成主要前端功能测试，可作为下一阶段维护与开发的稳定基线。

v1.0.0 — 首个稳定版本：WordPress 产品表面色卡管理插件

首个正式稳定版本发布。

WEM Product Surfaces 是一款轻量级 WordPress 产品表面色卡管理插件，主要用于木塑（WPC）产品的表面纹理、花色和饰面图片展示，同时适用于其他产品的图片色卡管理。

插件采用独立 Surface Library 数据管理架构，通过唯一 Surface ID 调用图片，无需绑定特定产品内容类型，兼容 WordPress 页面、文章、自定义内容类型及 Elementor 编辑器。

核心功能

• 独立色卡管理：支持新增、编辑、删除和统一管理 Surface。
• 图片管理：支持媒体库上传、选择、替换和移除图片。
• 文件名识别：后台图片预览旁显示原始文件名，方便识别。
• Surface ID 调用：通过唯一 ID 指定需要展示的色卡。
• 全部色卡调用：无需指定 ID，即可显示所有已发布且图片有效的色卡。
• 响应式展示：图片保持原始比例，支持自定义桌面端列数。
• Elementor 兼容：支持通过 Shortcode 小工具插入色卡。
• PHP 模板调用：支持传统 WordPress 主题直接调用。
• Usage 使用指南：后台内置简码示例、PHP 示例及一键复制功能。

Shortcode 使用示例

显示全部色卡：

[wem_surfaces]

显示指定色卡：

[wem_surfaces ids="3310,3300"]

指定列数：

[wem_surfaces columns="4"]

组合调用：

[wem_surfaces ids="3310,3300" columns="2"]

技术特点

• 基于 WordPress 原生 CPT 和媒体库 API。
• 无需创建额外数据库表。
• 不依赖特定主题或产品 CPT。
• 不需要配置产品与色卡的关联关系。
• 统一数据查询与前台渲染逻辑。
• 支持按 Surface ID 的稳定顺序输出。
• 包含基础权限验证、数据校验及安全转义处理。

v1.0.0 版本完善

• 优化 Surface ID 参数验证。
• 加强后台图片文件名识别的异常处理。
• 完善 README、使用指南和测试文档。
• 保留 v0.1.4 已验证的核心功能和数据结构。

安装与升级

通过 WordPress 后台上传插件 ZIP 安装包并启用。

已有旧版本的用户可直接升级，无需重新创建 Surface 数据。

升级后建议检查 Surface Library、Usage 页面及 Elementor Shortcode 的显示效果。

---

版本： v1.0.0
发布类型： Stable Release
适用场景： 木塑产品表面样式、产品色卡、装饰纹理及饰面图片展示。