美杜莎综合模块
文档
允许任何插件或提供商声明其选项并将管理员存储在管理器中的 Medusa 模块 medusa-config 编辑和不调用.
读取
什么是整合模块
集成模块允许任何插件声明其选项,并存储管理员配置为 整合 在管理者,没有 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 .
- 整合目录 : 行政官从"高尔高目录"中展示了整合情况. 加上你的,做一个 拉请求。 。 。 .
可用的整合
飞船
履行 @gorgo/medusa-fulfillment-apiship (英语)
T银行的T-Kassa
付款 · 校对:soup
刘克萨
付款 · @gorgo/medusa-pay-yookassa (英语)
罗布卡萨
付款 · 校对:soup
条纹
付款 · @gorgo/medusa-pay-stripe (英语)
付费页
付款 · 校对:soup
授权. net
付款 · 校对:soup
摩利语Name
付款 · @gorgo/medusa-pay-mollie (英语)
1C:企业
* ERP @gorgo-store/medusa-erp-1c (英语)
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 许可证。 。 。 .