Použitie špeciálnych slov a placeholderov v exportných šablónach
V článku vysvetlíme, ako vkladáte do exportných šablón v GoodEshop špeciálne slová, ktoré systém pri generovaní exportu nahradí konkrétnymi údajmi z objednávky. Popíšeme formát, najpoužívanejšie placeholdery a ukážky pre Excel aj PDF šablóny.
Čo sú špeciálne slová (placeholders)
Špeciálne slová sú zástupné výrazy ktoré vložíte do poľa „Šablóna“ a systém ich pri generovaní exportu nahradí konkrétnymi dátami z objednávky. Používajú sa pre údaje objednávky, klienta, produktov, faktúry alebo zásielky. Táto funkcionalita je rovnaká pre Excel i PDF exporty a zjednodušuje tvorbu dynamických výstupov.
Formátovanie šablóny pre Excel a PDF
Ak vytvárate Excel export, do poľa „Šablóna“ zadajte riadky vo formáte CSV a jednotlivé riadky oddeľujte bodkočiarkou. Pre PDF export vložíte HTML kód, v ktorom rovnaké placeholdery fungujú rovnako. Pred uložením si overte, že použité kľúče existujú pre daný typ dát.
Najčastejšie dostupné placeholdery
Medzi bežne používané zástupné slová patria napríklad {order.id}, {order.number}, {order.date}, {order.amount}, {order.client.name} a {order.client.email}. Pre položky v objednávke môžete použiť {order.product.name}, {order.product.quantity}, {order.product.unit_price} alebo {order.product.ean}. Kompletný zoznam dostupných kľúčov nájdete v dokumentácii exportov a v súvisiacich nastaveniach fakturácie či emailových šablón.
Ako vložím číslo objednávky do exportu?
Do šablóny vložte placeholder {order.number}. Pri generovaní exportu ho systém nahradí reálnym číslom objednávky pre každý riadok exportu.
Môžem v exporte zobrazovať viacero údajov o produkte?
Áno. Pre produkty použite kombináciu placeholderov ako {order.product.name}, {order.product.quantity}, {order.product.unit_price} a {order.product.ean}. Pri exportovaní viacerých položiek sa systém postará o ich správne doplnenie podľa šablóny.
Čo ak chcem v Excel šablóne oddeliť stĺpce a riadky?
Pri Excel type exportu zadávate riadky vo formáte CSV a jednotlivé riadky oddeľujete bodkočiarkou. Do jedného riadku vložte placeholdery v poradí stĺpcov, systém pri generovaní vytvorí správne CSV hodnoty pre každú objednávku.
Dobrý deň, momentálne sme online, radi vám zodpovieme vaše otázky.