Twig-tags gebruiken in de geavanceerde item-beschrijving van eBay

M2E Multichannel Connect ondersteunt Twig-tags in eBay Advanced Descriptions, waardoor u meer controle hebt over hoe uw productinformatie wordt weergegeven. Deze functie is bedoeld voor ervaren gebruikers die bekend zijn met HTML en sjabloonlogica.

Met Twig kunt u dynamische, voorwaardelijke en flexibele sjablonen maken in uw beschrijvingsbeleid.

Met Twig kunt u:

• Geef verschillende inhoud weer, afhankelijk van het type vermelding (bijvoorbeeld eenvoudig versus variatie).
• Formatteer tekst automatisch (bijvoorbeeld omzetten naar hoofdletters).
• Sla lege velden over om te voorkomen dat ontbrekende gegevens uw lay-out verstoren.
• Voeg gerelateerde producten toe of benadruk variatiedetails op dynamische wijze.

💡 Raadpleeg de eBay-gids voor geavanceerde item-beschrijvingen voor basisinstructies voor het instellen.

Ga voor een volledige lijst met ondersteunde syntaxis en tags naar de officiële Twig-documentatie. Hieronder vindt u de basisprincipes voor het werken met Twig in M2E Multichannel Connect.

Dynamische variabelen en verzamelingen #

M2E ondersteunt een reeks vooraf gedefinieerde variabelen en verzamelingen die u kunt gebruiken in uw Twig-sjablonen. Met deze variabelen kunt u product-, catalogus- en eBay-specifieke gegevens dynamisch weergeven.

Variabel	Beschrijving	Weersomstandigheden
isVariant	Geeft true terug als het product variaties heeft.	Gebruikt voor het voorwaardelijk weergeven van variatiegerelateerde inhoud.
isMultiVariant	Geeft aan dat het product tot een bovenliggende variatiegroep behoort.	Renders alleen voor variatiegroepen.
{{sku}}, {{title}}, {{price}}, {{description}}, etc.	Algemene productkenmerken uit uw winkel of catalogus.	Altijd beschikbaar, tenzij leeg.
{#attributeName#}	Extra attributen die zijn aangemaakt in uw winkel of M2E-catalogus.	Render alleen als het attribuut bestaat en een waarde heeft.
ebay.site	Het eBay-marktplaatsdomein (bijvoorbeeld ebay.com, ebay.co.uk).	Altijd beschikbaar voor actieve aanbiedingen.
ebay.itemId	De eBay-ID van het item.	Beschikbaar zodra de item wordt aangeboden.
ebay.category, ebay.categoryPath	De categorienaam en het volledige categoriepaden.	Beschikbaar voor actieve aanbiedingen.
suggestedProducts	Toont aanverwante of gerelateerde producten in uw beschrijving.	Wordt automatisch weergegeven wanneer vergelijkbare items in bulk worden weergegeven (4 per variabele).

ℹ️ Lege of ontbrekende variabelen worden automatisch overgeslagen als ze zijn opgenomen in {% if ... is not empty %} voorwaarden.

Veelgebruikte Twig-tags #

Twig biedt logische operatoren en opmaaktools voor het bouwen van dynamische inhoud. Hier zijn de meest bruikbare voor eBay-sjablonen:

• {% if ... %} ... {% endif %} – toon inhoud als een voorwaarde waar is.
• {% if not ... %} ... {% endif %} – toon inhoud als een voorwaarde onwaar is.
• {% if … is not empty %} – controleer of een waarde bestaat voordat je deze laat zien.
• {% set … = … %} – een attribuutwaarde toewijzen aan een Twig-variabele.

💡 Bekijk de volledige lijst met beschikbare tags in de Twig-documentatie.

Praktische gebruiksscenario's #

Hieronder vindt u enkele veelvoorkomende voorbeelden van hoe u Twig kunt gebruiken om uw eBay-beschrijvingen dynamischer te maken en beter te laten aansluiten op productgegevens. Elk voorbeeld bevat een korte uitleg over wanneer u het kunt gebruiken, gevolgd door het Twig-fragment en wat het in de praktijk doet.

Toepassing 1: Productkenmerken toevoegen #

U kunt kenmerken of metavelden uit uw winkel of M2E-catalogus invoegen in de eBay-itembeschrijving. Met deze kenmerken kunt u automatisch productdetails weergeven, zoals titels, SKU's, enz., of aangepaste velden zoals merk, materiaal, enzovoort.

Er zijn twee soorten kenmerken die u kunt gebruiken:

• Algemene kenmerken – standaard winkelvelden zoals titel, beschrijving, SKU of prijs.
  Formaat: {{title}}, {{shortDescription}}, {{sku}}, enz.
• Winkel-/catalogusattributen – aangepaste attributen die zijn aangemaakt in uw winkel of M2E-catalogus, bijvoorbeeld merk of materiaal.
  Formaat: {#brand#}, {#vendor#}, {#material#}, enz.

Hier leest u hoe u ze in uw sjabloon kunt weergeven en opmaken:

{% 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 %}

Hoe het werkt:

• De variabele {{sku}} haalt gegevens op uit het SKU-veld van uw winkel.
• De variabele {#brand#} haalt gegevens op uit uw M2E-catalogus of winkelattribuut.
• De voorwaarde zorgt ervoor dat lege attributen automatisch worden overgeslagen.

U kunt attributen invoegen met behulp van de vervolgkeuzelijst Variabele invoegen in uw geavanceerde eBay-item-beschrijvingeditor.

Gebruiksscenario 2: inhoud weergeven voor variabele aanbiedingen #

Wanneer u producten met meerdere variaties verkoopt (zoals Kleur of Maat), wilt u misschien een korte mededeling weergeven om kopers aan te moedigen alle beschikbare opties te bekijken.

Codevoorbeeld:

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

Hoe het werkt:

Het blok wordt alleen weergegeven voor aanbiedingen met variaties (isVariant = true). Als een aanbieding geen variaties bevat, wordt dit bericht automatisch overgeslagen.

Gebruiksscenario 3: inhoud weergeven voor eenvoudige aanbiedingen #

Als uw product geen variaties heeft, kunt u een aangepast bericht of een aangepaste lay-out weergeven die bedoeld is voor aanbiedingen met één item.

Codevoorbeeld:

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

Hoe het werkt:

De voorwaarde not isVariant zorgt ervoor dat het bericht alleen op eenvoudige lijsten verschijnt (isVariant = false). Dit helpt om op variaties gebaseerde en op één product gebaseerde sjablonen binnen één beschrijving te onderscheiden.

Gebruiksscenario 4: lege velden overslaan #

Soms ontbreken er optionele kenmerken bij producten (zoals gewicht, merk of materiaal). Als u deze kenmerken rechtstreeks invoegt, kan uw beschrijving lege regels of een verkeerde opmaak vertonen.

U kunt dit voorkomen door te controleren of de waarde bestaat voordat u deze weergeeft.

Codevoorbeeld:

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

Hoe het werkt:

• {% set %} wijst de attribuutwaarde toe aan een lokale variabele.
• {% if weight is not empty %} zorgt ervoor dat de regel alleen wordt weergegeven als het gewicht bestaat. Als een product geen gewichtswaarde heeft, wordt de hele alinea overgeslagen, waardoor uw lay-out overzichtelijk blijft.

Gebruiksscenario 5: Tekst opmaken met Twig-filters #

Met Twig-filters kunt u aanpassen hoe uw gegevens worden weergegeven, bijvoorbeeld door tekst om te zetten naar hoofdletters, spaties te verwijderen of woorden met een hoofdletter te beginnen.

Codevoorbeeld:

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

Hoe het werkt:

• Het |upper filter zet de tekst om in hoofdletters.
• U kunt andere filters gebruiken, zoals |capitalize, |lower of zelfs |replace voor het bewerken van tekenreeksen.

Gebruiksscenario 6: eBay-variabelen weergeven #

Naast winkel- en catalogusgegevens kunt u ook live eBay-informatie weergeven in uw beschrijving. Dit is handig voor het opnemen van dynamische elementen zoals item-ID's, categorieën of links naar uw live aanbieding.

Codevoorbeeld:

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

Hoe het werkt:

• Het ebay-object biedt live advertentiegegevens zodra het item is gepubliceerd.
• U kunt deze variabelen gebruiken om automatisch naar uw eBay-advertentie te linken of het categoriepad ervan weer te geven.

Voorbeeld van de geavanceerde beschrijving #

U kunt op Voorbeeld klikken in de eBay-beschrijvingsbeleid-editor om te zien hoe uw uiteindelijke lay-out er op eBay uit zal zien voordat u deze publiceert.

✅ Als u vragen heeft of hulp nodig heeft bij het instellen van uw eBay Advanced Description, neem dan contact op met ons ondersteuningsteam.