eleven59 / backpack-shop
为 Laravel 的 Backpack 提供的 Webstore CRUD 模型和功能。爱它。
Requires
- backpack/crud: ^5.0.0
- backpack/pro: ^1.0.0
- barryvdh/laravel-dompdf: ^2.0
- eleven59/backpack-image-traits: ^1.0
- illuminate/support: ~8|~9
- pragmarx/countries-laravel: ^0.7.0
Requires (Dev)
- orchestra/testbench: ~5|~6
- phpunit/phpunit: ~9.0
README
此包添加了自定义模型、CRUD 面板和订单功能,用于使用 Backpack for Laravel 构建网店。
功能
- 创建产品类别和产品
- 添加自定义产品属性和状态
- 处理订单和支付
- 基于位置、包裹大小和/或重量的自定义配送规则
- 以上所有内容的完整 CRUD 面板
- 购物车助手
- 自动安装程序
- 使用默认语言文件(包括英文和荷兰文)进行完全可翻译的 CRUD
要求
首先,请确保您正在运行 PHP 8.1+
并已安装
此包经过大量测试,与 Laravel 8 和 Backpack 5 兼容。它与 Laravel 9 和 10 以及 Backpack 6 也似乎兼容,但没有保证(目前还没有)。我将更新此包以兼容 Backpack 6,但对于那项的预计时间表我毫无头绪。
我还计划将 Backpack Pro 作为可选项,使其更易于访问。同样,没有预计时间表。
安装
步骤 1 - 需求包
通过 Composer 安装包
composer require eleven59/backpack-shop
步骤 2 - 运行安装程序
然后运行安装程序,它将发布配置文件,运行所有必需的迁移,并将商店商品添加到 sidebar_contents 文件。
php artisan backpack-shop:install
步骤 3 - 配置
请检查 config/eleven59/backpack-shop.php
,因为一些事情需要根据您的特定用例进行配置。
步骤 4 - 最小要求
更新配置文件后,几乎所有内容都应该能够直接运行,但需要在 Backpack Admin 中做一些事情才能有效地使用此包(即防止意外的错误)。基本要求是
- 在
增值税类别
CRUD 面板中定义至少一个增值税类别 - 使用
配送大小
CRUD 面板定义至少一个包裹大小(如果使用,请参阅配置文件) - 在
配送规则
CRUD 面板中创建至少一个配送规则 - 也许可以添加
类别
和一些产品
?毕竟这是一个网店包。
步骤 5(可选但推荐)- 选择或构建支付提供商
此包不包含内置的支付提供商。然而,它提供了一个“无支付”提供商。这是默认的,并在所有客户不需要在线支付的情况下(例如,他们使用银行转账,您只提供付款取货,或商店中的所有商品都是免费的)都有效。
如果您需要支付提供商,我已为 Mollie 编写了一个,您可以在以下位置找到它: eleven59/backpack-shop-mollie。该包的安装说明和配置方法也在该包的说明书中。
如果您已经有了与您选择的支付服务提供商通信的代码,并且只需要将其集成到此软件包的购物车和结账功能中,那么编写自己的代码相对也比较容易。有关文档,请参阅payment-providers.md。
使用方法
请参阅docs/usage.md。
变更日志
变更记录在此GitHub上,请浏览提交历史。
重大变更将在此列出
0.2.0
- 0.1.x版本使用每个产品一个分类。此版本添加了一个交叉表,取代了此功能。这意味着您必须手动重新输入所有分类(或者编写一个快速脚本来自动完成此操作)。这也意味着,如果您在任何地方使用$product->category,这现在将不再有效,并将生成错误。
测试
此软件包不提供测试。
贡献
有关待办事项列表和操作指南,请参阅contributing.md。
安全
如果您发现任何与安全相关的问题,请发送电子邮件至info@eleven59.nl,而不是使用问题跟踪器。
鸣谢
- 作者:eleven59.nl(github: eleven59)
- 使用Backpack for Laravel构建。特别感谢Cristian Tăbăcitu和Backpack团队的出色工作。
许可
本项目以MIT许可证发布,因此您可以在任何Backpack & Laravel项目上安装它。有关更多信息,请参阅许可文件。
但是,请注意,您需要安装Backpack Pro(注意:5.x),这是一款专有软件。有关如何开始的信息,请参阅他们的定价页面。
计划推出一个不需要Backpack Pro但仅需要开源核心的版本,但可能需要一段时间才能发布。