TaskiSMS v2.5, dokumentacja programu


Wprowadzenie

TaskiSMS jest programem służącym do wysyłania krótkich wiadomości tekstowych do telefonów komórkowych, a także innych elektronicznych urządzeń. Program aby wysłać wiadomość używa internetowych bramek operatorów sieci telefonii komórkowej a także bramek udostępnianych przez dostawców innych cyfrowych usług (np. telewizja cyfrowa).



Wymagania

Aby uruchomić program TaskiSMS musimy spełnić następujące wymagania:

Sprzęt:

  • Amiga z Kickstartem 3.0+
  • około 1MB wolnej pamięci RAM

Oprogramowanie:

  • Magic User Interface (MUI) w wersji 3.8+. MUI jest shareware'owym pakietem autorstwa Stefana Stuntza. Pakiet można pobrać oraz zamówić na stronie http://www.sasg.com
Oraz dodatkowe klasy MUI:
  • A także połączenie z internetem za pośrednictwem pakietu kompatybilnego z bsdsocket.library (AmiTCP, Genesis, Miami)

Licencja i rejestracja

TaskiSMS w wersji 2.5 rozpowszechniany jest na zasadzie Shareware. Jeżeli używasz wersji zarejestrowanej, jesteś zobowiązany używać tylko jedną kopię programu na jednym komputerze. Nie dozwolone jest udostępnianie tej wersji programu poprzez sieć (np. pakiet samba/Microsoft Networks).

Jeżeli zechcesz odsprzedać swoją kopię programu komuś innemu, obie strony muszą się skontaktować z autorem programu, od którego zależy zgoda na taką operacje.

Jeżeli używasz niezarejestrowanej wersji programu, powyższe deklarecje cię nie obowiązują. Rozpowszechnianie niezarejestrowanej wersji programu jest dozwolone i nieodpłatne pod warunkiem, że kopia pozostanie w formie niezmienionej do wersji z AmiNETu. Niezarejestrowanej wersji programu możesz używać przez miesiąc od daty pierwszego uruchomienia programu, po tym terminie powinieneś program zarejestrować.

Jeżeli chcesz stać się posiadaczem w pełni wartościowej wersji programu musisz go zarejestrować. Dokonać tego można za pośrednictwem karty kredytowej, wpłacając pieniądze na konto autora lub przysyłając pieniądze w kopercie.

Koszt pełnej wersji programu to 10 USD lub 20DM, 10EURO, akceptuję także inne wymienialne waluty.

Rejestracja za pomocą karty kredytowej odbywa się za pośrednictwem bezpiecznego serwisu RegNet.

Jeżeli zechcesz zarejestrować program przesyłając pieniądze w kopercie, wyślij je na adres:


Pawel Filipczak
ul. Herbsta 18/25
76-200 Slupsk
Poland

Jeżeli zechcesz zarejestrować program wpłacając na konto, wpłacaj na:

Bank Pekao SA II Oddziaî Sîupsk
Daniel Filipczak
12401835-00230117-2700-211112-001-0000

Aby zarejestrowac program potrzebne mi są następujące dane: imię i nazwisko, adres e-mail, kraj (jeżeli chesz możesz podać także adres zamieszkania i telefon). Dane te zostaną zapisane w mojej bazie użytkowników programu i nie będą udostępniane osobom trzecim. Możliwy jest także wgląd do tej bazy i dokonanie korekt dotyczącej własnej osoby.

Pełna wersja programu zostanie wysłana poprzez e-mail.

Polacy mogą nabyć program za 20zł. Płatności można dokonać przelewem na konto, przekazem pocztowym lub wysyłając pieniądze w kopercie.

Ograniczenia wersji demo:

  • długość SMS'a ograniczona do około 130 znaków, pełna wersja długie wiadomości dzieli na części po 160 znaków.
  • brak sortowania listy z SMS'ami a także w książce telefonicznej.
  • brak opcji pozwalającej na wyłączenie reklam.
  • brak możliwości dodawania własnych teczek.
  • okno "O programie" pokazujące się przy starcie programu.

Zarejestrowani użytkownicy mają dodatkowo możliwość:

  • otrzymania na rządanie beta wersji programu.
  • rządania napisania pluginu dedykowanego spejalnie dla ich operatora sieci komórkowej.

Instalacja

Aby zainstalować program TaskiSMS należy kliknąć na ikonie instalacji. Następnie należy postępować zgodnie z zaleceniami programu instalacyjnego.

Podziękowania

Specjalne podziekowania dla:
  • Sebastiana Jędruszkiewicza (elf) - za wielką pomoc w przyswajaniu tajników C, wielką cierpliwość przy testowaniu programu, wytrwałość przy resetowaniu Amigi, dyspozycyjność ;)
  • Grzegorza Kraszewskiego (Krashan) - za pomoc w przesiadce na C i testy (zwłaszcza za dwa stracone impulsy;)
  • Bartosza Romańczuka (VanS) - za pomoc przy testowaniu programu.
  • Mariusza Danilewicza (mANDI) - za przetłumaczenie dokumentacji na angielski
  • Daniela Filipczaka (Muffin) - za utrzymywanie firowego serwera w należytym stanie
  • Manou Billa - za ikonkę programu
  • a także dla innych o których zapomniałem

Kontakt z autorem

Najprostszym sposobem na kontakt ze mną jest e-mail. Listy w języku angielskim lub polskim wysyłaj pod adres: paplo@taski.com.pl. Miło by było gdybyś na początku tematu umieścił słowo TASKISMS.

Możesz także pisać normalne listy i wysyłać je za pośrednictwem standardowej poczty, oto mój adres:


Pawel Filipczak
ul. Herbsta 18/25
76-200 Slupsk
Poland

Możesz także próbować skontaktować się ze mną poprzez IRC. Znaleźć mnie można co dzień po 21-ej (CET) na kanale #amisia w sieci IRCNet. Mój nick to PaploTSI.

Główne okno

Oto główne okno programu TaskiSMS, znajdują się w nim dwie bardzo ważne listy, pasek narzędzi a także reklama, na którą należy klikać.

Wspomniane dwie listy odgrywają wielką rolę w obsłudze programu. Lista po lewej stronie okna (oznaczona jako 2) przedstawia nam spis dostępnych tzw. teczek, w których przechowywane będą wiadomości, które napiszesz i wyślesz. Jak widzisz na obrazku, standartowo dostępne są trzy teczki. W teczce "Do wysłania" program będzie przechowywał wiadomości, które mają zostać wysłane a także takie, które z różnych powodów nie mogły być wysłane wcześniej. W teczce "Wysłane" program przechowuje wiadomości, które zostały z powodzeniem wysłane. Teczka "Skasowane" służy do przechowywania wiadomości, które nie są nam już potrzebne i zaśmiecają inne teczki.

Lista po prawej stronie okna (na rysunku oznaczona jako 1) służy do wyświetlania zawartości teczki wskazanej w liście po lewej stronie okna. Lista ta podzielona jest na 4 kolumny, symbolizujące odpowiednio: odbiorcę wiadomości wraz z numerem telefonu, skróconą treść wiadomości, datę napisania wiadomości oraz nazwę pliku pod jaką kryje się wiadomość.

Pomiędzy dwoma listami znajduje się niewielki pionowy pasek. Służy on do zmiany szerokości teczek względem siebie. Program przy wyjściu zapiszę sobie ustawioną szerokość list aby przy następnym uruchomieniu programu nie trzeba było dokonywać odpowiedniej korekty.

Jak wspomniałem, na dole ekranu znajdują się reklamy. Kliknięcie na obrazek reklamy (na rysunku oznaczony jako 4) spowoduje uruchomienie przeglądarki WWW i wczytanie adresu kryjącego się pod obrazkiem. Staram się aby reklamy przedstawiały strony jak najbardziej związane z Amigą. Jeżeli jesteś zainteresowany reklamą swojej strony w TaskiSMS, skontaktuj się ze mną w celu uzgodnienia warunków.

Na górze okna znajduje się pasek narzędzi (oznaczony numerem 3). To dzięki niemu będziemy mogli napisać i wysłać wiadomość a także zrobić wiele innych rzeczy. Oto opis funkcji guzików, zaczynając od lewej:

  • Nowa - powoduje otworzenie okna edytora, który pozwoli nam napisać i wysłać nową wiadomość.
  • Edycja - powoduje otworzenie się okna edytora, który pozwoli nam zmodyfikować zaznaczoną wiadomość z teczki "Do wysłania".
  • Przenieś - guzik ten uaktywnia funkcję przenoszenia wiadomości pomiędzy folderami. Aby przenieść wiadomość (lub więcej) do innego folderu należy zaznaczyć tę wiadomość w liście wiadomości, a następnie przycisnąć guzik "Przenieś". Otworzy się okno, widoczne na ilustracji obok, w którym należy dwa razy kliknąć na nazwie teczki do której chcemy przenieść wiadomość. Aby zrezygnować z przenoszenia wiadomości należy po prostu zamknąć okno.
  • Wyślij - kliknięcie na ten guzik spowoduje wysłanie wszystkich wiadomości znajdujących się w teczce "Do wysłania". Wiadomości, które zostaną poprawnie wysłane automatycznie zostaną przeniesione do teczki Wysłane.
  • Skasuj - funkcja ta spowoduje przeniesienie wszystkich zaznaczonych wiadomości do teczki "Skasowane". Jeżeli funkcji tej poddane zostaną wiadomości znajdujące się już w teczce "Skasowane", zostaną one usunięte z teczki oraz dysku.
  • Telefony - pod tym guzikiem ukryta jest książka telefoniczna.
  • Ustawienia - powoduje otworzenie okna ustawień programu.

Menu głównego okna

W menu "Projekt" mamy do wyboru trzy pozycje:

  • "O programie..." spowoduje wyświetlenie okna informującego o programie.
  • "O MUI..." wyświetli okno informujące o autorze pakietu MUI.
  • "Skończ" spowoduje wyjście z programu bez wcześniejszego uprzedzenia.

W menu "Teczki" mamy do wyboru pięć pozycji, oto ich opis:

  • "Dodaj teczkę..." spowoduje dodanie nowej teczki do listy teczek. Zanim to nastąpi zostanie wyświetlone nowe okno z zapytaniem o nazwę nowej teczki oraz o nazwę katalogu dla tej teczki (nie należy podawać pełnej ścieżki dostępu a jedynie nazwę katalogu).
  • "Edycja teczki..." wyświetli okno w którym należy podać nową nazwę dla teczki. Po zaakceptowaniu zmian nazwa katalogu oraz zawartość teczki pozostanie bez zmian. Funkjca ta nie działa na trzech standardowych teczkach.
  • "Usuń teczkę..." spowoduje usunięcie wskazanej teczki. Po zaakceptowaniu wraz z teczką zostaną usunięte wszystkie wiadomości się w niej znajdujące. Funkcja ta nie działa na trzech standardowych teczkach.
  • "Odśwież zawartość teczki" spowoduje wygenerowanie nowego indeksu dla wskazanej teczki. Opcja przydatna jest gdy poprzednim razem zawiesił się komputer i indeks nie został poprawnie wygenerowany.
  • "Wyczyść teczkę "Skasowane"..." spowoduje usunięcie wszystkich wiadomości znajdujących się w teczce "Skasowane".

W menu "Ustawienia" mamy do wyboru dwie pozycje, oto ich opis:

Okno edytora

Tak wygląda okno edytora wiadomości. To w tym oknie będziemy pisać nowe wiadomości oraz dokonywać modyfikacji starych wiadomości zapisanych w teczce "Do wysłania".

Najważniejszym polem w oknie edytora jest oczywiście edytor. Na obrazku zaznaczony on został numerem 1. W tym polu wpisywać bedziemy treść wiadomości, która potem wyślemy. W dobrym tonie jest nie używanie znaków narodowych, gdyż nie wszystkie telefony komórkowe sobie z tym problemem poradzą, ponadto nie powinno się wysyłać wiadomości dłuższych niż 1000 znaków. O długości wpisywanej wiadomości na bieżąco informuje nas okienko oznaczone numerem 6.

Na górze okna znajduje się szereg przydatnych guzików. Najważniejszym jest pole tekstowe oznaczone numerem 4. To tutaj należy wpisywać numer telefonu osoby, do której mamy zamiar wysłać wiadomość. Ważne jest aby pamiętać aby numer podany został w formacie międzynarodowym. Format ten wygląda następująco: +xxyyyzzzzzz, gdzie xx to kod kraju, w którym mieszka nasz odbiorca, yyy to kod operatora telefonii komórkowej, a zzzzzz to numer telefonu. Dla przykładu aby wysłać wiadomość do Polski, do abonenta sieci PlusGSM, należy wpisać: +48601 a potem numer do konkretnej osoby.

Kolejnym elementem ważnym w obsłudze programu jest guzik oznaczony numerem 10. To za pomocą niego otworzymy okno książki telefonicznej, za pomocą której będziemy mogli wskazać zapisany wcześniej numer telefonu.

Pod guzikiem oznaczonym numerem 11 kryje się lista dostępnych pluginów. To dzięki nim nasza wiadomość zostanie wysłana do odbiorcy. Po kliknięciu na guzik 11 oczom naszym ukaże się lista pluginów, które potrafią wysłać wiadomość pod wpisany numer telefonu. Który plugin wybrać polecam sprawdzić metodą prób i błędów. W okienku tekstowym oznaczonym numerem 5 program informuje nas o nazwie aktualnie wskazanego pluginu, a także ilości dostępnych pluginów dla danego numeru telefonu.

Pole tekstowe oznaczone numerem 7 informuje nas o nazwisku osoby, której numer wpisaliśmy. Nazwisko to wyświetli się jedynie wtedy gdy dana osoba i jej numer został wpisany do książki telefonicznej.

Pole tekstowe oznaczone numerem 2 informuje nas o kraju, do którego należy wpisany numer telefonu. Jeżeli klikniesz na guziku oznaczonym numerem 8, otworzy się lista dostępnych krajów. Lista krajów podzielona została na dwie kolumny, pierwsza to nazwa kraju, a druga to numer kierunkowy do danego kraju. Jeżeli dwa razy klikniesz (lub naciśniesz enter) na nazwie danego kraju, numer kierunkowy dla tego kraju zostanie wstawiony w pole oznaczone numerem 4.

Pole tekstowe oznaczone numerem 3 informuje nas o nazwie operatora, do którego należy wpisany numer telefonu. Jeżeli klikniesz na guzik oznaczony numerem 9, otworzy się lista dostępnych operatorów dla danego kraju. Zawartość tej list będzie się zmieniała w zależności od wskazanego kraju. Jeżeli klikniesz dwa razy na nazwie operatora, w pole o numerze 4 zostanie wstawiony numer kierunkowy do kraju a także numer operatora.

Pozostały nam jeszcze 3 guziki na dole okna. Kliknięcie na guzik "Wyślij teraz" spowoduje zapisanie wiadomości do teczki "Do wysłania" a także automatyczne uruchomienie procesu jej wysyłania. Jeżeli wiadomość zostanie wysłana z powodzeniem, zostanie przeniesiona do teczki "Wysłane".
Kliknięcie na guzik "Wyślij później" spowoduje zapisanie wiadomości do teczki "Do wysłania" a następnie zamknięcie okna edytora. Tak zapisaną wiadomość możemy później wysłać (wraz z innymi zapisanymi w teczce "Do wysłania") klikając na guzik "Wyślij" w głównym oknie programu.
Kliknięcie na guzik "Poniechaj" spowoduje zamknięcie okna edytora i utratę wpisanej wiadomości.

Menu okna edytora

W menu "Wiadomość" mamy do wyboru trzy pozycje:

  • "Wyczyść" spowoduje wyczyszczenie zawartości edytora.
  • "Wczytaj z pliku..." spowoduje otworzenie okna wyboru pliku. Zawartość pliku zostanie wczytana do okna edytora.
  • "Wstaw z pliku..." spowoduje otworzenie okna wyboru pliku. Zawartość pliku zostanie wstawiona w miejsce pozycji kursora w edytorze. Poprzedna zawartość nie zostanie wyczyszczona.
W menu "Edycja" mamy do wyboru siedem pozycji:
  • "Wytnij" spowoduje wycięcie zaznaczonego obszaru tekstu i skopiowanie go do schowka systemowego.
  • "Skopiuj" spowoduje skopiowanie zaznaczonego obszaru tekstu do schowka systemowego.
  • "Wstaw" spowoduje wklejenie zawartości schowka systemowego do edytora w pozycji kursora.
  • "Confij" spowoduje cofnięcie ostatnich zmian w edytorze.
  • "Ponów" spowoduje działanie odwrotne do "Cofnij".
  • "Zamień znaki na małe" spowoduje zamianę wszystkich małych znaków na wielkie w zaznaczonym obszarze tekstu.
  • "Zamień znaki na duże" spowoduje zamianę wszystkich wielkich znaków na małe w zaznaczonym obszarze tekstu.

Okno książki telefonicznej

Tak prezentuje się okno książki telefonicznej. Aby dokonać pierwszego wpisu do tej książki należy kliknąć na guzik "Dodaj". W liście oznaczonej numerem 3 pojawiła się nowa pozycja. Następnie w polu oznaczonym numerem 1 należy wpisać nazwisko osoby, a w polu numer 2 jej numer telefonu. Oczywiście numer musi być podany w formacie międzynarodowym.
Aby usunąć wpis z książki telefonicznej należy wskazać na liście (nr 3) wybraną pozycję a następnie nacisnąć guzik "Usuń".
Jeżeli dwa razy klikniemy na wybranej pozycji z listy, program wstawi numer telefonu wybranej osoby w pole oznaczone numerem 4 w oknie edytora.

Okno ustawień programu

Tak wygląda zakładka "Osobiste" okna ustawień programu. W polu oznaczonym numerem 1 powinniśmy wpisać nasze imię i nazwisko. W polu nr 2 należy wpisać własny adres e-mail. W polu oznaczonym numerem 3 należy wpisać podpis, który ewentualnie będzie dołączany do każdej napisanej wiadomości. Podpis powinien wyglądać np. tak: "SMS od: Janka, ". Guzik oznaczony numerem 4 powinien być wciśnięty, jeżeli chcemy aby podpis był dołączany do wiadomości lub wyłączony jeżeli tego nie chcemy.

A tak wygląda zakładka "Sieć" okna ustawień. Na razie dostępne są jedynie ustawienia dotyczące serwera pośredniczącego. W polu nr 5 należy wpisać adres serwera, bez http://. W polu nr 6 należy wpisać port pod którym znajduje się usługa proxy na serwerze. Wciśnięcie przycisku oznaczonego numerem 7 spowoduje, że program każde następne połączenie będzie realizował za pośrednictwem serwera proxy.