LMS 1.0

Strona domowa

<< Poprzednia

Następna >>

Zawartość

Przedmowa

Rozdział 1 - Na początek
Czym jest LMS
Co LMS może a czego nie
Co wchodzi w skład LMS
Instalacja
Konfiguracja
Pierwsze logowanie
Prawa dostępu
Rozdział 2 - LMS UI (User Interface)
Konfiguracja
Rozdział 3 - LMS-MGC
Rozdział 4 - Skrypty
Instalacja
lms-notify
lms-cutoff
lms-eachmonth

Rozdział 4. Skrypty

Instalacja

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

lms-notify

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

lms-cutoff

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:

  • limit (opcjonalny)

    Pozwala na ustalenie limitu bilansu poniżej którego do bazy danych zostanie zapisany stan odłączony. Domyślnie limit = 0

    Przykład:

    limit = -20

lms-eachmonth

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.

<< Poprzednia

© 2001-2003 LMS Developers

Następna >>

LMS 1.0