Grafite Commerce
Grafite has archived this project and no longer supports or develops its code. We recommend using only as a source of ideas for your own code.
Commerce - An e-commerce package for Laravel apps using Grafite CMS
Commerce is a e-commerce package for Grafite CMS. It is an elegant solution for adding an e-commerce platform to your Grafite CMS instance. This means it can be added to existing apps, or fresh installs and setups of the Grafite CMS. You can control: products, subscriptions, transaction history, orders, and some year by year analytics. Utilizing the power of Stripe, you can spin up a store, where you can offer subscriptions, digital products for download, or even physical products for order shipments. Integrate any external services to handle shipping rates, and tracking number updates. Take control of the many things you make, and build the store you've always wanted.
Author(s):
- Matt Lantz (@mattylantz, mattlantz at gmail dot com)
Documentation
Installation
composer require grafite/commerce
composer require laravel/cashier
Don't worry about the laravel cashier installation, the only points of interest are specified below:
Add these to your config/app.php:
Grafite\Commerce\GrafiteCommerceModuleProvider::class,
Laravel\Cashier\CashierServiceProvider::class,
Setup
Then publish the vendor assets etc:
php artisan vendor:publish
Add the following to your app/Http/Kernel.php to the routeMiddleware array:
'isAjax' => \Grafite\Commerce\Http\Middleware\isAjax::class,
Add the following trait to the app/Models/User.php:
use Grafite\Commerce\Services\Concerns\hasFavorites;
Add the following to your app/Providers/RouteServiceProvider.php to the mapWebRoutes method inside the group method as a closure:
require base_path('routes/commerce.php');
Don't worry about the laravel cashier installation, the only points of interest are specified below:
Change your config/services.php to match the following:
'stripe' => [
'model' => App\Models\UserMeta::class,
'key' => env('STRIPE_KEY'),
'secret' => env('STRIPE_SECRET'),
],
Now you need to add the Billable trait to the App\Models\UserMeta::class
use \Laravel\Cashier\Billable;
Then migrate!
php artisan migrate
If you wish to maintain consistency with the store accross your login, user settings etc you can set the extends to @extends('commerce-frontend::layouts.store') Views you may wish to change for optimal consistency:
views/
auth/
login.blade.php
register.blade.php
passwords/
email.blade.php
reset.blade.php
user/
password.blade.php
settings.blade.php
Notes on Grafite CMS & Builder
Grafite Commerce is intented to be used with Grafite CMS so use outside of that context is to be done at your own risk. Similarly, though Grafite CMS is able to be added to any existing Laravel 5.6+ application, the documentation above is assuming you used the Grafite CMS setup command php artisan graifte:cms command, which is heavily integrated with Grafite Builder. If you did not, you may have to make adjustments that are not listed here.
LogisticService
The logistic service is published to your app specifically. The intention is for it to handle hooks on the various events that occur within your store purchase flow. The LogisticService handles the following events:
shipping($user)
getTaxPercent($user)
afterPurchase($user, $transaction, $cart, $result)
afterSubscription($user, $plan)
afterRefundRequest($transaction)
afterRefund($transaction)
cancelSubscription($user, $plan)
afterPlaceOrder($user, $transaction, $cart)
orderCreated($order)
shipOrder($order)
cancelOrder($order)
Extending
With any e-commerce platform there is a need to expand to fit your custom needs. With Grafite Commerce we have made this as easy as possible. We publish out the JavaScript files for cart interaction, and controllers and routes for general "browsing" of your store.
Public files:
- js/store.js
- js/card.js
- js/purchases.js
- css/shop.css
Within the public directory you will find a couple published CSS and JavaScript files which handle the elements of the Grafite Commerce experience. Feel free to change these as you desire but be mindful of URL changes since they may require route changes.
Controllers
There are a few controllers added to your app in the Grafite Commerce namespace. These are general controllers which you may wish to customize based on your app's setup. This is similar to Grafite CMS in the sense that you may wish to change certain parts. Be very mindful of how much you can impact the functionality of the Grafite Commerce store base by changing these files. Within the following namespace you should find these controllers which can be customized.
app/Http/Controllers/Commerce/
- CardController.php
- CartController.php
- CheckoutController.php
- FavoriteController.php
- OrderController.php
- PlanController.php
- ProductController.php
- ProfileController.php
- PurchaseController.php
- StoreController.php
- SubscriptionController.php
Routes
Routes can be customized in the routes/commerce.php file. Be mindful of changes here that can impact your JavaScript files above.
Views
There are Grafite Commerce view files that are published your app which you can modify, however, if you wish to edit the package views then you will need to update them in the resources/commerce directory.
Admin UI
There are some very easy to use Admin components set up with Grafite Commerce but feel free to clone the repo and add as you please.
Config
Grafite Commerce has a handful of config options.
| Key | Description |
|---|---|
| name | The name of the store |
| currency | The currency for your store, in relation to products |
| taxes_include_shipping | Whether or not you want the taxes to include the shipping rate |
| store_url_prefix | The store URL prefix (if changed you MUST update the published JS files as well) |
| currencies | Available currencies for subscription plan generating |
| subscriptions | If you want to enable/disable subscriptions as items in the store |
| forms | Forms config for commerce components |
General Requirements
- PHP 7.1.3+
- MySQL 5.7+
More Specific Requirements
- OpenSSL
- Laravel 5.6+
- Grafite CMS 3.0+
- Stripe Account
Compatibility and Support
| Laravel Version | Package Tag | Supported |
|---|---|---|
| 5.6.x | 2.0.x | no |
| 5.4.x - 5.5.x | 1.0.x | no |
License
Grafite Commerce is open-sourced software licensed under the MIT license
Bug Reporting and Feature Requests
Please add as many details as possible regarding submission of issues and feature requests
Disclaimer
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
2 Aug 8, 2022
129 Nov 15, 2022
1.7k Jan 5, 2023
43 Dec 20, 2022
2.6k Dec 28, 2022
158 Jan 2, 2023
3 May 31, 2022
7 Oct 27, 2022
101 Sep 14, 2022
6 May 10, 2021
3 Oct 12, 2021
208 Nov 2, 2022
304 Jan 6, 2023
5 Apr 20, 2022
1.7k Dec 24, 2022
58 Oct 19, 2022
2 Dec 10, 2022
1 Nov 4, 2021