本人开发了一款商店插件，目前在github中开源，其中商品实现依赖于其他插件能力，也就是说可以通过开发新的插件来丰富商店的功能。有兴趣的朋友可以尝试帮我写点商品出来。 flarum-ext-store Installation Install with composer: composer require mattoid/flarum-ext-store:"*" if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } Updating composer update mattoid/flarum-ext-store:"*" php flarum migrate php flarum cache:clear if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 下面是商品插件的注意事项帮助注册商品事件 (new StoreExtend('商品的唯一KEY，不可与其他拓展重复')) // 注册商品信息 ->addStoreGoods(Goods::class) // 注册前置校验器 ->addValidate(Validate::class) // 注册商品的业务逻辑 ->addAfter(After::class) // 商品失效逻辑 ->addInvalid(Invalid::class) if(window.hljsLoader && !document.currentScript.parentNode.hasAttribute('data-s9e-livepreview-onupdate')) { window.hljsLoader.highlightBlocks(document.currentScript.parentNode); } 事件简介购买前执行用户点击购买按钮后，优先执行 Mattoid\Store\Goods\Validate ，若要验证用户提交的表单或用户是否拥有商品权限则需要重写本类购买后执行用户点击购买按钮后，本插件会自动验证用户资金、商品购买权限等。确认无误后执行 Mattoid\Store\Goods\After 类。操作完成后通知事件 Mattoid\Store\Event\StoreBuyEvent 商品失效（扣费失败）时执行通过 php flarum schedule:run 命令定时查询失效商品，若商品开启自动扣费选项，则直接扣费（仅扣费不操作库存）。若为开启自动扣费或扣费失败则执行 Mattoid\Store\Goods\Invalid 类。操作完成后通知事件 Mattoid\Store\Event\StoreInvalidEvent 商品信息注册商品信息（显示在管理端的添加商品页面上），用户需要重写并注册 Mattoid\Store\Goods\Goods 类。事件介绍所有事件均不受事务管理，仅为执行结束行为的通知，不做任何拦截等处理。若要想实现事务原子性，请使用 Mattoid\Store\Extend\StoreExtend 类进行注册，该类注册的所有能力均视为本插件自有业务逻辑。 (例如：余额不足时，不执行 Mattoid\Store\Event\StoreBuyEvent 以及之后的逻辑； Mattoid\Store\Goods\After 执行失败时自动退款并增加库存) 事件通常不需要商品插件做特殊处理，本插件推荐使用 Mattoid\Store\Extend\StoreExtend 类的方式进行因为逻辑注册购买失败事件 Mattoid\Store\Event\StoreBuyFailEvent 该事件由本插件监听，若商品插件执行自有业务逻辑失败导致需要回滚购买信息时可通知该事件，本插件会自动处理库存以及退款等操作（若用用的是 Mattoid\Store\Extend\StoreExtend 注册的商品业务逻辑，则不需要考虑该事件。）购买通知事件 Mattoid\Store\Event\StoreBuyEvent 该事件由商品插件自行监听，用于通知商品插件购买结束，商品插件可执行购买后的操作添加购物车 Mattoid\Store\Event\StoreCartAddEvent 该事件由本插件监听，商品插件可通过通知该事件实现添加购物车的操作(该事件会自动减扣库存) 编辑购物车 Mattoid\Store\Event\StoreCartEditEvent 该事件由本插件监听，商品插件可通过通知该事件实现编辑购物车的操作(若 status 大于1，则该事件会自动增加库存) 回滚库存 Mattoid\Store\Event\StoreStockAddEvent 该事件由本插件监听，商品插件可通过通知该事件实现库存回滚操作扣除库存 Mattoid\Store\Event\StoreStockSubEvent 该事件由本插件监听，商品插件可通过通知该事件实现库存减扣操作商品失效事件 Mattoid\Store\Event\StoreInvalidEvent 该事件由商品插件监听，在商品失效时便会通知该事件（无论是否扣款成功）商品插件邀请码（审核版）补签卡自动签到卡

mattoid 是我的操作不大对吗

开发了一款商店插件，有没有志同道合的朋友来帮忙开发一些商品呀

mattoid

本人开发了一款商店插件，目前在github中开源，其中商品实现依赖于其他插件能力，也就是说可以通过开发新的插件来丰富商店的功能。有兴趣的朋友可以尝试帮我写点商品出来。
flarum-ext-store

Installation

Install with composer:

composer require mattoid/flarum-ext-store:"*"

Updating

composer update mattoid/flarum-ext-store:"*"
php flarum migrate
php flarum cache:clear

下面是商品插件的注意事项

帮助

注册商品事件

(new StoreExtend('商品的唯一KEY，不可与其他拓展重复'))
  // 注册商品信息
  ->addStoreGoods(Goods::class)
  // 注册前置校验器
  ->addValidate(Validate::class)
  // 注册商品的业务逻辑
  ->addAfter(After::class)
  // 商品失效逻辑
  ->addInvalid(Invalid::class)

事件简介

购买前执行

用户点击购买按钮后，优先执行Mattoid\Store\Goods\Validate，若要验证用户提交的表单或用户是否拥有商品权限则需要重写本类

购买后执行

用户点击购买按钮后，本插件会自动验证用户资金、商品购买权限等。确认无误后执行Mattoid\Store\Goods\After类。

操作完成后通知事件 Mattoid\Store\Event\StoreBuyEvent

商品失效（扣费失败）时执行

通过 php flarum schedule:run 命令定时查询失效商品，若商品开启自动扣费选项，则直接扣费（仅扣费不操作库存）。
若为开启自动扣费或扣费失败则执行 Mattoid\Store\Goods\Invalid 类。

操作完成后通知事件 Mattoid\Store\Event\StoreInvalidEvent

商品信息

注册商品信息（显示在管理端的添加商品页面上），用户需要重写并注册 Mattoid\Store\Goods\Goods 类。

事件介绍

所有事件均不受事务管理，仅为执行结束行为的通知，不做任何拦截等处理。若要想实现事务原子性，
请使用 Mattoid\Store\Extend\StoreExtend 类进行注册，该类注册的所有能力均视为本插件自有业务逻辑。
(例如：余额不足时，不执行 Mattoid\Store\Event\StoreBuyEvent 以及之后的逻辑；Mattoid\Store\Goods\After 执行失败时自动退款并增加库存)

事件通常不需要商品插件做特殊处理，本插件推荐使用 Mattoid\Store\Extend\StoreExtend 类的方式进行因为逻辑注册

购买失败事件

Mattoid\Store\Event\StoreBuyFailEvent

该事件由本插件监听，若商品插件执行自有业务逻辑失败导致需要回滚购买信息时可通知该事件，本插件会自动处理库存以及退款等操作
（若用用的是 Mattoid\Store\Extend\StoreExtend 注册的商品业务逻辑，则不需要考虑该事件。）

购买通知事件

Mattoid\Store\Event\StoreBuyEvent

该事件由商品插件自行监听，用于通知商品插件购买结束，商品插件可执行购买后的操作

添加购物车

Mattoid\Store\Event\StoreCartAddEvent

该事件由本插件监听，商品插件可通过通知该事件实现添加购物车的操作(该事件会自动减扣库存)

编辑购物车

Mattoid\Store\Event\StoreCartEditEvent

该事件由本插件监听，商品插件可通过通知该事件实现编辑购物车的操作(若 status 大于1，则该事件会自动增加库存)

回滚库存

Mattoid\Store\Event\StoreStockAddEvent

该事件由本插件监听，商品插件可通过通知该事件实现库存回滚操作

扣除库存

Mattoid\Store\Event\StoreStockSubEvent

该事件由本插件监听，商品插件可通过通知该事件实现库存减扣操作

商品失效事件

Mattoid\Store\Event\StoreInvalidEvent

该事件由商品插件监听，在商品失效时便会通知该事件（无论是否扣款成功）

商品插件

JntmIkun

mattoid 插件图标不出来，打开商店时强制隐藏了欢迎横幅。

microky

mattoid

能出个插件开发教程吗？官方文档中文版就一半成品，读起来难啃得要死
想开发个独立页面，不知道用什么命令生成，flarum-cli好像并没有相关生成命令
本人有一定的Laravel开发基础，JS基础稍差
不过，只要能够生成路由+页面模板，我大概知道后续怎么处理
Model已经生成，其他能够用flarum-cli生成的，比如控制器、路由等也都知道怎么生成
唯独不知道怎么生成页面模板

小鱼飘飘

大佬有没有兴趣先补充下您的插件本身应该怎么用，目前还不明确插件本身的使用方法。完成安装本体和附属后添加商品按钮的弹窗内依然没有任何内容。用以下代码做了简单测试，依然没有任何效果。

我觉得比起API文档，可能插件更需要一份使用说明

class MattoidGood extends Goods
{
    protected $name = "xypp-sticky-card.forum.sticky-card";
    protected $popUp = [];
}
// in extend.php
(new \Mattoid\Store\Extend\StoreExtend("sticky-card"))
    ->addStoreGoods(MattoidGood::class);

mattoid

小鱼飘飘
注释已经添加了，弹窗体内容可以看 Mattoid\Store\Goods\Goods 的 popUp 参数。（这个信息是存储在数据库的，也就是说你如果修改了这里的内容，需要在修改或者重新添加商品后生效）
当然你也可以参考邀请码（审核版）这个拓展

下面的几个例子实际就是用来说明商品插件应该怎么开发的。

小鱼飘飘

mattoid 我尝试安装了邀请码和商店，但是无法找到任何操作来添加商品，能否给一个大概的操作流程？谢谢。

mattoid

小鱼飘飘

你可以看看管理端的商店插件页面

小鱼飘飘

mattoid
Image description

Image description

是我的操作不大对吗

mattoid

小鱼飘飘
你把商品插件启动，若没有商品信息，可以尝试重启一下商品插件

小鱼飘飘

mattoid

这几个全开和开任何一个结果都是一样的。最后一个插件是您文中的邀请码（审核版）插件，开启后没有配置过。

mattoid

小鱼飘飘那可能是插件有问题，明天需要排查一下。

你可以监控一下日志，启动商品插件是否有报错的情况

小鱼飘飘

mattoid

查了一下，插件第一次启动会有报错

但是报错后再次点击开启按钮就能启用插件了。不过并没有成功添加商品。

mattoid

小鱼飘飘这其实是插件没有成功启动。看样子是没有配置时区导致的。你需要在商店插件配置时区信息

mattoid

JntmIkun 我的插件主打的就是没图标!（我不会承认自己菜的）

mattoid

microky 以后有时间了我可能会整理几篇博客来充实 flarum 的开发文档，但目前来说可能不太有时间做这个。如果你有兴趣的话，可以留下联系方式我们探讨探讨。qq 或者邮箱什么的都可以

microky

mattoid
要不，你QQ发我邮箱吧，我加你
sitemaillor@gmail.com

齐鲁农场

贴几个效果图吧

mattoid

齐鲁农场功能截图再wiki里面有，可以进入这里查看
wiki

huahua

Image description
如何添加？

mattoid

huahua 需要安装商品插件才能显示商品信息。目前已知有个BUG，是商店插件没有配置时区可能会导致商品插件无法正确启动。所以你启动商品插件之前需要先配置时区

huahua

mattoid Image description
下载这些？我下了似乎还是一样