Skrypty SMS
Opis i cechy programu (features)
- wysyłanie SMS-ów na wszystkie polskie sieci, z użyciem różnych bramek (nie tylko polskich operatorów) z poziomu command-line (shell, perl).
- Zwracanie kodu statusu (informacja o wyniku/błędach podczas wysyłania).
- Możliwość przesyłania treści dłuższych niż 160 znaków (wysyłanie w kilku kawałkach).
- możliwość instalacji skryptów globalnie na serwerze (dla wszystkich użytkowników, w hierarchii np. /usr/share) lub prywatnie ("per-użytkownik").
- możliwość uruchamiania programu - jako skryptów shellowych - na maszynach bez uprawnień do uruchamiania własnych programów (noexec), bez kompilatora (gcc).
- dobre przystosowanie do ustawienia powiadamiania SMS-em o przychodzącej poczie - zestaw narzędzi pomocniczych:
- powiadom - skrypt przetwarzający "goły" e-mail, formatujący SMS-a i delegujący go do odpowiedniej bramki; m.in. wbudowana możliwość przesyłania całej treści listu, jeśli temat zawiera jakieś słowo (domyślnie "ważne!"). Gotowe rozwiązanie do podstawienia do procmaila (.procmailrc), lub bezpośrednio do pliku naszego MTA, itd.,
- nopl - pozbawia listy "polskich literek" (zazwyczaj są problemy z ich przesyłaniem na komórkę),
- nc-emulator - skryptowy zamiennik wymaganego programu netcat (nc) do komunikacji po sieci.
- configure - autokonfigurator do powyższych programów (ustawia opcje wysyłania wiadomości z command-line; nie rusza zagadnień związanych z powiadamianiem).
- przygotowanie do tworzenia własnych "bramek" internetowych poprzez interfejs bramka-common.
- możliwość działania za firewallem, kiedy nie mamy dostępu do świata przez port http (80), a jedynie przez w3cache, lub w ogóle (w pierwszym przypadku wystarczy poprawka w używanych skryptach, w drugim potrzebna jest mała interwencja na firewallu).
Changelog (od 2008)
- 30.08.2008: migracja kodu i dokumentacji na Google Code: http://code.google.com/p/skrypty-sms/
Od teraz skrypty trzymane są w repozytorium SVN. Repozytorium ma dostęp publiczny ro, współpracownicy i ochotnicy mogą uzyskać rw na życzenie (mailowe).
- 30.08.2008: aktualizacja sms.eraomnix.pl (update po zmianach na stronie Ery) [thx: Paweł Dudziak]
- 08.04.2008: aktualizacja sms.miastoplusa.pl: nowe opcje wykorzystujące dodatkowe możliwości bramki (np. wyslanie o konkretnej godzinie, raport doreczenia) [thx: Rafał Matczak].
- 15.01.2008: aktualizacja sms.miastoplusa.pl: uaktualnione do strony po zmianach [thx: Mariusz Gruszka].
Pobieranie
Skrypty dostępne są poprzez repozytorium SVN:
svn checkout http://skrypty-sms.googlecode.com/svn/trunk/ skrypty-sms-read-only
Przeglądarka kodu na Google Code
W repozytorium zawsze powinna znajdować się stabilna, działająca wersja wszystkich skryptów.
Uznano, że w sytuacji, gdy głównie dokonywane zmiany polegają na aktualizacjach pojedynczych skryptów wybranych bramek - nie ma sensu wypuszczanie kolejnych wersji w sensie całościowych paczek.
Instrukcja obsługi, dokumentacja i gdzie zgłaszać problemy
Instrukcja obsługi
Pierwszym krokiem powinno być przeczytanie instrukcji szybkiego startu >>.
W wypadku kłopotów z uruchomieniem - przeczytaj jeszcze sekcję "najczęstsze pytania i odpowiedzi" (FAQ). Jeśli to nie pomaga, zadaj pytanie na liście mailingowej. Nie pisz jednak maili do autorów bezpośrednio - on już i tak dostaje dużo maili z pytaniami, a poza tym na liście być może ktoś odpowie szybciej i tak czy owak autor tę listę też czyta.
Z przykrością uprzedzamy, że z powodu braku czasu zapewne nie będziemy odpowiadać na pytania wskazujące na nieprzeczytanie instrukcji, lub ewidentną niechęć do spróbowania zrobienia czegokolwiek samemu - "jak postawić własną bramkę", "opowiedzieć prosto krok po kroku" itp.
Lista mailingowa
Lista dostępna jest pod adresem skryptysms-users (at) fiokware.com. Linki do przeglądarki archiwum i zapisania się - w ramce na górze strony.
Lista jest pierwszym i właściwym miejscem do napisania, jeżeli masz problem, znalazłeś błąd, masz pomysły na usprawnienia, lub chcesz pomóc. Nie pisz w tych sprawach maili bezpośrednio do autorów i współpracowników.
Dokumentacja
UWAGA! Niestety tekst pełnej instrukcji jest już mocno nieaktualny, np. za sprawą istnienia od jakiegoś czasu programu configure i powstania nowych bramek w Perlu. Niemniej jednak, w wielu przypadkach pełni on jeszcze swoją funkcję. Zwłaszcza: sekcja pytań i odpowiedzi (FAQ) oraz dla zainteresowanych skryptami bardziej "od środka" (tym polecam też obejrzenie źródeł; źródła nie są tragicznie skomplikowane).
Dla deweloperów
Zobacz także (czyli konkurencja)
Autorzy
Sebastian Zagrodzki (2000-2001), Jacek Fiok (2001-).
UWAGA! Brak rąk do pracy.
Z przyjemnością przekażemy opiekę nad projektem (poszczególnymi skryptami) ochotnikowi (ochotnikom).
Podziękowania:
Ostatnia modyfikacja strony: 30-08-2008, 17:09:49.
Sebastian Zagrodzki, Jacek Fiok
strona domowa maintainera >>
