Что такое 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. Так ошибку в условии или фильтре проще найти и убрать.

Комментарии

Оставьте свой комментарий
SK
Sergey K.

Не верно написали:
{% if product.available %}
Этот товар отсутствует // На самом деле, здесь товар присутствует.
{% else %}
Извините, этот товар распродан
{% endif %}

V
Vitalis2512

а где же следующая статья на тему Shopify?