Wstęp
Informacje na tej stronie dotyczą następujących wersji modułów serwerowych (można je sprawdzić poleceniem sowizor status):
- server-sowasql-prg - wersja 1.74.0 lub wyższa
- sowizor - wersja 2.8.0 lub wyższa
- smailer - wersja 0.17.0 lub wyższa
Jeśli wersja oprogramowania serwerowego jest niższa, przed konfiguracją poczty należy przeprowadzić jego aktualizację.
Po ustawieniu parametrów dot. wysyłki poczty (zob. następny akapit), należy włączyć usługę transportu poczty elektronicznej.
Parametry systemu dot. poczty
Wszystkie ustawienia przechowywane są w parametrach systemu. Zob. na stronie Parametry systemu SowaSQL w jaki sposób administrator może je ustawiać.
Parametry wyrażone wzorcem (zawierają w opisie znak #) pozwalają definiować grupy parametrów. W szczególności wykorzystywane jest to do konfiguracji wielu kont wysyłki poczty. Konieczne jest zdefiniowanie co najmniej grupy domyślnej, o nazwie "default" (zob. przykłady w dalszej części), dla której w miejsce znaku # podać należy "default".
| Parametr | Opis | Wyjaśnienie | Domyślnie |
|---|---|---|---|
| Parametry ogólne | |||
cfg_mailer | Włącza / wyłącza obsługę poczty | Parametr powinien przyjąć jedną z wartości:
| |
| Parametry ustawień konta pocztowego nadawcy wiadomości | |||
core.mail.#.sender | Adres nadawcy | Adres e-mail nadawcy wiadomości | |
core.mail.#.name | Nazwa nadawcy | Określa nazwę opisową nadawcy. Wartość ta będzie wyświetlana w e-mailu w polu nadawcy | |
core.mail.#.host | Adres serwera SMTP | Jest to adres serwera służącego do wysyłki poczty. Ważne: nie mylić tego adresu z adresem do obierania poczty (czyli POP lub IMAP). | |
core.mail.#.port | Numer portu serwera SMTP | Port, na którym działa serwer SMTP. Domyślnie przyjmowane jest 25, ale dla większości serwerów z szyfrowaniem jest to inny port (465 dla SSL lub 587 dla TLS) i należy to wskazać. | 25 |
core.mail.#.auth | Rodzaj autoryzacji | Metoda autoryzacji w serwerze, dostępne są:
| Login |
core.mail.#.crypt | Sposób szyfrowania transmisji | Metoda szyfrowania transmisji, dostępne są:
| Plain |
core.mail.#.login | Nazwa użytkownika | O ile do konta trzeba się logować - tutaj jest podawany jego login. Często jest on tożsamy z adresem e-mail. | |
core.mail.#.password | Hasło użytkownika | O ile do konta trzeba się logować - tutaj jest podawane hasło. | |
core.mail.#.reply_to | Adres do odpowiedzi zwrotnych | Adres e-mail, który będzie się pojawiać u odbiorcy maila, jako adres, na który należy kierować odpowiedzi lub zwroty | |
core.mail.#.cc | Adres "do wiadomości" | Spowoduje, że każdy wysyłany mail będzie dodatkowo wysłany do wiadomości na podany adres email (zostanie on dodany do nagłówka CC wysyłanego maila). Informacja ta będzie widoczna dla odbiorcy maila. | |
core.mail.#.bcc | Adres "ukryte do wiadomości" | Spowoduje, że każdy wysyłany mail będzie dodatkowo wysłany do wiadomości na podany adres email (zostanie on dodany do nagłówka BCC wysyłanego maila). Informacja ta będzie ukryta przed odbiorcą maila. | |
| Parametry schematów wysyłki wiadomości | |||
cfg_senders | Określa konta nadawcy na liście dostępnych w formularzu "Wyślij list" programu obsługi wypożyczeń. Parametr to lista wartości: id_nadawcy|opis_dla_formularza|.... Np. ustawienie wartości |Wypożyczalnia Główna|F1|Wysyłka jako Filia nr 1| ustawi listę wyboru nadawcy w formularzu opcję "Wypożyczalnia Główna" (wysyłka przez nadawcę domyślnego) oraz "Wysyłka jako Filia nr 1" (wysyłka przez nadawcę o identyfikatorze F1). | ||
cfg_agenda_mail | Pozwala przypisać poszczególnym agendom konkretne konto nadawcy. Jest to lista wartości: nr_agendy|id_nadawcy|... Np. Ustawienie wartości:
oznacza, że agenda "00" ma przypisanego nadawcę domyślnego (puste id_nadawcy), zaś agenda "01" nadawcę zdefiniowanego parametrem CORE.MAIL.F1.SENDER | ||
core.agenda.#.notify | Gdzie # to numer agendy | Jeśli wartość jest ustawiona na "disabled", to blokuje to wysyłkę automatycznych powiadomień z wybranej agendy. Np. core.agenda.10.notify dla agendy 10 | |
| Parametry dotyczące nadawanych wiadomości | |||
cfg_monit_mail | Jeśli >0 oraz liczba dni przetrzymania dzieli się przez wartość parametr, to wysyłany jest monit mailem | ||
cfg_zam_mail | Jeśli n>0 wysyła mail n dni przed końcem zamówienia | ||
cfg_przypomnij | Jeśli n>0 wysyła mail n dni przed końcem wypożyczenia | ||
cfg_przypomnij_# | Gdzie # to numer agendy | j/w - dla konkretnej agendy (np. CFG_PRZYPOMNIJ_02 - dla agendy 02) | |
cfg_wyp_kara_monit | Prezentacja kary w mailowym monicie: N wyłącza prezentację | ||
Przykład konfiguracji
| Parametr | Wartość | Wyjaśnienia |
|---|---|---|
core.mail.default.sender | biblioteka@biblioteka.miasto.pl | Grupa parametrów dla nadawcy domyślnego. W miejscu # podajemy default. |
core.mail.default.name | Biblioteka Miejska im. X | |
core.mail.default.host | smtp.mail.com | |
core.mail.default.port | 587 | |
core.mail.default.crypt | TLS | |
core.mail.default.login | biblioteka | |
core.mail.default.password | xyzABC123 | |
core.mail.filia1.sender | filia1@biblioteka.miasto.pl | Grupa parametrów dla nadawcy wiadomości z wybranej filii. W miejscu Ważne: nie ma potrzeby ustawiania wartości w tej grupie, jeśli nie różnią się od wartości z grupy |
core.mail.filia1.name | Filia nr 1 Biblioteki Miejskiej im. X | |
core.mail.filia1.login | filia1 | |
core.mail.filia1.password | zyxCBA321 | |
cfg_agenda_mail | 00||01|filia1| | Definiuje schemat nadawania wiadomości. Dla agendy 00 będzie użyty nadawca domyślny (stąd pusta wartość), zaś dla agendy 01 nadawca o identyfikatorze filia1. |