WP Choosing Lenses 快速入门与使用指南

WP Choosing Lenses 为 WooCommerce 眼镜商品增加在线选镜片、填写处方、计算镜片价格并保存订单配镜信息的流程。

1. 使用要求

• WordPress 5.6 或更高版本。
• PHP 7.4 或更高版本。
• 已安装并启用 WooCommerce。
• 不需要安装 Codestar Framework 或其他自定义字段插件。
• 当前主题能够正常显示 WooCommerce 商品页和加入购物车区域。

2. 安装插件

1. 在 WordPress 后台进入“插件 > 安装插件 > 上传插件”。
2. 上传插件 ZIP 并完成安装。
3. 启用“WP Choosing Lenses”。
4. 启用时插件会自动创建处方和价格数据表。
5. 刷新一次固定链接设置，确保页面和接口路由可正常访问。

3. 创建镜片选择页面

1. 新建一个 WordPress 页面。
2. 将页面固定链接设置为 choosing-lenses。
3. 在页面内容中加入 shortcode：[wp-choosing-lenses-app]。
4. 发布页面。

商品页上的“Select Lenses”按钮会把顾客带到该页面，并附带当前商品和规格参数。不要随意修改这个固定链接。

4. 配置镜片价格

1. 在 WordPress 后台进入“镜片处方 > 价格配置”。
2. 为实际销售的镜片组合填写价格，包括经典透明、防蓝光、变色、太阳镜和阅读等用途。
3. 按 1.56、1.61、1.67、1.74 等折射率分别检查价格；需要区分颜色时可添加单独组合。
4. 确认需要销售的组合处于“已启用”状态，然后点击“保存价格”。
5. 从商品页完整走一遍选镜片流程，确认最后显示的镜片费用正确。

价格由顾客选择的镜片用途、折射率和颜色共同决定。某个组合没有配置或未启用时，前台价格为 0。

5. 配置眼镜商品

1. 编辑需要支持配镜的 WooCommerce 商品。
2. 在“商品数据 > 常规”中设置“镜框基础图片”，供选择流程展示商品底图。
3. 如果某个商品只销售镜框或不应显示配镜入口，启用“隐藏镜片选择入口”。
4. 对可变商品逐个检查颜色或其他变体。顾客必须先选定变体，系统才能把正确的规格编号带入配镜和购物车流程。

6. 顾客配镜流程

顾客通常按以下顺序完成购买：

1. 在商品页选择需要的商品变体。
2. 点击“Select Lenses”；如果只购买镜框，则点击“Frame only”。
3. 选择单光、渐进或无度数镜片。
4. 填写处方数据，或按页面提示上传处方图片。
5. 选择镜片用途、颜色和折射率。
6. 核对镜框价格、镜片费用和总价。
7. 加入购物车并完成结账。

购物车、结账页和订单项目会保存对应的配镜记录。后台查看订单时，可打开配镜详情，并直接进入管理页面编辑处方。

7. 管理处方记录

1. 在 WordPress 后台进入“镜片处方 > 处方记录”。
2. 可按处方名称、记录编号或订单编号搜索，也可按状态筛选。
3. 点击处方名称进入编辑页；可维护商品、订单、镜片参数、瞳距、费用、状态和处方图片。
4. 从 WooCommerce 订单项目点击“编辑处方”时，会直接进入对应的 SPA 编辑页。
5. 删除处方不会删除 WooCommerce 订单，但订单将无法继续打开这条处方详情，因此仅在确认不再需要时删除。

8. 数据存储说明

• 处方保存在 {数据库前缀}choosing_lenses_prescriptions。
• 价格保存在 {数据库前缀}choosing_lenses_prices。
• 插件启用或升级时通过 wenprise/wp-db-base 检查并创建数据表。
• 商品开关和镜框基础图片仍属于单个 WooCommerce 商品配置，因此继续使用商品 Meta 保存。
• 本版本不会读取或迁移旧的 lenses 自定义文章和 product_options 选项数据。

9. 日常检查

• 调整镜片价格后，用一个测试商品验证每个已启用组合。
• 修改商品变体后，验证“Select Lenses”按钮携带的是当前变体。
• 更新 WooCommerce 或主题后，验证商品页按钮、选择页面、加入购物车和订单详情。
• 不需要配镜的商品应启用“隐藏镜片选择入口”，避免顾客进入不适用的流程。