{"id":4027,"date":"2020-05-08T12:37:45","date_gmt":"2020-05-08T10:37:45","guid":{"rendered":"https:\/\/ready-os.com\/?post_type=docs&p=4027"},"modified":"2022-05-24T14:06:15","modified_gmt":"2022-05-24T12:06:15","slug":"szablony-wiadomosci-email","status":"publish","type":"docs","link":"https:\/\/www2.ready-os.com\/pl\/docs\/system\/szablony-wiadomosci-email\/","title":{"rendered":"Szablony wiadomo\u015bci email"},"content":{"rendered":"

Mechanizm szablon\u00f3w dla wiadomo\u015bci email funkcjonuje w oparciu o bibliotek\u0119 Flexy. Umo\u017cliwia on wykorzystanie podczas tworzenia wiadomo\u015bci wybranego, przygotowanego wcze\u015bniej szablonu – przypisanego do danego konta pocztowego (domy\u015blnie), b\u0105d\u017a wybranego r\u0119cznie na formularzu wiadomo\u015bci email. Szablon to w zasadzie plik HTML\/Flexy zawieraj\u0105cy dowolne elementy (np. tabele, obrazki), style (np. t\u0142o, rodzaj i wielko\u015b\u0107 czcionki, itd.) oraz predefiniowane zmienne.<\/p>\n

Je\u015bli podczas tworzenia wiadomo\u015bci, na formularzu dokonana zostanie zmiana konta, z kt\u00f3rego wiadomo\u015b\u0107 zostanie wys\u0142ana, b\u0105d\u017a bezpo\u015brednio wybrany zostanie jeden z dost\u0119pnych szablon\u00f3w, tre\u015b\u0107 wiadomo\u015bci zostanie prze\u0142adowana z zastosowaniem w\u0142a\u015bciwego szablonu zachowuj\u0105c prawid\u0142ow\u0105 stopk\u0119, cytowan\u0105 wiadomo\u015b\u0107 (np. dla odpowiedzi, podczas przekazywania wiadomo\u015bci), oraz wprowadzon\u0105 tre\u015b\u0107.<\/p>\n

 <\/p>\n

Tworzenie nowego szablonu<\/h3>\n

Wszystkie pliki z szablonami dla wiadomo\u015bci email powinny mie\u0107 rozszerzenie .tpl<\/strong> i znajdowa\u0107 si\u0119 w Centrum -> Narz\u0119dzia -> Panel sterowania -> Pozosta\u0142e ustawienia -> Szablony systemowe -> katalog emails.<\/strong><\/p>\n

\"\"<\/p>\n

Pliki musz\u0105 by\u0107 zapisane w kodowaniu UTF-8.
\nSzablony s\u0105 identyfikowane nazwami plik\u00f3w z obci\u0119tym rozszerzeniem (np. plik nowy_szablon.tpl<\/em> b\u0119dzie wy\u015bwietlany na li\u015bcie wyboru szablonu pod nazw\u0105 nowy_szablon<\/em>).
\nSzablony s\u0105 parsowane przez silnik Flexy, a ich wynikowa zawarto\u015b\u0107 traktowana jest jako HTML.
\nW szablonach mo\u017cna wykorzystywa\u0107 tak\u017ce predefiniowane zmienne, kt\u00f3rych warto\u015b\u0107 jest generowana automatycznie w zale\u017cno\u015bci od kontekstu u\u017cycia szablonu:<\/p>\n

text - tre\u015b\u0107 wiadomo\u015bci wprowadzona przez u\u017cytkownika<\/pre>\n
footer - stopka wiadomo\u015bci, w\u0142a\u015bciwa dla danego konta, b\u0105d\u017a u\u017cytkownika je\u015bli stopka dla konta nie zosta\u0142a okre\u015blona<\/pre>\n
quoted - tre\u015b\u0107 cytowanej wiadomo\u015bci wraz z nag\u0142\u00f3wkiem - w przypadku tworzenia odpowiedzi lub przekazywania wiadomo\u015bci<\/pre>\n
W systemie instalowany jest domy\u015blnie wykorzystywany szablon o nazwie default<\/em>. Nie jest zalecana modyfikacja tego pliku, ani jego usuwanie. Domy\u015blny szablon jest u\u017cywany w przypadku braku mo\u017cliwo\u015bci u\u017cycia szablonu oczekiwanego w danym kontek\u015bcie (np. brak w\u0142a\u015bciwego pliku, brak uprawnie\u0144 do pliku). Zmiany powinny by\u0107 wprowadzane na zasadzie dodawania nowych szablon\u00f3w.<\/p>\n
 <\/p>\n
Linkowanie grafiki w szablonach wiadomo\u015bci<\/h3>\n
W szablonie mo\u017cna oczywi\u015bcie umieszcza\u0107 elementy graficzne (tag IMG) b\u0105d\u017a te\u017c okre\u015bla\u0107 w definicji styl\u00f3w obrazy wykorzystywane jako t\u0142o. Nale\u017cy jednak pami\u0119ta\u0107, \u017ce elementy te musz\u0105 by\u0107 linkowane jako zasoby zewn\u0119trzne, tzn. nie przesy\u0142ane wraz z wiadomo\u015bci\u0105. Grafik\u0119 najcz\u0119\u015bciej publikuje si\u0119 na serwerze obs\u0142uguj\u0105cym witryn\u0119 internetow\u0105 firmy.
\nElementy graficzne mo\u017cna tak\u017ce w formie kodowania base64<\/p>\n
<img src=\"data:image\/png;base64,iVBORw0KGgoAA.......\" \/>)<\/pre>\n
 <\/p>\n
Wykorzystanie szablonu w korespondencji<\/h3>\n
Dla ka\u017cdego z kont pocztowych mo\u017cliwe jest niezale\u017cne okre\u015blenie w\u0142a\u015bciwego szablonu, kt\u00f3ry b\u0119dzie wykorzystywany podczas tworzenia wiadomo\u015bci.<\/p>\n
Okre\u015blamy to w oknie konfiguracji konta pocztowego:<\/p>\n
\"\"<\/p>\n
W przypadku wysy\u0142ania bardziej specyficznych wiadomo\u015bci (np. ofert), gdzie oczekiwane jest zawarcie bardziej szczeg\u00f3\u0142owych, statycznych informacji, mo\u017cliwe jest wybranie szablonu ju\u017c bezpo\u015brednio na formularzu tworzonej wiadomo\u015bci, na przycisku Opcje<\/strong>.<\/p>\n
\"\"<\/p>\n
Okre\u015blony w ten spos\u00f3b szablon ma wy\u017cszy priorytet, ni\u017c domy\u015blny szablon przypisany do konta, wi\u0119c w tym momencie kolejne zmiany w polu Od<\/em> b\u0119d\u0105 powodowa\u0142y jedynie aktualizacj\u0119 stopki.<\/p>\n
 <\/p>\n
Przyk\u0142adowy szablon HTML\/Flexy<\/h3>\n
Poni\u017cej zamieszczony zosta\u0142 przyk\u0142adowy kod szablonu. Deklaracje important<\/em> przy rozmiarze czcionki i rodzaju czcionki s\u0105 konieczne dla nadpisania domy\u015blnych ustawie\u0144 edytora.<\/p>\n
<body>\n<head>\n<style type=\"text\/css\">\n    body {\n        font-size: 12pt !important;\n        font-family: calibri, arial, sans-serif !important;\n        color: #000;\n        background: #fff;\n        padding: 4px;\n    }\n    table, td {\n        font-family: calibri, arial, sans-serif;\n        border-style: none;\n        padding: 0px;\n        margin: 0px;\n    }\n    td {\n        vertical-align: top;\n    }\n    img {\n        padding: 0px;\n        border: 0px;\n    }\n    .tmain {\n        width: 100%;\n    }\n    .tmain .leftCol {\n        width: 200px;\n        color: #999;\n        border-right: 1px solid #bbb;\n    }\n    .tmain .rightCol {\n        padding: 0px 12px;\n    }\n    .footer {\n        border-top: 1px solid #bbb;\n        margin-top: 12px;\n        padding-top: 12px;\n    }\n    .account {\n        color: #777;\n    }\n    .quoted {\n        padding: 0px 10px;\n    }\n    .quoted blockquote {\n        border: 2px none #3D8BFF;\n        border-style: none solid;\n        padding: 0px 10px;\n        margin: 0px;\n    }\n<\/style>\n<\/head>\n<table class=\"tmain\">\n    <tr>\n        <td class=\"leftCol\">\n            <div class=\"company\">\n                <img src=\"data:image\/png;base64,iVBORw0KGgoAA.......\" \/>)<br>\n                Ready_\n            <\/div>\n        <\/td>\n        <td class=\"rightCol\">\n            \n            {text:h}\n            \n            {if:footer}\n            <div class=\"footer account\">\n                {footer:h}\n            <\/div>\n            {end:}\n        <\/td>\n    <\/tr>\n<\/table>\n\n{if:quoted}\n    <br><br>\n    <div class=\"quoted\">\n    {quoted:h}\n    <\/div>\n{end:}\n\n<\/body><\/pre>\n
Wstawianie danych z bazy do szablonu maila<\/h3>\n
Przydatn\u0105 opcj\u0105 dla du\u017cych organizacji jest pobieranie automatyczne danych do stopki z danych pracownika pochodz\u0105cych ze struktury organizacyjnej i konta u\u017cytkownika. Przyk\u0142adowe zapytania poni\u017cej:<\/p>\n
<div class=\"imie\">\n       {sql_query(#SELECT u.firnam || ' ' || u.lasnam  AS line_1 FROM organization_units o LEFT JOIN users_link_org_units ulo ON o.orunid = ulo.orunid LEFT JOIN users u ON u.usr_id = ulo.usr_id WHERE u.usr_id = {%1}#,LOGGED_USR_ID)}<br><\/div>\n       <br \/>\n<div class=\"stanowisko\">\n       {sql_query(#SELECT o.ndenam AS line_2 FROM organization_units o LEFT JOIN users_link_org_units ulo ON o.orunid = ulo.orunid LEFT JOIN users u ON u.usr_id = ulo.usr_id WHERE u.usr_id = {%1}#,LOGGED_USR_ID)}<br\/>\n        <br\/>\n        {sql_query(#SELECT CASE WHEN u.iphone IS NOT NULL THEN 'phone  ' || u.iphone ELSE ''END AS line_3 FROM organization_units o LEFT JOIN users_link_org_units ulo ON o.orunid = ulo.orunid LEFT JOIN users u ON u.usr_id = ulo.usr_id WHERE u.usr_id = {%1}#,LOGGED_USR_ID)}<br\/>\n        {sql_query(#SELECT CASE WHEN u.phone_  IS NOT NULL THEN 'mobile ' || u.phone_  ELSE ''END AS line_4 FROM organization_units o LEFT JOIN users_link_org_units ulo ON o.orunid = ulo.orunid LEFT JOIN users u ON u.usr_id = ulo.usr_id WHERE u.usr_id = {%1}#,LOGGED_USR_ID)}<br\/>\n       <u>{sql_query(#SELECT CASE WHEN e_mail IS NOT NULL THEN e_mail  ELSE ''END AS line_5 FROM organization_units o LEFT JOIN users_link_org_units ulo ON o.orunid = ulo.orunid LEFT JOIN users u ON u.usr_id = ulo.usr_id WHERE u.usr_id = {%1}#,LOGGED_USR_ID)}<\/u><br\/>\n        \n<br >\n<\/div>\n<\/pre>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
Mechanizm szablon\u00f3w dla wiadomo\u015bci email funkcjonuje w oparciu o bibliotek\u0119 Flexy. Umo\u017cliwia on wykorzystanie podczas tworzenia wiadomo\u015bci wybranego, przygotowanego wcze\u015bniej szablonu – przypisanego do danego konta pocztowego (domy\u015blnie), b\u0105d\u017a wybranego r\u0119cznie na formularzu wiadomo\u015bci email. Szablon to w zasadzie plik HTML\/Flexy zawieraj\u0105cy dowolne elementy (np. tabele, obrazki), style (np. t\u0142o, rodzaj i wielko\u015b\u0107 czcionki, itd.) […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":[],"doc_category":[143],"doc_tag":[],"knowledge_base":[134],"_links":{"self":[{"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/docs\/4027"}],"collection":[{"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/comments?post=4027"}],"version-history":[{"count":27,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/docs\/4027\/revisions"}],"predecessor-version":[{"id":10000,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/docs\/4027\/revisions\/10000"}],"wp:attachment":[{"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/media?parent=4027"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/doc_category?post=4027"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/doc_tag?post=4027"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/www2.ready-os.com\/pl\/wp-json\/wp\/v2\/knowledge_base?post=4027"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}