Sähköpostit

TWIG:n avulla voit rakentaa sisältöä Aivie-teemoissa dynaamisesti, muotoilla arvoja, suorittaa laskutoimituksia ja käyttää ehtoja. TWIG:iä käytetään erityisesti sähköpostien, aloitussivujen, lomakkeiden ja järjestelmäviestien mallitiedostoissa.

Miten TWIG-suodatin toimii?

Suodatin liitetään arvoon pystysuoralla viivalla:

{{ value|filter }}

Esimerkiksi:

{{ firstname|default('Guten Tag') }}
{{ title|upper }}

Useita suodattimia voidaan yhdistää keskenään:

{{ title|trim|upper }}

Muokkaa tekstiä

Teksteille on käytettävissä muun muassa seuraavat suodattimet:

Suodattimet	Käyttö
upper	Muunna teksti isoiksi kirjaimiksi
lower	Muunna teksti pieniksi kirjaimiksi
title	Sanat, jotka alkavat isolla kirjaimella
capitalize	Kirjoita ensimmäinen kirjain isolla
trim	Poista välilyönnit alusta ja lopusta
replace	Korvaa teksti
striptags	Poista HTML-tunnisteet
nl2br	Muunna rivinvaihdot HTML-muotoon
length	Määritä merkkien tai elementtien lukumäärä
default	Käytä korvaavaa arvoa, jos arvoa ei ole

Esimerkki:

{{ company|default('deinem Unternehmen')|trim }}

Lukujen muotoilu ja laskelmien suorittaminen

Twig tukee tavallisia laskutoimitusoperaattoreita:

{{ a + b }}
{{ a - b }}
{{ a * b }}
{{ a / b }}
{{ a // b }}
{{ a % b }}
{{ a ** b }}

Lisäksi seuraavat suodattimet ja toiminnot ovat hyödyllisiä:

Suodatin vai toiminto	Käyttö
int	Muunna arvo kokonaisluvuksi
abs	Absoluuttiluvun määrittäminen
round	Luvun pyöristäminen
number_format	Luvun muotoilu tulostusta varten
min()	Pienimmän arvon määrittäminen
max()	Suurimman arvon määrittäminen

Esimerkki sveitsiläisellä numeromuodolla:

{{ (price|int * quantity|int)|number_format(2, '.', "'") }}

Voit pyöristää luvun seuraavasti:

{{ value|round(2) }}
{{ value|round(0, 'ceil') }}
{{ value|round(0, 'floor') }}

Päivämääräarvojen käyttö

date – ja date_modify -funktioiden avulla voit muotoilla tai muuttaa päivämääräarvoja:

{{ "now"|date("d.m.Y") }}
{{ dateValue|date("d.m.Y") }}
{{ dateValue|date_modify("+30 days")|date("d.m.Y") }}

Listojen ja taulukoiden käsittely

Luetteloille on käytettävissä muun muassa seuraavat suodattimet:

Suodattimet	Käyttö
first	Ensimmäisen elementin tulostaminen
last	Viimeisen elementin tulostaminen
join	Yhdistä elementit tekstiksi
split	Tekstin jakaminen osiin
keys	Taulukon avaimen tulostaminen
merge	Yhdistä luettelot tai taulukot
slice	Käytä leikkausta
sort	Elementtien lajittelu
reverse	Käännä järjestys päinvastaiseksi
batch	Jaa elementit ryhmiin

Esimerkki:

{{ tags|join(', ') }}

Ehtojen ja silmukoiden käyttö

Ehtojen avulla voit näyttää sisältöä tietyn arvon perusteella:

{% if points|int >= 100 %}
    Du hast mindestens 100 Punkte erreicht.
{% else %}
    Dir fehlen noch einige Punkte.
{% endif %}

Voit tulostaa luettelot silmukan avulla:

{% for item in items %}
    {{ item }}
{% endfor %}

Myös summa voidaan laskea luotettavasti silmukan avulla:

{% set total = 0 %}

{% for value in values %}
    {% set total = total + (value|int) %}
{% endfor %}

{{ total|number_format(2, '.', "'") }}

Jotkin toiminnot on estetty turvallisuussyistä

Jotkin suodattimet voivat ottaa vastaan suoritettavia funktioita argumentteina. Aivie estää ne tämän vuoksi estääkseen luvattoman ohjelmakoodin suorittamisen. Esimerkiksi:

• map
• filter
• reduce

Myös toiminnot, jotka voisivat käyttää järjestelmän kokoonpanoa, tietokantaa, tiedostoja tai sisäisiä PHP-toimintoja, on estetty.

Jos tarvitset tiettyä laskutoimitusta tai tietojen muuntamista, jota ei voida toteuttaa käytettävissä olevilla toiminnoilla, ota meihin yhteyttä. Tarkistamme sitten, voidaanko järjestelmään lisätä tätä varten turvallinen ja selkeästi rajattu suodatin.

Tärkeää: Kaikki Aivie Editorin tekstikentät eivät tue TWIG-kieltä. Sähköpostien tavalliseen mukauttamiseen käytät edelleen käytettävissä olevia Aivie- tai Mautic-tunnisteita.

Lyhyesti sanottuna

Aivie tukee tavallisia TWIG-funktioita, jotka koskevat tekstiä, lukuja, päivämääriä, luetteloita, ehtoja ja silmukoita. Turvallisuussyistä vaaralliset funktiot ja suodattimet, joissa on vapaasti suoritettavia kutsutoimintoja, on estetty ladatuissa teemoissa.

Lisätietoja löydät TWIG:n verkkosivuilta.