Wiki source code of Tab Šablony

Last modified by Josef Vencl on 2021/01/14 13:07
Show last authors
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 )))
5
6 {{info}}
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ů.
8 {{/info}}
9
10 [[image:s-settings-email.png]]
11
12 Celý obsah tabu zabírá seznam šablon, vyjímkou je pouze tlačítko pro **přidání nové šablony (1)** vpravo nahoře.
13
14 Položka šablony obsahuje její** název (2)**,** jazyky (3)**, ve kterých je šablona dostupná a možnost celou šablonu **smazat (4)**.
15
16 Kliknutím na položku šablony se otevře okno pro její editaci.
17
18
19 === Vytvoření nové šablony ===
20
21 [[image:s-settings-email-new.png]]
22
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.
24
25 Jakmile klikneme na tlačítko **Potvrdit**, otevře se editační okno šablony.
26
27
28 == Editace šablony ==
29
30 [[image:s-settings-email-edit.png]]
31
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)**.
33
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.
35
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
42 [[image:s-settings-email-edit2.png]]
43
44 Jak již bylo řečeno, volbu mezi Základní a Agregovanou šablonou **(1)** prozatím popisovat nebudeme.
45
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
48 [[image:s-settings-email-editLang.png]]
49
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
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.
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
60