VI. Tworzenie wtyczek i dodatków
Tworzenie dodatków
kIEview
kDuoView
TłoK
kNotify
Emotikony
Bramki SMS
Dźwięki
"Złożony" w jedną całość template DIV okna rozmowy w kIEview znajdziemy pod adresem .
Wtyczka kIEview właśnie w taki sposób interpretuje klasy, którym nadajemy wygląd wizualny w arkuszach CSS.
.send .header .nick, .recv .header .nick /*klasy*/
{
font: bold 11px "Trebuchet MS";
display: block;
clear: none;
float: left;
border-left: 1px solid #A7A7A7;
color: #4C4952;
padding-left: 8px;
line-height: 18px;
}
Przykład budowy w CSS - niewielki fragment kodu
Więcej informacji na forum:
- kDuoView:
Szkielet wtyczki kDuoView udostępnia więcej zmiennych oraz jest bardziej elastyczny, niż w przypadku kIEview. Pełna lista zmiennych/klas została przedstawiona w wątku na forum -
Wtyczka interpretuje nasze własne klasy, utworzone przez nas. Muszą być one jednak uporządkowane wg szablonu w pliku *.ini. Mimo to, można zauważyć spore podobieństwo z wtyczką kIEview.
Szablon *.ini:
[main] - informacje o stylu
- name= nazwa stylu (opcjonalne)
- author= autor stylu (opcjonalne)
- version= wersja stylu (opcjonalne)
- date= data utworzenia stylu (opcjonalne)
- head= nagłówek! (WYMAGANE)
- preview= nazwa pliku z podglądem (opcjonalne)
- additional_info= informacje dodatkowe, adres www, komentarz (opcjonalne)
[MT_MESSAGE] - zwykła wiadomość
- send= pierwsza wiadomość wysłana w grupie
- recv= pierwsza wiadomość otrzymana w grupie
- sendnext= kolejne wiadomość wysłana
- recvnext= kolejna wiadomość otrzymana (tak samo jak w kIEView)
- sendend= dodawane za ostatnia wiadomością z grupy wysyłania
- recvend= dodawane za ostatnia wiadomością z grupy odbierania
[MT_QUICKEVENT]
- quick= powiadomienie o błędzie, nie wysłaniu wiadomości, odebraniu pliku itp.
[MT_CNTEVENT]
- cnt= powiadomienie o zmianie statusu kontaktu
[MT_FILE]
- sendfile= plik wysłany
- recvfile= plik otrzymany (tylko historia)
[MT_SMS]
[actions]
- onclear= dodawane po wyczyszczeniu okna
[send_control] - styl kontrolki wysyłania (opcjonalne)
- style= "Tahoma;238;-12;;0x0080FF;0x000000;" - ten format jest konieczny
Odpowiada za czcionkę w kontrolce (polu) wysyłania - typ, wielkosc, kolory (w BGR!)
[frames] - ramki (gdy styl posiada ramki - opcjonalne)
- talk_index= indeks ramki, w której wyświetlana jest rozmowa
- frame0.htm= to co zostanie dodane na początku pliku frame0.htm, będącego jedną z ramek
- frame1.htm= itd...
- frame1.htm= itd...
.quick //klasy utworzone przez nas
{
margin-top: 5px;
width: 100%;
background-color: #F0F6FF;
border-top: 1px;
border-left: 0px;
border-right: 0px;
border-bottom: 1px;
border-style: dotted;
border-color: #6F7073;
}
.qtime
{
width: 40px;
text-align: left;
vertical-align: top;
margin-left: 10px;
font-family: "Segoe UI", "Trebuchet MS", sans-serif;
font-size: 10px;
color: #707071;
}
.qbody
{
margin-right: 10px;
font-family: "Segoe UI", "Trebuchet MS", sans-serif;
font-size: 12px;
color: #000000;
}
Następnie implementujemy klasy w pliku INI:
[MT_QUICKEVENT]
quick="<div align="center"><table class="quick"><tr><td class="qtime">%time%</td><td class="qbody"><B>Komunikat:</B> %body%</td></tr></table></div>"
W ten sposób uzyskaliśmy powiadomienie QUICKEVENT w stylu Essic:
Przydatne odnośniki:
- TłoK
Wymagania:
- Tła mogą być wykonane w formatach .jpg, .png oraz .gif
- W przypadku portu tła, nie można łamać praw autorskich - podaj autora, źródło.
- Tło musi być estetyczne - zaleca się użycie takich programów jak Photoshop, GIMP czy Paint Shop Pro.
- Nie ma podanych wymiarów - ustala je sam autor.
- Gotowe tła publikujemy na forum - koniecznie przeczytaj temat
Przydatne odnośniki:
- Powiadomienia nad zasobnikiem systemowym (tray)
- k.Notify
Bardzo pomocny może się okazać poniższy obrazek, ukazuje on konstrukcję interpretacji poleceń wtyczkę kNotify.
Szablon deklaracji w pliku tekstowym (.ini lub .txt)
[margins]
left=22 -lewy margines
top=12 -górny
right=22 -prawy
bottom=22 -dolny
[sizing]
left=65
top=26
right=65
bottom=36
type=tile -powielanie
[background]
transparent=true -włączamy przezroczystość
mask=alpha -maską przezroczystości jest kanał alpha w
obrazku png
file=konnekt.png -plik tła
[font]
face=Tahoma -czcionka do wyświetlania informacji
size=8 -rozmiar czcionki
color=404040 -kolor czcionki
bold=off -pogrubienie
style=shadow -styl czcionki
shadow=EEEEEE -kolor cienia
align=left -wyrównanie tekstu
line=5 -przerwa między linijkami
[icon]
display=left -z której strony ma pojawić się ikonka
space=12 -odstęp
Przydatne odnośniki:
Istnieją dwie wtyczki do zaawansowanej obsługi okna rozmowy - kIEview oraz kDuoView. Jednak ich deklaracje emotikon różnią się regułami, związku z czym buźki pod kIEview nie są kompatybilne z kDuoView (i na odwrót).
- Tworzenie zestawów emotikon dla kIEview:
Reguły podstawowe:
"kod_emotikony","plik" //dla jednej deklaracji
"<papa>","papa.gif"
("kod_1","kod_2","kod_3"),"plik" //dla kilku deklaracji dla
jednego pliku
("<papa>","<zegnaj>","<bye-bye>"),"papa.gif"
"kod_emotikony","plik","plik_nieanim" //jeśli emotikona jest
animowana lub bardzo duża, bardzo wskazane jest dorobienie
wersji mniejszej/nieanimowanej
*"kod_emotikony","plik" //emotikona nie zostanie wyświetlona
w menu emotikon (dzięki znakowi *)
Ponadto wtyczka obsługuje wyrażenia regularne - w praktyce oznacza to, że emotikona :)))) = :) czy :-) = :) itp.
Wyrażenia regularne zostały przedstawione w wątku na forum - .
Przydatne odnośniki:
- Tworzenie zestawów emotikon dla kDuoView:
Dla każdej emotikony przysługują 3 linijki:
- NET - wartość NET sieci
- Kod Emotikony - <papa>
- Plik - papa.gif
Przykład:
Wartości NET:
- -1 - wszystkie sieci
- 10 - Gadu-Gadu
- 11 - ICQ
- 12 - Jabber
- 15 - LAN
- 60 - AIM
- 61 - Yahoo
- 62 - MSN
- 63 - Tlen
- 1313 - AQQ
Wartości NET można również podejrzeć odpalając Konnekt'a z parametrem -debug --> Konnekt --> Dev/DEBUG --> @DEV --> INFO.
kDuoView nie obsługuje wyrażeń regularnych!
Przydatne odnośniki:
- Bramki SMS są pisane w języku skryptowym LUA. Jego składnia jest podobna do tej znanej z Pascala, charakteryzuje się wydajnością i przenośnością kodu.
Każda bramka składa się z 3 części: definicji w języku XML, skryptu w języku LUA i plików dodatkowych jak logo (.ico).
Dokumentacja skryptów bramek sms znajduje się w katalogu domowym Konnekt'a --> Konnekt\doc\sms_bramki.html. Tamtejszy poradnik uwzględnia najnowszą wersję 1.7.
Wersja online poradnika znajduje się pod adresem - należy jednak pamiętać, że nie uwzględniono w niej zmian po wersji 1.7.
Przydatne odnośniki:
- kSound
Dźwięki możemy "obrabiać" w edytorze audio, np. Audacity czy GoldWave. Powinny być one krótkie i nadawać się do użytku ;-).
W folderze z dźwiękami powinien znaleźć się plik *.xml (z informacjami o autorze, komentarzem) oraz przede wszystkim - szablonem dźwięków.
Szablon pliku XML:
<?xml version="1.0" encoding="Windows-1250"?>
<sound>
<name> Nazwa zestawu </name>
<author> Autor </author>
<url> Strona www </url>
<comment> Krótki komentarz </comment>
<events>
<msgSent> plik.wav </msgSent>
//wiadomość wysłana
<newMsg> plik.wav </newMsg>
//wiadomość - zamknięte okno
<newMsgAct> plik.wav </newMsgAct>
//wiadomość - aktywne okno
<newMsgInact> plik.wav </newMsgInact>
//wiadomość - nieaktywne okno
<newUser> plik.wav </newUser>
//ktoś jest dostępny
<newServerEvent> plik.wav </newServerEvent>
//wiadomość od serwera
<quickEvent> plik.wav </quickEvent>
//zdarzenie
<fileReceived> plik.wav </fileReceived>
//odebranie pliku
<fileFinished> plik.wav </fileFinished>
//zakończono przesyłanie
</events>
</sound>
