======= Mailtrain ======

=== Úvod ===

[[https://mailtrain.pirati.cz|Mailtrain]] je nástroj pro tvorbu emailových newsletterů.

=== Základní názvosloví ===

  * **Seznamy (Lists)** = seznamy odběratelů
  * **Kanál (Channel)** = newsletter (konfigurace pro rychlejší vytvoření emailu)
  * **Kampaň (Campaign)** = jeden email z newsletteru
  * **Šablony (Templates)** = šablony vzhledu emailů
  * **Jmenné prostory (Namespaces)** = hierarchická struktura sloužící mj. k nastavení patřičných oprávnění

===== Návod pro vytvoření a rozeslání emailu newsletteru =====

//Dělá správce newsletteru - PKS, PMS, mediální tým, apod.//

V **Kanály** rozklikneme příslušný Kanál a klikneme na tlačítko ''Vytvořit kampaň'' (''Create Campaign''):
  - ''Název'' (''Name'') vyplníme jako název pro naše rozlišení, např. „Olomoucký kraj - únor 2023“. Případně doplníme i poznámku do ''Popis'' (''Description'').
  - Jako ''Řádek "Subject"'' (''Subject line'') zvolíme __název emailu pro odběratele__, např. „Únorové novinky Olomouckých Pirátů“.
  - Klikneme na tlačítko ''Uložit a upravit obsah'' (''Save and edit content'').
  - Vytvoříme obsah newsletteru a klikneme na ''Uložit a jít na status'' (''Save and go to status'').
  - Tlačítkem dole ''Testovací odeslání'' (''Test send'') pošleme testovací email na vybrané odběratele (v **Seznamy** v seznamu odběratelů je třeba v editaci vybraných osob zaškrtnout, že jsou testeři).
  - Pokud jsme spokojeni, rozešleme newsletter všem odběratelům tlačítkem ''Odeslat'' (''Send'').

[[https://tv.pirati.cz/w/oWahuQduwRtQda3hyHyLw8|Videonávod]]
===== Úpravy šablony =====

//Dělá správce newsletteru - PKS, PMS, mediální tým, apod. //

**Šablona** specifická pro konkrétní **Jmenný prostor** a **Kanál** je kopie výchozího Pirátského vzhledu a je možné si ji upravit podle potřeby. Upravit lze například odkazy na sociální sítě pro oblastní sdružení, připravit si podpis, apod.

===== Založení newsletteru =====

//Zakládá admin či support TO.//

<note>Pokud chcete založit newsletter pro váš tým, oblastní sdružení, apod. napište nám požadavek do [[https://redmine.pirati.cz/projects/to/issues/new|podatelny TO v Redmine]].</note>

  - V administraci vytvoříme **Jmenný prostor** a správně zařadíme. Např. „Olomoucký kraj“ zařazený pod **Jmenný prostor** „Kraje“.
  - Vytvoříme novou **Šablonu**:
    * Zvolíme ''Klonování z existující šablony'' (''Clone from an existing template'') a vybereme „Grafika Šipky“ z namespace „Sdílené šablony“.
    * ''Název'' (''Name'') dle sdružení či týmu, např. „Grafika Šipky OLK“.
    * Zařadíme pod **Jmenný prostor** __vytvořený v kroku 1__.
  - Vytvoříme nový **Seznam**:
    * ''Název'' (''Name'') zvolíme srozumitelně pro veřejnost, např. „Piráti Olomoucký kraj“.
    * ''Popis'' (''Description'') pro veřejnost např. „Novinky z činnosti Pirátů v Olomouckém kraji.“
    * ''Web'' (''Homepage'') nastavíme na web sdružení či týmu, např. „https://olomoucky.pirati.cz“.
    * ''Konfigurace odesílání'' (''Send configuration'') vybereme „System (Mailgun SMTP)“.
    * Zařadíme pod **Jmenný prostor** __vytvořený v kroku 1__.
    * ''Odhlášení odběru'' (''Unsubscription'') vybereme „Jeden krok s odhlašovacím formulářem (bez emailu s potvrzovacím odkazem)“ („One-step with unsubscription form (i.e. no email with confirmation link)“).
  - Vytvoříme nový **Kanál**:
    * ''Název'' (''Name'') stejný jako u **Seznam**, např. „Piráti Olomoucký kraj“.
    * Zařadíme pod **Jmenný prostor** __vytvořený v kroku 1__.
    * ''Seznam'' (''List'') vybereme ten __vytvořený v kroku 3__, tedy např. „Piráti Olomoucký kraj“.
    * ''Konfigurace odesílání'' (''Send configuration'') vybereme „System (Mailgun SMTP)“.
    * U **Šablona** vybereme ''Zdroj obsahu'' (''Content source'') „Vlastní obsah duplikovaný ze šablony“ („Custom content cloned from template“). A jako **Šablonu** vybereme šablonu __vytvořenou v kroku 2__, tedy např. „Grafika Šipky OLK“.

===== Nastavení oprávnění =====

//Dělá admin či support TO.//

V [[ao:chobotnice|Chobotnici]] se nakonfiguruje ''Mailtrain sdílení''. Kde se zadá **ID Namespace** a vybere se tým, který ho má v Mailtrainu spravovat. Jeden Namespace může spravovat více týmů. A jeden tým může spravovat více Namespaces (= newsletterů).

**Nastavení oprávnění přímo v Mailtrainu udělá [[ao:chobotnice|Chobotnice]] v rámci synchronizace.** Zde je popis, co nastavuje (pro kontrolu, nebo kdyby se to dělalo ručně):

  * Uživateli se přiřadí role „Campaigns Admin (multiple namespaces)“.
  * Uživateli se nasdílí Namespace s rolí „Campaigns Admin“.
  * Uživateli se nasdílí „Mosaico Template Versafix One“ s rolí „Viewer“.
  * Uživateli se nasdílí „System (Mailgun SMTP)“ s rolí „Campaigns Creator“.
  * Zavolá se API Mailtrainu na přegenerování oprávnění (není třeba pokud se sdílení nastavuje v UI Mailtrain).

--------

<hidden onHidden="Zobrazit štítek" onVisible="Skrýt  štítek">
---- dataentry navod ----
složka_page : to:start # organizační složka odpovědná za činnost
adresáts    : oblastní předsednictva, koordinátoři, mediální odbory či týmy # vymezení osob, jimž je návod určen
tags        : newsletter, email # seznam kategorií (tagů), kterých se návod týká
stav_wiki   : <color lightgreen>aktuální</color> # stav návodu, možné barvy: red, orange, blue, lightgreen, darkgreen
aktualizace : 27.03.2023 # datum poslední aktualizace textu návodu
----

</hidden>
Na tento návod odkazují [[?do=backlink|tyto stránky]].
{{page>navody/stitek}}