Pravidlo: Přidat hodnotu vícenásobného elementu#

Základním principem pravidla je, že námi vybranému existujícímu elementu přidá další hodnotu.

Extra funkce#

Jak se pravidlo chová v různých situacích? Pokud:

element zatím žádnou hodnotu nemá - přidá novou hodnotu na první pozici, nevznikne tak vícenásobný element:
- <g:additional_image_link></g:additional_image_link>
  ->
  <g:additional_image_link>nová hodnota</g:additional_image_link>
element má zatím jednu hodnotu - přidá novou hodnotu na další, tedy druhou pozici, vznikne tak vícenásobný element:
- <g:additional_image_link>původní hodnotaA</g:additional_image_link>
  ->
  <g:additional_image_link>původní hodnotaA</g:additional_image_link>
  <g:additional_image_link>nová hodnota</g:additional_image_link>
element má už více hodnot (už je vícenásobný) - přidá novou hodnotu na další, tedy první volnou pozici:
- <g:additional_image_link>původní hodnotaA</g:additional_image_link>
  <g:additional_image_link>původní hodnotaB</g:additional_image_link>
  ->
  <g:additional_image_link>původní hodnotaA</g:additional_image_link>
  <g:additional_image_link>původní hodnotaB</g:additional_image_link>
  <g:additional_image_link>nová hodnota</g:additional_image_link>

Konkrétní příklady#

Příklad 1: Přidání další URL alternativního obrázku#

1. Vytvoření nového pravidla:

Otevřete stránku Pravidla.
Klikněte na tlačítko Nové pravidlo.

2. Výběr typu pravidla:

V poli Typ pravidla vyberte možnost Přidat hodnotu vícenásobného elementu.

3. Výběr produktů:

V poli Výběr zvolte buď Všechny produkty, nebo vytvořte vlastní Produktový výběr pro specifické produkty, na které chcete pravidlo použít.

4. Volba elementu pro změnu:

V poli Element vyberte element, u kterého chcete provést změnu.
v našem případě to bude g:additional_image_link

5. Zadejte novou hodnotu:

Do pole Nová hodnota zadejte
- textovou hodnotu, například: konkrétní url (https://www…)
- proměnnou, ve které je hodnota uložená, například: %url%
- kombinaci proměnné a textu, například: https://www.my-shop.com/%image_handle%

6. Pojmenování pravidla:

V posledním kroku zadejte název pravidla, například: “Přidání alternativních obrázků”

Další využití pravidla#

Přidat další alternativní kategorie.

FAQ#

K čemu pravidlo „Přidat hodnotu vícenásobného elementu“ slouží?#

Toto pravidlo umožňuje přidat novou hodnotu do existujícího elementu, který podporuje vícenásobné hodnoty (např. obrázky, kategorie nebo parametry). Používá se typicky pro doplnění dalších URL obrázků (g:additional_image_link) nebo alternativních kategorií.

Jak se pravidlo chová, když element zatím nemá žádnou hodnotu?#

Pokud element nemá žádnou hodnotu, Mergado vytvoří první hodnotu a element se zatím nepovažuje za vícenásobný.

<g:additional_image_link></g:additional_image_link>
→
<g:additional_image_link>nová hodnota</g:additional_image_link>

Co se stane, pokud má element jednu nebo více hodnot?#

Pokud má jednu hodnotu, nová hodnota se přidá na další pozici a element se stane vícenásobným.
Pokud má více hodnot, nová hodnota se přidá na první volné místo (tj. jako další položka v pořadí).

💡 Příklad:

<g:additional_image_link>původníA</g:additional_image_link>

→

<g:additional_image_link>původníA</g:additional_image_link>

<g:additional_image_link>nová_hodnota</g:additional_image_link>

Dá se tímto pravidlem přidat více hodnot najednou?#

Ne přímo. Každé pravidlo přidá jednu hodnotu na jeden řádek. Pokud chcete přidat více hodnot (např. více URL obrázků), použijte více pravidel tohoto typu.

Jaké typy hodnot lze do elementu přidat?#

Do pole Nová hodnota můžete zadat:

textovou hodnotu, např. https://www.mujshop.cz/img123.jpg,
proměnnou, např. %url%,
kombinaci textu a proměnné, např. https://cdn.mujshop.cz/%image_name%.

Dá se tímto pravidlem přidat i dynamická hodnota z jiného elementu?#

Ano. Pokud chcete přidat hodnotu z jiného elementu, použijte jeho proměnnou (např. %g:image_link%). Mergado při přegenerování automaticky doplní hodnotu každého produktu podle této proměnné.

Jak poznám, že můj element je vícenásobný?#

Na stránce Elementy v projektu se u vícenásobných elementů (např. g:additional_image_link) zobrazuje maximální počet hodnot v závorce, např. (6×). Takové elementy se mohou u jednoho produktu vyskytovat vícekrát.
Přehled najdete v dokumentaci: Vícenásobné elementy v Mergadu.

Dá se pravidlo použít i pro jiné účely než obrázky?#

Ano. Pravidlo lze využít např. pro:

přidání dalších kategorií,
doplnění alternativních URL,
rozšíření seznamu parametrů (např. přidat nový parametr u produktů s určitým výběrem).

Dá se přidávaná hodnota omezit jen na určité produkty?#

Ano. V poli „Výběr“ můžete zvolit buď Všechny produkty, nebo vytvořit vlastní výběr, například jen pro produkty určité značky, kategorie nebo s chybějícím obrázkem.

Co se stane, pokud element, do kterého chci přidávat, ve feedu chybí?#

Pravidlo ho nevytvoří automaticky – musíte ho nejprve přidat ručně:

Otevřete stránku Elementy,
klikněte na Nový element,
zadejte název elementu (např. g:additional_image_link),
a potvrďte vytvoření.

Dá se přidání hodnoty naplánovat v čase?#

Ano. Pokud chcete například přidávat odkazy jen v určitém období (např. sezónní obrázky), můžete aktivovat časovač pravidla a nastavit konkrétní dny či hodiny, kdy se má pravidlo spouštět.

Jak ověřím, že přidání hodnoty proběhlo správně?#

Po uložení a aplikování pravidel nebo po přegenerování feedu:

otevřete stránku Elementy nebo stránku Produkty,
zkontrolujte, že nový řádek hodnoty přibyl,
případně spusťte Průchod pravidly u konkrétního produktu – zobrazí vám výsledek pravidla v reálném čase.

Dá se tímto pravidlem nahradit existující hodnota?#

Ne.
Pravidlo pouze přidává nové hodnoty, existující hodnoty nemění ani nemaže.
Pokud potřebujete hodnoty přepsat, použijte pravidlo Přepsat nebo Hromadné přepisování dle výběru.

Na co si dát pozor při použití pravidla?#

Po přidání pravidla vždy proveďte přegenerování feedu.
Pokud se hodnoty neprojevují, zkontrolujte výběr produktů a zda element skutečně existuje.

Dá se přidat hodnota do elementu, který není ve výstupním formátu povolený?#

Pokud cílový element není ve formátu podporovaný, Mergado ho do výstupu nevloží.
V takovém případě je potřeba nejprve upravit výstupní formát projektu, nebo element vytvořit ručně ve stránce Elementy.

Mohu tímto pravidlem doplňovat obrázky z externí tabulky (např. z Google Sheets)?#

Ano. Pokud máte tabulku s odkazy na obrázky, můžete je importovat do Mergada pomocí Import datového souboru (CSV / XML) a následně doplnit pomocí tohoto pravidla. Tím lze kombinovat externí data s vícenásobnými elementy ve feedu.