Systém pre tvorbu šablón

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}" alebo {variable}. 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}".

`10000`

{variable}

{variable.second_level_variable.last_level_variable}

{variable.$key}

{set variabile='text'}

{set variabile=1.5}

{set variabile2=variable1}

{set variabile="[0, 1, 2, 3]"}
{variabile|list|log}

{set variabile=variable_list.0}

{set variabile=variable_list.1}

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".

Filtre (textové)

• 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".
• smallfirst - Prvé písmeno hodnoty zmení na malé
  • Ak premenná "{name}" má hodnotu "John", tak pri použití "{name|smallfirst}" 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".
• replace -
  • {variable|replace:X:Y}
• pad -
  • {variable|pad:1: :}
• 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".
  • {variable|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".
• nohtml -
  • {variable|nothtml}
• cut -
  • {variable|cut:0:10}
• trim -
  • {variable|trim:X}
• esc -
  • {variable|esc:1:1}
• escxml -
  • {variable|escxml}

Filtre (numerické)

• number -
  • {variable|number:2:,: }
• 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".

Filtre (čas)

• date -
  • {variable|date:Y-m-d}
• time -
  • {variable|time}

Filtre (polia, zoznamy)

• count -
  • {variable|count}
• join -
  • {variable|join:,}
• split -
  • {variable|split:,}

Filtre (ostatné)

• log -

  • {variable|log}

Funkcie

if

• if -

  • {if} {if variable == '' && variable === TRUE && variable|true && variable > 0}

• elseif -
  • elseif variable != ''}
• else -
  • {else}

loop

• loop -
  • {loop} {loop variable}
• value -
  • {value} {value.variable}
• key -
  • {key}
• counter -
  • {counter}
• continue -
  • {continue}
• break -
  • {break}

Overenie

• match -
  • {variable|match:X}
• value -
  • {variable|value:X}
• key -
  • {variable|key:X}
• numeric -
  • {variable|numeric}
• integer -
  • {variable|integer}
• float -
  • {variable|float}
• string -
  • {variable|string}
• bool -
  • {variable|bool}
• object -
  • {variable|object}
• array -
  • {variable|array}
• empty -
  • {variable|empty}
• full -
  • {variable|full}
• set -
  • {variable|set}
• null -
  • {variable|null}
• true -
  • {variable|true}
• false -
  • {variable|false}

Nespracovanie kódu

{*} ... {*}

Komentáre ku kódu

{# ... #}

{#} ... {#}