|
Rozdział 4. Skrypty
Jeśli chcemy ustawić konfigurację któregoś ze skryptów, robimy to w odpowiedniej sekcji lms.ini. Same skrypty przenosimy do katalogu /usr/sbin. Po przeniesieniu musimy je jeszcze dopisać do crontaba tak, aby były uruchamiane automatycznie właśnie wtedy kiedy tego chcemy.
Pamiętaj że przeważnie będziesz chciał aby te skrypty były uruchamiane tylko raz w miesiącu (no chyba że chcesz naliczać użytkownikom opłaty kilka razy w miesiącu.)
Przykładowo, jeśli chcielibyśmy aby opłata abonamentowa była naliczana uzytkownikom 5 dnia każdego miesiąca o godzinie 1:20, przykładowy wpis w crontab powinien wyglądać tak:
20 1 5 * * /usr/sbin/lms-eachmonth |
Po więcej informacji możesz sięgnąć do man crontab
Szablony
lms-notify jest dobrym sposobem przypominania ludziom o tym że do pracy sieci i łącz konieczne są ich pieniążki. Pozwala on na napisanie kilku[-nastu] plików tekstowych [w iso-8859-2] i traktowania ich jako szablonów do mailingu.
W plikach można używać następujących zmiennych:
-
%date-m - zostanie zastąpione aktualnym miesiącem, licząc od 1 poprzedzone 0, np. 02
-
%date-y - zostanie zastąpione aktualnym rokiem, np 2003
-
%saldo - zostanie zastąpione aktualnym saldem użytkownika, np. 535
-
%abonament - zostanie zastąpione kwotą abonamentu jaka jest do danego użytkownika przypisana, np. 107
-
%b - saldo z zanegowanym znakiem, np. 107
-
%B - saldo z prawdziwym znakiem, np. -107
-
%last_10_in_a_table - wyciąg ostatnich 10 operacji kasowych na koncie użytkownika, np:
Przykładowy wyciąg 10 ostatnich operacji kasowych
Data | Opis | Wartość
-----------+------------------------------------------------------+---------
2003-02-02 | Abonament za miesiąc 2003/02 | 107.00
2003-02-01 | Wpłata | -107.00
2003-02-01 | Abonament za miesiąc 2003/02 | 107.00
2003-02-01 | Wpłata | -321.00
2003-01-31 | Abonament za miesiąc 2003/01 | 107.00
2003-01-31 | Abonament za miesiąc 2003/01 | 107.00
2003-01-31 | Abonament za miesiąc 2003/01 | 107.00
-----------+------------------------------------------------------+--------- |
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
bierzą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
Gerwazy Reguła
telefon: 0-509031337
email: gerwazy@staff.naszasiec.pl
Gwidon Mniejważny
telefon: 0-606666666
email: gwidonm@naszasiec.pl
ps. załączamy ostatnie 10 operacji jakie zostało zarejestrowane przez nasz
system bilingowy na Państwa koncie:
kwota operacji | typ operacji | data
%last_10_in_a_table
--
Amatorska Sieć Komputerowa NaszaSiec
http://www.naszasiec.pl/ |
Konfiguracja
Konfigurację dla lms-notify możemy ustalić w pliku lms.ini w sekcji [notify]. Możemy tam ustawić następujące parametry:
-
limit (opcjonalny)
Pozwala na ustalenie limitu bilansu poniżej którego do użytkownika zostanie wysłany email z upomnieniem. Domyślnie limit = 0
Przykład: limit = -20
-
mailsubject (wymagany)
Pozwala na ustalenie tematu emaila wysyłanego do użytkownika. Można używać podstawień znanych z szablonów (%B, %b, %date-y, %date-m, %last_10_in_a_table). Domyślnie nieustawione.
Przykład: mailsubject = Informacje o zaległościach w opłatach za internet
-
mailtemplate (wymagany)
Pozwala na wskazanie szablonu wiadomości która zostanie wysłana do użytkownika. Więcej o szablonach tutaj. Domyślnie nieustawione
Przykład: mailtemplate = /etc/lms/notifytemplate.txt
-
mailfrom
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. Domyślnie nieustawione
Przykład: mailfrom = staff@domain.pl
-
mailfname
Nazwa nadawcy maila
Przykład: mailfname = Administratorzy
-
smtp_server
Serwer SMTP przez który ma zostać wysłana wiadomość. Domyślnie: 127.0.0.1
Przykład: smtp_server = smtp.mydomain.pl
-
debug_email (opcjonalny)
Adres email do debugowania. Gdy ustawiony, cała poczta zostaje wysłana na dany email zamiast do użytkowników. Przydatne do debugowania i sprawdzania czy wszystko działa OK. Domyślnie nieustawiony.
Przykład: lexx@domain.pl
Skrypt pozwala na odłączenie (a raczej zmianę w bazie danych stanu komputerów na wyłączony) użytkowników których bilans jest poniżej zadanej wartości. Właściwe odłączanie powinno być realizowane przez generator plików konfiguracyjnych.
Konfigurację dla lms-cutoff możemy ustalić w pliku lms.ini w sekcji [cutoff]. Możemy tam ustawić następujące parametry:
Skrypt po uruchomieniu nalicza użytkownikom opłatę abonamentową. Aby działał poprawnie powinien być uruchamiany tylko raz w miesiącu (o ile użytkownicy wnoszą opłaty co miesiąc). Skrypt ten nie posiada żadnych opcji konfiguracyjnych.
|