This packages adds customizable models, CRUD panels, and order functionality for building a webshop with Backpack for Laravel.
Functionality:
- Create product categories and products
- Add custom product attributes and statuses
- Process orders and payments
- Customizable shipping rules based on location, package size and/or weight
- Fully featured CRUD panels for all of the above
- Shopping cart helper
- Automated installer
- Fully translatable CRUD using default lang files (EN and NL included)
First, make sure you are running PHP 8.1+ and have installed:
- Backpack (
5.x) (install guide) - Backpack Pro (sorry, it's required for now; see pricing)
This package was tested extensively with Laravel 8 and Backpack 5. It seemed fine with Laravel 9 and 10, and Backpack 6 as well, but no guarantees (yet). I will be updating the package for Backpack 6 compatibility, but I have no idea on the ETA for that.
I'm also planning to make Backpack Pro optional, so it will be more accessible. Again, no ETA.
Install the package via Composer
composer require eleven59/backpack-shopThen run the installer, which publishes the config file, runs all required migrations, and adds shop items to the sidebar_contents file.
php artisan backpack-shop:installPlease check config/eleven59/backpack-shop.php since some things will need to be configured for your particular use case.
After updating the config file, almost everything should run out of the box, but a couple of things will need to be done in the Backpack Admin to use the package effectively (i.e., prevent unexpected errors). The bare minimum is:
- Define at least one VAT class in the
VAT classesCRUD panel - Define at least one package size (if using, see config) using the
Shipping sizesCRUD panel - Create at least one shipping rule on the
Shipping rulesCRUD panel - Maybe add
Categories, and someProducts? It's a webshop package after all.
This package does not come with a payment provider included. It does, however, come with a "No payment" provider. This is the default, and works in all cases where customers don't have to pay online (i.e., they pay using bank transfer, you only offer pay and collect, or everything in the store is free).
If you do need a payment provider, I have written one for Mollie, which you can find here: eleven59/backpack-shop-mollie. Install instructions and how to configure are also in the readme for that package.
It's also relatively easy to write your own if you already have code to talk with your payment provider of choice and only need to integrate it with the shopping cart and checkout functionality of this package. See payment-providers.md for the documentation.
See docs/usage.md.
Changes are documented here on Github. Please browse the commit history.
Breaking changes are be listed here:
- 0.1.x used a single category per product. This version adds a pivot table which replaces this functionality. This means you will have to re-enter all categories manually (or write a quick script to do this automatically). It also means that if you are using $product->category anywhere, this no longer works and will generate an error.
This package provides no testing.
Please see contributing.md for a todolist and howtos.
If you discover any security related issues, please send an email to [email protected] instead of using the issue tracker.
- Author: eleven59.nl (github: eleven59)
- Built with Backpack for Laravel. Special thanks to Cristian Tăbăcitu and the rest of the Backpack team for the awesome work.
This project was released under MIT, so you can install it on top of any Backpack & Laravel project. Please see the license file for more information.
However, please note that you do need Backpack Pro (note: 5.x) installed, which is proprietary software. Please refer to their pricing page to get started.
A version that does not require Backpack Pro but only the open core source is planned, but will probably not be released for a while.