Różnice

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

--- skrypty [2012/04/23 17:06] – [4.2. Lista dostępnych skryptów] ceho
+++ skrypty [2012/12/05 11:08] – [4.2. Lista dostępnych skryptów] dodanie odnosnikow do opisow skryptow ceho
@@ Linia 5: / Linia 5: @@
 0 * * *       /usr/sbin/lms-payments 1 > /dev/null
 </code>
-Po więcej informacji możesz sięgnąć do man crontab
+Po więcej informacji możesz sięgnąć do **man crontab**
 Większość lms'owych skryptów posiada dodatkowe opcje uruchomieniowe:
 <code>
@@ Linia 17: / Linia 18: @@
 ^Nazwa  ^ Opis ^
-|lms-notify               |Powiadamianie klientów pocztą internetową o zaległościach, wystawionych fakturach, przekroczeniu terminu płatności|
+|[[lms-notify]]               |Powiadamianie klientów pocztą internetową o zaległościach, wystawionych fakturach, przekroczeniu terminu płatności|
-|lms-notify-sms           |Odpowiednik lms-notify do wysyłania smsów|
+|[[lms-notify-sms]]           |Odpowiednik lms-notify do wysyłania smsów|
-|lms-notify-messages      |Odpowiednik lms-notify do ustawiania powiadomień http|
+|[[lms-notify-messages]]      |Odpowiednik lms-notify do ustawiania powiadomień http|
-|lms-cutoff               |Odłączanie klientów zadłużonych|
+|[[lms-cutoff]]               |Odłączanie klientów zadłużonych|
-|lms-etherdesc            |Generowanie pliku dla iptraf zawierającego pary MAC adres - nazwa hosta|
+|[[lms-etherdesc]]            |Generowanie pliku dla iptraf zawierającego pary MAC adres - nazwa hosta|
-|lms-payments             |Naliczanie opłat okresowych (abonamentowych) z fakturowaniem|
+|[[lms-payments]]             |Naliczanie opłat okresowych (abonamentowych) z fakturowaniem|
-|lms-traffic              |Zapis statystyk wykorzystania łącza|
+|[[lms-traffic]]              |Zapis statystyk wykorzystania łącza|
-|lms-traffic-logiptables  |Statystyki łącza dla iptables|
+|[[lms-traffic-logiptables]]  |Statystyki łącza dla iptables|
 |lms-makearp              |Tworzenie tablicy ARP (/etc/ethers)|
-|lms-makedhcpconf         |Konfiguracja serwera DHCP (dhcpd.conf)|
+|[[lms-makedhcpconf]]         |Konfiguracja serwera DHCP (dhcpd.conf)|
-|lms-makeiptables         |Konfiguracja firewalla iptables|
+|[[lms-makeiptables]]         |Konfiguracja firewalla iptables|
 |lms-makeipchains         |Konfiguracja firewalla ipchains|
 |lms-makeopenbsdpf        |Konfiguracja firewalla dla systemu OpenBSD|
 |lms-makeoidentconf       |Konfiguracja oident|
-|lms-sendinvoices         |Wysyłanie faktur do klientów|
+|[[lms-sendinvoices]]         |Wysyłanie faktur do klientów|
-|lms-makemacs             |Filtrowanie ruchu na bazie adresów źródłowych MAC|
+|[[lms-makemacs]]             |Filtrowanie ruchu na bazie adresów źródłowych MAC|
-|lms-makehosts            |Generuje plik /etc/hosts|
+|[[lms-makehosts]]            |Generuje plik /etc/hosts|
-|lms-makewarnings         |Generuje regułki przekierowujące ruch klientów zadłużonych|
+|[[lms-makewarnings]]         |Generuje regułki przekierowujące ruch klientów zadłużonych|
-|lms-makemessages         |Generuje regułki przekierowujące ruch klientów, którym ustawiono wiadomość administracyjną|
+|[[lms-makemessages]]         |Generuje regułki przekierowujące ruch klientów, którym ustawiono wiadomość administracyjną|
-|lms-fping                |Badanie aktywności komputerów|
+|[[lms-fping]]                |Badanie aktywności komputerów|
-|lms-reminder             |Przypominanie o zaplanowanych zadaniach z Terminarza|
+|[[lms-reminder]]             |Przypominanie o zaplanowanych zadaniach z Terminarza|
-|lms-rtparser             |Backend do Helpdesk'a|
+|[[lms-rtparser]]             |Backend do Helpdesk'a|
-|lms-teryt                |Import bazy TERYT|
+|[[lms-teryt]]                |Import bazy TERYT|
 ====4.3. Opis i konfiguracja====
@@ Linia 114: / Linia 115: @@
 Konfigurację dla lms-notify można ustalić w pliku lms.ini w sekcji [notify]. Możesz tam ustawić następujące parametry, które mają zastosowanie również dla skryptów lms-notify-sms i lms-notify-messages:
-  * debtors_template (opcjonalny)
+^Nazwa ^Opis ^Wartość domyślna ^Przykład^
-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. Domyślnie: pusta
+|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.|puste|debtors_template = /etc/lms/debtors.txt|
-Przykład: debtors_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.|puste|invoices_template = /etc/lms/new_invoice.txt|
-  * debtors_subject (opcjonalny)
+|invoices_subject (opcjonalny)|Temat wiadomości o nowej fakturze.|'New invoice notification'|invoices_subject = 'Powiadomienie o wystawieniu faktury'|
-Temat wiadomości o zadłużeniu. Domyślnie: 'Debtors notification'
+|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.|pusta|notes_template = /etc/lms/new_note.txt|
-Przykład: debtors_subject = 'Powiadomienie o zadłużeniu'
+|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.|pusta|deadline_template = /etc/lms/deadline.txt|
-  * invoices_template (opcjonalny)
+|deadline_subject (opcjonalny)|Temat wiadomości o przeterminowanych fakturach.|'Invoice deadline notification'|deadline_subject = 'Powiadomienie o zaległości'|
-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. Domyślnie: pusta
+|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|
-Przykład: invoices_template = /etc/lms/new_invoice.txt
-  * invoices_subject (opcjonalny)
-Temat wiadomości o nowej fakturze. Domyślnie: 'New invoice notification'
-Przykład: 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. Domyślnie: pusta
-Przykład: notes_template = /etc/lms/new_note.txt
-  * notes_subject (opcjonalny)
-Temat wiadomości o nowej nocie obciążeniowej. Domyślnie: 'New debit note notification'
-Przykład: 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. Domyślnie: pusta
-Przykład: deadline_template = /etc/lms/deadline.txt
-  * deadline_subject (opcjonalny)
-Temat wiadomości o przeterminowanych fakturach. Domyślnie: 'Invoice deadline notification'
-Przykład: 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. Domyślnie: 0
-Przykład: limit = -20
 Poniżej przedstawiono opcje dotyczące wyłącznie wiadomości e-mail.
-  * mailfrom (wymagana)
+^Nazwa ^Opis ^Wartość domyślna ^Przykład^
-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: pusta.
+|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|
-Przykład: mailfrom = staff@domain.pl
+|mailfname|Nazwa nadawcy maila.|pusta|mailfname = Administratorzy|
+|smtp_host|Serwer SMTP, przez który ma zostać wysłana wiadomość.|localhost|smtp_host = smtp.mydomain.pl|
-  * mailfname
+|smtp_auth|Sposób autoryzacji. Dozwolone wartości: LOGIN, PLAIN, CRAM-MD5, NTLM.|pusta (brak autoryzacji)|smtp_auth = LOGIN|
-Nazwa nadawcy maila. Domyślnie: pusta.
+|smtp_user|Login do autoryzacji SMTP.|pusty|smtp_user = admin|
-Przykład: mailfname = Administratorzy
+|smtp_pass|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 = lexx@domain.pl|
-  * smtp_host
-Serwer SMTP, przez który ma zostać wysłana wiadomość. Domyślnie: localhost
-Przykład: smtp_host = smtp.mydomain.pl
-  * smtp_auth
-Sposób autoryzacji. Dozwolone wartości: LOGIN, PLAIN, CRAM-MD5, NTLM. Domyślnie: pusta (brak autoryzacji)
-Przykład: smtp_auth = LOGIN
-  * smtp_user
-Login do autoryzacji SMTP. Domyślnie: pusty
-Przykład: smtp_user = admin
-  * smtp_pass
-Hasło do konta zdefiniowanego w opcji smtp_user. Domyślnie: puste
-Przykład: 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. Domyślnie: nie ustawiony.
-Przykład: debug_email = lexx@domain.pl
 ===4.3.2. lms-notify-sms===
@@ Linia 185: / Linia 142: @@
 Konfigurację dla lms-notify-sms można ustalić w pliku lms.ini w sekcji [notify-sms], oprócz opcji dostępnych w lms-notify masz do dyspozycji następujące opcje:
-  * service (opcjonalny)
+^Nazwa ^Opis ^Wartość domyślna ^Przykład^
-Pozwala na wybranie usługi SMS niezależnie od tej, którą podano w sekcji [sms]. Domyślnie: pusta
+|service (opcjonalny)|Pozwala na wybranie usługi SMS niezależnie od tej, którą podano w sekcji [sms].|pusta|service = smstools|
-Przykład: service = smstools
 ===4.3.3. lms-notify-messages===
@@ Linia 199: / Linia 155: @@
 Konfigurację dla lms-cutoff możemy ustalić w pliku lms.ini w sekcji [cutoff]. Możemy tam ustawić następujące parametry:
-  * limit (opcjonalny)
+^Nazwa ^Opis ^Wartość domyślna ^Przykład^
-Pozwala na ustalenie limitu bilansu poniżej którego do bazy danych zostanie zapisany stan odłączony. Domyślnie: 0
+|limit (opcjonalny)|Pozwala na ustalenie limitu bilansu poniżej którego do bazy danych zostanie zapisany stan odłączony.|0|limit = -20|
-Przykład: limit = -20
+|message (optional)|Jeśli nie jest pusta, wiadomość ta po dołączeniu użytkownika zostanie zapisana do jego rekordu w polu wiadomości administracyjnej. W treści wiadomości można użyć zmiennej %now, która zostanie zamieniona na bieżącą datę oraz zmiennych %b i %B tak jak w skrypcie lms-notify.|'Automatic cutoff caused by exceeding of liabilities limit on %now'|message = ' '|
-  * message (optional)
-Jeśli nie jest pusta, wiadomość ta po dołączeniu użytkownika zostanie zapisana do jego rekordu w polu wiadomości administracyjnej. W treści wiadomości można użyć zmiennej %now, która zostanie zamieniona na bieżącą datę oraz zmiennych %b i %B tak jak w skrypcie lms-notify. Domyślnie: 'Automatic cutoff caused by exceeding of liabilities limit on %now'
-Przykład: message = ' '
 ===4.3.5. lms-payments===
@@ Linia 212: / Linia 164: @@
 Skrypt ten udostępnia trzy opcje do fakturowania, które można ustawić w sekcji [payments] pliku lms.ini:
-  * deadline (opcjonalny)
+^Nazwa ^Opis ^Wartość domyślna ^Przykład^
-Pozwala na ustalenie terminu płatności w dniach. Domyślnie: 14
+|deadline (opcjonalny)|Pozwala na ustalenie terminu płatności w dniach.|14|deadline = 7|
-Przykład: deadline = 7
+|paytype (opcjonalny)|Identyfikator rodzaju płatności (1-gotówka, 2-przelew, 3-przelew/gotówka, 4-karta, 5-kompensata, 6-barter, 7-umowa).|2 (przelew)|paytype = 1|
-  * paytype (opcjonalny)
+comment (opcjonalny) - Opis pozycji na fakturze za naliczane zobowiązanie.|'Tariff %tariff subscription for period %period'|Przykład: comment = 'Abonament za %current_month w/g taryfy %tariff'
-Identyfikator rodzaju płatności (1-gotówka, 2-przelew, 3-przelew/gotówka, 4-karta, 5-kompensata, 6-barter, 7-umowa). Domyślnie: 2 (przelew)
+Niektóre ze słów kluczowych są zastępowane:  * %tariff - nazwa taryfy
-Przykład: paytype = 1
-  * comment (opcjonalny)
-Opis pozycji na fakturze za naliczane zobowiązanie
-Domyślnie: 'Tariff %tariff subscription for period %period'
-Niektóre ze słów kluczowych są zastępowane:
-%tariff - nazwa taryfy
 %period - okres (liczony od dziś do ostatniego dnia cyklu rozliczeniowego, w formacie RRRR/MM/DD)
 %current_month - okres od pierwszego dnia bieżącego miesiąca do jego końca
@@ Linia 230: / Linia 175: @@
 %next_period - następny miesiąc w formacie MM/RRRR
 %desc - opis taryfy
-Przykład: comment = 'Abonament za %current_month w/g taryfy %tariff'
   * settlement_comment (opcjonalny)