Liquid Filters

default

Задать значение поумолчанию

{{ product_price | default: 2.99 }}
>> 2.99
{% assign product_price = "" %}
{{ product_price | default: 2.99 }}
>> 2.99 copy

lstrip

Удалить табы, пробелы, переносы в начале строки

{{ " So much room for activities! " | lstrip }}
>> So much room for activities!
copy

escape(input)

Фильтр используется для преобразовывания специальных и национальных символов в URL представление (percent-encoding: пробел в %20, например) в тексте ссылки. Это необходимо, согласно стандарта RFC1738 - Uniform Resource Locators (URL).

{{ link.title | escape }}copy

append(input)

Фильтр используется для добавления указанных символов к концу указанной строки.

{{ 'sales' | append: '.jpg' }}copy sales.jpgcopy

prepend(input)

Фильтр используется для добавления указанных символов к началу указанной строки.

size(input)

Возвращает размер массива или строки.

{{ 'this is an 30 character string' | size }}copy 30copy

sort(input, property = z)

Фильтр используется для сортировки массива. Второй параметр - необязательный.

split(input, segmenter = ' ')

Разбивает строку на массив подстрок по указанному разделителю. Пример:

{{ 'abc // foo // bar' | split: '//' | last }}copy barcopy

join(input, segmenter = ' ')

Фильтр объединяет массив в строку, используя как разделитель элементов указанную последовательность символов. Пример:

{{ product.tags | join: ', ' }}copy tag1, tag2, tag3copy

downcase(input)

Фильтр преобразовывает строку к нижнему регистру.

upcase(input)

Фильтр преобразовывает строку к верхнему регистру.

strip_html

Этот фильтр изымает из указанного текста все HTML-теги. Очень эффективен в сочетании с truncate. {{ article.content | strip_html | truncate: 20 }}copy

strip_newlines

Фильтр изымает из указанной последовательности символов служебный символ "Новая строка" (символ, обозначаемый NL, \n, имеющий код 0ah).

truncate(input, characters = 100)

Фильтр укорачивает строки до указанного количества символов удалением конца строки. В случае, если обрабатываемый текст содержит HTML-теги, можно сперва применить фильтр strip_html(см. выше).

truncatewords(input, words = 15)

Фильтр укорачивает строку до указанного количества символов удалением конца строки.

date(input, format)

Фильтр преобразует формат даты в указанный (все даты - григорианского календаря)

• %a - Сокращённое обозначение дня недели (``Sun'')
• %A - Полное обозначение дня недели (``Sunday'')
• %b - Сокращённое обозначение названия месяца (``Jan'')
• %B - Полное обозначение названия месяца (``January'')
• %c - Предпочтительное местное представление даты и времени
• %d - День месяца (01..31)
• %H - Час суток, 24-часовое представление (00..23)
• %I - Час суток, 12-часовое представление (01..12)
• %j - Номер дня года (001..366)
• %m - Номер месяца года (01..12)
• %M - Номер минуты часа (00..59)
• %p - Указатель времени суток (``AM'' or ``PM'') ''после полудня'' или ''до полудня'' соответственно
• %S - Секунда минуты (00..60)
• %U - Неделя текущего года, начиная с первого воскресенья года как первого дня первой недели (00..53)
• %W - Неделя текущего года, начиная с первого понедельника года как первого дня первой недели (00..53)
• %w - Номер дня недели (Воскресенью соответствует 0, 0..6)
• %x - Предпочтительное представление только даты, без указания времени
• %X - Предпочтительное представление только времени, без указания даты
• %y - Номер года двузначный (00..99)
• %Y - Номер года четырёхзначный
• %Z - Имя временной зоны
• %% - Обозначает символ ``%''

first(array)

Фильтр возвращает первый элемент из массива

{{ product.images | first | to_img }} copy

last(array)

Вернуть последний элемент массива

{{ product.images | last | to_img }} copy

newline_to_br

Фильтр добавляет тег конца строки <br /> перед каждым служебным символом "Новая строка" (символ, обозначаемый NL, \n, имеющий код 0ah).

replace(input, substring, replacement)

Фильтр заменяет все вхождения в input последовательности substring на последовательность replacement

{{ product.description | replace: 'super', 'mega' }} copy

replace_first(input, substring, replacement)

Фильтр заменяет первое вхождение в input последовательности substring на последовательность replacement

{{ product.description | replace_first: 'super', 'mega' }} copy

remove(input, substring)

Фильтр удаляет из input все вхождения последовательности substring

{{ product.description | remove: 'way too expensive'}} copy

remove_first(input, substring)

Фильтр удаляет из input первое вхождение последовательности substring

{{ product.description | remove_first: 'remove-me'}} copy

plus(input, operand)

Фильтр возвращает результат сложения input и operand. Если это строки, то они приводятся к формату "целое" перед сложением.

Showing {{ paginate.current_offset }}-{{ paginate.current_offset | plus: paginate.page_size }} itemscopy

minus(input, operand)

Фильтр возвращает результат вычитания operand из input. Если это строки, то они приводятся к формату "целое" перед вычитанием.

{{ product.price | minus: 10 | money_with_currency }}copy

round(input, operand)

Фильтр возвращает результат округления operand до input знаков после разделителя.

{{ product.price | round: X | money_with_currency }}copy

times(input, operand)

Фильтр возвращает результат умножеия input и operand.

{{ ‘foo’ | times:4 }} #=> ‘foofoofoofoo’ {{ 5 | times:4 {{ #=> 20 copy

divided_by(input, operand)

Фильтр возвращает результат деления input на operand.

{{ 10 | divided_by:2 }} #=> 5copy

modulo

Модуль числа. Возвращает остаток после деления

{{ 12 | modulo:5 }} => 2copy

• wiki ›
• 

Filters

asset_url

Gives you the url for an asset

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

capitalize

Capitalizes the text

{{ 'capitalize me' | capitalize }}copy Capitalize Mecopy

default_pagination

used in conjunction with the {{ paginate }} liquid tag

global_asset_url

Returns the url for a global asset (global assets are faster than regular asset_url)

{{ 'image.png' | global_asset_url }}copy

file_url

Returns the url for a file (Сайт->Файлы)

{{ 'image.png' | file_url }}copy

locale_url

Фильтр преобразует URL с учетом текущего языка (нужно только в мультиязычных магазинах)

{{ '/page/about' | locale_url }}copy

link_to

Название магазинаGenerates a html link

Simple {{ 'Click' | link_to: 'http://insales.ru' }}copy <a href="http://insales.ru" >Click</a>copy Add a title {{ 'Click' | link_to: 'http://insales.ru','Title text' }}copy <a href="http://insales.ru" title="Title text">Click</a>copy

money_with_currency_format

Используется вместе с InSales.formatMoney для формата вывода цены через js.

$('#price-field').html(InSales.formatMoney(variant.price, "{{money_with_currency_format}}"))copy $19.00 CADcopy

money

Adds the currency symbol

{{ product.price | money }}copy $19.00copy

• wiki ›
• 

Liquid

Logic

{% comment %}

Comments will be hidden

My name is {% comment %}Mark{% endcomment %} Dunkleycopy My name is Dunkleycopy

{% if %}

"If" statements let you determine if something is true or not

if username is elvis {% if user.name == 'elvis' %}
hey Elvis
{% endif %}copy hey Elviscopy Else if example {% if user.name == 'elvis' %}
hey elvis
{% elsif user.name == 'Mark' %}
hey mark
{% else %}
hi stranger
{% endif %}copy hi strangercopy

{% unless %}

If not true, then it will do something

username is not "elvis" {% unless user.name == 'elvis' %}
hey ugly
{% endunless %} copy hey uglycopy

{% case %}

Used when you have consistent cases of something

case [handle is 'cookie'] {% case handle %}
{% when 'cake' %}
This is a cake
{% when 'cookie' %}
This is a cookie
{% else %}
This is not a cookie/cake
{% endcase %}copy This is a cookiecopy

{% cycle %}

Use when you need to alternate between something.

Basic example {% cycle 'one', 'two' %}
{% cycle 'one', 'two' %}
{% cycle 'one', 'two' %} copy one
two
onecopy Group cycles {% cycle 'group 1': 'one', 'two', 'three' %}
{% cycle 'group 1': 'one', 'two', 'three' %}
{% cycle 'group 2': 'one', 'two', 'three' %}
{% cycle 'group 2': 'one', 'two', 'three' %}
copy one two one two copy

{% for %}

Use "for loops" if you want to repeat/test something over and over

Loop options

• limit:
• offset:

For Loop [product are: hat, pez, pad] {% for product in collection.products %}
{{ product.name }},
{% endfor %} copy hat, pez, pad,copy Limit [product are: hat, pez, pad] {% for product in collection.products limit:2 %}
{{ product.name }},
{% endfor %} copy hat, pez,copy

{% break %}

Exits a for loop

{% raw %}

Временно отключить обработку тегов, чтобы избежать конфликтов синтаксиса.

{% raw %}
In Handlebars, {{ this }} will be HTML-escaped, but {{{ that }}} will not.
{% endraw %}

{% tablerow %}

Generate table rows/cells

You have a few options

• cols:
• limit:

Example [products are: hat, pez, pad] <table>
{{% tablerow product in collection.products cols: 2 %}
<td>
{{ product.title }}
</td>
{% endtablerow %}
</table>copy <table>
<tr>
<td>hat</td>
<td>pez</td>
</tr>
<tr>
<td>pad</td>
</tr>
</table>
copy

{% assign %}

Create variables

{% assign myvariable = false %}
{% if myvariable != true %}
The if statement is valid
{% endif %}copy The if statement is validcopy

{% capture %}

Similar to {% assign %} and allows you to "capture" a variable you output

{% capture productlink %}
{{ product.url }}
{% endcapture %}
{{ productlink }}copy /products/applecopy

{% include %}

Insert a snippet into your layout

Within the snippet color.liquid color: '{{ color }}'
shape: '{{ shape }}'
copy Within the template index.liquid {% assign shape = 'circle' %}
{% include 'color' %}
{% include 'color' with 'red' %}
{% include 'color' with 'blue' %}
{% assign shape = 'square' %}
{% include 'color' with 'red' %}copy color: ''
shape: 'circle'
color: 'red'
shape: 'circle'
color: 'blue'
shape: 'circle'

color: 'red'
shape: 'square'
copy

{% increment %}

Создает новую переменную и каждый раз, когда он вызывается увеличивает значение на 1, с начальным значением равным 0

{% increment variablename %}
{% increment variablename %} 0
1

{% decrement %}

Создает новую переменную и каждый раз, когда он вызывается уменьшает значение на 1, с начальным значением бытия -1

{% decrement variablename %}
{% decrement variablename %} -1
-2

Operators

== !- > < >= <= or and

You can use operators in all the above logic statements

• == equal
• != not equal
• > bigger than
• < less than
• >= bigger or equal
• <= less or equal
• or this or that
• and must be this and that
• contains includes the substring if used on a string, or element if used on an array

• wiki ›
• 

Theme Settings

Text field

                  <tr>
                  <th><label for="my_text">Name of this setting.</label></th>
                  <td><input type="text" id="my_text" name="my_text" class="text" value=""/></td>
                  </tr>
                

Multiline text field

                  <tr>
                  <th><label for="my_textarea">Name of this setting.</label></th>
                  <td><input type="textarea" rows="4" cols="20" id="my_textarea" name="my_textarea" class="textarea" value=""/></td>
                  </tr>
                

Drop-down menus

                  <tr>
                  <td><label for="my_dropdown">Name of this Setting</label></td>
                  <td>
                  <select name="my_dropdown" id="my_dropdown">
                  <option value="1" selected="selected">1</option>
                  <option value="2">2</option>
                  <option value="3">3</option>
                  <option value="4">4</option>
                  </select>
                  </td>
                  </tr>
                

Checkboxes

                  <tr>
                  <td><label for="my_checkbox">Name of this Setting</label></td>
                  <td><input type="checkbox" id="my_checkbox" name="my_checkbox" value="1" /></td>
                  </tr>
                

File Uploads

                  <tr>
                  <td><label for="my_img">Settings Name</label></td>
                  <td>
                  <input type="file" id="my_img" name="my_img.jpg"  data-max-width="100" data-max-height="200" />
                  </td>
                  </tr>
                

• wiki ›
• 

Essentials

What is liquid and what are tags

We use liquid to generate our code. There are 2 types

Will output something {{ 'output me' }}copy output mecopy Logic statement {% logic %}copy

What is a handle?

A handle is how we name our elements (collections, products, articles, etc)

• wiki ›
• 

Template variables

collection.liquid

collection.id

Id коллекции

collection.title

Название категории.

collection.handle

Пермалинк коллекции

collection.description

Описание категории.

collection.seo_description

Дополнительное описание категории.

collection.products

Массив товаров категории.

collection.products_count

Количество товаров в данной категории.

collection.image

Изображение категории.

collection.current_collections

Массив родительских категорий, включая текущую.

collection.current?

Является ли категория текущей?

collection.has_subcollections?

Есть ли у категории подкатегории. Метод используется только в выводе дерева категорий через collections.flatten.

collection.subcollections

Подколлекции данной категории.

collection.level

Уровень вложенности категории (начинается с 1).

collection.parent

Родительская категория.

current_collections

Список текущих категорий (полезно в случае многоуровневой структуры каталога), например для вывода хлебных крошек.

collection.first?

Первая ли категория среди подкатегорий родительской категории. Метод используется в выводе дерева категорий.

collection.last?

Последняя ли категория среди подкатегорий родительской категории. Метод используется в выводе дерева категорий.

collection.show?

Нужно ли показывать категорию при отображения дерева. Верно, если это категория верхнего уровня, текущая или родительская категория является текущей. Метод используется в выводе дерева категорий.

collection.level_difference?

Возвращает разницу уровней между текущей и предыдущей категорией, по сути число означает сколько закрывающих тегов надо вывести при отображении дерева.

collection.properties

Параметры всех товаров категории.

collections.current_characteristics

Текущие значения параметров всех товаров категории.

collections.[handle].flatten_branch

Массив коллекций без вложенности, тоесть субколлекции находятся в одном массиве с основными коллекциями.

collection.options

Свойства всех товаров категории.

collection.current_option_values

Текущие свойства всех товаров категории.

collection.next_product

При помощи этого метода можно организовать в карточке товара переход к следующему товару категории (горизонтальная навигация).

collection.previous_product

При помощи этого метода можно организовать в карточке товара переход к предыдущему товару категории (горизонтальная навигация).

collection.products_price_min

Минимальная цена товара в категории.

collection.products_price_max

Максимальная цена товара в категории.

collection.url

URL коллекции

collection.page_title

Title страницы категории

collection.recursive?

Включена ли настройка "Содержит товары из подкатегорий"

collection.meta_keywords

meta keywords страницы категории

collection.meta_description

meta description страницы категории

collection.filters

Массив всех seo-фильтров категории.

collection.fields

Массив дополнительный поле категории

Filter (SEO-Filter)

filter.title

Название фильтра.

filter.id

id фильтра

filter.meta_keywords

Значение мета тега description фильтра.

filter.meta_description

Значение мета тега keywords фильтра.

filter.handle

Пермалинк фильтра.

filter.description

Описание фильтра.

Cart

cart.items_count

Число позиций в корзине.

cart.items

Массив товаров (товарных позиций) в корзине.

cart.items_price

Суммарная стоимость всех позиций в корзине.

cart.total_price

Суммарная стоимость заказа с учетом доставки.

cart.items_weight

Суммарный вес всех позиций в корзине.

cart.enable_coupon?

Флаг, обозначающий, включено использование купонов или нет, - если купоны запрещены тарифом - возвращает true.

cart.coupon

Введенный код купона.

cart.invalid_coupon?

Флаг, обозначающий, что введенн неверный купон, если купон не задан возвращает false.

cart.coupon_error

Сообщение ошибки ввода купона.

cart.discounts

Массив скидок.

item.id

Идентификатор позиции.

item.title

Название позиции.

item.product

Товар позиции.

item.variant

Модификация товара позиции.

item.sale_price

Цена одного товара позиции.

item.weight

Вес одного товара позиции.

item.quantity

Число товаров в позиции.

item.total_price

Суммарная стоимость товаров позиции.

item.total_weight

Суммарный вес товаров позиции.

item.url

URL для удаления товаров из корзины.

item.comment

Комментарий к позиции заказа.