Różnice

Różnice między wybraną wersją a wersją aktualną.

--- lms-notify.php [2016/02/02 13:43] – chilek
+++ lms-notify.php [2017/12/04 22:32] (aktualna) – chilek
@@ Linia 2: / Linia 2: @@
 lms-notify.php umożliwia komunikację z klientami na wiele sposobów wyzwalaną różnymi zdarzeniami. Skrypt jest wielofunkcyjny - włączenie określonego zadania następuje poprzez określenie parametrem uruchomieniowym skryptu typów zadań. Do wysyłania poczty i sms-ów używane są standardowe mechanizmy dostępne w LMS.
-==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 i temacie wiadomości można używać następujących zmiennych:
   * %bankaccount - zostanie zastąpione numerem rachunku do przelewu
   * %b - saldo z zanegowanym 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-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, licząc od 1 poprzedzone 0, np. 02 (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)
   * %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
   * %pin - numer PIN klienta
@@ Linia 66: / Linia 69: @@
     * **sms** - powiadomienia sms-em,
     * **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 abonenckich.
+    * **block** - specjalny kanał powodujący zablokowanie komputerów, wyłączenie przy zobowiązaniach flagi "faktura" oraz zmianę statusu klienta na **windykacja**,
+    * **unblock** - specjalny kanał powodujący odblokowanie komputerów, włączenie przy zobowiązaniach flagi "faktura" oraz zmianę statusu klienta na **podłączony**.
   * **-t**, **--type**=typy_powiadomień_oddzielone_przecinkami      lista dostępnych typów powiadomień (domyślnie: **wszystkie typy**):
-    * **contracts** - powiadomienia o upływających terminach umów abonenckich,
+    * **documents** - powiadomienia o upływających terminach umów/aneksów abonenckich (liczone w oparciu o datę "do" obowiązywania dokumentu),
+    * **contracts** - powiadomienia o upływających terminach umów/aneksów abonenckich (liczone w oparciu o maksymalną datę obowiązywania "do" dla wszystkich zobowiązań klienta),
     * **debtors** - powiadomienia o zadłużeniu abonentów,
     * **reminder** - powiadomienia abonentów o nieopłaconych fakturach,
     * **invoices** - powiadomienia o wystawionych fakturach,
     * **notes** - powiadomienia o wystawionych notach odsetkowych,
-    * **warnings** - powiadomienia do abonentów, których komputery mają włączone ostrzeżenia,
+    * **warnings** - powiadomienia abonentów, których komputery mają włączone ostrzeżenia,
+    * **events** - powiadomienia abonentów i użytkowników o aktywnych zdarzeniach w terminarzu (temat i treść są kopiowane bezpośrednio ze zdarzenia),
     * **messages** - powiadomienia o wiadomościach nadanych do klientów (ma zastosowanie wyłącznie dla kanału **www**)
   * **-s**, **--section**=nazwa_sekcji_konfiguracyjnej    nazwa sekcji konfiguracyjnej LMS z której ładowane są ustawienia skryptu (najpierw pod uwagę brane są ustawienia przechowywane w bazie danych/interfejsie użytkownika LMS, zaś w drugiej kolejności z pliku lms.ini) - domyślnie: **notify**
@@ Linia 99: / Linia 105: @@
 ^Nazwa ^Opis ^Wartość domyślna ^Przykład^
 |mailfrom (wymagana dla kanału **mail**)|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=info@firma.pl|
-|mailfname|Nazwa nadawcy maila.|pusta|mailfname=Administratorzy|
+|mailfname (opcjonalny)|Nazwa nadawcy maila.|pusta|mailfname=Administratorzy|
-|smtp_host|Serwer SMTP, przez który ma zostać wysłana wiadomość.|pusty|smtp_host=smtp.firma.pl|
+|smtp_host (opcjonalny)|Serwer SMTP, przez który ma zostać wysłana wiadomość.|pusty|smtp_host=smtp.firma.pl|
-|smtp_port|Port serwera SMTP|pusty|smtp_port = 25|
+|smtp_port (opcjonalny)|Port serwera SMTP|pusty|smtp_port = 25|
-|smtp_auth|Sposób autoryzacji. Dozwolone wartości: LOGIN, PLAIN, CRAM-MD5, NTLM.|pusta|smtp_auth=PLAIN|
+|smtp_auth (opcjonalny)|Sposób autoryzacji. Dozwolone wartości: LOGIN, PLAIN, CRAM-MD5, NTLM.|pusta|smtp_auth=PLAIN|
-|smtp_user|Login do autoryzacji SMTP.|pusty|smtp_user=admin|
+|smtp_user (opcjonalny)|Login do autoryzacji SMTP.|pusty|smtp_user=admin|
-|smtp_pass|Hasło do konta zdefiniowanego w opcji smtp_user.|puste|smtp_pass=password|
+|smtp_pass (opcjonalny)|Hasło do konta zdefiniowanego w opcji smtp_user.|puste|smtp_pass=password|
 |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**.
+**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**.