原文:
https://discuss.flarum.org/d/5151
作者:
Luceos
翻译:Golden
Bazaar, the extension marketplace
本扩展可以使您在无法使用 composer 或终端的情况下添加和删除扩展程序。
免责声明
- 巴扎会用到 migrations 迁移功能,这意味着当您通过巴扎市场卸载扩展时,该扩展的数据库表也会被一同删除。
- 巴扎无法在您卸载扩展后即时删除该扩展的资产文件。
- 巴扎会尝试将自身允许使用的内存调整到 1GB,最终是否能成功取决于您的托管环境。
- 巴扎会在 flagrow.io 上读取 API 以获取兼容的扩展名单。您通过巴扎市场安装扩展程序即表示您同意共享一些数据(Flarum 版本号和 URL)给巴扎,以便巴扎顺利完成其工作。
未来功能
- 是管理员可以轻松地控制已安装、已启用的扩展程序。
- 创建一个由社区驱动,拥有分类功能的高质量扩展名单。
- 允许管理员绑定巴扎市场到 Flagrow.io 账户,并可以在 Flagrow.io 的仪表盘展示所有已绑论坛的运行状态。
- 支持 Flagrow 及其他开发者的付费扩展。
安装
composer require extiverse/bazaar
请确保 web/php 用户拥有以下目录及文件的写入权。
composer.json
composer.lock
vendor/
给服务器增加计划任务方可安装插件:https://github.com/extiverse/bazaar/wiki/Cron-task-processing
更新
composer update extiverse/bazaar
php flarum migrate
php flarum cache:clear
配置
安装后,在论坛后台的扩展程序(或译为插件)页面下启用本扩展。然后将弹出一个设置对话框,要求您提供令牌(令牌应该会程序自动填入)。一切就绪后,点击侧边栏中的 “巴扎市场” 选项卡,开始使用!
对于 0.3或更高版本(Flarum 0.1.0-beta.8+),请务必考虑启用 Cron 任务处理,将安装、卸载事件移至后台运行,这能大大提升您在巴扎市场的操作体验。
写给扩展开发人员
巴扎市场与 flagrow.io 互联,以提供最新的扩展列表和元数据。
通过 Packagist API 定期更新数据缓存。
该网站大约每隔五分钟抓取一次新发布扩展,大约每小时更新一次已抓取扩展的新数据。
这意味着您无需进行任何特殊操作,即可将您的扩展程序收录进巴扎市场。
但是,您可以采取一些措施来改善您的扩展程序的外观(请检查 composer.json
文件中的一下键):
license
:许可证,以便告诉其他人您的代码可以被怎么二次使用。
authors
:作者,为扩展程序的作者添加 authors
字段并填写好邮箱等值,以便人们可以找到作者。
extra.flarum-extension.title
:扩展程序的名称,与标签字段一起使用以提供搜索关键字索引。
- `extra.flarum-extension-icon:扩展程序的图标,您可以选择 FontAwesome、SVG、PNG等作为您扩展程序的标志。
extra.flagrow.discuss
:将您的扩展程序与 Flarum 官方论坛的主题帖链接起来,此值必须以 https://discuss.flarum.org/d/
起头。
常见问题
链接
由 Flagrow 制作并维护此插件。
本译文仅用于学习和交流目的,转载请务必注明文章译者、原文出处、和本文链接。