# Instrukcja obsługi

### Ustawienia programu

Możemy skonfigurować program Kadu według własnych potrzeb wybierając polecenie Konfiguracja z menu Kadu.
Poszczególne zakładki umożliwiają kolejne opcje

### Ogólne

W zakładce tej ustawiamy. Dane użytkownika tzn. powinny być tam już wpisane ale istnieje możliwość ich zmiany. W Opcje SMS konfigurujemy program do wysyłania sms. W tym celu zaznaczamy Użyj wbudowanej aplikacji SMS.

Zaznaczenie pola Automatyczny status "zaraz wracam"" powoduje ze nasz status zmienia się automatycznie po podanej liczbie sekund kiedy Kadu pozostaje bezczynne.

Opcja Status Domyślny ustawia status jaki ma być podczas uruchomienia programu Kadu.

Opcja Włącz dymki w zasobniku systemowym powoduje ukazywanie się "dymka" z informacjami np.: o błedach (gdy zaznaczymy tą opcję), o nadejściu wiadomosci lub statusach osób z listy kontaktów. wiadomości.

Zaznaczenie opcji Przechowuj wiadomości spowoduje zapis rozmów i sms-ów do historii.

Zaznaczenie opcji Tylko dla znajomych spowoduje że będziemy widoczni w statusach "Dostępny" "Zaraz wracam" tylko dla kontaktów znajdujących się na naszej liście kontaktów.

Opcja Sprawdź wersję uruchamia sprawdzanie w momencie startu Kadu czy są dostępne uaktualnienia. Jeżeli na serwerze kadu.net pojawi się nowa wersja zostanie wyświetlony stosowny komunikat

Opcja Przywróć kształt okna zachowuje rozmiary okien przez nas ustalone.

Opcja Uruchom zminimalizowany powoduje start Kadu zminimalizowane do dockpanel.

Opcja Dodaj do opisu Pozwala na wykorzystanie plugina Xmms do dodawania tytułów utworów do informacji w statusie. W celu jej użycia zaznaczamy znacznik przy opcji i w Xmms włączasz plugin songchange. W jego konfiguracji wpisujemy jako command kod:

            echo "%s" > ~/.gg/description

i teraz jeśli masz w Kadu ustawiony status opisowy, to będzie podciągał tytuł piosenki i doklejał do twojego opisu.
XMMS w tej funkcji ma mały błąd, a mianowicie jeżeli zostanie zamknięty przed zamknięciem Kadu to w opisie pozostaje nam "%s", który musimy sami skasować. Napisalismy króciutki skrypt naprawiający ten błąd. Aby z niego skorzystać należy utworzyć plik tekstowy, najlepiej w katalogu /.gg W naszym przykładzie nosi on nazwę xmms_korekta. Nadajemu mu atrybut wykonywalności i w treści wklejamy co nastepuje:

    #!/bin/bash
    if [ "$1" == "%s" ]; then
    echo "" > ~/.gg/description
    else
    echo " Słucham: $1" > ~/.gg/description
    fi

Słowo "Słucham" można zastąpic każdym innym byle przed nim była spacja, aby tekst się niesklejał . Wówczas wywołanie w programie xmms będzie wyglądało nastepująco:

    ~/.gg/xmms_korekta "%s"

Ikonka w panelu Odznaczenie tej opcji spowoduje start Kadu bez ikony w dockpanelu. Przydatne gdy używasz Kadu w innym menadżerze okien niż KDE.

Z powrotem do spisu treści

### Dźwięki

W tym oknie ustawiamy następujące parametry:

- Odgrywanie sygnałów dźwiękowych

- Konfiguracje programu odgrywającego dźwięki

- Regulację głośności

- Sygnalizację dźwiękową nadejścia wiadomości

- Sygnalizację o dostępności kontaktu

Istnieje możliwość przypisania różnych dźwięków do różnych kontaktów. Aby to osiągnąć należy przedewszystkim mieć pliki dźwiękowe o nazwie zawierajacej nr UIN kontaktu np.:

    dostępny-123456.wav

Następnie w konfiguracji podajemy ścieżkę do pliku stosując następującą składnię (tu analogicznie do naszego przykładu):

    /usr/share/apps/kadu/themes/sounds/dostępny-%u.wav

%u symbolizuje zmienną nr UIN dla kontaktu dlatego gdy takie zjawisko zaistniej że będzie odgrywany dźwięk dostępności kontaktu o nr UIN #123456 zostanie odegrany plik dostępny-123456.wav

Z powrotem do spisu treści

### Rozmowa

W oknie tym ustawiamy:

- Włączenie obsługi emotikonów - "Brak", "Statyczne", "Animowane".

- Dostępny zestaw emotikonów.

- Usuwanie treści wiadomości w trakcie rozmowy.

- Szyfrowanie - zaznaczenie tej opcji powoduje uaktywnienie możliwości użycia i wygenerowania swojego klucza publicznego, według którego będą szyfrowane wiadomości. Długość klucza, jeżeli jest aktywna, ustawiamy na 1024 gdyż pozostałe nie są obsługiwane przez protokół. Możliwość zmiany wielkości klucza zostanie wkrótce usunięta.

- Przesuwaj historię rozmowy w dół.

- Klawisz "Enter" domyślnie wysyła wiadomość.

- Potwierdzenie dostarczenia wiadomości. Zaznaczenie tej opcji powoduje ze tekst wiadomości w oknie Chat nie jest przenoszony do górnego okna dopóki nie nadejdzie potwierdzenie ze wiadomość dotarła do adresata.

- Mrugający tytuł okna rozmowy gdy przyjdzie nowa wiadomość. Opcja ta powoduje mruganie tytułu okna chat oraz ikony w dockpanelu gdy przyjdzie nowa wiadomość a okno rozmowy nie jest aktywne.

- Ignoruj wiadomości od nieznajomych - zaznaczenie tej opcji spowoduje ignorowanie wiadomości, które przyjdą od osób których nie masz na liście kontaktów.

- Informacja o nowej wiadomości w dymku - zaznaczenie tej opcji spowoduje wyświetlanie informacji o nadejściu nowej wiadomości w dymku (hincie), który będzie się ukazywał nad zasobnikiem systemowym.

Z powrotem do spisu treści

### Powiadom

W oknie Powiadom ustawiamy czy program ma powiadamiać o dostępności gdy osobie z listy kontaktów zmieni się status na dostępny i w jaki sposób ma to być sygnalizowane dźwiękiem czy oknem dialogowym. Wybieramy również o których kontaktach mamy być powiadamiani.

Z powrotem do spisu treści

### Sieć

W oknie tym mamy możliwość włączenia połączeń bezpośrednich (DCC), skonfigurowania połączenia z siecią gdy np. komputer jest w sieci i dostęp do internetu ma przez serwer proxy. Tutaj też decydujemy czy Kadu ma się łączyć z domyślnym serwerem Gadu-Gadu czy z serwerem lub serwerami, których IP podamy w okienku Adresy IP
W przypadku gdy wybierzemy opcje własnych adresów IP będziemy mogli również zadecydować na jakim porcie ma się odbyć połączenie. Do wyboru mamy dwie opcje port: 8074 i 443
Gdy wybierzemy domyślne serwery to Kadu połączy się z hubem GG i samo przydzieli port

Dla tych, którzy łączą się z internetem poprzez serwer proxy, istotne będzie wypełnienie pól konfigurujących to połączenie. Ta część kodu nie jest jeszcze w pełni skończona jeśli chodzi o autoryzację na serwerze. Jak tylko Libgadu będzie wstanie to obsłużyć opcja ta będzie wykorzystywana.

Z powrotem do spisu treści

### Wygląd

Okno to służy do zmiany kolorów naszego Kadu w oknach Chat (kolor tła użytkownika, kontaktu oraz kolory, typ i rozmiar czcionki) i Listy kontaktów (kolor tła oraz kolor, typ i rozmiar czcionki).

W cześci tej można zadeklarować zawartość panela informacyjnego oraz tytułów okien "rozmowa" lub "konferencja"
Wstawiając odpowiednie symbole zmiennych (info jakie pojawia sie w dymku gdy przytrzymamy kursor myszy nad danym polem) zadeklarujemy jakie informacje mają się nam pokazywać w panelu lub w tytułach okien. Obowiazują tu zasady jak w html czyli można używać znaczników. Poszczególne zmienne można zamykać w bloki za pomoca nawiasów kwadratowych, wówczas tekst dołączony do zmiennej wyświetli się tylko wtedy gdy taka zmienna będzie miała wartość.

    Lista występujących zmiennych:
    	  %s -> status
    	  %d -> opis
    	  %i -> nr IP
    	  %n -> nick
    	  %a -> pole wyświetl z informacji o kontakcie
    	  %f -> imię
    	  %r -> nazwisko
    	  %m -> nr telefonu
    	  %u -> nr gg
    	  %g -> grupa do jakiej należy kontakt
    	  %o -> jeżli kontakt nie ma cię zapisanego na liście kontaktów zostanie zwrócona spacja
    	  %v -> DNS-owe nazwy serwerów
    	  %p -> port

Nie wypełnienie tych pól spowoduje użycie ustawień domyślnych
A to przykładowe zastosowanie zmienych
kod:

    	  <table width=210 cellpadding=0 cellspacing=0 border=0><tr><td rowspan=3
    	  valign=middle width=50><img src=/home/.gg/user.png width=50 height=50>
    	  </td><td align=right width=125>[ID::%u]</td></tr><tr><td align=right width=125>
    	  <font color=yellow>[IP::%i][:%p]</font> </td></tr><tr><td align=right width=125>
    	  <font color=orange>[TEL::+48:%m]</font></td></tr></table>[<hr><b>%f %r</b>]
    	  [<hr><font color=yellow><i>%v</i></font>][<hr><font color=orange>%d</font>]

I efekt wizualny:

Panel informacyjny - zaznaczenie spowoduje uaktywnienie panela informacyjnego

Zakładki grup - zaznaczenie powoduje wyświetlenie się w liscie kontaktów dodatkowych zakładek z nazwami grup kontaków.

Wielokolumnowa lista kontaktów - zaznaczenie powoduje, że gdy rozciągniemy listę kontaktów na boki i gdy tylko będzie na tyle szeroka, lista wyświetli się wielokolumnowo

Z powrotem do spisu treści

### Historia

Okno konfiguracji historii rozmów.
Mamy tu możliwość ustawienia czy chcemy aby w nowootwartym oknie rozmowy były cytowane fragmenty rozmów wcześniejszych, ilość fraz z poprzedniej rozmowu i zakres czasu do którego maja być wyswietlane z dokładnościa do 1 godziny.

Z powrotem do spisu treści

### Inne

Opcjonalne ustawienie wyskakujacych okien. Zaznaczenie tej opcji powoduje natychmiastowe wyświetlenie okna z wiadomością gdy tylko nadejdzie, pod warunkiem że już wcześniej nie jest ono otwarte.
Konfiguracja dostepu do bramki sms sieci ERA GSM. Wymagana jest wcześniejsza rejestracja na stronie ERY

Z powrotem do spisu treści

### Skróty klawiszowe

Tutaj konfigurujemy skróty klawiszowe.

Z powrotem do spisu treści