Wiki source code of Tab Šablony

Last modified by Josef Vencl on 2021/01/14 13:07
Hide last authors
Josef Vencl 12.1 1 (% class="box" %)
2 (((
3 Zde se spravují šablony emailových zpráv a notifikací, které posílá systém uživatelům. Konkrétně se zde určuje obsah jednotlivých šablon v různých jazycích, případně proměnné použité v těchto šablonách. Tyto šablony se dále použijí v tabech [[Tab Notifikace 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Nastavení.Tab Notifikace.WebHome]], Workflow 💻 nebo u jednotlivých aktivit na obrazovce [[Detail aktivity 💻>>doc:Main.Official manuals.Competent - Uživatelská příručka.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Aktivity.Detail aktivity.WebHome]].
4 )))
admin admin 1.1 5
Petr Blšťák 10.1 6 {{info}}
Josef Vencl 12.1 7 Sekce správy šablon emailů bude v brzké době přepracována pro lepší přehlednost a pochopitelnost systému. Z toho důvodu zde nepopisujeme systém agregovaných šablon. Princip funkčnosti šablon by měl zůstat stejný, změnit by se mělo hlavně grafické rozhraní a rozložení prvků.
Petr Blšťák 10.1 8 {{/info}}
9
Petr Blšťák 7.2 10 [[image:s-settings-email.png]]
admin admin 1.1 11
Petr Blšťák 7.3 12 Celý obsah tabu zabírá seznam šablon, vyjímkou je pouze tlačítko pro **přidání nové šablony (1)** vpravo nahoře.
admin admin 1.1 13
Petr Blšťák 10.1 14 Položka šablony obsahuje její** název (2)**,** jazyky (3)**, ve kterých je šablona dostupná a možnost celou šablonu **smazat (4)**.
Petr Blšťák 7.3 15
16 Kliknutím na položku šablony se otevře okno pro její editaci.
17
18
19 === Vytvoření nové šablony ===
20
Petr Blšťák 7.2 21 [[image:s-settings-email-new.png]]
22
Petr Blšťák 7.3 23 Pro novou šablonu je nejprve potřeba definovat název. Přesněji zde definujeme **název skupiny šablon (1)**. Tato skupina šablon je identifikována právě daným názvem a obsahuje šablony pro ten samý email v ruzných jazycích. Pokud budeme mít šablony pouze v jednom jazyku, každá skupina pak bude obsahovat právě jednu reálnou šablonu.
Petr Blšťák 7.2 24
Petr Blšťák 7.3 25 Jakmile klikneme na tlačítko **Potvrdit**, otevře se editační okno šablony.
26
27
28 == Editace šablony ==
29
Petr Blšťák 7.2 30 [[image:s-settings-email-edit.png]]
31
Petr Blšťák 9.1 32 Kliknutím na položku šablony v seznamu nebo založením nové šablony se dostaneme do editačního okna šablony, respektive skupiny šablon. Název skupiny je zobrazen v horním řádku pod záhlavím modálního okna a je možné jej editovat pomocí tlačítka **Upravit název (1)**.
Petr Blšťák 7.2 33
Josef Vencl 12.2 34 Pod názvem skupiny část týkající se hromadného nastavení šablon, což je **Typ šablony (2)**. Zatím se spokojme s tím, že tento typ je nastaven na Základní. Druhou možností je Agregovaný typ šablony, který ovšem kvůli vyšší komplikovanosti momentálně vynecháme.
Petr Blšťák 7.3 35
Petr Blšťák 9.1 36 Dále už volíme konkrétní šablonu, kterou budeme upravovat - tedy **jazyk šablony (4)**, který definuje reálný objekt jedné šablony. Pokud již v této skupině existují nějaké šablony, vidíme zde rozbalovací menu jako na obrázku výše. Rozbalením a výběrem jazyka zvolíme šablonu, se kterou budeme dále pracovat. Tlačítky vedle rolovacího menu můžeme aktuální šablonu smazat nebo přidat novou. Pokud zatím v této skupině žádné šablony neexistují, rozbalovací menu se zde nezobrazí a musíme nejprve nějakou šablonu přidat pomocí tlačítka **Přidat jazyk**.
37
38 Pod volbou jazyka je zobrazen **Předmět šablony (5)**, její **Popis (6)** a poté její text, tedy samotné **Tělo emailu** **(7)**. Předmět a tělo emailu jsou informace, které se ve výsledku ukáží uživateli, když obdrží email. Popis je zobrazen pouze zde, pro informace k čemu a kdy je šablona používána například.
39
40 Pokud chceme aktuálně vybranou šablonu upravovat, klikneme na tlačítko **Upravit šablonu (3)** vpravo nahoře.
41
Petr Blšťák 7.2 42 [[image:s-settings-email-edit2.png]]
43
Petr Blšťák 9.1 44 Jak již bylo řečeno, volbu mezi Základní a Agregovanou šablonou **(1)** prozatím popisovat nebudeme.
Petr Blšťák 7.2 45
Petr Blšťák 9.1 46 V případě, že needitujeme stávající šablonu, ale přidáváme nový jazyk, ukáže se místo zvoleného jazyka a zašedlých tlačítek **(3)** volba pro novy jazyk:
47
Petr Blšťák 7.2 48 [[image:s-settings-email-editLang.png]]
Petr Blšťák 7.3 49
Petr Blšťák 9.1 50 V červené oblasti jsou tlačítka všech dostupných jazyků, pro které zatím neexistuje šablona. Aktuálně vybraný jazyk je pak vyznačen jiným pozadím tlačítka a bílou barvou písma.
51
52 **Předmět **a **popis **šablony jsou obyčejná vypisovací pole, můžeme sem tedy vložit libovolný text.
53
Josef Vencl 12.2 54 **Tělo emailu** je vypisovací oblast, kam také můžeme vepsat libovolný text, ale navíc je možné vkládat sem **proměnné**, jako vidíme například proměnnou **${firstName}**. Tyto proměnné jsou zástupné symboly, které říkají systému, aby v okamžiku odesílání emailu nahradil tento symbol reálnou informací, zde konkrétně křestním jménem uživatele. To je velice použitelné pro jednoduché psaní obecných emailů, například ve formátu "//Dobrý den, pane XXX, dne XXX vám vyprší přístup ke kurzu XXX, který zatím nemáte splněný. Nejlepší dosavadní pokus má skóre XXX.//" Všechna XXX jsou pak v okamžiku posílání emailu nahrazena reálnými údaji, které se liší v závislosti na tom kterému uživateli a o jakém kurzu se posílají informace.
Petr Blšťák 9.1 55
56 Proměnné se do těla emailu vkládají z lišty pod tělem emailu. Nejprve je zvolen **tab objektu (4)**, ke kterému se proměnná vztahuje a poté kliknutím na konkrétní **název proměnné (5)**, je tato proměnná umístěna do těma emailu na aktuální pozici kurzoru.
57
58 Jakmile jsou úpravy šablony hotové, uložíme šablonu kliknutím na tlačítko **Uložit (2)**.
59
Petr Blšťák 7.3 60