Difference between revisions of "Theme.liquid"

From Spiffy Stores Knowledge Base

(New page: == Overview == The file '''theme.liquid'' is basically an HTML/XHTML file that contains liquid tags and provides the overall ''theme'' of the site. In this file, you will want everything ...)
 
m
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Overview ==
 
== Overview ==
  
The file '''theme.liquid'' is basically an HTML/XHTML file that contains liquid tags and provides the overall ''theme'' of the site. In this file, you will want everything that is normally included in a standard ''index.html'' page.
+
The '''theme.liquid''' file is basically an HTML/XHTML file that contains liquid tags and provides the overall ''theme'' of the site. In this file, you will want everything that is normally included in a standard ''index.html'' page.
  
 
For example, you will need
 
For example, you will need
  
* A doctype specifying whether it's transitional or strict
+
* A Doctype specifying whether it's transitional or strict
* A head tag
+
* A Head tag
* A body tag
+
* A Body tag
  
This file contains all the static elements of your store.
+
This file contains all the static elements of your site.
  
You must include the following two lines somewhere within the file.
+
You '''must''' include the following two lines somewhere within the file.
  
 
* head section:
 
* head section:
Line 18: Line 18:
 
   <pre> {{ content_for_layout }}</pre>
 
   <pre> {{ content_for_layout }}</pre>
  
The dynamic content(meaning all the other liquid templates being found in ../templates) such as the products screen or articles are rendered at the position where you included this tag.
+
The dynamic content is provided by the other liquid templates and the result of rendering these templates is included at the position where you included the ''content_for_layout'' tag.
  
Most likely you will want to specify javascript and stylesheet includes in the head tag of this file.
+
Normally, you will want to specify javascript and stylesheet includes in the head tag of this file.
  
An example of a javascript include tag with a liquid filter
+
Here is an example of a javascript include tag with a liquid filter
  
{{ 'shop.js' | asset_url | script_tag }}
+
<pre>{{ 'shop.js' | asset_url | script_tag }}</pre>
  
An example of a stylesheet include tag with a liquid filter
+
This is an example of a stylesheet include tag with a liquid filter
  
{{ 'shop.css' | asset_url | stylesheet_tag }}
+
<pre>{{ 'shop.css' | asset_url | stylesheet_tag }}</pre>
  
 
=== Variables ===
 
=== Variables ===
Line 34: Line 34:
 
In this file you have access to the following liquid variables:
 
In this file you have access to the following liquid variables:
  
    * template
+
* [[Liquid Template Variables - template|template]]
    * handle
+
* [[Liquid Template Variables - page_title|page_title]]
    * shop
+
* [[Liquid Template Variables - handle|handle]]
    * cart
+
* [[Liquid Template Variables - shop|shop]]
    * collections
+
* [[Liquid Template Variables - cart|cart]]
    * linklists
+
* [[Liquid Template Variables - products|products]]
    * pages
+
* [[Liquid Template Variables - collections|collections]]
    * blogs
+
* [[Liquid Template Variables - linklists|linklists]]
 +
* [[Liquid Template Variables - pages|pages]]
 +
* [[Liquid Template Variables - blogs|blogs]]
 +
* [[Liquid Template Variables - request|request]]
 +
* [[Liquid Template Variables - cookies|cookies]]
 +
 
 +
== Further Reference ==
 +
 
 +
* [[Liquid Basics]]
 +
* [[Liquid Tag Reference]]
 +
* [[Liquid Filter Reference]]
 +
* [[Liquid Variable Reference]]
 +
* [[Liquid Paginate Tag|Pagination ]]

Latest revision as of 12:17, 25 June 2018

Overview

The theme.liquid file is basically an HTML/XHTML file that contains liquid tags and provides the overall theme of the site. In this file, you will want everything that is normally included in a standard index.html page.

For example, you will need

  • A Doctype specifying whether it's transitional or strict
  • A Head tag
  • A Body tag

This file contains all the static elements of your site.

You must include the following two lines somewhere within the file.

  • head section:
{{ content_for_header }}
  • main content area:
 {{ content_for_layout }}

The dynamic content is provided by the other liquid templates and the result of rendering these templates is included at the position where you included the content_for_layout tag.

Normally, you will want to specify javascript and stylesheet includes in the head tag of this file.

Here is an example of a javascript include tag with a liquid filter

{{ 'shop.js' | asset_url | script_tag }}

This is an example of a stylesheet include tag with a liquid filter

{{ 'shop.css' | asset_url | stylesheet_tag }}

Variables

In this file you have access to the following liquid variables:

Further Reference