Shortcode típus
Két különböző matematikai shortcode típus érhető el:
- [mathvar]: Ha saját változókat szeretnél megadni, és velük számolni.
- [calc]: Ha csak egy egyszerű listát adnál meg számokkal, és azon végzel műveletet.
Emellett támogatott a dinamikus mezők beillesztése is, például ügyfél vagy lehetőség adatlapján szereplő egyedi mezők használatával.
[mathvar]: Változós számítások
Ezzel a formátummal saját nevű változókat adhatsz meg, amiket a kifejezésben felhasználhatsz.
Szintaxis:
[mathvar expression="kifejezés" variables="változó1=érték1,változó2=érték2"]
Példa:
[mathvar expression="a+b*c" variables="a=10,b=5,c=3"]
Eredmény: 25,00 (10 + 5×3)
Dinamikus mezők használata:
[mathvar expression="letszam * ar" variables="letszam={%letszam-123%},ar={%ar-per-fo-234%}"]
Ebben a példában a letszam és ar dinamikus mezőkből érkeznek.
[calc]: Egyszerű számlista számítások
Ha nem szeretnél változókat definiálni, elég csak felsorolni a számokat és kiválasztani a műveletet.
Szintaxis:
[calc numbers="szám1,szám2,szám3" operation="művelet"]
Példa:
[calc numbers="10,20,30" operation="sum"]
Eredmény: 60,00
Támogatott műveletek:
- sum: összeadás
- average: átlag
- multiply: szorzás
- divide: osztás
- subtract: kivonás
- min / max: minimum / maximum érték
Dinamikus mezők beillesztése számok helyére
Shortcode-okban használhatók QlickCRM-es egyedi mezők is, például egy lehetőség adatlapon rögzített számok.
Formátum:
{%slug-azonosító%}
Példák:
- {%letszam-123%}: például egy „Létszám" mező értéke
- {%ar-per-fo-234%}: például „Ár per fő" mező értéke
Teljes példa számítással:
[mathvar expression="letszam * ar" variables="letszam={%letszam-123%},ar={%ar-per-fo-234%}"]
Ez kiszámolja a teljes összeget a létszám és az ár per fő alapján.
Eredmény formázás
Mindkét shortcode támogatja az eredmény formázását:
- decimals: tizedesjegyek száma (pl. decimals="1")
- format="currency": pénznem formázás
- currency_symbol="Ft": pénznem megadása
Példa:
[calc numbers="1000,500" operation="sum" format="currency" currency_symbol="Ft"]
Eredmény: 1 500,00 Ft
Példa:
Egy e-mail sablonban így számolhatsz dinamikusan teljes árat:
[mathvar expression="letszam * ar" variables="letszam={%letszam-123%},ar={%ar-per-fo-234%}" format="currency"]
Egyéb matematikai shortcode-ok
A fentieken túl további matematikai shortcode-ok is elérhetők:
- [math]: gyors számítás változók nélkül, csak a képletet adod meg. Példa:
[math expression="10+5*2"]eredménye 20,00. - [smartcalc]: a megadott szövegből kiszedi a számokat, és műveletet végez velük. Példa:
[smartcalc text="10 Forint és 20 darab" operation="sum"]eredménye 30,00. - [extract]: kilistázza a szövegben talált számokat. Példa:
[extract text="10, 20, 30"]eredménye 10,00, 20,00, 30,00.
Ezek is támogatják az eredmény formázását (decimals, format, currency_symbol), ugyanúgy, mint a [mathvar] és [calc].