@gorgo/medusa-integration

中文文档
2.0.0发布于 2026/11/13MITTypeScriptESM + CJS构建来源已验证近 30 天下载 5748

美杜莎综合单元

中文使用文档
文档目录10 节
  1. 什么是整合模块
  2. 特征
  3. 可用的整合
  4. 支持社区
  5. 所需资源
  6. 安装
  7. 配置
  8. 环境变量
  9. 文档
  10. 许可证

Integration Module logo

美杜莎综合模块

文档
允许任何插件或提供商声明其选项并将管理员存储在管理器中的 Medusa 模块 medusa-config 编辑和不调用.
读取


Medusa Medusa npm version

Support Chat on Telegram

Medusa.js Chat on Telegram

Watch the Integration Module demo video

观看演示视频

什么是整合模块

集成模块允许任何插件声明其选项,并存储管理员配置为 整合 在管理者,没有 medusa-config 编辑和不调用。 该模块负责UI,存储,加密和验证.

集成模块对于任何需要可配置设置的美杜莎开发者建筑插件,提供者,或自定义模块都是有用的,例如API密钥,证书,模式,或webhooks,但谁宁愿不手建设置UI页面,数据层,以及每个模块的验证.

特征

  • 管理员设置管理 : 设置在 设置 − 集成 节,无 medusa-config/env 编辑和不调用.
  • 任何插件、 提供者或模块 : 工作涉及支付、实现、企业资源规划、通知、内容和其他扩展.
  • 声明说明defineIntegration: 对选项,设置部分,验证,和连接测试的单一描述.
  • 灵活打字和验证: 输入字段( O)string, (中文(简体) ), url, (中文(简体) ), email, (中文(简体) ), uuid, (中文(简体) ), number, (中文(简体) ), boolean, (中文(简体) ), enum, (中文(简体) ), json),具有每选项和截面规则,有条件的能见度,并只读字段. 在运行时,插件会得到一个被打出,被解密的对象. 不完全或被禁用的设置永远不会解析,所以插件永远不会得到未填充的草稿.
  • 加密机密 : 标记字段 secret 被加密(AES-256-GCM),永远不能到达浏览器.
  • 多个实例 : 同一提供者可以被配置不止一次. 例如,对于同一第三方服务中的若干账户.
  • 连接测试 : 对照第三方服务从行政主管处对证书进行核查.
  • 更改历史 : 模块记录了修改集成设置和时间的字段 。 您可以搜索并过滤管理员中的历史, 而秘密值永远不会到达它 .
  • 广泛的UI : 区段可以重新排序(布局计算器) (中文(简体) ). 如果生成的段落不够, 您可以使用自定义部件为您的选项执行任何 UI .
  • 整合目录 : 行政官从"高尔高目录"中展示了整合情况. 加上你的,做一个 拉请求。 。 。 .

可用的整合

ApiShip logo 飞船
履行 @gorgo/medusa-fulfillment-apiship (英语)

T-Kassa logo T银行的T-Kassa
付款 · 校对:soup

YooKassa logo 刘克萨
付款 · @gorgo/medusa-pay-yookassa (英语)

Robokassa logo 罗布卡萨
付款 · 校对:soup

Stripe logo 条纹
付款 · @gorgo/medusa-pay-stripe (英语)

PayPal logo 付费页
付款 · 校对:soup

Authorize.net logo 授权. net
付款 · 校对:soup

Mollie logo 摩利语Name
付款 · @gorgo/medusa-pay-mollie (英语)

1C logo 1C:企业
* ERP @gorgo-store/medusa-erp-1c (英语)

1C logo 1C: 企业目录
* ERP 校对:soup

任何插件都可以使用整合模块,参见 文档。 。 。 .

支持社区

有问题或想法吗? 加入Telegram 支持聊天 @gorgojs 聊天

在Telegram上与其他 Medusa 开发者连接 @medusajs 聊天

这个 维修 页面解释我们如何测试、更新和修正模块.

所需资源

  • 美杜莎 v2.21.0 或 后期
  • 节点.js v22.23.4或后(22.x),v24.22.1或后(24.x),或v26.12.1或后

安装

yarn add @gorgo/medusa-integration
# or
npm install @gorgo/medusa-integration

配置

将模块注册到 medusa-config.ts 与您安装的插件的提供者, 例如 T- Kassa :

module.exports = defineConfig({
  plugins: [
    {
      resolve: "@gorgo/medusa-integration",
      options: {
        encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
        providers: [
          {
            resolve: "@gorgo/medusa-payment-tkassa/providers/integration-tkassa",
            id: "tkassa-1",
            options: {},
          },
        ],
      },
    },
  ],
})

该模块将整合及其变化历史保存在自己的表格中. 安装或更新后运行迁移 :

yarn medusa db:migrate
# or
npx medusa db:migrate

一旦迁移运行,则重新启动服务器. 每一个注册的融合都出现在Medusa Admin中 设置 − 集成。 。 。 .

环境变量

  • INTEGRATION_ENCRYPTION_KEY - 密码句你通过作为 encryptionKey 选项。 模块生成加密选项的密钥 secret: true 从它。 设置为长随机字符串, 例如输出 openssl rand -hex 32. 一个有秘密选项的供应商没有它就无法工作.
  • GORGO_LICENSE – Gorgo仪表板的项目密钥. 只有付费的Gorgo插件需要它. 模块在背景中检查他们的许可证, 并永远不屏蔽服务器启动 。 见 安装付费插件。 。 。 .

文档

完整的安装、配置和使用指南可在 戈尔戈文献网站。 。 。 .

许可证

凭 MIT 许可证。 。 。 .

版本与发布记录

@gorgo/medusa-integration 共发布 32 个版本,首次发布于 2026/07/15;过去 12 个月发布了 32 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.0.0latest2026/11/134 天前
0.3.32026/11/116 天前
0.3.22026/11/0412 天前
0.3.12026/11/0116 天前
0.3.02026/10/2819 天前
0.2.92026/10/2720 天前

其他发布通道:beta → 0.3.0-beta.4。

关于 @gorgo/medusa-integration 的常见问题

@gorgo/medusa-integration 是什么?

美杜莎综合单元

如何安装 @gorgo/medusa-integration?

在项目目录运行 npm install @gorgo/medusa-integration,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@medusajs/ui(^4.1.16)、@medusajs/cli(^2.21.0)、@medusajs/deps(^2.21.0)、@medusajs/icons(^2.21.0)、@medusajs/medusa(^2.21.0)、react-router-dom(^6.30.4 || ^7.0.0)、@medusajs/admin-sdk(^2.21.0)、@medusajs/dashboard(^2.21.0)、@medusajs/framework(^2.21.0)、@medusajs/test-utils(^2.21.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gorgo/medusa-integration 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gorgo/medusa-integration 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gorgo/medusa-integration 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.23.4 || ^24.22.1 || >=26.12.1。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@gorgo/medusa-integration 可以商用吗?

@gorgo/medusa-integration 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gorgo/medusa-integration 的下载量有多少?

根据 npm 官方下载统计,@gorgo/medusa-integration 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,748 次,日均约 192 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gorgo/medusa-integration 还在维护吗?

最新版本 2.0.0 发布于 2026/11/13(4 天前);至今共发布 32 个版本,其中过去 12 个月发布了 32 个;首次发布于 2026/07/15。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。