Cart, Checkout and Orders Flow with Secure Zones Module - Tutorial

This Tutorial shows you how to use the eCommerce and Secure Zones Modules together

Prerequisites:

Introduction

Siteglide eCommerce is even more powerful with Secure Zones. With the security of a Secure Zone, you can show your Users more sensitive data about their shopping experience.

1) Create a Secure Zone

Create a Secure Zone which will used by shoppers on your eCommerce site. Alternatively, you can use a Secure Zone that you have created already. Find out more about the Secure Zones Module here.

2) Create a "My Orders" Page in a Secure Zone

Document image

Create a new page which will display a list of Products Users have ordered. Learn more about creating Pages here. Make a note of the Page slug, because you will want to add this to the Checkout Form’s "Redirect URL" field later.

Click the Secure Zones accordion to reveal the "Select a Secure Zone" field. Click in this to open a drop-down list of your Secure Zones and select the one you wish to be accessed by Users after they complete Checkout.

Document image

3) Add the Secure Zone to the Checkout Form

Document image

Make sure your Checkout Form is still in "Test Mode" unless the Site is Live.

The document How to Set Up a Shopping Cart and Guest Checkout, explained how to create a Checkout Form. Here we will modify this form so that it also either signs in a User or logs them in, depending on their current status.Find Forms in the Siteglide Admin’s left-hand side menu under CMS / Forms. Select the pencil icon on the right hand side of your Checkout Form to edit the structure of your form.

In the "Redirect URL" field add your Orders Page slug, preceded by a forward slash. E.g. /my-orders

Select the Secure Zones tag and then click in the Secure Zones Input field to see a dropdown of Secure Zones you have already created.

Select the Secure Zone you want to log your Users in to when they complete the form.

Press the "Save" Button to save your changes. At this point:

  1. Completing the Checkout Form will log Users in to the Secure Zone
  2. It will also redirect the Users to the My Orders Page
  3. The Users will be allowed to access the My Orders Page, because they are logged into the Secure Zone.
  4. Other Users who are not logged in will be unable to access the My Orders Page.

4) Create an Orders List Layout

As Orders List Layouts are for showing secure information about Users, they are stored under the following file structure:

  • layouts
    • modules
      • module_5
        • user_orders
          • name_of_my_layout.liquid

Create a new file in the user_orders folder and give it a name of your choice. Make a note of the name you gave it.

5) Develop your Layout

Your layout will have access to the "orders" object. You can loop over each order in the "Order" object with the following liquid (the "order" variable can be renamed to anything you like):

HTML

Inside this loop, you can access the following fields. (If you have renamed the order variable, make sure you also rename it when outputting the fields.)

Field Name

Liquid Tag

Description

Order ID

{{ order.id }}

The unique ID of the order

User ID

{{ order.user_id }}

The unique ID of the Current User

User Email

{{ order.email }}

The email address of the User who completed the Order

Status

{{ order.status }}

The status of the Order

Billing Address

{{ order.billing_address }}

Not yet available

Shipping Address

{{ order.shipping_address }}

Not yet available

Payment Method

{{ order.payment_method }}

Not yet available

Shipping Method

{{ order.shipping_method }}

Coming soon!

Tracking Number

{{ order.tracking_number }}

Not yet available

Price

{{ order.price }}

The Price paid for the Order as a decimal

Currency

{{ order.currency }}

The currency the Order was made in

6) Add Orders layout to the Orders Page

Add the following liquid to your Orders page to output a list of the current logged-in User’s Orders:{%- include 'user_orders', layout: 'my_orders_list_layout', sort_type: 'id', sort_order: 'asc', show_pagination: 'false' %}

The layout parameter should take the name of the list layout you created.

Other Ways to Use Secure Zones with eCommerce

You could add a Secure Zone to other pages related to your eCommerce flow, for example the Cart, in the same way you did with the Orders page. You could redirect the users to a login page when they visit the Cart page and are not logged in.

Learn more about Secure Zones here.