We'll now go through the configuration file in detail. Some values need to be configured for everything to work properly, so don't skip this step.
'templates' => [ 'cart' => '', 'checkout' => '', 'order-confirmation' => '', ],
The template paths for the default views usually needed in a webshop. Defined the way you'd usually define a view path, such as
path.to.my.view. If left empty, that route will not be registered.
order-confirmation route will have access to an
$order variable, to make it easy for you to display the necessary order information.
'models' => [ 'Order' => Happypixels\Shopr\Models\Order::class, 'OrderItem' => Happypixels\Shopr\Models\OrderItem::class, ],
You may use your own models to extend the orders/order items. Read more about this on the Customization page.
'currency' => 'USD',
The currency defines how money will be formatted by default. Formatted money values will be returned as
attribute_formatted, such as
The currency must be defined using the ISO4217 format, see https://www.xe.com/iso4217.php for more information and a full currency list.
/* * The money formatter class. You may provide your own class here, just make sure it extends * the default Happypixels\Shopr\Money\Formatter class. */ 'money_formatter' => Happypixels\Shopr\Money\Formatter::class,
The default money formatter will be enough for most use cases. However, you may configure your own formatter class. This will give you full control of how money is displayed on your site. Read more under the
Custom money formatter section.
'tax' => 0,
This defines the tax percentage which will be calculated on all shoppable items.
'admin_emails' => , 'mail' => [ 'customer' => [ 'order_placed' => ['enabled' => true, 'template' => null, 'subject' => null], ], 'admins' => [ 'order_placed' => ['enabled' => true, 'template' => null, 'subject' => null], ], ],
admin_emails holds an array of email addresses to the administrators of the site.
path.to.view). These views will have access to the
$order variable. However, default templates are used as fallback. You may also define a specific subject if you'd like.
'discount_coupons' => [ 'validation_rules' => [ Happypixels\Shopr\Rules\Cart\CartNotEmpty::class, Happypixels\Shopr\Rules\Discounts\OnlyOneCouponPerOrder::class, Happypixels\Shopr\Rules\Discounts\CouponHasNotBeenApplied::class, Happypixels\Shopr\Rules\Discounts\CouponExists::class, Happypixels\Shopr\Rules\Discounts\DateIsWithinCouponTimespan::class, Happypixels\Shopr\Rules\Discounts\CartValueAboveCouponLimit::class ] ],
These rules are validated when a customer attempts to add a discount coupon to their cart. The default rules make sure the following statements are true:
You may add or remove any rules from this list to make sure it fits your needs.
'gateways' => [ 'stripe' => [ 'publishable_key' => env('STRIPE_PUBLISHABLE_KEY', ''), 'api_key' => env('STRIPE_SECRET_KEY', '') ] ]
This setting holds the details about the payment gateways you wish to enable. We currently support
Stripe out of the box.