Дополнительные разделы в YML-файле

В YML-файле, помимо описания товаров offer, могут содержаться дополнительные разделы с данными: категории товаров, подарки и промоакции. Эти данные можно использовать в письмах.

В шаблонах писем доступ к этим данным осуществляется через функции работы с YML:

• yml_load,
• yml_xxx_get,
• yml_xxx_list.

Sendsay поддерживает следующие дополнительные разделы YML:

• category — категории;
• gift — подарки;
• promo — промоакции и промокоды.

Перед использованием данных в шаблоне необходимо загрузить YML-файл:

[% yml = yml_load("URL_YML_ФАЙЛА", "ignore_error", 1) %]

Далее данные из каждого раздела можно:

• получить по id — с помощью функций yml_xxx_get();
• получить список всех id — с помощью функций yml_xxx_list().

Если элемент не найден или данные недоступны, функции вернут undef.

Категории товаров

Раздел category содержит список категорий товаров и структуру рубрикатора.

Чтобы получить категории по id:

[% category = yml_category_get(yml, "ID_КАТЕГОРИИ") %]

Чтобы получить список категорий:

[% category_ids = yml_category_list(yml) %]

Подарки

Раздел gift содержит информацию о подарках.

Чтобы получить подарок по id:

[% gift = yml_gift_get(yml, "ID_ПОДАРКА") %]

Чтобы получить список подарков:

[% gift_ids = yml_gift_list(yml) %]

Промоакции

Раздел promo содержит описание акций и условий их применения.

Получить промоакцию по id:

[% promo = yml_promo_get(yml, "ID_ПРОМО") %]

Получить список промоакций:

[% promo_ids = yml_promo_list(yml) %]

Пример структуры данных в YML-файле

Это пример того, как могут выглядеть данные из дополнительных разделов YML-файла:

{
  "category": {
    "11": {
      "name": "Смартфоны",
      "parent": null
    },
    "40": {
      "name": "Samsung",
      "parent": "11"
    }
  },
  "gift": {
    "1234567": {
      "id": "1234567",
      "name": "Samsung Galaxy Buds",
      "picture": "https://example.ru/buds.jpg"
    }
  },
  "promo": {
    "03": {
      "description": "Получи беспроводные наушники в подарок",
      "start-date": "2024-02-21 00:00:00",
      "end-date": "2024-03-07 23:59:59"
    }
  }
}

Конкретный набор полей зависит от структуры вашего файла.