安装插件并按网站启用扩展

08 页面构建器 / 08.02 模块与展示

先准备安装包和管理账号

瓜奇插件可以增加页面模块、页头页脚样式或其他业务功能。同一后台连接多个网站时，可以分别选择哪些网站启用插件。

进入瓜奇后台的插件管理区域。安装、启停和删除操作需要账号具备 WordPress 的管理设置权限（manage_options）；普通访客不能执行这些操作。

准备开发者提供的瓜奇插件 ZIP 包。安装包需要符合瓜奇插件格式，包含有效的 manifest.json。普通 WordPress 插件、网页模板或自行压缩的文件，不能直接当作瓜奇插件安装。

安装并启用到指定网站

1. 点击「选择插件 ZIP」，选中安装包，再点击「安装插件」。
2. 安装完成后，核对插件卡片上的名称、说明和版本。「包含 WordPress 功能」表示这个插件还带有后台处理代码。
3. 找到「启用到以下网站」，核对网址，再打开目标网站的开关。打开即启用，关闭即停用，不需要再点一次总保存。
4. 查看该网站这一行的同步结果。显示「已启用」后，再去网站检查实际功能。

卡片顶部的启用状态和网站数量用于查看整体情况。一个插件已经在 A 网站启用，不代表 B 网站也能使用；应以目标网址这一行的状态为准。

看懂同步状态

状态或提示	含义与处理方法
已启用、未启用	查看目标网站当前的启停结果，并到实际页面验证。
等待网站上线后启用、停用或删除	后台已保存操作，但网站还没有完成处理。恢复网站连接后点击「重试」。
等待网站确认启用或停用	当前同步结果还需要网站确认。查看提示中的同步时间，必要时重试。
启用失败、停用失败或删除失败	先按错误提示处理原因，再点击「重试」。
插件状态已同步，旧文件清理未完成	启停状态与旧文件清理是两个结果，仍需处理未完成的清理。
同步全部网站	按后台保存的配置重新同步各网站，完成后仍要检查是否有待重试项。

在页面中使用插件功能

插件启用后，是否还需要配置，取决于它提供的功能。页面模块通常还需要添加到构建器；页头页脚样式需要在对应位置选择；业务插件可能还要求填写内容或设置权限。

1. 打开目标网站的构建器。如果插件提供可添加的模块，在「第三方模块」中查找并添加。
2. 按模块要求填写文本、选项、分类或其他内容。插件提供哪些字段，以当前模块设置为准。
3. 如果插件提供页头或页脚样式，到相应设置中选择。只扩展后台流程、表单或其他界面的插件，未必会出现在模块列表中。
4. 完成设置后发布配置，再打开真实网址，检查桌面和手机显示，以及按钮、登录和相关业务操作。

构建器可以使用插件提供的示例数据。预览中的文章、订单或统计数字，不一定是网站的真实记录。

插件也可能替换已有模块或界面组件。启用前先查看插件说明，确认它会影响哪些页面。安装一个插件，不代表自动获得插件系统支持的全部扩展能力。

更新插件

1. 取得同一插件的新 ZIP 包，在插件管理区域重新上传安装。
2. 原来启用该插件的网站会进入更新流程。逐个检查同步状态，处理仍待同步或失败的网站。
3. 打开受影响的页面，检查模块设置、显示和业务操作。若升级说明要求调整旧字段或配置，按说明完成。

出现「插件文件缺失或无法读取」时，需要重新上传安装包修复，再打开网站开关。提示 ZIP 或 manifest.json 不正确时，应向插件提供方索取正确安装包。

停用或删除插件

操作	适用情况与范围
关闭网站开关	暂停该网站使用插件，或排查插件带来的问题。
从此网站删除	在该网站旁的菜单中操作，删除这个网站上的插件文件，其他网站不受此操作影响。
删除插件	在插件卡片菜单中操作，从 WordPress 删除插件，并处理各网站的删除同步。

删除前，先处理仍在引用插件的页面模块、样式和业务入口。删除插件是否保留业务记录，由具体插件决定，不能据此判断订单会撤销或数据会全部清空。

有网站离线时，WordPress 端删除完成后仍可能存在待同步项。网站恢复连接后，点击「同步全部网站」，检查删除是否完成。

找不到功能时怎么检查

• 安装后页面没变化：先确认正确网站已启用，再检查是否需要添加模块、选择样式或填写业务数据。
• 构建器没有模块：确认构建器连接的是目标网站，检查同步结果后刷新；再查看插件是否提供模块，以及是否限制页面类型。
• 提示网站版本过旧、缺少插件管理接口：升级对应网站程序，使前后台版本兼容，再重试。反复上传插件包不能补齐网站接口。
• 切换语言后文字没有翻译：检查插件是否提供对应语言文件，以及内容设置是否填写了译文。网站启用一种语言不会自动翻译插件全部文字。

跨网站复用页面时，目标网站也要启用兼容的插件，并重新核对分类、文章、表单和语言。按网站独立启停，不代表插件业务数据一定按网站隔离。

需要定制插件时，把页面、字段、权限、业务流程、语言和适用网站说明清楚，再由开发者制作符合瓜奇格式的安装包。

相关操作见配置通用内容与运行时插件模块。