eleven59/backpack-shop

为 Laravel 的 Backpack 提供的 Webstore CRUD 模型和功能。爱它。

0.2.6 2024-04-14 14:14 UTC

This package is auto-updated.

Last update: 2024-09-14 15:21:59 UTC


README

Latest Version on Packagist Total Downloads

此包添加了自定义模型、CRUD 面板和订单功能,用于使用 Backpack for Laravel 构建网店。

功能

  • 创建产品类别和产品
  • 添加自定义产品属性和状态
  • 处理订单和支付
  • 基于位置、包裹大小和/或重量的自定义配送规则
  • 以上所有内容的完整 CRUD 面板
  • 购物车助手
  • 自动安装程序
  • 使用默认语言文件(包括英文和荷兰文)进行完全可翻译的 CRUD

要求

首先,请确保您正在运行 PHP 8.1+ 并已安装

  • Backpack (5.x) (安装指南)
  • Backpack Pro(抱歉,目前需要;请参阅 定价

此包经过大量测试,与 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,而不是使用问题跟踪器。

鸣谢

许可

本项目以MIT许可证发布,因此您可以在任何Backpack & Laravel项目上安装它。有关更多信息,请参阅许可文件

但是,请注意,您需要安装Backpack Pro(注意:5.x),这是一款专有软件。有关如何开始的信息,请参阅他们的定价页面。

计划推出一个不需要Backpack Pro但仅需要开源核心的版本,但可能需要一段时间才能发布。