Condities (if, else, for) gebruiken in e-mail templates

Met condities in mails kan je de tekst van e-mails aanpassen op bijvoorbeeld de status van een bestelling of de gebruikte vervoerder.

De gebruikte placeholders in de voorbeelden zijn niet voor alle type e-mails beschikbaar, bekijk de beschikbare placeholders voor:

Indien conditie: If-statement

Met een if-statement geef je tekst weer, indien een bepaalde conditie waar is.

Voorbeeld

Indien de opmerking bij de inkoopbestelling tekst bevat (lengte groter is dan 0), geef dan de opmerking weer.

{% if purchaseorder.remarks | length > 0 %}
{{ purchaseorder.remarks }}
{% endif %}

Indien, anders conditie: If-else statement

Indien de conditie waar is, geef de ene tekst weer, geef anders een andere tekst weer.

Voorbeeld

Indien de vervoerder PostNL is, geef de track en trace link weer, anders de tekst om het pakket af te halen.

{% if shipment.public_providername == "PostNL" %}
Volg je pakket hier: https://jouw.postnl.nl/#!/track-en-trace/zoeken/
{% else %}
Het pakket staat voor je klaar op Dorpstraat 33 in Klein Veendam.
{% endif %}

Lijsten weergeven

Sommige placeholders bij e-mail zijn lijsten of arrays. Hier kan je met een for-statement een lijst van maken in de mail.

Voorbeeld

{% for product in products.products %}
{{ product.amount }}x {{ product.name }} ({{ product.productcode}})
{% endfor %}

Dit komt in de e-mail:
1x Honig Standard Tripple (AT807917)
1x Mars Lumix Graphing (ZC360355)

Voorbeeld met zendingen:

{% for shipment in shipments %}
- {{ shipment.trackingcode }} | {{ shipment.trackingurl}}
{% endfor %}

Dit komt in de e-mail:
- https://example.org/tracking/3S9399232 | 3S9399232
- https://example.org/tracking/3S9981273 | 3S9981273

Beschikbare operators voor condities

Controleren of iets true is (anders false)

{% if single_shipment %}

Controleren of de placeholder een waarde bevat

{% if shipment.trackingcode | length > 0 %}

Controleren of een placeholder een bepaalde waarde heeft

{% if delivery_address.country == 'DE' %}

Witregels

Met het gebruik van if-statements en variabelen aan het begin of einde van een regel, kunnen er te veel of te weinig witregels ontstaan in de uiteindelijke e-mail. Daarom haalt Picqer automatisch dubbele witregels onder elkaar weg en maakt daar een enkele witregel van. Zo kan je in de template witregels gebruiken om voor jezelf duidelijk onderscheid te maken, zonder dat dit je uiteindelijke mail beïnvloed.

Het is ook mogelijk een - of een ~ in in tags te gebruiken om witregels specifiek te houden of weg te halen. Tags zoals {%- if has_shipment %} zorgt ervoor dat witregels daarvoor weggehaald worden, en {%~ if has_shipment %} zorgt er juist voor dat alle witregels in takt gehouden worden. Tips hierover vind je in deze blogpost van Twig.

Goed om te weten

Je kan alle placeholders van een mail gebruiken voor de condities.
If of if-else statements sluit je altijd af met {% endif %} om aan te geven tot waar de conditie van toepassing is.
For statements sluit je altijd af met {% endfor %} om aan te geven tot waar de opsomming van toepassing is.

Filters

Je kan condities ook combineren met filters. Daarmee kan je bijvoorbeeld tekst omzetten in hoofdletters of tellen hoe lang een tekst is.