Tags

• Field Whitelisting
• Redirects
• Form Validation
• How the "form tags" work
  • Using the "form tags" in Blade
• Alias

Simple Commerce provides a set of tags allowing you to build your e-commerce sites.

• Cart
• Checkout
• Countries
• Coupon
• Currencies
• Customer
• Gateways
• Regions
• Shipping

Field Whitelisting

When using Form Tags, Simple Commerce requires you to specify any additional fields you wish to be editable via front-end forms.

For example: you may wish for customers to fill in the shipping_note field via the {{ sc:cart:update }} form but you wouldn't want them filling the is_paid field.

With 'field whitelisting', you must specify the fields you wish to allow in the Simple Commerce config file.

 1/*
 2|--------------------------------------------------------------------------
 3| Field Whitelist
 4|--------------------------------------------------------------------------
 5|
 6| You may configure the fields you wish to be editable via front-end forms
 7| below. Wildcards are not accepted due to security concerns.
 8|
 9| https://simple-commerce.duncanmcclean.com/tags#field-whitelisting
10|
11*/
12 
13'field_whitelist' => [
14    'orders' => [
15        'shipping_name', 'shipping_address', 'shipping_address_line2', 'shipping_city', 'shipping_region',
16        'shipping_postal_code', 'shipping_country', 'use_shipping_address_for_billing', 'billing_name', 'billing_address',
17        'billing_address_line2', 'billing_city', 'billing_region', 'billing_postal_code', 'billing_country',
18    ],
19 
20    'line_items' => [],
21],

Redirects

If you're using one of Simple Commerce's "form tags", you can choose to redirect the user upon submission. If no redirect is specified, the user will be redirected back to the same page.

You may use the redirect parameter to specify the URL you'd like to redirect the user to after the form submission has been successful.

1{{ sc:cart:addItem redirect="/cart" }}
2    <input type="hidden" name="product" value="{{ id }}">
3    <input type="hidden" name="quantity" value="1">
4    <button class="button-primary">Add to Cart</button>
5{{ /sc:cart:addItem }}

You may also specify an error_redirect parameter where the user would be taken if the form contains any validation errors.

Form Validation

On "form tags", Simple Commerce allows you to specify a Form Request which will be used for validation.

Simply specify the name of the Form Request you wish to use and it'll be picked up.

1{{## Form Request: app\Http\Requests\CheckoutInformationRequest ##}}
2 
3{{ sc:cart:update request="CheckoutInformationRequest" }}
4 
5{{ /sc:cart:update }}

It's worth noting that although you can specify the request parameter on any form tag, not all of them will actually use it. Here's a list of the forms that do:

• {{ sc:cart:addItem }}
• {{ sc:cart:updateItem }}
• {{ sc:cart:update }}
• {{ sc:customer:update }}
• {{ sc:checkout }}

How the "form tags" work

Essentially, whenever you use any of Simple Commerce's "form tags", it will wrap your HTML in a <form> element. If you provide any optional parameters to the form tags, they will be added onto the <form> element (think class, id, etc).

Whenever you use the redirect/form request parameters, Simple Commerce will add some hidden inputs to the form's HTML. The values of the inputs will be encrypted to avoid them being tampered with by your users.

Using the "form tags" in Blade

Simple Commerce's "form tags" work slightly differently in Blade. Instead, you need to construct the HTML of the <form> yourself as well as adding some hidden parameters. Thankfully, this is an easy peasy process:

 1@php
 2$form = Statamic::tag('sc:cart:addItem')->params([
 3    'redirect' => '/cart',
 4])->fetch();
 5@endphp
 6 
 7<form {!! $form['attrs_html'] !!}>
 8    {!! $form['params_html'] !!}
 9 
10    <input type="hidden" name="product" value="{{ $id }}" />
11    <input type="text" name="quantity" value="1" />
12    <button>Add to Cart</button>
13</form>

The above example is using the {{ sc:cart:addItem }} form. You simply use the {!! $form['attrs_html'] !!} in the <form> tag (this adds the action and method attributes). Then, somewhere inside the form, add the hidden parameters with {!! $form['params_html'] !!}.

Alias

If you'd prefer not to use the shorthand of sc in your tags, you can also use simple-commerce which will work the same way.

This could be used to give more context of the tag in use to make it clear it's dealing with Simple Commerce.

1{{ simple-commerce:countries }}