### [08.02.070 安装插件并按网站启用扩展](https://guaqi.com/docs/77642)

**Published:** 2026-09-11T02:31:01

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 瓜奇支持通过插件继续增加功能，并让同一后台下的不同网站选择各自需要的扩展。 例如，你可以…

[08 页面构建器](/docs-archive/1264) / [08.02 模块与展示](/docs-archive/1266)

## 一、这个功能能做什么

**瓜奇支持通过插件继续增加功能，并让同一后台下的不同网站选择各自需要的扩展。** 例如，你可以给品牌站增加新的页面模块，给帮助中心保留原有页面；以后需要新业务时，也可以安装适配瓜奇的插件或委托开发者制作扩展。

这里的插件包需要符合瓜奇的插件格式。普通 WordPress 插件、网页模板或随意压缩的文件，不能直接当作瓜奇插件安装。

### 插件机制可以扩展哪些地方

| 扩展能力 | 对网站有什么用 |
| --- | --- |
| 新增页面模块 | 在构建器中添加新的展示或交互模块，与现有模块组合页面 |
| 模块专属设置 | 插件可提供文本、开关、数字、选项、分类选择等设置，调整内容和表现 |
| 替换已有模块 | 适用插件可改变原模块的展示或数据处理方式，启用前应确认影响哪些页面 |
| 替换指定界面组件 | 适用插件可调整特定界面部件，不必重做整套网站 |
| 页头、页脚样式 | 插件可提供新的完整样式，在对应构建器设置中选择 |
| 新增表单类型 | 插件可增加自己的表单类型、编辑设置和前台展示方式 |
| 扩展页面类型 | 适用插件可以声明自己的列表、详情或分类页面，承载新的内容业务 |
| 后台与前台联动 | 一个插件包可以同时提供 WordPress 后台处理、网站服务和页面组件 |
| 复用网站交互 | 按适配情况接入登录状态、支付弹窗等现有能力，让新业务与网站连接 |
| 多语言展示 | 插件可以携带语言文件；实际支持哪些语言取决于插件提供的翻译 |
| 按页面使用资源 | 页面加载实际用到的插件组件资源，减少无关模块资源的传输 |

这些是插件系统支持的扩展方式。每个插件具体提供哪些能力，需要查看该插件的说明；安装一个插件不会自动获得表中的全部能力。

### 安装与网站管理

| 操作或信息 | 功能与效果 |
| --- | --- |
| 选择插件 ZIP、安装插件 | 上传开发者提供的安装包，在后台统一管理 |
| 名称、说明和版本 | 识别安装的是哪个插件、哪个版本，以及它的用途 |
| 包含 WordPress 功能 | 提醒该插件除了前台组件，还包含后台处理能力 |
| 启用到以下网站 | 为每个前端网站分别打开或关闭插件 |
| 已启用网站数量 | 查看同一插件被多少个网站使用 |
| 网站同步状态 | 区分已启用、未启用、等待网站上线、启用失败或停用失败 |
| 重试  | 对失败或等待同步的网站重新尝试操作 |
| 同步全部网站 | 按后台保存的插件配置重新同步各网站 |
| 更新安装包 | 上传同一插件的新包，原来启用它的网站会进入更新流程 |
| 停用  | 关闭指定网站的插件功能，便于暂停使用或排查问题 |
| 从此网站删除 | 删除指定网站上的插件文件，其他网站不受此操作影响 |
| 删除插件 | 从 WordPress 删除整个插件，并处理各网站上的删除同步 |

## 二、设置后会有什么效果

你可以使用同一后台管理多个功能组合不同的网站。A 网站启用某个扩展，B 网站保持未启用；两个网站仍由同一处管理安装包和启停状态。

正常的生产插件安装、启停和更新流程不需要重新打包整个前端或重启 Node 服务。操作后要看目标网站的同步状态，确认成功，再检查实际页面。网站离线时，后台保存操作不代表网站已经完成更新。

插件启用成功后，有些能力会直接接入对应流程；有些还需要在构建器中添加模块、选择样式，或在内容编辑页配置数据。只有启用，没有完成这些设置，页面未必会出现新内容。

各网站独立启停不等于插件业务数据天然独立。插件是否共用记录、支持哪些语言、如何限制用户和分类范围，还取决于具体插件的实现。

## 三、怎么使用

### 安装并启用

1.  在 WordPress 后台进入瓜奇的「插件管理」，点击「选择插件 ZIP」。
2.  选择适配瓜奇的安装包，点击「安装插件」。
3.  核对插件卡片上的名称、说明和版本。
4.  在「启用到以下网站」中，打开需要使用插件的网站开关。开关操作直接保存，不需要再点一次总保存。
5.  等待该网站显示「已启用」。出现等待或失败时，先恢复网站连接或处理错误，再点击「重试」。

### 在构建器中使用

打开目标网站的构建器，在「第三方模块」中查找插件提供的模块，添加后填写它要求的内容、分类或其他设置。如果插件提供的是页头、页脚样式或表单类型，应到对应设置入口选择，并非所有插件都在第三方模块列表里新增一项。

配置完成后保存页面，打开实际网址，检查桌面和手机显示，以及按钮、登录和相关业务操作。构建器预览可以使用插件提供的示例数据，预览中的订单、文章或统计示例不能当作网站的真实业务记录。

跨网站复制页面时，确认目标网站也启用了对应插件，并重新检查分类、文章、表单和语言。复制页面布局不会自动安装插件或复制全部业务数据。

### 更新插件

取得同一插件的新安装包，在插件管理中上传安装。原来启用该插件的网站会进行更新；逐个检查网站状态，再检查受影响的页面和设置。更新插件不表示它会自动兼容所有旧页面配置，涉及字段或业务变化时按插件升级说明处理。

### 暂停使用或删除

暂时不用时，先关闭对应网站开关。需要移除某个网站上的文件时，使用该网站旁菜单里的「从此网站删除」。不再使用整个插件时，使用插件卡片菜单中的「删除插件」。

删除前先处理仍在使用它的页面模块、样式或业务入口，避免页面继续引用已移除的功能。插件业务记录是否保留、如何清理，需要按该插件说明处理，不能把删除插件理解为自动撤销订单或清空所有数据。

网站离线时，删除可能仍有待同步项。网站恢复后，点击「同步全部网站」并检查结果。

## 四、常见问题

### 已经安装，为什么前台没有变化？

先看是否打开了正确网站的开关，以及该网站是否显示「已启用」。随后检查是否需要添加模块、选择样式、发布内容或填写插件要求的数据。

### 插件显示已启用，为什么某个网站仍然不能用？

插件卡片可能表示它已被部分网站使用。检查具体网址那一行的开关和同步状态，不能只看卡片顶部的总状态。

### 为什么构建器找不到模块？

核对构建器连接的网站、插件启用状态和同步结果，再刷新构建器。插件还可能只适用于指定页面类型，或只扩展表单、样式、后台流程，本身不提供可添加的页面模块。

### 为什么显示“等待网站上线后启用”？

后台已记录启用要求，但目标网站还没有完成同步。确认该网站服务恢复、后台能够连接它，再点「重试」或「同步全部网站」。

### 提示网站版本过旧、缺少插件管理接口怎么办？

检查 WordPress 端与前端程序是否为互相兼容的版本，先完成对应程序升级，再重试插件同步。反复上传同一个插件包不能补齐网站缺少的管理接口。

### 插件有中文，为什么切换英文后部分文字没有翻译？

网站启用英文不会自动替插件生成完整译文。确认插件是否提供英文语言文件，以及插件内容设置中是否填写了英文；必要时向插件提供方获取翻译支持。

### 可以把一个网站的插件配置直接复制给另一个网站吗？

可以复用适合的页面设置，但目标网站必须启用兼容插件，并检查内容范围、分类、语言和关联记录。按网站独立启停与业务数据是否共享，是两件需要分别确认的事。

### 能否为自己的业务定制插件？

可以。将需要增加的页面、字段、权限、业务流程、多语言和网站范围说明清楚，由开发者按瓜奇插件格式制作安装包。日常安装使用无需自行编写代码。

相关操作见[配置通用内容与运行时插件模块](/docs/77641)。



---