安装说明 [WooCommerce]

开始之前

请确保你的店铺满足最低要求：

  • WordPress：6.4+
  • WooCommerce：6.0+（已安装并启用）
  • PHP：8.0+
  • 出于安全考虑，服务器必须启用 HTTPS / SSL
  • 需要 Alter Product 账户（将使用 Access Key + Access Token）

重要说明：插件在独立的 iframe 中运行 Customizer、Configurator 或 Viewer，因此不会修改 WooCommerce 的核心结账行为。

安装与设置步骤

  1. 登录 WordPress 管理后台。
  2. 在 WordPress 管理后台中，进入插件 → 安装插件，搜索 Alter Product – 3D Configurator for WooCommerce，安装并启用插件。* 可选：手动上传 ZIP 并启用。
  3. 在 WordPress 管理后台中打开 Alter Product，然后点击 Auto Connect 中的连接。* 可选的手动设置：在 Alter Product 的 API 设置页面创建 API 密钥，复制 Access Key 和 Access Token，然后在 嵌入设置中添加你的店铺域名。
  4. 按照显示的安装步骤完成配置。
  5. 创建第一个设计：进入 WooCommerce 产品编辑页面，在 Alter Product 选项卡中新建设计（或选择现有设计）。设计将映射到该产品。定义与 WooCommerce 产品匹配的变体，可按需启用 Customizer，然后保存项目。

设置完成后

配置完成后，你可以：

  • 管理素材，包括产品、变体、样机、图形库、徽标、设计模板、背景、环境和字体
  • 从 Alter Product 存储导入项目
  • 创建和管理产品设计
  • 在公开的 WooCommerce 商店页面或产品页面上显示所选电商工具的按钮
  • 在 WooCommerce 产品页面或 WordPress 页面上嵌入 Viewer / Configurator / Customizer
  • 将 WooCommerce 产品映射到 Alter Product 设计
  • 让客户个性化定制产品（文字、图像、布局、二维码等）
  • 将所选配置同步到 WooCommerce 购物车

故障排查

  • API 测试失败：请在 Alter Product → 状态中检查 Access Key / Access Token，以及服务器与 https://alterproduct.com/public-api 的连接。
  • 素材下载有问题：请进入 Alter Product → 状态，确保服务器满足服务器资源表中的要求。
  • iframe 空白／无法通信：请确保你的店铺域名已添加到 Alter Product 的电商设置 → 集成中，或检查服务器是否使用 HTTPS 和有效的 SSL 证书。
  • 固定链接问题：如果 Customizer、Configurator 或 Viewer 页面显示未找到，请进入设置 → 固定链接并点击保存更改，刷新重写规则。
  • 加入购物车无效：请确认产品映射已完成，且嵌入工具已启用电商操作。