Difference between revisions of "Liquid Variable Reference"
From Spiffy Stores Knowledge Base
m (→Global Objects) |
|||
| (30 intermediate revisions by 2 users not shown) | |||
| Line 3: | Line 3: | ||
==Requirements== | ==Requirements== | ||
| − | Following variables | + | Following variables must be included in every Liquid theme file such as the [[Theme.liquid | theme.liquid]]. |
* <pre>{{content_for_header}}</pre> | * <pre>{{content_for_header}}</pre> | ||
* <pre>{{content_for_layout}}</pre> | * <pre>{{content_for_layout}}</pre> | ||
| − | ==Template specific objects== | + | == Template specific objects == |
| − | Special purpose templates usually export the object they reference by the same name as the template file. Product.liquid, for example, would export a product object which references the current product on the page. | + | Special purpose templates usually export the object they reference by the same name as the template file. <code>Product.liquid</code>, for example, would export a product object which references the current product on the page. |
===[[Index.liquid|index.liquid]]=== | ===[[Index.liquid|index.liquid]]=== | ||
| − | This template creates your store's home page. It is not directly related to any given resource of your store in the same way that | + | This template creates your store's home page. It is not directly related to any given resource of your store in the same way that <code>Product.liquid</code> is. |
| − | Because it does not refer to a specific resource, | + | Because it does not refer to a specific resource, [[Index.liquid|index.liquid]] makes use of the global objects referenced below. You are free to use any objects (product, collection, page, etc.) in your store from here. |
| − | By convention the default themes will render all articles of a blog with the handle home-page, if it exists, and will display products from a collection with the handle home-page. Both of these objects are created automatically during the Spiffy Stores | + | By convention the default themes will render all articles of a blog with the handle home-page, if it exists, and will display products from a collection with the handle home-page. Both of these objects are created automatically during the Spiffy Stores signup when your new store is created. |
===[[Product.liquid|product.liquid]]=== | ===[[Product.liquid|product.liquid]]=== | ||
| − | This template displays the referenced product and all its variants. | + | This template displays the referenced [[Liquid_Template_Variables_-_product|product]] and all its variants. |
===[[Blog.liquid|blog.liquid]]=== | ===[[Blog.liquid|blog.liquid]]=== | ||
| − | This template is used to display a blog and its articles. | + | This template is used to display a [[Liquid_Template_Variables_-_blog|blog]] and its [[Liquid_Template_Variables_-_article|articles]]. |
===[[Collection.liquid|collection.liquid]]=== | ===[[Collection.liquid|collection.liquid]]=== | ||
| − | This template is used to display a collection of products and all the tags for the collection. This template will usually use pagination to help display a large number of items. | + | This template is used to display a collection of [[Liquid_Template_Variables_-_product|products]] and all the tags for the collection. |
| + | |||
| + | This template will usually use [[Liquid_Paginate_Tag|pagination]] to help to display a large number of items. | ||
===[[Page.liquid|page.liquid]]=== | ===[[Page.liquid|page.liquid]]=== | ||
| − | This template provides the basic support for displaying the static pages for your store. | + | This template provides the basic support for displaying the static [[Liquid Template Variables - page|pages]] for your store. |
| + | |||
| + | === [[Cart.liquid|cart.liquid]] === | ||
| + | |||
| + | This template contains the layout for your shopping [[Liquid Template Variables - cart|cart]], and will show all the items that the customer has selected for purchase. | ||
| + | |||
| + | === [[Search.liquid|search.liquid]] === | ||
| + | |||
| + | This template contains the layout for your [[Liquid_Template_Variables_-_search|search]] results. | ||
| + | |||
| + | === [[404.liquid|404.liquid]] === | ||
| + | |||
| + | This template will be displayed whenever a page, product or collection cannot be found. It gives you the opportunity to redirect your customers to a search page or some other way of helping them find what they are looking for. | ||
| − | ===[[ | + | === [[list-collections.liquid|list-collections.liquid]] === |
| − | This template | + | This template displays all of the collections in your store except the home page collection. In many cases the behaviour can be overridden by creating a menu called "Collections". |
| − | ==Global | + | == Global Objects == |
| − | Following objects are available from any | + | Following objects are available from any Liquid template in the system. |
* [[Liquid Template Variables - template|template]] | * [[Liquid Template Variables - template|template]] | ||
* [[Liquid Template Variables - page_title|page_title]] | * [[Liquid Template Variables - page_title|page_title]] | ||
| + | * [[Liquid Template Variables - page_description|page_description]] | ||
* [[Liquid Template Variables - shop|shop]] | * [[Liquid Template Variables - shop|shop]] | ||
* [[Liquid Template Variables - cart|cart]] | * [[Liquid Template Variables - cart|cart]] | ||
| Line 55: | Line 70: | ||
* [[Liquid Template Variables - request|request]] | * [[Liquid Template Variables - request|request]] | ||
* [[Liquid Template Variables - cookies|cookies]] | * [[Liquid Template Variables - cookies|cookies]] | ||
| + | * [[Liquid Template Variables - header|header]] | ||
| + | * [[Liquid Template Variables - canonical_url|canonical_url]] | ||
| + | * [[Liquid Template Variables - exchange_rate|exchange_rate]] | ||
| + | * [[Liquid Template Variables - gift_card|gift_card]] | ||
| + | |||
| + | == Conditional Objects == | ||
| + | |||
| + | If a customer is logged in | ||
| + | |||
| + | * [[Liquid Template Variables - customer|customer]] | ||
| + | * [[Liquid Template Variables - customer_credit|customer_credit]] | ||
| + | |||
| + | == Other Objects == | ||
| + | |||
| + | The following objects are referenced by other Liquid Template Variables, and may be accessed from those objects, rather than being referenced directly. | ||
| + | |||
| + | * [[Liquid Template Variables - metafields|metafields]] | ||
| + | |||
| + | == Further Reference == | ||
| + | |||
| + | * [[Liquid Basics]] | ||
| + | * [[Liquid Tag Reference]] | ||
| + | * [[Liquid Filter Reference]] | ||
| + | * [[Liquid Paginate Tag|Pagination ]] | ||
Latest revision as of 12:04, 28 January 2022
The following is a reference list of objects which you can use in your liquid templates. For an introduction to liquid templates you can check out the Liquid Basics page.
Contents
Requirements
Following variables must be included in every Liquid theme file such as the theme.liquid.
{{content_for_header}}{{content_for_layout}}
Template specific objects
Special purpose templates usually export the object they reference by the same name as the template file. Product.liquid, for example, would export a product object which references the current product on the page.
index.liquid
This template creates your store's home page. It is not directly related to any given resource of your store in the same way that Product.liquid is.
Because it does not refer to a specific resource, index.liquid makes use of the global objects referenced below. You are free to use any objects (product, collection, page, etc.) in your store from here.
By convention the default themes will render all articles of a blog with the handle home-page, if it exists, and will display products from a collection with the handle home-page. Both of these objects are created automatically during the Spiffy Stores signup when your new store is created.
product.liquid
This template displays the referenced product and all its variants.
blog.liquid
This template is used to display a blog and its articles.
collection.liquid
This template is used to display a collection of products and all the tags for the collection.
This template will usually use pagination to help to display a large number of items.
page.liquid
This template provides the basic support for displaying the static pages for your store.
cart.liquid
This template contains the layout for your shopping cart, and will show all the items that the customer has selected for purchase.
search.liquid
This template contains the layout for your search results.
404.liquid
This template will be displayed whenever a page, product or collection cannot be found. It gives you the opportunity to redirect your customers to a search page or some other way of helping them find what they are looking for.
list-collections.liquid
This template displays all of the collections in your store except the home page collection. In many cases the behaviour can be overridden by creating a menu called "Collections".
Global Objects
Following objects are available from any Liquid template in the system.
- template
- page_title
- page_description
- shop
- cart
- products
- collections
- linklists
- pages
- blogs
- request
- cookies
- header
- canonical_url
- exchange_rate
- gift_card
Conditional Objects
If a customer is logged in
Other Objects
The following objects are referenced by other Liquid Template Variables, and may be accessed from those objects, rather than being referenced directly.