Niektoré sekcie systému WEXBO® poskytujú možnosť vytvorenia vlastných šablón za použitia tzv. premenných (výrazy, ktoré sa nahradia hodnotou konkrétnej položky) a filtre premenných a funkcie. Táto nápoveda popisuje syntax a sémantiku šablónovacieho systému WEXBO®.
Premenné
Premenné sú vlastne hodnoty položiek, ku ktorým máte prístup (napr. číslo objednávky alebo cena objednávky, atď.). Premenné sa zadávajú ako názov premennej uzatvorený prostredníctvom zložených zátvoriek, tj. "{nazov_premennej}". Povolené znaky pre názov premennej sú malé alfa-numerické znaky "a-z0-9" bez diakritiky a podtržník "_". Zároveň je v prípade premenných polí možné použiť bodku "." ako oddeľovač pre zavolanie konkrétneho atribútu, napr. "{order.id}" alebo "{order.price}".
Filtre
Na zvolenú hodnotu premennej je možné použiť dodatočný filter na zmenu pôvodnej hodnoty a to tak, že za názov premennej použijete oddeľovač zvislej čiary "|" a za ním názov filtra. Napr. ak premennú "{country}", ktorá má hodnotu "sk" vyžadujete mať zadanú veľkými písmenami, použijete filter "big" s nasledujúcim zápisom "{country|big}", pričom výsledná hodnota premennej tak bude "SK".
Parametre filtrov
Niektoré filtre vyžadujú zadanie dodatočných parametrov, ktoré sa zadávajú za názov filtra prostredníctvom dvojbodky ":" nasledujúcej požadovaným parametrom. Napr. ak premenná "{order.price}" má hodnotu "12.345", ktorú chcete zaokrúhliť na 2 desatinné miesta, použije sa filter "round" s parametrom "2", tj "{order.price|round:2}", pričom výsledná hodnota premennej tak bude "12.35".
Hodnota parametra nesmie obsahovať dvojbodku a úvodzovky, pričom v takomto prípade je nutné hodnotu parametra uzavrieť do jednoduchých úvodzoviek '...' napr. "{name|replace:':':-}" (nahradenie dvojbodky pomlčkou).
Použitie viacerých filtrov
Pre jednu premennú je možné naraz použiť viacero filtrov zadaných za sebou. Napr. ak premenná "{order.price}" má hodnotu "-12.345", ktorú chcete zmeniť na kladnú hodnotu a zároveň zaokrúhliť na 2 desatinné miesta, použijete filtre "abs" a "round" s parametrom "2", tj "{order.price|abs|round:2}", pričom výsledná hodnota premennej tak bude "12.35".
Textové filtre
- big - Všetky malé písmená sa zmenia na veľké (nepodporuje diakritiku).
- Ak premenná "{name}" má hodnotu "john", tak pri použití "{name|big}" bude výsledná hodnota "JOHN".
- small - Všetky veľké písmená sa zmenia na malé (nepodporuje diakritiku).
- Ak premenná "{name}" má hodnotu "John", tak pri použití "{name|small}" bude výsledná hodnota "john".
- bigfirst - Prvé písmeno hodnoty zmení na veľké
- Ak premenná "{name}" má hodnotu "john", tak pri použití "{name|bigfirst}" bude výsledná hodnota "John".
- reverse - Prehodí postupnosť znakov v zadanom výraze.
- Ak premenná "{name}" má hodnotu "john", tak pri použití "{name|reverse}" bude výsledná hodnota "nhoj".
- length - Počet znakov hodnoty.
- Ak premenná "{name}" má hodnotu "john", tak pri použití "{name|length}" bude výsledná hodnota "4".
- br - Nové riadky budú nahradené HTML tagom "BR".
- url - Dekódovanie hodnoty do znakov podporovaných v URL adrese.
- Ak premenná "{name}" má hodnotu "John Doe", tak pri použití "{name|url}" bude výsledná hodnota "John%20Doe".
- repeat:[NUM] - Opakovanie hodnoty premennej požadovaný počet krát. Za názov filtra je nutné zadať dvojbodku a číslo pre požadovaný počet opakovaní.
- Ak premenná "{name}" má hodnotu "john", tak pri použití "{name|repeat:3}" bude výsledná hodnota "johnjohnjohn".
- abs -
- big -
- big -
- big -
Numerické filtre
- round:[NUM] - Matematické zaokrúhlenie čísla na požadovaný počet desatinných miest. Za názov filtra je nutné zadať dvojbodku a požadovaný počet desatinných miest.
- Ak premenná "{price}" má hodnotu "12.345", tak pri použití "{price|round:2}" bude výsledná hodnota "12.35".
- roundup - Zaokrúhlenie čísla smerom nahor.
- Ak premenná "{price}" má hodnotu "12.1", tak pri použití "{price|roundup}" bude výsledná hodnota "13".
- rounddown - Zaokrúhlenie čísla smerom nadol.
- Ak premenná "{price}" má hodnotu "12.9", tak pri použití "{price|rounddown}" bude výsledná hodnota "12".
- abs - Zmena číselnej hodnoty na absolútne číslo.
- Ak premenná "{price}" má hodnotu "-12", tak pri použití "{price|abs}" bude výsledná hodnota "12".
- min:[NUM] - Výber najmenšej hodnoty medzi hodnotou premennej a hodnoty zadanej v parametri.
- Ak premenná "{price}" má hodnotu "12", tak pri použití "{price|min:10}" bude výsledná hodnota "10".
- max:[NUM] - Výber najväčšej hodnoty medzi hodnotou premennej a hodnoty zadanej v parametri.
- Ak premenná "{price}" má hodnotu "12", tak pri použití "{price|max:10}" bude výsledná hodnota "12".
Funkcie
IF
ELSEIF
ELSE
LOOP