Tutorial für Samurize-Anzeige von Miranda

Einleitung

Da ich es schon lange versprochen habe, ein Tutorial für das Mirandaplugin für Samurize zu machen, habe ich es nun endlich geschafft. Ich hoffe es lichtet etwas die doch recht unübersichtlich aussehende Readme. Vorab: Ich werde nicht auf jede Funktion des Plugins eingehen, denn das Plugin ist sehr umfangreich und einige Optionen habe ich nicht ausprobiert, da ich sie nicht brauche. Auch mir wirds schon bei einem Blick in die Readme ganz duselig.

Was brauchen wir

Samurize, Miranda und natürlich das Plugin SamMiranda (was ihr aber mit Sicherheit schon habt, wenn ihr diese Zeilen lest) und ein wenig solltet ihr euch mit Samurize auch schon auskennen.

Einbau

Die sammiranda.zip beinhaltet vier Ordner. Ich schreibe auch gleich dazu, wo die Inhalte hingehören, sowie eine kleine Erläuterung:

wohin mit den Dateien?

• Miranda\Plugins: MirandaRPC.dll - Dies ist das Plugin für Miranda. Es kommt wie ihr seht nach ...\Miranda\Plugins
• Samurize\Configs: miranda.ini - Eine Beispielconfig, die in den Configs-Ordner von Samurize kommt.
• Samurize\Plugins: Miranda.dll - Das ist das Plugin, was für Samurize am wichtigsten ist, denn dieses werden wir nachher im Editor aufrufen und verwenden. Kommt in ...\Samurize\Plugins rein
• Die Miranda.txt ist die Readme (in Englisch)
• Mit der Miranda_example.ini kann ich nichts anfangen. Wenn ich das richtig verstehe, trägt man da Daten ein, wenn es darum geht, dass Samurize und Miranda auf verschiedenen Rechnern laufen. Keine Ahnung. Hier ist Eigeninitiative angesagt.
• mextcontrol: mextcontrol.exe - Diese mextcontrol.exe kann hingelegt werden, wo man will. Ich habe sie direkt im Samurizeverzeichnis abgelegt, da finde ich, liegt sie am besten. Dies ist die Steuerung für Miranda aus Samurize heraus. Die MextControl.txt ist die Readme hierzu.

Einbau vorbereiten

Wenn alles ordnungsgemäss verstaut ist, kann es losgehen. Zuerst aktivieren wir das MirandaRPC.dll. Dazu im Miranda in den Einstellungen/Plugins das Plugin anschalten und Miranda neu starten. Das wars auch schon. Wenns doch immer so einfach wäre. Um wenigstens nicht ganz wie der Ochs vorm Berg dazustehen, könnt ihr ja mal einen Blick in die Beispielconfig werfen und gleichzeitig mal die Config auf den Desk laden. Viel gesehen habe ich da allerdings auch nicht (aufm Desk).

Dann mal ran an den Speck

Samurize-Editor auf -> Plugin einfügen -> Miranda.dll

Status von einem Kontakt anzeigen

Dies machen wir mit der Funktion "showContactStatusDesc". Als Parameter geben wir hier ein:

• MSN: [MSN]kontakt@email.adresse
• ICQ: [ICQ]1234567890 (ICQnr des Kontaktes)
• Skype: [SKYPE]Nickname des Kontaktes
• IRC: [IRC]Nickname des Kontaktes

Andere Protokolle nutze ich nicht. Wenn man auf dem Reiter "Allgemein" von "Text" auf "Bild" umstellt, kann man mit dem Alarmwert "Wert gleichgestellt" auch Statusicons anzeigen lassen. Darauf achten, dass dann bei "Wert" der Anfangsbuchstabe des Status gross geschrieben wird, da er so von Miranda übergeben wird.

Status der eigenen Protokolle anzeigen

Die Funktion hierfür heisst "showMyStatusDesc". Folgende Parameter warten auf ihren Einsatz:

• ICQ: ICQ
• MSN: MSN
• SKYPE: SKYPE
• IRC: IRC

Auch hier gilt das gleiche wie oben mit den Statusicons.

Eigenen Status ändern:

Nun kommt die "mextcontrol.exe" zu ihrem ersten Einsatz. Da ich sie in C:\Programme\Samurize\ liegen habe, müsst ihr evtl. einen anderen Pfad wählen als meinen. Dies sind Meterverlinkungen, die ihr auf dem Eingabereiter eingebt.

Protokollstatus ändern

Folgende Befehle ändern den Status eines Protokolls:

ICQ:

• online = C:\Programme\Samurize\MExtControl.exe SetStatus(Online,ICQ)
• abwesend = C:\Programme\Samurize\MExtControl.exe SetStatus(na,ICQ)
• ausser Haus = C:\Programme\Samurize\MExtControl.exe SetStatus(away,ICQ)
• offline = C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,ICQ)
• etc.

MSN:

• online = C:\Programme\Samurize\MExtControl.exe SetStatus(Online,MSN)
• abwesend = C:\Programme\Samurize\MExtControl.exe SetStatus(na,MSN)
• ausser Haus = C:\Programme\Samurize\MExtControl.exe SetStatus(away,MSN)
• offline = C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,MSN)
• etc.

IRC:

• online = C:\Programme\Samurize\MExtControl.exe SetStatus(Online,IRC)
• abwesend = C:\Programme\Samurize\MExtControl.exe SetStatus(na,IRC)[/list]
• offline = C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,IRC)
• Kein etc.

SKYPE:

• online = C:\Programme\Samurize\MExtControl.exe SetStatus(Online,SKYPE)
• abwesend = C:\Programme\Samurize\MExtControl.exe SetStatus(na,SKYPE)
• ausser Haus = C:\Programme\Samurize\MExtControl.exe SetStatus(away,SKYPE)
• offline = C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,SKYPE)
• etc.

Für weitere Statusänderungen bitte im Samurizeeditor mit der Funktion "showMyStatusDesc" (siehe oben) nachschauen, ob der gewünschte Status gross oder klein geschrieben wird, denn sonst passiert nichts. (Online geht, online geht nicht).

Meterverlinkungen mit MenuMaker

Da es doch eine Menge Meterverlinkungen wären, empfehle ich für die Statusänderungen das Plugin MenuMaker. Damit benötigt man nur einen Meter, was die Sache doch sehr angenehm macht. Hier mal mein Code, den ich im Menumakerplugin drin stehen habe:

Statuswechsel:
<LINE>
<ICQ>
online=C:\Programme\Samurize\MExtControl.exe SetStatus(Online,ICQ)
abwesend=C:\Programme\Samurize\MExtControl.exe SetStatus(na,ICQ)
ausser Haus=C:\Programme\Samurize\MExtControl.exe SetStatus(away,ICQ)
offline=C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,ICQ)
</ICQ>
<MSN>
online=C:\Programme\Samurize\MExtControl.exe SetStatus(Online,MSN)
abwesend=C:\Programme\Samurize\MExtControl.exe SetStatus(na,MSN)
ausser Haus=C:\Programme\Samurize\MExtControl.exe SetStatus(away,MSN)
offline=C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,MSN)
</MSN>
<IRC>
online=C:\Programme\Samurize\MExtControl.exe SetStatus(Online,IRC)
abwesend=C:\Programme\Samurize\MExtControl.exe SetStatus(na,IRC)
offline=C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,IRC)
</IRC>
<SKYPE>
online=C:\Programme\Samurize\MExtControl.exe SetStatus(Online,SKYPE)
abwesend=C:\Programme\Samurize\MExtControl.exe SetStatus(na,SKYPE)
ausser Haus=C:\Programme\Samurize\MExtControl.exe SetStatus(away,SKYPE)
offline=C:\Programme\Samurize\MExtControl.exe SetStatus(Offline,SKYPE)
</SKYPE>

Chat mit einem Kontakt starten

Oder anders gesagt, einfach das Nachrichtenfenster zu einem Kontakt öffnen geht folgendermassen:

ICQ: C:\Programme\Samurize\MExtControl.exe OpenMsgDlg([ICQ]1234567890)

MSN: C:\Programme\Samurize\MExtControl.exe OpenMsgDlg([MSN]MSNkontakt@email.adresse)

SKYPE: C:\Programme\Samurize\MExtControl.exe OpenMsgDlg([SKYPE]nickname)

IRC: C:\Programme\Samurize\MExtControl.exe OpenMsgDlg([IRC]nickname)

Fazit

Mit diesen paar Funktionen kann man sich eigentlich eine voll funktionsfähige Kontaktliste frei nach seinem Geschmack basteln. Bei den anderen Funktionen müsst ihr selber mal gucken.