E-mailové šablony

Vytvořil(a) Jakub Jirsa, Změněno dne Čt, 5 Březen v 3:57 ODPOLEDNE dle Jakub Jirsa

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

Systém JZ ONE využívá pro automatické e-maily (potvrzení objednávky, expedice atd.) propracovaný systém šablon. Tyto šablony se skládají ze dvou hlavních částí: Layoutu (celkový grafický rámec e-mailu) a Uživatelských bloků (menší části kódu, které do e-mailu vkládají konkrétní data, jako jsou seznamy produktů nebo kontaktní údaje).

1. Základní orientace a vytvoření šablony

Správu e-mailů naleznete v menu pod cestou Nastavení -> Vzhled -> E-maily. Zde vidíte seznam všech existujících vzhledů. Šablona označena jako Výchozí se bude automaticky používat pro veškerou systémovou komunikaci.

Novou šablonu vytvoříte kliknutím na tlačítko PŘIDAT NOVOU ŠABLONU v pravém dolním rohu.

❗ Důležité upozornění: Uživatelské bloky jsou vždy svázány pouze s konkrétní šablonou. Pokud vytvoříte zcela novou šablonu, bloky z té předchozí v ní nebudou dostupné a musíte si je vytvořit znovu.

2. Jazykové mutace a obsah e-mailu

Systém JZ ONE je plně multijazyčný. V rámci jedné šablony najdete záložky pro jednotlivé jazyky (např. Obsah CS pro češtinu a Obsah EN pro angličtinu).

☝️ Nezapomeňte na obě verze!

Pro každou jazykovou mutaci je nutné připravit vlastní HTML kód. To platí pro hlavní Layout i pro jednotlivé bloky. Pokud prodáváte do zahraničí např. v angličtině, musíte mít v anglické verzi šablony vložené anglicky psané bloky a anglický HTML layout.

U každého jazyka můžete vyplnit dva typy obsahu:

HTML obsah: Hlavní verze e-mailu s grafikou, barvami a obrázky.
Textový obsah: Čistě textová verze bez formátování. Tu doporučujeme vždy vyplnit, protože pomáhá doručitelnosti e-mailu a slouží jako záloha pro starší e-mailové klienty.

3. Práce s dynamickými značkami (% vs $)

Aby e-maily nebyly jen statické texty, používají se tzv. dynamické zkratky (zástupci) a příznaky. Mezi nimi je zásadní rozdíl v tom, kde je můžete použít:

Zkratky s procenty (např. %CONTENT%, %SUBJECT%, %BLOCK_PATICKA%): Slouží jako jednoduché textové náhrady. Fungují jak v běžném textovém editoru (v záložce Obsah), tak přímo v HTML kódu.
Příznaky s dolarem (např. {$order->number}, {$order->totalWithVat}): Jsou to dynamické programové prvky, které systém zpracovává až při odesílání. Tyto značky fungují výhradně v HTML kódu. Můžete je vložit buď přímo do HTML kódu hlavního Layoutu, nebo do HTML kódu jednotlivých bloků.

❗ Pokud vložíte příznak {$order->number} do textového HTML editoru (Textový obsah), systém jej nepozná a zákazníkovi se odešle pouze tento text místo skutečného čísla objednávky.

☝️Jak správně pracovat s dynamickými zástupci?

Pro podrobnější popis práce s dynamickými zástupci, jejich funkce a příklady použití jsme pro vás připravili samostatný článek: Podrobný průvodce dynamickými zástupci.

4. Jak propojit Layout s Bloky

V záložce BLOKY si vytvoříte například blok se zkratkou ADRESY. Do jeho HTML obsahu vložíte kód s příznaky pro jméno a adresu zákazníka.

☝️ Víte že..

Systém vašim blokům automaticky přiděluje prefix %BLOCK_. Pokud jste si vytvořili blok ADRESY, v záložce Layout jej do e-mailu vložíte pomocí zkratky %BLOCK_ADRESY%. Seznam všech vašich vytvořených bloků najdete vždy přehledně vypsaný pod editorem v záložce Layout.

5. Náhled a testování s demo daty

Nikdy nepoužívejte šablonu bez předchozího otestování. Pod každým editorem najdete dvě důležitá tlačítka:

Tlačítko NÁHLED: Otevře náhled e-mailu, do kterého systém automaticky dosadí demo data (vzorové jméno, produkty a ceny).
- V náhledu Layoutu uvidíte celkový grafický rámec.
- V náhledu konkrétního Bloku uvidíte, jak se tento blok vykreslí s reálnými daty v rámci celé šablony.
Tlačítko ODESLAT TESTOVACÍ EMAIL: Odešle aktuální podobu e-mailu s demo daty na e-mail vyplněný u vašeho účtu administrátora, abyste si ověřili zobrazení v mobilu i na počítači.

Shrnutí všech dostupných příznaků pro HTML kód

Níže naleznete kompletní seznam dynamických značek, které můžete vkládat do HTML kódu vašich šablon a bloků. Systém tyto značky při odeslání automaticky nahradí reálnými daty z konkrétní objednávky.

Objednávka
{$order->number} | {$order->dateCreated} | {$order->paymentDate} | {$order->variableSymbol} | {$order->orderStage} | {$order->paymentStatus} | {$order->shippingStatus} | {$order->totalWithVat} | {$order->totalWithoutVat} | {$order->shippingWithVat} | {$order->shippingWithoutVat} | {$order->totalPaid} | {$order->totalToPay} | {$order->customerNote} | {$order->deliveryNote} | {$order->isDeliveryAddressDifferent} | {$order->items}

Fakturační adresa
{$order->billingAddress->companyName} | {$order->billingAddress->firstName} | {$order->billingAddress->surname} | {$order->billingAddress->street} | {$order->billingAddress->houseNumber} | {$order->billingAddress->city} | {$order->billingAddress->postalCode} | {$order->billingAddress->countryCode} | {$order->billingAddress->countryName} | {$order->billingAddress->companyId} | {$order->billingAddress->vatId} | {$order->billingAddress->phoneNumber} | {$order->billingAddress->email}

Dodací adresa
{$order->deliveryAddress->companyName} | {$order->deliveryAddress->firstName} | {$order->deliveryAddress->surname} | {$order->deliveryAddress->street} | {$order->deliveryAddress->houseNumber} | {$order->deliveryAddress->city} | {$order->deliveryAddress->postalCode} | {$order->deliveryAddress->countryCode} | {$order->deliveryAddress->countryName} | {$order->deliveryAddress->phoneNumber} | {$order->deliveryAddress->email}

Informace o platbě
{$order->payment->name} | {$order->payment->sku} | {$order->payment->type} | {$order->payment->onlinePaymentUrl}

Informace o dopravě
{$order->shipping->name} | {$order->shipping->sku} | {$order->shipping->type} | {$order->shipping->trackingNumber} | {$order->shipping->trackingUrl}

Položky objednávky
{$orderItem->name} | {$orderItem->quantity} | {$orderItem->sku} | {$orderItem->description} | {$orderItem->unit} | {$orderItem->imageUrl} | {$orderItem->vatRate} | {$orderItem->unitPriceWithVat} | {$orderItem->unitPriceWithoutVat} | {$orderItem->totalWithVat} | {$orderItem->totalWithoutVat} | {$orderItem->type} | {$orderItem->subType} | {$orderItem->chainedItems}

Navázané položky
{$orderChainedItem->name} | {$orderChainedItem->quantity} | {$orderChainedItem->sku} | {$orderChainedItem->description} | {$orderChainedItem->unit} | {$orderChainedItem->imageUrl} | {$orderChainedItem->vatRate} | {$orderChainedItem->unitPriceWithVat} | {$orderChainedItem->unitPriceWithoutVat} | {$orderChainedItem->totalWithVat} | {$orderChainedItem->totalWithoutVat} | {$orderChainedItem->type} | {$orderChainedItem->subType} | {$orderChainedItem->chainedItems}

Systémové informace
{$system->now} | {$system->year}