Правило: Додати значення багатозначного елемента#

Основний принцип правила полягає в тому, що воно додає вибраному наявному елементу ще одне значення.

Додаткові функції#

Як поводиться правило в різних ситуаціях? Якщо:

елемент поки що не має жодного значення – додає нове значення на першу позицію, тож багатозначний елемент не виникає:
- <g:additional_image_link></g:additional_image_link>
  ->
  <g:additional_image_link>нове значення</g:additional_image_link>
елемент поки що має одне значення – додає нове значення на наступну, тобто другу позицію, тож виникає багатозначний елемент:
- <g:additional_image_link>початкове значення А</g:additional_image_link>
  ->
  <g:additional_image_link>початкове значення А</g:additional_image_link>
  <g:additional_image_link>нове значення</g:additional_image_link>
елемент уже має кілька значень (уже є багатозначним) – додає нове значення на наступну, тобто першу вільну позицію:
- <g:additional_image_link>початкове значення А</g:additional_image_link>
  <g:additional_image_link>початкове значення Б</g:additional_image_link>
  ->
  <g:additional_image_link>початкове значення А</g:additional_image_link>
  <g:additional_image_link>початкове значення Б</g:additional_image_link>
  <g:additional_image_link>нове значення</g:additional_image_link>

Конкретні приклади#

Приклад 1: Додавання ще однієї URL-адреси альтернативного зображення#

1. Створення нового правила:

Відкрийте сторінку Rules.
Натисніть кнопку New rule.

2. Вибір типу правила:

У полі Rule type виберіть варіант Add a Value to a Multi-Value Element.

3. Вибір товарів:

У полі Query або виберіть All products, або створіть власну Product query для конкретних товарів, до яких хочете застосувати правило.

4. Вибір елемента для зміни:

У полі Element виберіть елемент, у якому хочете виконати зміну.
У нашому випадку це буде g:additional_image_link

5. Введіть нове значення:

У поле New value введіть:
- текстове значення, наприклад: конкретну URL-адресу (https://www…)
- змінну, у якій збережено значення, наприклад: %url%
- поєднання змінної й тексту, наприклад: https://www.my-shop.com/%image_handle%

6. Назва правила:

На останньому кроці введіть назву правила, наприклад: Додавання альтернативних зображень.

Інші способи використання правила#

Додати ще альтернативні категорії.

Часті запитання#

Для чого слугує правило «Add a Value to a Multi-Value Element»? #

Це правило дає змогу додати нове значення до наявного елемента, який підтримує кілька значень (наприклад, зображення, категорії або параметри). Зазвичай його використовують для доповнення ще однієї URL-адреси зображення (g:additional_image_link) або альтернативних категорій.

Як поводиться правило, коли елемент поки що не має жодного значення?#

Якщо елемент не має жодного значення, Mergado створить перше значення, і елемент поки що не вважається багатозначним.

<g:additional_image_link></g:additional_image_link>
→
<g:additional_image_link>нове значення</g:additional_image_link>

Що станеться, якщо елемент має одне або кілька значень?#

Якщо він має одне значення, нове значення додасться на наступну позицію, і елемент стане багатозначним.
Якщо він має кілька значень, нове значення додасться на перше вільне місце (тобто як наступна позиція за порядком).

💡 Приклад:

<g:additional_image_link>початкове_А</g:additional_image_link>

→

<g:additional_image_link>початкове_А</g:additional_image_link>

<g:additional_image_link>нове_значення</g:additional_image_link>

Чи можна цим правилом додати кілька значень одночасно?#

Не безпосередньо. Кожне правило додає одне значення в один рядок. Якщо хочете додати кілька значень (наприклад, кілька URL-адрес зображень), використайте кілька правил цього типу.

Які типи значень можна додати до елемента?#

У поле New value можна ввести:

текстове значення, наприклад https://www.mujshop.cz/img123.jpg,
змінну, наприклад %url%,
поєднання тексту й змінної, наприклад https://cdn.mujshop.cz/%image_name%.

Чи можна цим правилом додати й динамічне значення з іншого елемента?#

Так. Якщо хочете додати значення з іншого елемента, використайте його змінну (наприклад, %g:image_link%). Mergado під час перегенерації автоматично доповнить значення кожного товару відповідно до цієї змінної.

Як дізнатися, що мій елемент багатозначний?#

На сторінці Elements у проєкті в багатозначних елементів (наприклад, g:additional_image_link) відображається максимальна кількість значень у дужках, наприклад (6×). Такі елементи можуть в одного товару траплятися кілька разів.
Огляд знайдете в документації: Багатозначні елементи в Mergado.

Чи можна використати правило й для інших цілей, ніж зображення?#

Так. Правило можна використати, наприклад, для:

додавання інших категорій,
доповнення альтернативних URL-адрес,
розширення списку параметрів (наприклад, додати новий параметр для товарів із певної вибірки).

Чи можна додаване значення обмежити лише певними товарами?#

Так. У полі Query можна вибрати або All products, або створити власну вибірку, наприклад лише для товарів певного бренду, категорії або з відсутнім зображенням.

Що станеться, якщо елемент, до якого я хочу додавати, у фіді відсутній?#

Правило його автоматично не створить – спершу його потрібно додати вручну:

Відкрийте сторінку Elements,
натисніть New element,
введіть назву елемента (наприклад, g:additional_image_link),
і підтвердьте створення.

Чи можна додавання значення запланувати в часі?#

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

Як перевірити, що додавання значення пройшло правильно?#

Після збереження й застосування правил або після перегенерації фіду:

відкрийте сторінку Elements або сторінку Products,
перевірте, що з’явився новий рядок значення,
або запустіть Rule walkthrough для конкретного товару – він покаже вам результат правила в реальному часі.

Чи можна цим правилом замінити наявне значення?#

Ні. Правило лише додає нові значення, наявні значення не змінює й не видаляє. Якщо вам потрібно переписати значення, скористайтеся правилом Переписати або Масове переписування за вибірками.

На що звернути увагу під час використання правила?#

Після додавання правила завжди виконайте перегенерацію фіду.
Якщо значення не відображаються, перевірте вибірку товарів і те, чи елемент справді існує.

Чи можна додати значення до елемента, який у вихідному форматі не дозволений?#

Якщо цільовий елемент у форматі не підтримується, Mergado його до виходу не вставить. У такому разі потрібно спершу змінити вихідний формат проєкту або створити елемент вручну на сторінці Elements.

Чи можу я цим правилом доповнювати зображення із зовнішньої таблиці (наприклад, з Google Sheets)?#

Так. Якщо у вас є таблиця з посиланнями на зображення, їх можна імпортувати до Mergado за допомогою правила Імпорт файлу даних (CSV / XML) і потім доповнити за допомогою цього правила. Так можна поєднувати зовнішні дані з багатозначними елементами у фіді.