@alphabite/medusa-wishlist

中文文档
0.7.6发布于 2026/10/18MITTypeScriptESM + CJS零依赖近 30 天下载 4596

Alphabite 的 Medusa 愿望列表插件

中文使用文档
文档目录15 节
  1. 版本兼容性
  2. 安装最新版本(Medusa 2.14.*及以上)
  3. 正在安装0.5.8版本(Medusa 2.13.*)
  4. 安装0.5.7版本(Medusa版本低于2.13.0)
  5. 目录
  6. * 特性
  7. * 安装
  8. QQ 插件选项
  9. • 行政部门
  10. API 终点
  11. SDK 用户
  12. QQ 来宾愿望列表流程
  13. 所需经费
  14. 邮递员收藏
  15. 捐款

美杜莎愿望列表插件

这个 Alphabite 愿望列表插件 最完整的愿望列表系统 美杜莎日报社。它支持认证用户和来宾用户,每个用户有多个愿望列表,以及用于前端集成的全功能SDK客户端.

此插件飞船 :

  • QQ 完全输入的 JS SDK 插件
  • 邮递员收藏
  • QQ 支持客人和认证客户

版本兼容性

请安装匹配您的 Medusa 版本的插件版本 :

美杜莎版本插件版本安装命令
2.14.* 及以上职等latestnpm install @alphabite/medusa-wishlist
2.13.*0.5.8npm install @alphabite/[email protected]
以下 2.13.00.5.7npm install @alphabite/[email protected]

latest 由美杜莎建造并测试 2.21.0。 。 。 .

安装最新版本(Medusa 2.14.*及以上)

npm install @alphabite/medusa-wishlist

正在安装0.5.8版本(Medusa 2.13.*)

npm install @alphabite/[email protected]

安装0.5.7版本(Medusa版本低于2.13.0)

npm install @alphabite/[email protected]

iQQ使用不匹配的版本可能导致相容性问题. 确定检查您的美杜莎版本( S)npm list @medusajs/medusa在安装之前.


目录


* 特性

  • 每个客户的多个愿望名单
  • 将项目添加/删除到/从任何愿望列表中
  • ++ 已登记时支持的来宾愿望列表
  • 完全打入了美杜莎JSDK 与我们的SDK客户端的整合
  • * 内置加固和过滤
  • 管理页面 设置 + 键 分析 选项卡

* 安装

通过 npm 安装插件 :

npm install @alphabite/medusa-wishlist

在你身边 medusa-config.js,注册插件 :

const plugins = [
  {
    resolve: "@alphabite/medusa-wishlist",
    options: {
      // all are optional, read bellow about default values
      wishlistFields: [],
      wishlistItemsFields: [],
      includeWishlistItems: true,
      includeWishlistItemsTake: 5,
      allowGuestWishlist: true,
    },
  },
];

QQ 插件选项

选项类型默认说明
wishlistFieldsstring[]["items.*", "items.product_variant.*", "items.product_variant.prices.*", "items.product_variant.product.thumbnail", "items.product_variant.product.id"]有选择地将美杜莎产品或产品变异域列入 " 愿望清单 " 清单/检索包括 " 愿望清单 " 项目的终点
wishlistItemsFieldsstring[]["id", "product_id", "wishlist_id", "created_at", "wishlist.customer_id", "updated_at", "deleted_at", "product_variant.*", "product_variant.prices.*", "product_variant.calculated_price", "product_variant.product.thumbnail",]选择性地将美杜莎产品或产品变异域列入愿望清单项目清单/检索终点
includeWishlistItemsbooleanfalse自动填充愿望列表项目 GET /store/wishlists
includeWishlistItemsTakenumber5如果 includeWishlistItems 真实
allowGuestWishlistbooleanfalse启用不认证的愿望列表创建和使用( 基于 cookie)

• 行政部门

插件添加一个 愿望列表 页面到管理员边栏(/app/wishlists与 两个标签 : 设置 (宾客/多切入)和 分析 联合国 kPI的只读仪表板,一种活动趋势,以及最希望列入清单的产品 和变体).

见 医生/医疗分析员 用于分析终点 和反应形状.


API 终点

所有端点均可在 /store/wishlists。 。 。 .

方法终点认证说明
获取/store/wishlists✅当前客户的希望列表
邮政/store/wishlists (可选)创建一个新的愿望列表
获取/store/wishlists/:id (可选)使用 ID 获取愿望列表
点/store/wishlists/:id✅更新愿望列表元数据
迪莱特/store/wishlists/:id✅删除一个愿望列表
邮政/store/wishlists/:id/transfer✅向登录用户传输来宾愿望列表
获取/store/wishlists/:id/items (可选)在愿望列表中获取项目
邮政/store/wishlists/:id/add-item (可选)在愿望列表中添加一个项目
迪莱特/store/wishlists/:id/items/:item_id (可选)从愿望列表中删除项目

SDK 用户

❗❗❗更多关于我们的美杜莎相容的SDK

import { AlphabiteMedusaClient, wishlistPlugin } from '@alphabite/sdk'

const sdk = new AlphabiteMedusaClient({
  {
    baseUrl,
    debug: process.env.NODE_ENV === "development",
    publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
  },
  [wishlistPlugin],
  {
    getAuthHeader: () => { return { authorization: `Bearer ${customerJwt}` } },
  }
})

// Create wishlist
await sdk.alphabite.wishlist.create({ name: 'My Sneakers' })

// Add item
await sdk.alphabite.wishlist.addItem({
  id: 'wishlist_id',
  product_variant_id: 'variant_id',
})

// List items
const { data } = await sdk.alphabite.wishlist.listItems({ id: 'wishlist_id' })

QQ 来宾愿望列表流程

来宾许愿者的工作就像来宾推车:

  1. 创建一个愿望列表( 不需要认证)
  2. 保存该 id 在饼干中
  3. 使用该ID来列出/添加/删除物品
  4. 当用户签名或登录时,请打电话 transfer 关联的终点:
await medusa.alphabite.wishlist.transfer({ id: wishlistId });

之后,饼干就不再需要了.


所需经费

  • 美杜莎 v 2.14.0 +
  • 两人合作 @medusajs/types 财务报告和审定财务报表 @medusajs/framework

@mikro-orm/*, (中文(简体) ), awilix 财务报告和审定财务报表 pg 由美杜莎提供,不需要在插件旁边安装.


邮递员收藏

您可以在下列地点找到即时进口邮递员收藏:

alphabite-wishlist-postman.json

用它来交互地探索和测试所有的终点.


捐款

我们欢迎问题、反馈和公关。 分叉取出,造出取出,改良取出.

让我们让商业更加个性化

版本与发布记录

@alphabite/medusa-wishlist 共发布 41 个版本,首次发布于 2025/06/10;过去 12 个月发布了 18 个版本。

版本发布日期距今
0.7.6latest2026/10/1820 天前
0.7.42026/06/055 个月前
0.7.32026/06/045 个月前
0.7.22026/06/035 个月前
0.7.12026/06/025 个月前
0.7.02026/06/025 个月前

关于 @alphabite/medusa-wishlist 的常见问题

@alphabite/medusa-wishlist 是什么?

Alphabite 的 Medusa 愿望列表插件

如何安装 @alphabite/medusa-wishlist?

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

@alphabite/medusa-wishlist 支持 TypeScript 吗?

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

@alphabite/medusa-wishlist 支持 ESM 还是 CommonJS?

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

@alphabite/medusa-wishlist 需要什么版本的 Node.js?

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

@alphabite/medusa-wishlist 可以商用吗?

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

@alphabite/medusa-wishlist 的下载量有多少?

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

@alphabite/medusa-wishlist 还在维护吗?

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