Dynamičtí zástupci

Vytvořil(a) Jakub Jirsa, Změněno dne Út, 3 Březen v 2:30 ODPOLEDNE dle Jakub Jirsa

☝️ Tato nápověda je určena pouze pro e-commerce řešení JZ ONE.

Pomocí dynamických zástupců (proměnných) můžete snadno automaticky doplňovat hodnoty dynamicky generovaného obsahu, např. v transakčních zprávách.

Dynamické zástupce rozlišujeme dle použití:

V HTML editoru (WYSIWYG editor)

Zkratka začíná a končí %, všechna písmena jsou velká, např. %ORDERNUMBER%

☝️ Příklad použití zástupce %ORDER_NUMBER% v HTML editoru

Vážený zákazníku,

objednávka č. %ORDER_NUMBER% je připravena k vyzvednutí.

Váš nejlepší e-shop.

V HTML obsahu

Zkratka začíná $ a je obalena složenou závorkou {}, např. {$order->number}

☝️ Příklad použití proměnné {$order->number} v HTML obsahu

<td>

<span>objednávka č. </span>

<span>{$order->number}</span>

</td>

Vkládání dynamických zástupců do formulářových polí

Pod každým formulářovým polem, kde je možné vkládat dynamické zástupce, jsou vypsané proměnné, které je možné do formuláře vložit.

Pro vložení stačí na proměnnou kliknout, čímž se zkopíruje do schránky. Poté klávesovou zkratkou CTRL+V vložíte zástupce do obsahu nebo kódu podle potřeby.

U každého zástupce se po najetí myší zobrazí krátká nápověda, jaká hodnota se bude generovat.

Po zkopírování se nad zástupcem zobrazí text "Uloženo do schránky"

Tvorba dynamických bloků

Pro zjednodušení tvorby transakčních zpráv je možné vytvářet tzv. dynamické bloky. Dynamický blok je tvořen z dynamických zástupců a HTML obsahu pro pokročilejší možnosti formátování a tvorby pokročilé logiky.

Dynamický blok se do transakčních zpráv vkládá stejně, jako dynamický zástupce. Vkládá se přímo do HTML editoru, zkratka začíná vždy %BLOK_.... a vaše uživatelské jméno bloku. Zkratky dynamických bloků se zobrazují mezi ostatními zástupci pod formulářovým polem.

Bloky se vkládají stejným způsobem, jako dynamičtí zástupci.

Transakční e-mail nové objednávky pak může vypadat např. takto:

❗ Pozor

Dynamické bloky se definují uživatelsky na úrovni každé emailové šablony (layoutu), neexistují žádné obecné bloky a pro každou vytvořenou šablonu e-mailu je nutné bloky definovat znovu.

Pokročilá práce se zástupci

V HTML kódu dynamických bloků je možné vytvářet logické operace se značkami a zobrazovat pouze ty informace, které jsou právě relevantní. Nemusíte např. vytvářet transakční e-mail pro každou platební metodu, ale pomocí podmínek vytvořit jednotný obsah, který se bude měnit dle dat z objednávky.

Příklad použití podmínky {if $order->orderStage == 'pending'}..... {/if}

Některé proměnné vyžadují použití cyklu, např. pro zobrazení produktů je potřeba definovat {foreach $order->items as $orderItem}.

Oslovení jménem v 5. pádu (vocativ)

Pro skloňování jmen je k dispozici knihovna českých jmen v 5. pádě. Stačí použít filtr proměnné vocative. Pro detekci, zda se jedná o křestní jméno nebo příjmení, je použíit parametr $isLastName, proto je vhodné rozlišit křestní jméno hodnotou :false a příjmení hodnotou :true.

Příklad použití oslovení s celým jménem:

Dobrý den {$order->billingAddress->firstName|vocative:false} {$order->billingAddress->surname|vocative:true},

Výsledný zápis: Dobrý den Pavle Nováku,