Použití speciálních slov a placeholderů v exportních šablonách
V článku vysvětlíme, jak vkládáte do exportních šablon v GoodEshopu speciální slova, která systém při generování exportu nahradí konkrétními údaji z objednávky. Popíšeme formát, nejpoužívanější placeholdery a ukázky pro Excel i PDF šablony.
Co jsou speciální slova (placeholders)
Speciální slova jsou zástupné výrazy které vložíte do pole „Šablona“ a systém je při generování exportu nahradí konkrétními daty z objednávky. Používají se pro údaje objednávky, klienta, produktů, faktury nebo zásilky. Tato funkcionalita je stejná pro Excel i PDF exporty a usnadňuje tvorbu dynamických výstupů.
Formátování šablony pro Excel a PDF
Pokud vytváříte Excel export, do pole „Šablona“ zadejte řádky ve formátu CSV a jednotlivé řádky oddělujte středníkem. Pro PDF export vložíte HTML kód, ve kterém stejné placeholdery fungují stejně. Před uložením si ověřte, že použité klíče existují pro daný typ dat.
Nejčastěji dostupné placeholdery
Mezi běžně používaná zástupná slova patří například {order.id}, {order.number}, {order.date}, {order.amount}, {order.client.name} a {order.client.email}. Pro položky v objednávce můžete použít {order.product.name}, {order.product.quantity}, {order.product.unit_price} nebo {order.product.ean}. Kompletní seznam dostupných klíčů naleznete v dokumentaci exportů a v souvisejících nastaveních fakturace či emailových šablon.
Do šablony vložte placeholder {order.number}. Při generování exportu jej systém nahradí reálným číslem objednávky pro každý řádek exportu.
Ano. Pro produkty použijte kombinaci placeholderů jako {order.product.name}, {order.product.quantity}, {order.product.unit_price} a {order.product.ean}. Při exportování více položek se systém postará o jejich správné doplnění podle šablony.
U Excel typu exportu zadáváte řádky ve formátu CSV a jednotlivé řádky oddělujete středníkem. Do jednoho řádku vložte placeholdery v pořadí sloupců, systém při generování vytvoří správné CSV hodnoty pro každou objednávku.
Dobrý den, momentálně jsme online, rádi vám zodpovíme vaše dotazy.