Метаполя в шаблонах

Метаполя — это пользовательские данные, которые вы или ваши приложения храните в Shopify: подарочное сообщение в заказе, инструкция по уходу у товара, номер счёта клиента. Шаблоны могут выводить их с помощью Liquid. Вкладка Метаполя в редакторе кода показывает синтаксис для каждого вида.

Перед началом: проверьте, какие метаполя загружает Foliant

Foliant загружает метаполя вместе с заказом, но не может загрузить их все. Это работает так:

В вашем магазине должно быть хотя бы одно определение метаполя (в админке Shopify: Настройки › Пользовательские данные). Если определений нет, метаполя не загружаются.
Для каждого вида (заказы, черновики заказов, клиенты, товары и варианты) Foliant загружает закреплённые вами определения, до 10 на вид, в порядке закрепления.
Если у вида нет закреплённых определений, Foliant загружает первые 10 найденных для него метаполей.

Поэтому, чтобы метаполе точно выводилось, создайте для него определение и закрепите его в разделе Настройки › Пользовательские данные. Изменения определений могут появиться в документах в течение часа.

Вывод метаполя

Замените namespace и key на пространство имён и ключ вашего метаполя (например, custom.gift_message):

Метаполе	Liquid
Заказа или черновика заказа	`{{ order.metafields.namespace.key }}`
Клиента	`{{ customer.metafields.namespace.key }}`
Товара	`{{ line_item.product.metafields.namespace.key }}`
Варианта	`{{ line_item.variant.metafields.namespace.key }}`

Метаполя товаров и вариантов относятся к отдельной позиции, поэтому используйте их внутри цикла по позициям:

{% for line_item in line_items %}
  {{ line_item.title }}
  {% if line_item.product.metafields.custom.care_instructions != blank %}
    <br>{{ line_item.product.metafields.custom.care_instructions }}
  {% endif %}
{% endfor %}

Как выводятся типы метаполей

Тип	Что вы получаете
Текст, URL, дата, цвет…	Значение в виде текста
Целое число, десятичное число	Число, которое можно сравнивать или использовать в вычислениях
Истина или ложь	`true` или `false` для `{% if %}`
Форматированный текст	Текст без форматирования
Вес, размер, объём	`.value` и `.unit`, например `{{ … .weight.value }} {{ … .weight.unit }}`
Деньги	`.value` (например, `23.00`) и `.unit` (код валюты). Не в центах.
Рейтинг	`.value`, `.scale_min` и `.scale_max`
JSON, списки	Список или объект, по которому можно пройти циклом

Полезно знать

Пустое или отсутствующее метаполе ничего не выводит. Используйте != blank, чтобы скрыть его подпись.
В визуальных шаблонах выводите метаполя с помощью блока Свой Liquid.
Листы сборки могут показывать метаполя товаров или вариантов в виде столбцов: это задаётся в настройках Лист сборки шаблона.

Добро пожаловать

Начало работы

Печать

Шаблоны

Редактор шаблонов

Дизайны

Отправка PDF

Шаблоны писем

Аккаунты покупателей

Экспорт

Счета и нумерация

Налоги и юридические данные

Интеграции

Оплата и тарифы

Настройки

Устранение неполадок

Правовая информация

Перед началом: проверьте, какие метаполя загружает Foliant

Вывод метаполя

Как выводятся типы метаполей

Полезно знать

Связанные статьи