Tab Šablony

Zde se spravují **Šablony emailových zpráv a [[notifikací>>doc:Uživatelská příručka Competent.Slovník.Notifikace.WebHome]]**, které systém posílá uživatelům automaticky na základě událostí, které se v něm odehrávají. Konkrétně se zde určuje obsah jednotlivých šablon v různých jazycích a případně proměnné použité v těchto šablonách. Tyto šablony se dále použijí v tabech Tab Notifikace, Workflow nebo u jednotlivých aktivit na obrazovce Detail aktivity.

2

3

[[image:Obsah tabu Šablona emailu.png||alt="Obsah tabu Šablony emailů" data-xwiki-image-style-border="true" height="401" width="809"]]

4

5

Tlačítko pro přidání **nové šablony (1)** je umístěno vpravo nahoře. Položka šablony obsahuje její **název (2)**, **jazyky (3)**, ve kterých je šablona dostupná, informaci o tom, zda je šablona **Základní** či **Agregovaná (4)**, a možnost celou šablonu** smazat (5)**.

6

7

Kliknutím na položku šablony se otevře okno pro její editaci.

8

9

10

== Vytvoření nové šablony ==

11

12

[[image:Vytvoření nové šablony.png||alt="Vytvoření nové šablony" data-xwiki-image-style-border="true" height="152" width="817"]]

13

14

Pro novou šablonu je nejprve potřeba definovat název. Přesněji zde definujeme **Název skupiny šablon (1)**, ale pro jednoduchost ji dále nazýváme Šablona emailu. Tato Šablona emailu je identifikována právě daným názvem a obsahuje šablony pro tentýž email v různých jazycích. Pokud budeme mít šablony pouze v jednom jazyku, tak každá skupina bude obsahovat právě jednu reálnou šablonu.

15

16

Jakmile klikneme na tlačítko **Potvrdit**, otevře se editační okno šablony.

17

18

19

== Editace šablony ==

20

21

Kliknutím na položku šablony v seznamu nebo vytvořením nové šablony se dostaneme do editačního okna. V případě více jazykových verzí jde o editaci celé skupiny šablon. Název skupiny je zobrazen v horním řádku pod záhlavím modálního okna a je možné jej upravit pomocí tlačítka** Upravit název (1)**.

22

23

[[image:Nova Skupina sablon.png||alt="Editace šablony emailů" data-xwiki-image-style-border="true" height="640" width="811"]]

24

25

26

Pod názvem skupiny je část týkající se hromadného nastavení daných šablon, konkrétně **Typ šablony (3)**. Typ šablony může být **Základní** nebo **Agregovaná**:

27

28

* **Základní šablona** navázána na konkrétní notifikační událost v Tabu Notifikace slouží k odeslání emailové zprávy pokaždé, když nastane daná událost (např. přiřazení kurzu uživateli).

29

* **Agregovaná šablona** slouží k slučování stejného typu událostí za určité časové období do jedné emailové zprávy. Časový interval odesílání se následně nastavuje až při přiřazení ke konkrétní Notifikaci v [[Tabu Notifikace>>doc:Uživatelská příručka Competent.Uživatelské rozhraní.Administrátorské rozhraní.Obrazovka Nastavení.Tab Notifikace.WebHome]].

30

31

Dále už volíme konkrétní **Jazyk šablony (4)**, kterou budeme upravovat. Pokud již v této Šabloně existují nějaké jazyky, vidíme zde **rozbalovací menu (4a)**. Rozbalením a výběrem jazyka zvolíme jazyk šablony, se kterým budeme dále pracovat. Tlačítky vedle rolovacího menu můžeme aktuální jazyk šablony smazat nebo přidat nový. Pokud zatím v této Šabloně neexistují žádné jazyky, rozbalovací menu se zde nezobrazí a musíme nejprve nějaký jazyk přidat pomocí tlačítka **Přidat jazyk (4b)**. Aktuálně vybraný jazyk je pak vyznačen tmavým pozadím tlačítka a bílou barvou písma** (4c)**.

32

33

[[Možné stavy nastavení jazyka 4a>>image:Možné stavy nastavení jazyka 4b.png||alt="Možné stavy nastavení jazyka 4b" data-xwiki-image-style-border="true" height="44" width="372"]]

34

35

[[Možné stavy nastavení jazyka 4b>>image:Možné stavy nastavení jazyka 4a .png||alt="Možné stavy nastavení jazyka 4b" data-xwiki-image-style-border="true" height="46" width="280"]]

36

37

[[Možné stavy nastavení jazyka 4c>>image:Možné stavy nastavení jazyka 4c.png||alt="Možné stavy nastavení jazyka 4c" data-xwiki-image-style-border="true" height="45" width="214"]]

38

39

40

Pod volbou jazyka je zobrazen **Předmět emailu (šablony) (5)**, jehož vyplnění je podmínkou ke správnému odesílání emailových zpráv. Dále následuje **Popis (6)** a text šablony, 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 a slouží jako informace o tom, k čemu a kdy je šablona používána (vyplnění není povinné).

41

42

Po dokončení šablony klikneme na tlačítko **Uložit (2)** vpravo nahoře. V případě, že chceme již uloženou a aktuálně vybranou šablonu upravovat, vpravo nahoře se bude zobrazovat tlačítko **Upravit šablonu**.

43

44

Ať při založení Nové skupiny šablon, tak při Editaci existující šablony, si nastavujeme zda chceme šablonu Základní, která se odešle vždy při každé dané události, nebo Agregovanou, která slučuje stejný typ událostí za určité období do jedné emailové zprávy. Typ šablony má vliv na podobu Těla emailu a jeho specifika.

45

46

V případě Základního typu šablony se nám jako hlavní zapisovací oblast zobrazuje **Tělo emailu (1)**. Do této oblasti můžeme zapisovat libovolný text pomocí **WYSIWIG editoru** nebo **HTML formátování**.

47

48

[[image:Šablona emailu - zakladni typ šablony.png||data-xwiki-image-style-border="true" height="459" width="816"]]

49

50

51

Pomocí **WYSIWIG editoru (2)** můžeme text jednoduše formátovat dle potřeby. Základní formáty jsou např. tučné písmo, kurzíva, podtržení, zarovnání textu, barevné písmo, odrážky apod.

52

Je možné využít také **HTML formátování (3)**, které se zapisuje pomocí řádkových a blogových tagů viz obrázky níže. Editor, do nějž lze vložit HTML kód, se nám zobrazí po kliknutí na ikonku **< >**.

53

54

[[image:HTML formátování 2.png||data-xwiki-image-style-border="true" height="163" width="812"]]

55

56

57

Při volbě **Agregovaného typu šablony** se zobrazí editační oblasti **Hlavička (1)**, **Tělo emailu (2)** a **Patička (3)**:

58

59

* Do** Hlavičky (1)** zapisujeme text, který se v emailu zobrazí pouze jednou na začátku.

60

* Do **Těla emailu (2)** zapisujeme text, který odpovídá opakující se části zprávy. Tato část se v odeslaném emailu zopakuje pro každou proběhlou událost.

61

62

Do **Patičky (3)** zapisujeme text, který se zobrazí pouze jednou na konci emailu.

63

64

[[image:Agregovaná šablona a zpráva.png||alt="Agregovaná šablona a zpráva" data-xwiki-image-style-border="true" height="241" width="827"]]

== Proměnné ==

V textech šablon lze využít **Proměnné (5)**, které fungují jako zástupné symboly. Při odesílání emailu se nahradí reálnou hodnotou z Competentu.

70

71

[[image:Proměnné.png||alt="Proměnné" data-xwiki-image-style-border="true" height="113" width="820"]]

72

73

Proměnné se dělí dle objektu, kterému v Competentu přísluší, tedy ze kterého se při generování e-mailu vyplňují do šablony data. Může se jednat o hlavní objekty (např. Aktivita, Pokus) nebo objekt popisující vztahy mezi těmito objekty (např. Uživatel-Aktivita). Pro výběr proměnné tedy nejprve zvolíme **Tab příslušného objektu (4)**. Poté kliknutím na název proměnné vložíme symbol na aktuální pozici kurzoru. Proměnnou lze do textu šablony zapsat i přímo vstupem z klávesnice. Seznam objektů a proměnných najdete níže.

74

75

Jakmile jsou úpravy šablony hotové, uložíme ji kliknutím na tlačítko **Uložit** vpravo nahoře. [[image:Zrušit a Uložit.png||data-xwiki-image-style-border="true" height="52" width="136"]]

76

77

Seznam [[proměnných>>doc:Uživatelská příručka Competent.Slovník.Proměnné.WebHome]], které v Šabloně můžete využít, najdete ve Slovníku.

Wiki source code of Tab Šablony