lms-notify.php
Różnice
Różnice między wybraną wersją a wersją aktualną.
Nowa wersja | Poprzednia wersja | ||
lms-notify.php [2016/02/02 13:10] – utworzono chilek | lms-notify.php [2017/12/04 22:32] (aktualna) – chilek | ||
---|---|---|---|
Linia 1: | Linia 1: | ||
- | ===4.3.1. lms-notify=== | + | ===4.3.1. lms-notify.php=== |
- | lms-notify.php | + | lms-notify.php |
- | ==4.3.1.1. Treści wiadomości == | + | ==4.3.1.1. Treść i temat wiadomości == |
- | W treści wiadomości można używać następujących zmiennych: | + | W treści |
* %bankaccount - zostanie zastąpione numerem rachunku do przelewu | * %bankaccount - zostanie zastąpione numerem rachunku do przelewu | ||
* %b - saldo z zanegowanym znakiem, np. 107 | * %b - saldo z zanegowanym znakiem, np. 107 | ||
* %B - saldo z prawdziwym znakiem, np. -107 | * %B - saldo z prawdziwym znakiem, np. -107 | ||
+ | * %totalb - podobnie jak %b z uwzględnieniem wszystkich należności | ||
+ | * %totalB - podobnie jak %B z uwzględnieniem wszystkich należności | ||
* %date-y - zostanie zastąpione aktualnym rokiem, np. 2003 | * %date-y - zostanie zastąpione aktualnym rokiem, np. 2003 | ||
* %date-m - zostanie zastąpione aktualnym miesiącem, licząc od 1 poprzedzone 0, np. 02 | * %date-m - zostanie zastąpione aktualnym miesiącem, licząc od 1 poprzedzone 0, np. 02 | ||
Linia 15: | Linia 17: | ||
* %deadline-d - zostanie zastąpione numerem dnia w którym przypada termin płatności, | * %deadline-d - zostanie zastąpione numerem dnia w którym przypada termin płatności, | ||
* %saldo - zostanie zastąpione aktualnym saldem klienta, np. 535 | * %saldo - zostanie zastąpione aktualnym saldem klienta, np. 535 | ||
+ | * %totalsaldo - podobnie jak %saldo z uwzględnieniem wszystkich należności | ||
* %abonament - zostanie zastąpione kwotą abonamentu jaka jest do danego klienta przypisana, np. 107 | * %abonament - zostanie zastąpione kwotą abonamentu jaka jest do danego klienta przypisana, np. 107 | ||
* %pin - numer PIN klienta | * %pin - numer PIN klienta | ||
Linia 66: | Linia 69: | ||
* **sms** - powiadomienia sms-em, | * **sms** - powiadomienia sms-em, | ||
* **www** - powiadomienia przez przeglądarkę www (skrypt jest w stanie generować listy reguł zawierające adresy IP), | * **www** - powiadomienia przez przeglądarkę www (skrypt jest w stanie generować listy reguł zawierające adresy IP), | ||
- | * **blocking** - specjalny kanał powodujący zablokowanie komputerów | + | * **block** - specjalny kanał powodujący zablokowanie komputerów, wyłączenie przy zobowiązaniach flagi " |
+ | * **unblock** - specjalny kanał powodujący odblokowanie komputerów, | ||
* **-t**, **--type**=typy_powiadomień_oddzielone_przecinkami | * **-t**, **--type**=typy_powiadomień_oddzielone_przecinkami | ||
- | * **contracts** - powiadomienia o upływających terminach umów abonenckich, | + | |
+ | | ||
* **debtors** - powiadomienia o zadłużeniu abonentów, | * **debtors** - powiadomienia o zadłużeniu abonentów, | ||
* **reminder** - powiadomienia abonentów o nieopłaconych fakturach, | * **reminder** - powiadomienia abonentów o nieopłaconych fakturach, | ||
* **invoices** - powiadomienia o wystawionych fakturach, | * **invoices** - powiadomienia o wystawionych fakturach, | ||
* **notes** - powiadomienia o wystawionych notach odsetkowych, | * **notes** - powiadomienia o wystawionych notach odsetkowych, | ||
- | * **warnings** - powiadomienia | + | * **warnings** - powiadomienia abonentów, których komputery mają włączone ostrzeżenia, |
- | * **messages** - powiadomienia o wiadomościach nadanych do klientów | + | * **events** - powiadomienia abonentów i użytkowników o aktywnych zdarzeniach w terminarzu (temat i treść są kopiowane bezpośrednio ze zdarzenia), |
- | * **-s**, **--section**=nazwa_sekcji_konfiguracyjnej | + | * **messages** - powiadomienia o wiadomościach nadanych do klientów |
+ | * **-s**, **--section**=nazwa_sekcji_konfiguracyjnej | ||
- | ==4.3.1.2. Konfiguracja== | + | ==4.3.1.3. Konfiguracja== |
- | Konfigurację | + | Konfigurację |
+ | Wszystkie ustawienia składają się z dwóch członów oddzielonych znakiem podkreślenia (" | ||
+ | * nazwy typu powiadomienia, | ||
+ | * ustawienia. | ||
+ | Przykład: ustawienie wiadomości używanej przy powiadomieniach o wystawieniu faktur będzie miało postać **invoices_message**. | ||
+ | |||
+ | Poniżej opisano obsługiwane ustawienia w postaci drugiego członu nazwy ustawienia). | ||
^Nazwa ^Opis ^Wartość domyślna ^Przykład^ | ^Nazwa ^Opis ^Wartość domyślna ^Przykład^ | ||
- | |debtors_template (opcjonalny)|Lokalizacja pliku z szablonem wiadomości wysyłanej do zadłużonych klientów. Pozostawienie tej opcji pustej wyłączy powiadomienia | + | |limit|Limit salda klienta wyzwalający powiadomienia|0|debtors_limit=-50| |
- | |debtors_subject (opcjonalny)|Temat wiadomości | + | |message|Treść |
- | |invoices_template (opcjonalny)|Lokalizacja pliku z szablonem | + | |subject|Temat wiadomości z powiadomieniem|... notification|reminder_subject=to jest temat listu| |
- | |invoices_subject (opcjonalny)|Temat wiadomości o nowej fakturze.|'New invoice notification' | + | |days|Liczba dni wyzwalająca powiadomienia, |
- | |notes_template (opcjonalny)|Lokalizacja | + | |file|Nazwa pliku do której zapisywane |
- | |notes_subject (opcjonalny)|Temat wiadomości o nowej nocie obciążeniowej.|'New debit note notification' | + | |header|Wiersz nagłówka |
- | |deadline_template (opcjonalny)|Lokalizacja | + | |rule|Reguła z adresem IP - symbol specjalny %i za który podstawiany jest adres IP komputera klienckiego |
- | |deadline_subject | + | |footer|(ma zastosowanie dla kanału powiadomień **www**)|pusty|messages_footer=ipset swap messages_tmp messages\nipset destroy messages_tmp\n| |
- | |limit (opcjonalny)|Pozwala na ustalenie limitu bilansu poniżej którego do klienta zostanie wysłana wiadomość z informacją o zadłużeniu.|0|limit = -20| | + | |
- | + | ||
- | Poniżej przedstawiono opcje dotyczące wyłącznie wiadomości e-mail. | + | |
+ | Poniżej przedstawiono ustawienia niezależne od typu powiadomienia. | ||
^Nazwa ^Opis ^Wartość domyślna ^Przykład^ | ^Nazwa ^Opis ^Wartość domyślna ^Przykład^ | ||
- | |mailfrom (wymagana)|Adres e-mail z którego zostanie wysłany e-mail. Proszę pamiętać, że na niektórych MTA (np. exim) konto to musi istnieć w systemie.|pusta|mailfrom = staff@domain.pl| | + | |mailfrom (wymagana |
- | |mailfname|Nazwa nadawcy maila.|pusta|mailfname = Administratorzy| | + | |mailfname |
- | |smtp_host|Serwer SMTP, przez który ma zostać wysłana wiadomość.|localhost|smtp_host = smtp.mydomain.pl| | + | |smtp_host |
- | |smtp_auth|Sposób autoryzacji. Dozwolone wartości: LOGIN, PLAIN, CRAM-MD5, NTLM.|pusta | + | |smtp_port (opcjonalny)|Port serwera SMTP|pusty|smtp_port = 25| |
- | |smtp_user|Login do autoryzacji SMTP.|pusty|smtp_user = admin| | + | |smtp_auth |
- | |smtp_pass|Hasło do konta zdefiniowanego w opcji smtp_user.|puste|smtp_pass = password| | + | |smtp_user |
- | |debug_email (opcjonalny)|Adres e-mail do debugowania. Gdy ustawiony, cała poczta zostaje wysłana na dany email zamiast do klientów. Przydatne do debugowania i sprawdzania czy wszystko działa OK.|nie ustawiony|debug_email = lexx@domain.pl| | + | |smtp_pass |
+ | |debug_email (opcjonalny)|Adres e-mail do debugowania. Gdy ustawiony, cała poczta zostaje wysłana na dany email zamiast do klientów. Przydatne do debugowania i sprawdzania czy wszystko działa OK.|nie ustawiony|debug_email=user@firma.pl| | ||
+ | |service (opcjonalny)|Nazwa backendu sms, który ma być używany do wysyłki sms-ów|pusty|service=smstools| | ||
+ | |debug_phone (opcjonalny)|Numer telefonu na który mają być wysyłane wszystkie sms-y (zamiast do klientów)|pusty|debug_phone=666666666| | ||
+ | |||
+ | **Uwaga!** Brak ustawień **smtp_...** powoduje użycie ustawień z sekcji konfiguracyjnej **mail**.\\ Brak ustawienia **service** powoduje wysyłkę sms-ów w oparciu o domyślny backend sms-owy określony w sekcji konfiguracyjnej **sms**. | ||
lms-notify.php.1454415017.txt.gz · ostatnio zmienione: 2016/02/02 13:10 przez chilek