Narzędzia użytkownika

Narzędzia witryny


lms-notify.php

To jest stara wersja strony!


4.3.1. lms-notify

lms-notify.php jest dobrym sposobem przypominania ludziom o tym że do pracy sieci i łącz konieczne są ich pieniążki. Pozwala on na skonfigurowanie kilku[-nastu] sposobów komunikacji z klientem. 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

W treści 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
  • %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_month_name - zostanie zastąpione nazwą bieżącego miesiąca, np. marzec
  • %deadline-y - zostanie zastąpione numerem roku w którym przypada termin płatności, np. 2003 (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)
  • %deadline-m - zostanie zastąpione numerem miesiąca 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)
  • %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
  • %abonament - zostanie zastąpione kwotą abonamentu jaka jest do danego klienta przypisana, np. 107
  • %pin - numer PIN klienta
  • %cid - ID klienta
  • %number - numer dokumentu (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)
  • %invoice - numer dokumentu (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)
  • %value - wartość brutto na fakturze (tylko w powiadomieniu o fakturze)
  • %lastday - ostatni dzień bieżącego miesiąca, licząc od 1 poprzedzone 0, np. 31
  • %cdate-y - zostanie zastąpione rokiem w którym wystawiono dokument (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)
  • %cdate-m - zostanie zastąpione miesiącem w którym wystawiono dokument (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)
  • %cdate_d - zostanie zastąpione dniem w którym wystawiono dokument (tylko w powiadomieniu o fakturze lub nocie obciążeniowej)

Przykład 4-2. Lms-notify.php: Przykład szablonu

UWAGA! Ta wiadomość została wygenerowana automatycznie.

Uprzejmie informujemy iż na Pani/Pana koncie figuruje zaległość w opłatach za
internet w wysokości %B zł.

Jeżeli porozumieli się już Państwo z administratorami w kwestii opłaty za
bieżący miesiąc czyli %date-m %date-y roku, prosimy o
zignorowanie tej wiadomości.

W wypadku gdy uważają Państwo iż zaległość ta jest nieporozumieniem prosimy o
jak najszybszy kontakt.

Wszelkie informacje na temat Państwa rozliczeń mogą Państwo znaleźć pod
adresem http://www.naszasiec.pl/mojekonto/

Jeżeli chcieliby Państwo uregulować zaległości prosimy o kontakt:

Dział Rozliczeń ASK NaszaSiec

Gwidon Mniejważny
telefon: 0-606666666
e-mail: gwidonm@naszasiec.pl

--
Amatorska Sieć Komputerowa NaszaSiec
http://www.naszasiec.pl/
4.3.1.2. Parametry uruchomieniowe skryptu

Poniżej parametry uruchomieniowe charakterystyczne dla skryptu lms-notify.php:

  • -d, –debug wiadomości nie są wysyłane do odbiorców; pozwala na proste debugowanie skryptu.
  • -f, –fakedate=YYYY/MM/DD skrypt zakłada, że wskazana data jest datą bieżącą
  • -c, –channel=kanały_komunikacyjne_powiadomień lista oddzielonych przecinkami kanałów komunikacyjnych z listy poniżej (domyślnie: mail):
    • mail - powiadomienia mailem,
    • 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.
  • -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,
    • 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,
    • messages - powiadomienia o wiadomościach nadanych do klientów
  • -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)
4.3.1.2. Konfiguracja

Konfigurację konta SMTP oraz backendu SMS określamy standardowymi sekcjami konfiguracyjnymi LMS, tj. odpowiednio mail i sms.

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 o zadłużeniu.pustedebtors_template = /etc/lms/debtors.txt
debtors_subject (opcjonalny)Temat wiadomości o zadłużeniu.'Debtors notification'debtors_subject = 'Powiadomienie o zadłużeniu'
invoices_template (opcjonalny)Lokalizacja pliku z szablonem wiadomości z informacją o wystawieniu faktury. Pod uwagę brane są faktury wystawione w ciągu ostatnich 24 godzin od uruchomienia skryptu. Pozostawienie tej opcji pustej wyłączy powiadomienia o nowych fakturach.pusteinvoices_template = /etc/lms/new_invoice.txt
invoices_subject (opcjonalny)Temat wiadomości o nowej fakturze.'New invoice notification'invoices_subject = 'Powiadomienie o wystawieniu faktury'
notes_template (opcjonalny)Lokalizacja pliku z szablonem wiadomości z informacją o wystawieniu noty obciążeniowej. Pod uwagę brane są noty wystawione w ciągu ostatnich 24 godzin od uruchomienia skryptu. Pozostawienie tej opcji pustej wyłączy powiadomienia o nowych notach.pustanotes_template = /etc/lms/new_note.txt
notes_subject (opcjonalny)Temat wiadomości o nowej nocie obciążeniowej.'New debit note notification'notes_subject = 'Powiadomienie o wystawieniu noty obciążeniowej'
deadline_template (opcjonalny)Lokalizacja pliku z szablonem wiadomości wysyłanej do zadłużonych klientów, posiadających przeterminowane (nierozliczone) faktury. Pozostawienie tej opcji pustej wyłączy powiadomienia.pustadeadline_template = /etc/lms/deadline.txt
deadline_subject (opcjonalny)Temat wiadomości o przeterminowanych fakturach.'Invoice deadline notification'deadline_subject = 'Powiadomienie o zaległości'
limit (opcjonalny)Pozwala na ustalenie limitu bilansu poniżej którego do klienta zostanie wysłana wiadomość z informacją o zadłużeniu.0limit = -20

Poniżej przedstawiono opcje dotyczące wyłącznie wiadomości e-mail.

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.pustamailfrom = staff@domain.pl
mailfnameNazwa nadawcy maila.pustamailfname = Administratorzy
smtp_hostSerwer SMTP, przez który ma zostać wysłana wiadomość.localhostsmtp_host = smtp.mydomain.pl
smtp_authSposób autoryzacji. Dozwolone wartości: LOGIN, PLAIN, CRAM-MD5, NTLM.pusta (brak autoryzacji)smtp_auth = LOGIN
smtp_userLogin do autoryzacji SMTP.pustysmtp_user = admin
smtp_passHasło do konta zdefiniowanego w opcji smtp_user.pustesmtp_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 ustawionydebug_email = lexx@domain.pl
lms-notify.php.1454415083.txt.gz · ostatnio zmienione: 2016/02/02 13:11 przez chilek