Difference between revisions of "Shopify Liquid"
From the Directed Edge Developer Base
| (10 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
| − | == Liquid | + | See also our page with [[Shopify Liquid Examples]]. |
| + | |||
| + | == Liquid variables supported by Directed Edge == | ||
=== <tt>groups</tt> === | === <tt>groups</tt> === | ||
The liquid variable groups contain all recommendation types that are available for the requested page. Each group has following properties: | The liquid variable groups contain all recommendation types that are available for the requested page. Each group has following properties: | ||
{| class="variable-ref-table" | {| class="variable-ref-table" | ||
|- | |- | ||
| − | | label || A formatted label of the group, for example, “Recommended Items”, “Recently Viewed”, etc. Those labels can be customized in | + | | label || A formatted label of the group, for example, “Recommended Items”, “Recently Viewed”, etc. Those labels can be customized in our [http://shopify.directededge.com/settings#styling Appearance Settings]. |
|- | |- | ||
| − | | handle || A machine friendly identifier for the group (e.g. bundle, recommended_product, etc.) | + | | handle || A machine friendly identifier for the group (e.g. <tt>bundle</tt>, <tt>recommended_product</tt>, etc.) |
|- | |- | ||
| products || An array of all of the products in returned for this recommendations group. | | products || An array of all of the products in returned for this recommendations group. | ||
| Line 21: | Line 23: | ||
{% endfor %} | {% endfor %} | ||
</source> | </source> | ||
| − | A detailed description of all | + | A detailed description of all product’s properties can be found [http://docs.shopify.com/themes/liquid-variables/product here]. |
|- | |- | ||
| bundle || A boolean field that indicates if this group is a bundle. This is useful to render custom content for that particular group. The following snippet would display both product images separated by a plus sign and followed by a equals sign and the bundle price: | | bundle || A boolean field that indicates if this group is a bundle. This is useful to render custom content for that particular group. The following snippet would display both product images separated by a plus sign and followed by a equals sign and the bundle price: | ||
| Line 40: | Line 42: | ||
=== <tt>bundle</tt> === | === <tt>bundle</tt> === | ||
| − | The bundle variable is used to access | + | The bundle variable is used to access extra information about bundles, not available in other groups: |
{| class="variable-ref-table" | {| class="variable-ref-table" | ||
|- | |- | ||
| − | | text || | + | | text || Bundle’s buy message (e.g. “Buy both for $20”) which can be adjusted in the [http://shopify.directededge.com/settings#bundle Directed Edge for Shopify Bundle Settings] page. |
|- | |- | ||
| − | | price || The total price of a bundle calculated using the method specified in the [http://shopify.directededge.com/settings#bundle Directed Edge for Shopify Bundle Settings] page. | + | | price || The total price of a bundle calculated using the method specified in the [http://shopify.directededge.com/settings#bundle Directed Edge for Shopify Bundle Settings] page. It can be formatted with the price filter just like elsewhere in Shopify templates: <source lang="xml">{{ bundle.price | money }}</source> |
|- | |- | ||
| − | | buy_link || A link that will add both products to the shopping cart and will | + | | buy_link || A link that will add both products to the shopping cart and will ask the user to pick a variant if multiple variants are available for the bundled products. |
| + | |} | ||
| + | |||
| + | |||
| + | === <tt>product</tt> === | ||
| + | |||
| + | We support the same variables as Shopify, with the following additions. See their documentation for <tt>[http://docs.shopify.com/themes/liquid-variables/product product]</tt>. | ||
| + | |||
| + | {| class="variable-ref-table" | ||
| + | | buy_link || A link that will add the product to the shopping cart and will ask the user to pick a variant if multiple variants are available for the product. | ||
|} | |} | ||
Latest revision as of 12:32, 12 July 2018
See also our page with Shopify Liquid Examples.
Liquid variables supported by Directed Edge
groups
The liquid variable groups contain all recommendation types that are available for the requested page. Each group has following properties:
| label | A formatted label of the group, for example, “Recommended Items”, “Recently Viewed”, etc. Those labels can be customized in our Appearance Settings. |
| handle | A machine friendly identifier for the group (e.g. bundle, recommended_product, etc.) |
| products | An array of all of the products in returned for this recommendations group.
The following example would print title and price of all products in all available groups: {% for group in groups %}
<ul>
{% for product in group.products %}
<li>
<b>{{ product.title }}</b><br />
{{ product.price | money }}
{% endfor %}
</ul>
{% endfor %}A detailed description of all product’s properties can be found here. |
| bundle | A boolean field that indicates if this group is a bundle. This is useful to render custom content for that particular group. The following snippet would display both product images separated by a plus sign and followed by a equals sign and the bundle price:
{% for group in groups %}
{% if group.bundle %}
{{ group.products.first.featured_image | product_img_url: 'small' }}
+
{{ group.products.last.featured_image | product_img_url: 'small' }}
=
{{ bundle.price }}
{% else %}
<!-- render other content here -->
{% endif %}
{% endfor %} |
bundle
The bundle variable is used to access extra information about bundles, not available in other groups:
| text | Bundle’s buy message (e.g. “Buy both for $20”) which can be adjusted in the Directed Edge for Shopify Bundle Settings page. |
| price | The total price of a bundle calculated using the method specified in the Directed Edge for Shopify Bundle Settings page. It can be formatted with the price filter just like elsewhere in Shopify templates: {{ bundle.price | money }} |
| buy_link | A link that will add both products to the shopping cart and will ask the user to pick a variant if multiple variants are available for the bundled products. |
product
We support the same variables as Shopify, with the following additions. See their documentation for product.
| buy_link | A link that will add the product to the shopping cart and will ask the user to pick a variant if multiple variants are available for the product. |
