安装适用于 WordPress 的 Alter Product 插件

开始之前

将 Alter Product 作为 WordPress 插件安装。该插件需要已安装并启用的 WooCommerce 来管理商店的产品、变体、购物车和订单。

安装插件前，请确保你的网站满足最低要求：

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

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

必须启用固定链接

必须在 WordPress 中启用固定链接。请前往：

WordPress Admin Panel → Settings → Permalinks

如果 Customizer、Configurator 或 Viewer 页面显示未找到，请打开此设置页并点击保存更改来刷新固定链接。

将 WooCommerce 连接到 Alter Product（视频）

按照 YouTube 分步教程安装 WordPress 插件，将您的 WooCommerce 商店连接到 Alter Product，并设置第一个可供顾客个性化定制的商品。

插件安装与账户连接

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

插件设置完成后

在 WordPress 中配置好插件后，你可以：

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

开箱即用的 WordPress AWS S3 存储

插件还内置了私有 AWS S3 存储。请查看存储桶和 IAM 设置、连接测试及迁移步骤。AWS 使用费用单独计费。

故障排查

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