Použití značek Twig v pokročilém popisu položky na eBay

M2E Multichannel Connect podporuje tagy Twig v pokročilých popisech eBay, což vám dává větší kontrolu nad tím, jak se zobrazují informace o vašich produktech. Tato funkce je určena pro zkušené uživatele, kteří jsou obeznámeni s HTML a logikou šablon.

Twig vám umožňuje vytvářet dynamické, podmíněné a flexibilní šablony ve vašich Pravidlech popisu.

S Twig můžete:

• Zobrazujte různý obsah v závislosti na typu nabídky (např. jednoduchá vs. variabilní).
• Automaticky formátujte text (např. převádějte na velká písmena).
• Přeskočte prázdná pole, aby chybějící data nenarušila vaše rozvržení.
• Vložte související produkty nebo dynamicky zvýrazněte podrobnosti o variantách.

💡 Základní pokyny k nastavení najdete v průvodci pokročilým popisem položek na eBay.

Úplný seznam podporovaných syntaxí a značek najdete v oficiální dokumentaci Twig. Níže jsou uvedeny základní informace pro práci s Twig v M2E Multichannel Connect.

Dynamické proměnné a kolekce #

M2E podporuje řadu předdefinovaných proměnných a kolekcí, které můžete použít ve svých šablonách Twig. Tyto proměnné vám pomohou dynamicky vykreslovat data týkající se produktů, katalogů a eBay.

Proměnná	Popis	Podmínky vykreslování
isVariant	Vrátí hodnotu true, pokud má produkt varianty.	Používá se pro podmíněné zobrazení obsahu souvisejícího s variantami.
isMultiVariant	Označuje, že produkt patří do nadřazené skupiny variant.	Rendery pouze pro skupiny variant.
{{sku}}, {{title}}, {{price}}, {{description}}, etc.	Běžné atributy produktů z vašeho obchodu nebo katalogu.	Vždy k dispozici, pokud není prázdný.
{#attributeName#}	Další atributy vytvořené ve vašem obchodě nebo katalogu M2E.	Renderuje pouze v případě, že atribut existuje a má hodnotu.
ebay.site	Doména tržiště eBay (např. ebay.com, ebay.co.uk).	Vždy k dispozici pro aktivní nabídky.
ebay.itemId	ID položky na eBay.	K dispozici, jakmile bude položka uvedena v seznamu.
ebay.category, ebay.categoryPath	Název kategorie a úplná cesta ke kategorii.	K dispozici pro aktivní nabídky.
suggestedProducts	Zobrazuje sousední nebo související produkty ve vašem popisu.	Automaticky vykresluje, když jsou podobné položky uvedeny hromadně (4 na proměnnou).

ℹ️ Prázdné nebo chybějící proměnné jsou automaticky přeskočeny, pokud jsou zabaleny do podmínek {% if ... is not empty %}.

Běžné tagy Twig #

Twig poskytuje logické operátory a formátovací nástroje pro vytváření dynamického obsahu. Zde jsou ty nejužitečnější pro šablony eBay:

• {% if ... %} ... {% endif %} – zobrazí obsah, pokud je podmínka pravdivá.
• {% if not ... %} ... {% endif %} – zobrazí obsah, pokud podmínka není splněna.
• {% if … is not empty %} – před zobrazením hodnoty zkontroluje, zda existuje.
• {% set … = … %} – přiřadí hodnotu atributu proměnné Twig.

💡 Zobrazit úplný seznam dostupných značek v dokumentaci Twig.

Praktické příklady použití #

Níže uvádíme běžné příklady toho, jak můžete pomocí Twig zvýšit dynamiku popisu produktů na eBay a zlepšit jeho přizpůsobivost produktovým datům. Každý příklad obsahuje krátké vysvětlení, kdy jej použít, následované úryvkem Twig a popisem jeho praktického využití.

Případ použití 1: Přidání atributů produktu #

Do popisu položky na eBay můžete vložit atributy nebo metapole ze svého obchodu nebo katalogu M2E. Tyto atributy vám umožňují automaticky zobrazit podrobnosti o produktu, jako jsou názvy, SKU atd., nebo vlastní pole, jako jsou značka, materiál atd.

Můžete použít dva typy atributů:

• Společné atributy – standardní pole obchodu, jako je název, popis, SKU nebo cena.
  Formát: {{title}}, {{shortDescription}}, {{sku}}, atd.
• Atributy obchodu/katalogu – vlastní atributy vytvořené ve vašem obchodě nebo katalogu M2E, například značka nebo materiál.
  Formát: {#brand#}, {#vendor#}, {#material#} atd.

Takto je můžete zobrazit a formátovat ve své šabloně:

{% if sku is not empty %}
  <p>SKU: {{sku}}</p>
  <p>SKU (UPPER): {{ sku|upper }}</p>
{% endif %}
{% if '{#brand#}' is not empty %}
  <p>Brand: {{ '{#brand#}' }}</p>
{% endif %}

Jak to funguje:

• Proměnná {{sku}} načítá data z pole SKU vašeho obchodu.
• Proměnná {#brand#} načítá data z vašeho katalogu M2E nebo atributu obchodu.
• Podmínka zajišťuje, že prázdné atributy jsou automaticky přeskočeny.

Atributy můžete vložit pomocí rozevíracího seznamu Vložit proměnnou v pokročilém editoru popisu položky eBay.

Případ použití 2: Zobrazení obsahu pro variabilní nabídky #

Pokud prodáváte produkty s více variantami (například Barva nebo Velikost), můžete zobrazit krátkou poznámku, která zákazníky povzbudí k prozkoumání všech dostupných možností.

Příklad kódu:

{% if isVariant %}
<p style="color: green">✅ Product has variations: try it in 12 colors and 7 sizes!</p>
{% endif %}

Jak to funguje:
Blok se zobrazí pouze u nabídek, které mají varianty (isVariant = true). Pokud nabídka neobsahuje varianty, bude tato zpráva automaticky přeskočena.

Případ použití 3: Zobrazení obsahu pro jednoduché nabídky #

Pokud váš produkt nemá žádné varianty, můžete zobrazit vlastní zprávu nebo rozvržení určené pro nabídky s jedinou položkou.

Příklad kódu:

{% if not isVariant %}
<p style="color: red">❌ Product has NO variations! 1 size, 1 color.</p>
{% endif %}

Jak to funguje:

Podmínka not isVariant zajišťuje, že se zpráva zobrazí pouze u jednoduchých nabídek (isVariant = false). To pomáhá rozlišit šablony založené na variantách a šablony pro jeden produkt v rámci jednoho popisu.

Případ použití 4: Přeskočit prázdná pole #

Někdy u produktů chybí volitelné atributy (jako hmotnost, značka nebo materiál). Pokud tyto atributy vložíte přímo, může se ve vašem popisu zobrazit prázdné řádky nebo poškozené formátování.

Tomu můžete zabránit tím, že před zobrazením hodnoty zkontrolujete, zda existuje.

Příklad kódu:

{% set weight = '{#weight_test#}' %}
{% if weight is not empty %}
  <p>Weight: {{ weight }}</p>
{% endif %}

Jak to funguje:

• {% set %} přiřadí hodnotu atributu lokální proměnné.
• {% if weight is not empty %} zajistí, že se řádek vykreslí pouze v případě, že hmotnost existuje. Pokud produkt nemá hodnotu hmotnosti, celý odstavec se přeskočí, čímž zůstane rozvržení čisté.

Případ použití 5: Formátování textu pomocí filtrů Twig #

Filtry Twig vám umožňují upravit vzhled vašich dat, například převést text na velká písmena, oříznout mezery nebo psát slova velkými písmeny.

Příklad kódu:

<p>Vendor: {{ '{#vendor#}' }}</p>
<p>Vendor (UPPER): {{ '{#vendor#}'|upper }}</p>

Jak to funguje:

• Filtr |upper převede text na velká písmena.
• Pro manipulaci s řetězci můžete použít i jiné filtry, jako například |capitalize, |lower nebo dokonce |replace.

Případ použití 6: Zobrazení proměnných eBay #

Kromě údajů o obchodě a katalogu můžete ve svém popisu zobrazit také aktuální informace z eBay. To je užitečné pro zahrnutí dynamických prvků, jako jsou ID položek, kategorie nebo odkazy na vaše aktuální nabídky.

Příklad kódu:

<p>eBay site: <strong>{{ ebay.site }}</strong></p>
<p>Item ID: <strong>{{ ebay.itemId }}</strong></p>
<p>
  <a href="https://{{ ebay.site }}/{{ ebay.itemId }}" target="_blank">
    View this product on eBay
  </a>
</p>
<p>Category path: <strong>{{ ebay.category }} – {{ ebay.categoryPath }}</strong></p>

Jak to funguje:

• Objekt ebay poskytuje živé podrobnosti o nabídce, jakmile je položka zveřejněna.
• Tyto proměnné můžete použít k automatickému propojení s vaší nabídkou na eBay nebo k zobrazení cesty k její kategorii.

Náhled pokročilého popisu #

V editoru pravidel popisu eBay můžete kliknout na Náhled a před zveřejněním si prohlédnout, jak bude váš konečný návrh vypadat na eBay.

✅ Máte-li jakékoli dotazy nebo potřebujete pomoc s nastavením pokročilého popisu na eBay, kontaktujte náš tým podpory.