Что такое Liquid и как он работает в Shopify
Liquid (ликвид) – это открытый язык шаблонов, созданный Shopify. На нем написаны темы магазинов, а сам язык используют и вне Shopify, например в Jekyll. В статье разберем objects, tags и filters, условия, циклы и актуальный вывод изображений.
Код темы редактируют в админке Shopify через «Интернет-магазин» → «Темы» → меню темы → «Изменить код».
Для локальной разработки используют Shopify CLI. Примеры ниже подходят для файлов секций и сниппетов темы.
Как работает Liquid в теме Shopify
Shopify собирает страницу из нескольких уровней темы. Layout задает общую оболочку, JSON-шаблон выбирает секции, а секции и сниппеты содержат HTML с Liquid-разметкой.
В Online Store 2.0 шаблоны страниц обычно хранятся в формате JSON. Файл вроде templates/product.json описывает состав страницы, а разметка товара находится в секции, например sections/main-product.liquid. Общая оболочка темы лежит в layout/theme.liquid.
Shopify обрабатывает Liquid на сервере и отправляет браузеру готовый HTML.
Браузер не исполняет Liquid-код: он получает результат работы объектов, тегов и фильтров. Архитектура темы описана в документации Shopify по архитектуре тем.
Основы Liquid
У Liquid есть три базовые конструкции. Они отвечают за вывод данных, управление разметкой и преобразование значения.
Вывод объектов через двойные скобки
Objects выводят данные между двойными фигурными скобками {{ }}. Точка обращается к свойству объекта и помогает получать вложенные значения.
<h2>{{ product.title }}</h2>
<div>{{ product.description }}</div>Выражение product.title обращается к названию текущего товара. Выражение product.description выводит его описание, включая разметку, которую сохранил редактор товара.
Пример с объектом магазина выглядит так:
<p>Магазин: {{ shop.name }}</p>
<p>Коллекция: {{ collection.title }}</p>Список доступных объектов и их свойств собран в справочнике объектов Liquid.
Теги Liquid в фигурных скобках с процентом
Tags управляют логикой шаблона. Они могут проверять условие, запускать цикл, создавать переменную или подключать сниппет.
{% if product.available %}
<p>Товар есть в наличии</p>
{% else %}
<p>Товар распродан</p>
{% endif %}Конструкция if выводит первый блок при истинном значении product.available. Конструкция else выбирает второй блок, когда условие ложно.
Фильтры после вертикальной черты
Filters изменяют значение перед выводом.
Несколько фильтров образуют цепочку: следующий фильтр получает результат предыдущего.
{{ product.title | escape | upcase }}Сначала escape экранирует значение для HTML, затем upcase меняет регистр. Официальный список фильтров находится в справочнике Liquid filters.
Доступ к свойствам через точку
В выражении product.title элемент слева от точки – объект, а элемент справа – его свойство. Такая запись также работает с вложенными данными.
{{ product.selected_or_first_available_variant.price }}Если значение может отсутствовать, добавьте условие или фильтр, который задает подходящий результат. Так шаблон не показывает пустой заголовок без объяснения.
Логика и условия Liquid
Условия выбирают HTML по значению объекта. Используйте if для основной проверки, elsif для дополнительных вариантов, unless для обратного условия, а case – для нескольких вариантов одного значения.
if, elsif, else и unless
{% if product.available %}
<span>В наличии</span>
{% elsif product.tags contains 'preorder' %}
<span>Доступен предзаказ</span>
{% else %}
<span>Нет в продаже</span>
{% endif %}
{% unless cart.item_count > 0 %}
<p>Корзина пуста</p>
{% endunless %}unless выполняет блок, когда условие ложно.
Сложные цепочки условий лучше разделять на понятные проверки, чтобы шаблон оставался читаемым.
case и when
{% case product.type %}
{% when 'Кофе' %}
<p>Раздел с кофе</p>
{% when 'Аксессуары' %}
<p>Раздел с аксессуарами</p>
{% else %}
<p>Другой тип товара</p>
{% endcase %}case сравнивает одно выражение с вариантами when. Такая форма удобнее длинной последовательности elsif, когда все проверки относятся к одному свойству.
Переменные assign и capture
Тег assign сохраняет вычисленное значение. Тег capture собирает текстовый фрагмент, в который можно включить Liquid-разметку.
{% assign heading = product.title | escape %}
<h2>{{ heading }}</h2>
{% capture label %}Товар: {{ product.title }}{% endcapture %}
<p>{{ label }}</p>Операторы Liquid
Оператор сравнивает значения, а логический оператор соединяет проверки. В таблице собраны основные варианты для условий.
| Оператор | Значение | Пример |
|---|---|---|
== | равно | product.type == 'Кофе' |
!= | не равно | product.type != 'Одежда' |
> | больше | cart.item_count > 0 |
< | меньше | product.price < 1000 |
>= | больше или равно | product.price >= 1000 |
<= | меньше или равно | product.price <= 1000 |
contains | содержит значение | product.title contains 'Кофе' |
and | оба условия истинны | product.available and product.price > 0 |
or | истинно хотя бы одно условие | product.available or product.tags contains 'preorder' |
Циклы Liquid
Цикл for проходит по элементам массива. Shopify завершает цикл после последнего элемента и продолжает обработку шаблона.
Этап 1: массив product.images
Объект product.images содержит массив изображений текущего товара.
Внутри цикла переменная image получает текущий элемент. Массив изображений отличается от коллекции товаров магазина: каждый его элемент описывает отдельную картинку.
{% for image in product.images %}
{{ image | image_url: width: 800 | image_tag: alt: product.title }}
{% endfor %}Похожим массивом служит product.variants. Передайте его в for, если выводите варианты товара.
Этап 2: image_url и image_tag
Фильтр image_url создает URL изображения и принимает параметр width. Фильтр image_tag превращает URL в HTML-элемент изображения и добавляет атрибуты тега.
{{ image | image_url: width: 800 | image_tag: alt: product.title, loading: 'lazy' }}Такой вариант заменяет устаревший product_img_url.
Параметр width задает ширину изображения для выбранного URL, а image_tag создает обычный элемент <img>.
Этап 3: параметры цикла
Параметры limit и offset ограничивают диапазон элементов. Объект forloop сообщает позицию текущего элемента.
{% for image in product.images limit: 4 offset: 1 %}
<figure class="product-image{% if forloop.first %} is-first{% endif %}{% if forloop.last %} is-last{% endif %}">
{{ image | image_url: width: 800 | image_tag: alt: product.title }}
<figcaption>Изображение {{ forloop.index }}</figcaption>
</figure>
{% else %}
<p>Нет изображений в выбранном диапазоне</p>
{% endfor %}forloop.first и forloop.last возвращают логическое значение. Свойство forloop.index нумерует элементы с 1, а forloop.index0 – с 0.
render для сниппетов
Тег render подключает сниппет и передает ему данные.
Используйте render при разработке новых тем. Прежний тег подключения include устарел.
{% for image in product.images %}
{% render 'product-image', image: image, product: product %}
{% endfor %}Файл snippets/product-image.liquid получает переменные image и product. Сниппет помогает не дублировать разметку в нескольких секциях.
Комментарии и пробелы
Тег comment временно скрывает фрагмент Liquid. Управление пробелами через {%- и -%} убирает пробельные символы вокруг тега.
{% comment %}Временный фрагмент{% endcomment %}
{%- assign title = product.title -%}
<h2>{{ title }}</h2>Фильтры Liquid
Фильтр получает значение слева от вертикальной черты и возвращает измененный результат. Аргументы фильтра пишутся после двоеточия, а цепочка обрабатывается слева направо.
Дата, текст и адрес
| Фильтр | Что делает | Пример |
|---|---|---|
date | Форматирует дату | {{ article.published_at | date: '%d %B %Y' }} |
escape | Экранирует текст для HTML | {{ product.title | escape }} |
strip | Убирает пробелы по краям | {{ value | strip }} |
replace | Заменяет часть строки | {{ title | replace: 'старое', 'новое' }} |
handleize | Создает handle из строки | {{ product.title | handleize }} |
{{ article.published_at | date: '%d %B %Y' }}Деньги и списки
| Фильтр | Что делает | Пример |
|---|---|---|
money | Форматирует цену по настройкам магазина | {{ product.price | money }} |
money_with_currency | Добавляет обозначение валюты | {{ product.price | money_with_currency }} |
default | Подставляет значение, если исходное пустое | {{ product.metafields.custom.subtitle | default: product.title }} |
join | Объединяет элементы массива | {{ product.tags | join: ', ' }} |
sort | Сортирует массив | {{ collection.products | sort: 'title' }} |
asset_url и stylesheet_tag
Фильтр asset_url строит адрес файла из папки assets. Фильтр stylesheet_tag оборачивает этот URL в элемент <link rel="stylesheet">.
{{ 'theme.css' | asset_url | stylesheet_tag }}Цепочка сначала получает адрес theme.css, затем создает HTML-подключение таблицы стилей.
Аналогично фильтр script_tag создает элемент для подключения JavaScript-файла.
{{ 'theme.js' | asset_url | script_tag }}Что запомнить о Liquid
Liquid связывает данные Shopify с HTML темы. Objects выводят значения через {{ }}, tags управляют логикой через {% %}, а filters преобразуют значения после вертикальной черты.
Для изображений используйте связку image_url и image_tag, для повторяющегося блока – for и render. Справочник объектов, тегов и фильтров поможет подобрать точное имя свойства или конструкции.
Совет от редакции: сначала соберите небольшой фрагмент в отдельном сниппете, а затем подключайте его в секцию через render. Так ошибку в условии или фильтре проще найти и убрать.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы для создания сайтов — плюсы, минусы и сравнения 22 мин чтения
- Как правильно редактировать шаблоны WordPress 4 мин чтения
- Как отредактировать главную страницу WordPress 11 мин чтения
- Как увеличить размер файла в WordPress 12 мин чтения
- Как настроить SMTP в WordPress: проверка и установка 2 мин чтения
Комментарии
Не верно написали:
{% if product.available %}
Этот товар отсутствует // На самом деле, здесь товар присутствует.
{% else %}
Извините, этот товар распродан
{% endif %}
а где же следующая статья на тему Shopify?