Config File

Those are the basic and most important settings to make.

Shop information

Those information will mostly be used for view or email templates.

'name' => 'Statamic Butik',
'address1' => '132 Main Street',
'address2' => 'Sea view, Fahrensodde',
'zip_city' => '24937 Flensburg',
'country' => 'DE',
'phone' => '+49 1294 238474934',
'mail' => 'butik@shop.com',

You need to define your country via an alpha-2 iso code. https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements

The defined country will be set as your default country. As long as a user does not select another country in the checkout process, all shipping prices will be calculated on the basis of the default country.

Shop overview

'overview_type' => 'newest',
'overview_limit' => '6',

What do you want butik to show on the overview page; the entry point for your shop?

By default, the shop entry point will be /shop

Options

Description

all

All products ordered by name. The limit will be ignored.

name

All products ordered by name. The limit will be respected.

newest

Showing the latest added products.

cheapest

Showing products with the lowest price first.

The overview limit does only limit the number of products shown on the shop overview page.

Mail

'order-confirmations' => 'your_mail@butik.com',

Butik will send one confirmation e-mail for every sold product. You can define the address right here.

You need to set up your mails with Statamic correctly, before butik can successfully notify you.

See the Statamic documentation for more information. You can easily send yourself a test mail from the control panel to confirm that you mail is working as expected.

Currency

'currency_name' => 'Euro',
'currency_isoCode' => 'EUR',
'currency_symbol' => '€',
'currency_delimiter' => ',',

Choose the currency of your default country.

Please keep the currency_isoCode strict to the ISO 4217 standard. That's just a fancy name for the know currency syntax: https://en.wikipedia.org/wiki/ISO_4217

Widgets

'widget_orders-limit' => 10,

The default is set to 10 entries. If you do use the Orders widget and want to regulate the number of orders shown, please do so.

Routing

'shop_route_active' => true,
'product_route_active' => true,
'category_route_active' => true,
'route_shop-prefix' => 'shop',
'route_cart' => 'cart',
'route_category' => 'category/{category}', // keep {category}
'route_checkout-delivery' => 'checkout/delivery',
'route_checkout-payment' => 'checkout/payment',
'route_payment-receipt' => 'payment/{order}/receipt', // keep {order}

We made it easy to configure all standard routes. This could be handy in case you want localized routes.

There may be cases where you don't want to use our default routes to view the shop, the product or categories. Set them to false to deactivate those routes.

Layouts

'layout_product-index' => 'layout',
'layout_product-category' => 'layout',
'layout_product-show' => 'layout',
'layout_cart' => 'layout',
'layout_checkout-delivery' => 'layout',
'layout_checkout-payment' => 'layout',
'layout_checkout-receipt' => 'layout',
'layout_checkout-receipt-invalid' => 'layout',

We will default to the standard layout in your resources/views/ folder. Move and/or change the layout file as you need it and define it here. Butik will take of the rest.

Template

'template_product-index' => 'butik::web.shop.index',
'template_product-category' => 'butik::web.shop.category',
'template_product-show' => 'butik::web.shop.show',
'template_cart' => 'butik::web.cart.index',
'template_checkout-delivery' => 'butik::web.checkout.delivery',
'template_checkout-payment' => 'butik::web.checkout.payment',
'template_checkout-receipt' => 'butik::web.checkout.receipt',
'template_checkout-receipt-invalid' => 'butik::web.checkout.invalid-receipt',

We put a lot of effort into the creation of our default templates to get you started as quick as possible.

The files will automatically be stored inside resources/views/vendor/butik. You can move those files or create your own.

If you want to link to a file named cart inside your resources/views/shop/cart.blade.php folder, the updated path would be shop.cart without the prefix butik::

Mike Martin created our beautiful templates.

Shipping

'shipping' => [
'price' => \Jonassiewertsen\StatamicButik\Shipping\ShippingByPrice::class,
],

If you want, you can implement your own shipping methods or disable those, you don't want to use.

Payment Gateway

'payment_gateway' => Jonassiewertsen\StatamicButik\Http\Controllers\PaymentGateways\MolliePaymentGateway::class,

Out of the box, butik does implement Mollie as our payment provider of choice, which is ready to use.

You can easily swap our implementation with your own.