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

vito · říjen 30, 2025, 7:04odp.

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.

Zdroje

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

Vytvoření nového pravidla:
- Otevřete stránku “Pravidla”.
- Klikněte na tlačítko Nové pravidlo.
Výběr typu pravidla:
- V poli Typ pravidla vyberte možnost Přidat hodnotu vícenásobného elementu.
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.
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
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: my-shop.com - my shop Resources and Information.
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:

1. 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í.

2. 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>

3. 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>

4. 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.

5. 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%.

6. 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é.

7. 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.

8. 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).

9. 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.

10. 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í.

11. 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.

12. 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.

13. 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.

14. 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.

FAQ:

1. K čemu slouží pravidlo Přidat hodnotu vícenásobného elementu?
Toto pravidlo umožňuje přidat další hodnotu k již existujícímu elementu, aniž by se původní obsah přepsal.
Využívá se například při doplňování dalších URL obrázků, alternativních kategorií nebo jiných vícenásobných údajů.

2. Jak poznám, že element je vícenásobný?
Element je vícenásobný, pokud se ve feedu může vyskytovat vícekrát se stejným názvem.
Například:

<g:additional_image_link>url1.jpg</g:additional_image_link>
<g:additional_image_link>url2.jpg</g:additional_image_link>

V takovém případě je možné přidávat další hodnoty, aniž by se staré přepsaly.

3. Co se stane, když přidávám hodnotu do elementu, který zatím žádnou hodnotu nemá?
Pokud element zatím neexistuje nebo je prázdný, Mergado vytvoří nový element s první hodnotou.
Nevznikne vícenásobný element, ale pouze jeden záznam, např.:

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

4. Co když element už obsahuje jednu hodnotu?
V takovém případě Mergado přidá novou hodnotu na další (druhou) pozici, např.:

<g:additional_image_link>původní</g:additional_image_link>
<g:additional_image_link>nová hodnota</g:additional_image_link>

5. A co když element už obsahuje více hodnot?
Pravidlo přidá novou hodnotu na další volnou pozici.
Původní hodnoty zůstanou zachovány, např.:

<g:additional_image_link>hodnotaA</g:additional_image_link>
<g:additional_image_link>hodnotaB</g:additional_image_link>
<g:additional_image_link>nová hodnota</g:additional_image_link>

6. Jaký typ hodnot mohu přidávat?
Do pole „Nová hodnota“ můžete vložit:

text (např. https://.../image.jpg),
proměnnou (např. %image_url%),
nebo kombinaci textu a proměnné (např. https://shop.cz/%image_handle%).

8. Dá se pravidlo využít i pro jiné účely než obrázky?
Ano. Pravidlo lze použít pro jakýkoliv vícenásobný element – například pro alternativní kategorie, další odkazy, více parametrů, nebo variantní informace.

9. Co když přidám stejnou hodnotu, která už v elementu existuje?
Mergado v tuto chvíli duplikaci neodstraňuje automaticky.
Pokud přidáte hodnotu, která už v elementu existuje, bude ve výstupu uvedena dvakrát.

10. Jak zkontroluji, zda se hodnota skutečně přidala?
Po uložení a aplikování pravidel nebo po přegenerování feedu otevřete náhled produktů nebo použijte Průchod pravidly.
Uvidíte, že se do vícenásobného elementu přidala nová hodnota, aniž by se ty původní změnily.

11. Mohu pomocí pravidla přidat hodnotu jen vybraným produktům?
Ano. V poli „Výběr“ zvolte buď „Všechny produkty“, nebo vyberte konkrétní produktový výběr, kterému chcete novou hodnotu přidat.
Můžete tak např. doplnit alternativní obrázky jen u produktů v určité kategorii.

12. Jak se chová pravidlo, pokud přidávám proměnnou, která je prázdná?
Pokud je proměnná prázdná, Mergado nevytvoří nový záznam.
Tím se zamezí vzniku prázdných elementů bez hodnoty.

13. Mohu přidávání hodnot naplánovat (např. jen pro určité období)?
Ano. Pomocí Časovače můžete určit konkrétní dny, hodiny nebo datumové rozmezí, kdy má být pravidlo aktivní.
To je vhodné např. pro sezónní doplnění kategorií nebo dočasné přidání promo obsahu.

14. Lze tímto pravidlem nahrazovat existující hodnoty?
Ne. Pravidlo pouze přidává nové hodnoty, nikdy nepřepisuje existující.
Pokud potřebujete hodnoty změnit nebo nahradit, použijte pravidlo Přepsat nebo Najít a nahradit.

15. 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.

16. 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.