A dinamikus változókkal a sablonjaidba olyan adatokat illeszthetsz be, amelyek küldéskor vagy generáláskor automatikusan a tényleges értékre cserélődnek. Például a {%NAME%} helyére a partner neve kerül. Ebben a cikkben összeszedtük, mely változók érhetők el az egyes helyeken (e-mail sablonok, dokumentum sablonok, ajánlat), és mire érdemes figyelni.
Hogyan működnek a dinamikus változók?
- A változó alakja mindig
{%NAGYBETŰS_NÉV%}. - A sablonban a dinamikus változó a nyers
{%...%}alakjában van. A behelyettesítés akkor történik, amikor a sablonból tényleges tartalom lesz: az e-mail elküldésekor, a dokumentum generálásakor, vagy az adatlap és a teendő létrehozásakor. - Egy változó csak akkor kap értéket, ha a megfelelő adat rendelkezésre áll. Például egy partner nélkül küldött levélben a
{%NAME%}üresen marad.
⚠️ Az e-mail és a dokumentum sablonok változólistája eltér egymástól. Egy változó, ami e-mailben működik, nem feltétlenül működik dokumentumban is (és fordítva). Mindig az adott szakasz listáját használd.
Fontos különbség a ki nem töltött változóknál:
- E-mailben a ki nem töltött vagy ismeretlen változó eltűnik (üresen marad).
- Dokumentumban a fel nem ismert változó nyers alakban (pl.
{%NAME%}) ott marad a kész dokumentumban. Ezért a dokumentum sablonban különösen figyelj a pontos névre.
Egy egyszerű példa
 |  |
E-mail sablonok változói
Az e-mail sablonokban (és a hozzászólásból küldött levelekben) az alábbi változók használhatók. A részletekről lásd: E-mail sablonok.
Dátum (mindig behelyettesítődik)
{%DATE%}mai dátum{%DAY%}vagy{%TODAY_DAY%}a mai nap száma{%TODAY_DAY_NAME%}a mai nap neve{%WEEK_NUMBER%}az aktuális hét sorszáma{%MONTH%}a hónap száma,{%MONTH_NAME%}a hónap neve{%YEAR%}az aktuális év{%PREV_DAY%}tegnapi nap,{%PREV_MONTH%}előző hónap száma,{%PREV_MONTH_NAME%}előző hónap neve,{%PREV_YEAR%}előző év
Küldő felhasználó (a levelet küldő felhasználó adataiból)
{%USER_FULL_NAME%}teljes név{%USER_FIRSTNAME%}keresztnév,{%USER_LASTNAME%}vezetéknév,{%USER_NICKNAME%}becenév{%USER_EMAIL%}e-mail cím,{%USER_PHONE%}telefonszám,{%USER_JOB_POSITION%}beosztás
Partner (csak ha a levél egy partnerhez tartozik)
{%NAME%}név,{%FIRSTNAME%}keresztnév,{%LASTNAME%}vezetéknév,{%CONTACT_ID%}azonosító{%EMAIL%}e-mail,{%WORK_EMAIL%}munkahelyi e-mail,{%PHONE%}telefon,{%WORK_PHONE%}munkahelyi telefon{%VAT_NUMBER%}adószám{%INVOICE_NAME%},{%INVOICE_COUNTRY%},{%INVOICE_COUNTY%},{%INVOICE_ZIP%},{%INVOICE_CITY%},{%INVOICE_ADDRESS%}számlázási adatok{%SHIPPING_NAME%},{%SHIPPING_COUNTRY%},{%SHIPPING_COUNTY%},{%SHIPPING_ZIP%},{%SHIPPING_CITY%},{%SHIPPING_ADDRESS%}szállítási adatok
Elsődleges kapcsolattartó
A partner elsődleges kapcsolattartójának adatai. Cég partnernél a koronával megjelölt személy, személy partnernél maga a személy.
{%PRIMARY_CONTACT_PERSON_NAME%}neve{%PRIMARY_CONTACT_PERSON_FIRSTNAME%}keresztneve,{%PRIMARY_CONTACT_PERSON_LASTNAME%}vezetékneve{%PRIMARY_CONTACT_PERSON_EMAIL%}e-mail címe,{%PRIMARY_CONTACT_PERSON_PHONE%}telefonszáma
Ügy / adatlap (csak ha a levél egy ügyhöz tartozik)
{%OBJECT_ID%}azonosító,{%OBJECT_KEY%}kulcs,{%OBJECT_NAME%}név,{%OBJECT_DESCRIPTION%}leírás{%OBJECT_START_DATE%}kezdő dátum,{%OBJECT_END_DATE%}befejező dátum
Dokumentum (csak ha a levélhez dokumentum tartozik)
{%DOCUMENT_NAME%}a dokumentum neve,{%DOCUMENT_NUMBER%}a dokumentum száma
Ajánlat (csak ajánlatküldő e-mailben)
{%QUOTE_URL%}az ajánlat megnyitó linkje{%QUOTE_VALIDITY_DATE%}az ajánlat érvényessége (lejárati dátuma)
ℹ️ Az ajánlatkészítő szerkesztőben további ajánlat-specifikus változók is elérhetők (például az ajánlat száma, az érvényesség napokban, a nettó összeg). Ezeket maga a szerkesztő kínálja fel.
Egyedi mezők
Az egyedi mezők a slugjukkal (azonosítójukkal) hivatkozhatók, nem a nevükkel: {%mezo_slug%}. A mező slugját az egyedi mező beállításainál találod. Lásd: Adatlap és partner egyedi mezők létrehozása.
Dokumentum sablonok változói
A dokumentum sablonokban a behelyettesítés a dokumentum generálásakor történik. A lista részben eltér az e-mailes változóktól. A részletekről lásd: Dokumentum sablonok.
Dátum (mindig behelyettesítődik)
{%DATE%},{%YEAR%},{%PREV_YEAR%},{%WEEK_NUMBER%}{%MONTH%},{%MONTH_NAME%},{%MONTH_NAME_EN%}{%PREV_MONTH%},{%PREV_MONTH_NAME%},{%PREV_MONTH_NAME_EN%}{%NEXT_MONTH%},{%NEXT_MONTH_NAME%},{%NEXT_MONTH_NAME_EN%}{%PREV_YEAR_AND_MONTH%}előző év és hónap
Dokumentum (mindig behelyettesítődik)
{%DOCUMENT_NUMBER%}a dokumentum száma{%PRODUCTS_AND_SERVICES%}a tételek (termékek és szolgáltatások) táblázata
Partner (csak ha a dokumentumhoz partner tartozik)
{%CONTACT_NAME%},{%NAME%}név,{%VAT_NUMBER%}adószám,{%BIRTHDAY%}születési dátum{%INVOICE_NAME%},{%INVOICE_COUNTRY%},{%INVOICE_COUNTY%},{%INVOICE_CITY%},{%INVOICE_ADDRESS%},{%INVOICE_ZIP%}számlázási adatok{%SHIPPING_NAME%},{%SHIPPING_COUNTRY%},{%SHIPPING_COUNTY%},{%SHIPPING_CITY%},{%SHIPPING_ADDRESS%},{%SHIPPING_ZIP%}szállítási adatok{%EMAIL%},{%WORK_EMAIL%},{%PHONE%},{%WORK_PHONE%}elérhetőségek
Elsődleges kapcsolattartó
Az elsődleges kapcsolattartó öt változója a dokumentum sablonban is működik: {%PRIMARY_CONTACT_PERSON_NAME%}, {%PRIMARY_CONTACT_PERSON_FIRSTNAME%}, {%PRIMARY_CONTACT_PERSON_LASTNAME%}, {%PRIMARY_CONTACT_PERSON_EMAIL%}, {%PRIMARY_CONTACT_PERSON_PHONE%}.
Ügy / adatlap (csak ha a dokumentumhoz ügy tartozik)
Figyelem: a dokumentum sablonban az ügy-változók a modul számszerű azonosítóját igénylik utótagként, {%TŐ_MODULAZONOSÍTÓ%} formában (például {%OBJECT_NAME_3%}). A modul neve vagy slugja nem működik, csak a szám.
- Tövek:
OBJECT_ID,OBJECT_KEY,OBJECT_NAME,OBJECT_DESC,OBJECT_CREATED_AT,OBJECT_START_DATE,OBJECT_END_DATE
ℹ️ Ugyanaz az ügy-adat e-mailben utótag nélkül (
{%OBJECT_NAME%}), dokumentumban viszont modul-azonosítóval ({%OBJECT_NAME_3%}) hivatkozható. Ez a két lista egyik legfontosabb különbsége.
Egyedi mezők
A dokumentum sablonban is a mező slugjával hivatkozol az egyedi mezőkre: {%mezo_slug%}.
Jó tudni
- A változó alakja mindig
{%...%}, nagybetűkkel. - Ki nem töltött változó: e-mailben eltűnik, dokumentumban nyersen ottmarad.
- Egyedi mezőnél a slug számít, nem a mező neve.
- Az ügy-változók dokumentumban a modul számszerű azonosítóját igénylik (
{%OBJECT_NAME_3%}).
Összefoglalás
A dinamikus változókkal a sablonjaid automatikusan személyre szabott tartalmat állítanak elő: a partner, az ügy, a dátumok és az egyedi mezők értékei maguktól a helyükre kerülnek. A legfontosabb, hogy a megfelelő helyen a megfelelő listát használd, mert az e-mail és a dokumentum sablonok változói eltérnek egymástól.