Manuály pro uživatele
Systém umožňuje generovat personalizované návody ve formátu PDF z DOCX šablon. Návody se automaticky přikládají k e-mailům o založení účtu a lze je sdílet jako veřejný odkaz. Do šablony se automaticky dosadí údaje o firmě, přihlašovací adresa, uzávěrky a režim úhrad.
Funkce se hodí zejména pro provozy, kde uživatelé potřebují podrobný návod k objednávání jídla – typicky školní jídelny, domovy pro seniory nebo firemní stravování s více platebními režimy.
Kde sekci najdete
Sekci najdete v administraci v Nastavení systému → Manuály pro uživatele. Sekce je dostupná pouze tehdy, když je v Systémovém nastavení zapnutý přepínač Zapnout manuály pro uživatele.
Pro zobrazení sekce je potřeba oprávnění Nastavení systému (view).
Stránka manuálů
Stránka se skládá ze tří bloků:
Aktuální šablony návodu
Tabulka zobrazuje seznam všech režimů manuálů a jejich aktuální stav. U každého režimu je vidět:
- Režim – název platebního režimu (např. „Obecný manuál", „Kreditové konto", „Na fakturu" apod.).
- Zdroj – odkud se šablona bere:
- Základní návod – používá se výchozí šablona dodávaná systémem.
- Vlastní návod – používá se vlastní DOCX šablona nahraná pro aktuální provoz.
- Nenalezen – pro daný režim není k dispozici žádná šablona.
- Akce – tlačítka pro stažení DOCX nebo PDF náhledu a pro smazání vlastního návodu.
Náhled (PDF i DOCX) se generuje s ukázkovými daty prvního jídelního lístku v provozu, takže je vidět, jak bude výsledný dokument vypadat.
Sdílecí odkaz na návod
Blok umožňuje vygenerovat veřejný odkaz na PDF manuál, který lze sdílet uživatelům – například e-mailem, na webových stránkách restaurace nebo v tištěných materiálech.
- Jídelní lístek – výběr konkrétního jídelního lístku (firmy). Návod se personalizuje podle nastavení zvoleného jídelního lístku (uzávěrky, adresa, název).
- Režim manuálu – výběr platebního režimu, pro který se má návod zobrazit.
- URL – vygenerovaný odkaz, který lze zkopírovat tlačítkem.
Odkaz funguje bez přihlášení – kdokoli s odkazem si může PDF stáhnout.
Pokud zvolený režim odpovídá výchozímu platebnímu režimu daného jídelního lístku, URL je ve tvaru /<slug>/navod. Pokud se režim liší od výchozího, URL obsahuje i typ: /<slug>/navod/<typ>.
Nahrát vlastní šablonu návodu
Formulář pro nahrání vlastní DOCX šablony. Vlastní šablona přepíše výchozí šablonu pro zvolený režim a platí pouze pro aktuální provoz – ostatní provozy zůstanou nedotčené.
- Podporovaný formát: .docx (maximální velikost 20 MB).
- Po nahrání se vlastní šablona zobrazí v tabulce jako „Vlastní návod".
- Vlastní šablonu lze kdykoli smazat – systém se vrátí k výchozí šabloně.
Režimy manuálů
Každý manuál odpovídá jednomu platebnímu režimu. Pokud provoz nemá zapnuté platby, je k dispozici pouze obecný manuál.
| Režim v administraci | URL typ |
|---|---|
| Obecný manuál (bez plateb) | obecny |
| Kreditové konto | kredit |
| Zpětná úhrada | zpetne |
| Měsíční fakturace | fakturace |
| Týdenní fakturace | fakturace-tyden |
| Kredit s doporučenou zálohou | kredit-zaloha |
Proměnné v DOCX šabloně
Šablona používá proměnné ve tvaru ${NAZEV_PROMENNE}. Systém je při generování nahradí skutečnými hodnotami podle nastavení firmy a uživatele.
Základní proměnné
| Proměnná | Popis | Příklad hodnoty |
|---|---|---|
${APP_URL} | Adresa aplikace (bez https://) | jidelna.example.cz |
${LOGIN_URL} | Adresa přihlašovací stránky | https://jidelna.example.cz/prihlaseni |
${LOGIN_LINK} | Stejné jako LOGIN_URL (alias) | https://jidelna.example.cz/prihlaseni |
${PARENT_COMPANY_NAME} | Název provozovatele | Školní jídelna Horní |
${COMPANY_NAME} | Název jídelního lístku (firmy) | ZŠ Horní - obědy |
${ADMIN_FIRM_NAME} | Název odběrného místa uživatele | Budova A |
${PAYMENT_MODE} | Režim úhrad textově | Kreditové konto |
Proměnné uzávěrek
| Proměnná | Popis | Příklad hodnoty |
|---|---|---|
${SOFT_DEADLINE} | Text uzávěrky objednávek | 1 pracovní den předem v 14:00 |
${HARD_DEADLINE} | Text uzávěrky storna (pokud je aktivní) | v 8:00 aktuálního dne |
${WEEKLY_DEADLINE} | Text týdenní uzávěrky (pokud je aktivní) | v pátek v 14:00 |
${DEADLINE_DAY_MODE} | Režim počítání dní | pracovní dny nebo kalendářní dny |
Podmíněné bloky v šabloně
DOCX šablona podporuje podmíněné bloky, které se zobrazí nebo skryjí podle nastavení firmy. Blok se zapíše takto:
${IS_HARD_DEADLINE_ACTIVE}
Tento text se zobrazí jen pokud je aktivní uzávěrka storna.
${/IS_HARD_DEADLINE_ACTIVE}Dostupné podmíněné bloky:
${IS_HARD_DEADLINE_ACTIVE} ... ${/IS_HARD_DEADLINE_ACTIVE}– obsah se zobrazí, pokud je aktivní uzávěrka storna.${IS_WEEKLY_DEADLINE_ACTIVE} ... ${/IS_WEEKLY_DEADLINE_ACTIVE}– obsah se zobrazí, pokud je aktivní týdenní uzávěrka.${IS_CLASSIC_DEADLINE_ACTIVE} ... ${/IS_CLASSIC_DEADLINE_ACTIVE}– obsah se zobrazí, pokud je aktivní klasická denní uzávěrka (tj. není týdenní).${IS_WORKING_DAY_DEADLINE} ... ${/IS_WORKING_DAY_DEADLINE}– obsah se zobrazí, pokud se uzávěrka počítá v pracovních dnech.
Blok se zobrazí, pokud je hodnota podmínky 1, true, ano nebo yes. Při hodnotách 0, false, ne nebo no se obsah bloku odstraní.
Podmíněné bloky lze kombinovat s proměnnými. Například pro zobrazení uzávěrky storna jen tehdy, kdy je aktivní:
${IS_HARD_DEADLINE_ACTIVE}
Uzávěrka storna: ${HARD_DEADLINE}
${/IS_HARD_DEADLINE_ACTIVE}Priorita zdrojů šablony
Při generování manuálu systém hledá šablonu v tomto pořadí:
- Vlastní šablona pro daný režim – pokud je nahrána vlastní DOCX šablona pro aktuální provoz a konkrétní platební režim.
- Vlastní obecná šablona – pokud je nahrána vlastní DOCX šablona pro aktuální provoz bez specifikace režimu.
- Výchozí systémová šablona – šablona dodávaná systémem.
Přepis uzávěrek z odběrného místa
Pokud má provoz zapnuté přepisování uzávěrek na úrovni odběrných míst a u konkrétního odběrného místa je nastaven override uzávěrky, manuál generovaný pro uživatele na tomto odběrném místě převezme uzávěrkové hodnoty z odběrného místa místo z jídelního lístku. Toto se uplatní pouze u denních uzávěrek (ne u týdenních).
Příloha v e-mailu o založení účtu
Při založení uživatelského účtu systém automaticky přiloží k uvítacímu e-mailu PDF manuál vygenerovaný podle platebního režimu daného uživatele. Příloha se přikládá pouze tehdy, když:
- je zapnutý přepínač Zapnout manuály pro uživatele v systémovém nastavení,
- pro daný režim existuje šablona (vlastní nebo výchozí).
E-mail zároveň obsahuje informaci o tom, že návod je v příloze.
Veřejný odkaz na jídelním lístku
Pokud jsou manuály zapnuté, na stránce objednávkového formuláře se zobrazí odkaz Stáhnout návod. Uživatel si může kdykoli stáhnout aktuální verzi manuálu odpovídající jeho jídelnímu lístku a platebnímu režimu.
Cache a aktualizace
Vygenerované PDF manuály se ukládají do cache. Cache se automaticky invaliduje při:
- změně nastavení uzávěrek (jídelní lístek nebo odběrné místo),
- nahrání nebo smazání vlastní šablony,
- změně systémového nastavení manuálů.
Při prvním přístupu na veřejný odkaz po invalidaci se manuál automaticky přegeneruje.
Řešení problémů
- Proměnná se nevyplní: zkontrolujte, že v DOCX šabloně je proměnná zapsána přesně ve tvaru
${NAZEV}včetně složených závorek a dolaru. Pozor na formátování ve Wordu – pokud Word rozdělí text proměnné do více „runs" (např. kvůli kontrole pravopisu nebo formátování), systém ji nemusí rozpoznat. Doporučujeme proměnné psát najednou nebo je vkládat jako prostý text. - Podmíněný blok se nezobrazí / neskryje: ověřte, že otevírací i zavírací značka jsou ve stejném formátovacím stylu a nejsou rozdělené formátováním Wordu.
- PDF se nevygeneruje: zkontrolujte, že šablona DOCX je platný soubor a nepřesahuje 20 MB. Pokud problém přetrvává, zkuste šablonu uložit znovu ve Wordu jako nový soubor.