Dynamičtí zástupci
Dynamický zástupce (nebo také proměnná) je nositelem hodnoty, která se doplní např. při generování dokumentu, systémového emailu, konverzního kódu atd. Začíná a končí složenou závorkou. Uvnitř je název se znaménkem $ na začátku.
Hodnotu si nastavujete někde v administraci e-shopu. Pokud hodnotu zástupce v administraci změníte, začne se nová hodnota automaticky generovat na všech místech, kde je zástupce umístěn.
Možnosti a omezení
Nabídka dynamických zástupců se vztahuje pouze k danému formulářovému poli, nad kterým je umístěná. Pokud zástupce použijete na jiných místech administrace, nebude se jeho hodnota generovat nebo může dojít k chybě.
V šablonách emailů nejsou některé údaje dostupné na všech místech z důvodu rychlejšího zpracování dat.
Příklad: Typicky se dynamičtí zástupci používají v dokumentech. Ty se od sebe liší podle jednotlivých údajů jako jsou informace o zákazníkovi, objednané produkty apod. Dynamičtí zástupci se v dokumentu nahradí hodnotami uloženými v databázi e-shopu.
Pokud v administraci změníte hodnotu, kterou dynamický zástupce reprezentuje, projeví se tato změna automaticky na všech místech, kde byl zástupce umístěn.
Dynamické zástupce je možné používat pouze v naší administraci. Při externím použití nebudou naši dynamičtí zástupci fungovat. Např. v externím klientovi emailové služby (Feldhost, Ecomail...) apod.
Vložení značky do textového pole
Ideálním řešení je značku správně zkopírovat. Postup je následující:
- Na značku stačí pouze kliknout kurzorem myší, čímž se její název zkopíruje do schránky.
- Následně klikněte v textovém poli do místa, kam chcete název značky vložit.
- A vložíte obsah schránky pomocí Ctrl + V.
Pokud značku kopírujete jiným způsobem, než je popsáno výše, dejte pozor, ať při tom nepřenesete do textu i nežádoucí formátování značky. Případně je značku lepší přesně opsat včetně všech závorek.
Příklad
V následujícím příkladu si ukážeme, jak přesně vložit Fakturační adresu provozovatele do dokumentu. Obdobným způsobem můžete pracovat s dynamickými odkazy v rámci jiných modulů administrace.
Postup v administraci
- V nabídce Zástupci najděte zástupce pro hodnotu Město zákazníka. Myší najedete na danou značku a zobrazí se tip s nápovědou.
- Značku jednoduše zkopírujete dle postupu výše.
- Uložte změny.
- Následně se v dokumentu vyplní hodnota, která je zadaná v administraci.
Pokročilá práce se značkami
Pomocí značek lze obsah vkládat do podmínek, například u značky {!$billing_address}.
Podmínka je zde {if $billing_address} .... {/if}
Pokud budete někdy podmínku mazat, je důležité ji odstranit kompletně, tedy včetně uzavírací značky {/if}. Jinak se v dokumentu objeví chyba.
Některé značky jsou zobrazeny v poli proměnných. Např. {$products}. Pro zobrazení jejich obsahu se používají cykly, např. {foreach $products as $product}
Pokročilou práci s dynamickými značkami doporučujeme technicky zdatným uživatelům, protože při ní může dojít k chybě. V takovém případě je třeba vrátit vše do původního stavu z vlastní zálohy.