MODULES
...
eCommerce
Subscriptions

List View

5min

This view allows you to display available Subscription products for customers to browse through.

Introduction

The Subscriptions List View displays a list of Subscription products. Like other List Views, it can be sorted and filtered via Liquid.

This is slightly different from the user_subscriptions List view in the Secure Zones Module. This can be used to display a List of Subscription Orders belonging to a User. Learn more here.

Outputting a List View

You can use the type parameter to output a List Layout in most Liquid files:

HTML


File Structure

Subscription Layouts can be found at the path: layouts/modules/module_14/subscription Within this folder, you can create a folder for each Layout. Each Layout folder can contain a further "list" folder containing the wrapper and item files it needs.

Document image


Developing the List Layout

The Wrapper

The wrapper.liquid file should be used to add any HTML structure you may require around your main list.

You must include the following Liquid, which will in turn loop over the Items and output the item.liquid file for each Subscription Item. Most fields are specific to the Item and will only be available inside the item.liquid file.

HTML


Fields

Subscription Fields

  • {{this}}- Output all fields as JSON
  • {{this.id}}
  • {{this.weighting}}
  • {{this.release_date}}
  • {{this.expiry_date}}
  • {{this['Description']}}
  • {{this['Interval']}}
  • {{this['Interval Count']}}
  • {{this.full_slug}} - URL for the Product Detail Page
  • {{this['Secure Zones']}} - Array containing the IDs of Secure Zones associated with this Subscription.
  • {{this.price.id}}
  • {{this.price.currency}}
  • {{this.price.price_charge}} - The chargeable price of this Subscription each Interval. Integer format.
  • {{this.price.price_display}} - A field for displaying a secondary price of your choice, e.g. recommended retail price. This is not used by the integration. Integer format.
  • {{this.price.currency_symbol}}
  • {{this.price.price_charge_formatted}} - The chargeable price of this Subscription each Interval. Currency format
  • {{this.price.price_display_formatted}} - A field for displaying a secondary price of your choice, e.g. recommended retail price. This is not used by the integration. Currency format.

Subscription Order Fields You'll see when developing a Subscription Detail Page that when the User is logged in, it is also possible to access fields relating to a subscription_order the User has made for that Subscription product already. This is not currently available on the List view- as the List view is designed as a way to browse Subscription products. To allow the user to view and manage their Subscription Orders, we recommend the User Subscriptions view.

Updated 03 Mar 2023
Did this page help you?