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

• 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).

Changelog na Google Code

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

• Przeglądaj całą dokumentację na Google Code >>
  
  
• Szybki start >>
• Wspierane platformy i ich ograniczenia >>
• FAQ >>
• Zalążek (wiki) nowej, pełnej instrukcji obsługi >>
Stara, nieaktualna wersja pełnej instrukcji obsługi >>

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

• Do zrobienia (TODO) >>
• Zwracane ze skryptów kody wyjścia >>
• W przyszłości: opis ustalonych między skryptami interfejsów, szablonu kodowania(...)

Zobacz także (czyli konkurencja)

• Program "SMS" (napisany w C++) Mikołaja Rydzewskiego. Chyba najbardziej znany.

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:

• Adam Rojek
• Andrzej Kalemba
• Piotr Włodarczyk
• Rafał Matczak

Ostatnia modyfikacja strony: 15-06-2010, 13:37:54.

Sebastian Zagrodzki, Jacek Fiok
strona domowa maintainera >>