@devx-commerce/strapi

中文文档
2.0.0-beta.0发布于 2026/05/19MITESM + CJS零依赖近 30 天下载 2967

Strapi 作为 CMS 的 Medusa 插件

中文使用文档
文档目录8 节
  1. 特征
  2. 所需资源
  3. 安装
  4. 设置
  5. 设置 Strapi
  6. 同步数据
  7. 使用量
  8. 文档

Medusa logo

美杜莎插件 - Strapi

文档 | 网站

用于将 Strapi 作为 Medusa 的 CMS 执行插件

特征

  • 美杜莎和斯特拉皮的无缝融合
  • 您的电子商务商店的灵活内容管理
  • 产品图像和资产的丰富媒体管理
  • QQ 以自定义字段和内容扩展产品信息
  • * 万能商业无头建筑
  • • 美杜莎和斯特拉皮之间的自动同步

所需资源

此插件需要:

安装

  1. 安装插件 :
npm install @devx-commerce/strapi @strapi/client
# or
yarn add @devx-commerce/strapi @strapi/client
  1. 将插件添加到您的 medusa-config.js数字 :
const { defineConfig } = require("@medusajs/medusa"); // or "@medusajs/framework/utils"

module.exports = defineConfig({
  // ... other config
  plugins: [
    // ... other plugins,
    {
      resolve: "@devx-commerce/strapi",
      options: {
        base_url: process.env.STRAPI_URL,
        api_key: process.env.STRAPI_API_KEY,
      },
    },
  ],
});

设置

设置 Strapi

  1. 如果您还没有安装 Strapi :
npx create-strapi-app@latest my-strapi-cms
  1. 启动您的 Strapi 服务器 :
cd my-strapi-cms
npm run develop
  1. 在 Strapi 创建 API 令牌 :

    • 转到 设置 > API 键
    • 创建新的全程访问符
    • 复制用于您美杜莎配置的代号
  2. 在 Strapi 中创建产品和变体收藏 :

    • 在您的 Strapi 管理面板中, 去 内容- 类型构建器
    • 创建名为新收藏类型 产品
      • 添加一个 标题 字段(文本类型)
      • 添加一个 系统编号 字段(文本类型,唯一)
    • 创建另一个名为收藏类型 备选案文
      • 添加一个 标题 字段(文本类型)
      • 添加一个 系统编号 字段(文本类型,唯一)
    • 保存并发布您的新收藏类型
  3. 为您的 Medusa 后端配置环境变量 :

    STRAPI_URL=http://localhost:1337
    STRAPI_API_KEY=your-api-token-here
    

同步数据

在安装和设置后,插件将自动:

  • 在草原中修改产品、收藏和类别时创建和更新
  • 在美杜莎和斯特拉皮之间同步产品、收藏和分类元数据
  • 允许使用 Strapi 的内容类型扩展产品数据

使用量

一旦设置了插件,您可以使用 Strapi 的管理员面板在您的产品中添加丰富的内容并使用 Strapi API为您的存储前端获取此内容.

从美杜莎取取出产品内容的例子(带有斯特拉皮字段):

// In your storefront
async function getProductContent(productId) {
  const response = await fetch(
    `${MEDUSA_BASE_URL}/store/products/${productId}?fields=cms_product.*`,
    {
      headers: {
        "x-publishable-api-key": STOREFRONT_PUBLISHABLE_API_KEY,
      },
    },
  );
  const data = await response.json();
  return data.data[0];
}

文档


版本与发布记录

@devx-commerce/strapi 共发布 41 个版本,首次发布于 2025/05/20;过去 12 个月发布了 1 个版本。

版本发布日期距今
2.0.0-beta.0latest2026/05/195 个月前
1.1.0-beta.3beta2025/10/101.1 年前
1.1.4-custom-jw-mayavecustom-jw-mayave2025/10/071.1 年前
0.0.122025/10/071.1 年前
1.1.3-custom-jw-mayave2025/10/061.1 年前
1.1.0-sync-options.2sync-options2025/09/301.1 年前

关于 @devx-commerce/strapi 的常见问题

@devx-commerce/strapi 是什么?

Strapi 作为 CMS 的 Medusa 插件

如何安装 @devx-commerce/strapi?

在项目目录运行 npm install @devx-commerce/strapi,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:qs(^6.14.0)、@medusajs/ui(4.1.9)、@medusajs/cli(2.14.2)、@medusajs/icons(2.14.2)、@medusajs/medusa(2.14.2)、@medusajs/admin-sdk(2.14.2)、@medusajs/framework(2.14.2)、@medusajs/test-utils(2.14.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@devx-commerce/strapi 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/devx-commerce__strapi 是否存在。

@devx-commerce/strapi 支持 ESM 还是 CommonJS?

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

@devx-commerce/strapi 需要什么版本的 Node.js?

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

@devx-commerce/strapi 可以商用吗?

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

@devx-commerce/strapi 的下载量有多少?

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

@devx-commerce/strapi 还在维护吗?

最新版本 2.0.0-beta.0 发布于 2026/05/19(5 个月前);至今共发布 41 个版本,其中过去 12 个月发布了 1 个;首次发布于 2025/05/20。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。