Služba Webpresence

Základný popis

Táto služba umožňuje používateľovi prezentovať svoj status cez HTTP linku vo forme obrázka, textu alebo XML dokumentu. Pri registrácii je možné vybrať si jednu z dostupných tém pre obrázkovú prezentáciu statusu, vygenerovanie náhodného ID v prípade, že používateľ nechce, aby v HTTP linke bol uvádzaný názov jeho účtu na jabber.sk ako aj ďalšie možnosti.
Na jabber.sk túto službu zabezpečuje samotný webpresence modul servera ejabberd.

Registrácia

Každý z registrovaných používateľov jabber.sk sa môže cez "Service discovery" registrovať na túto prídavnú službu jabber.sk.
Cesta k "Service discovery" závisí od klienta, ktorého používate. V prípade klienta Gajim sa k tejto možnosti dostanete cez menu 'Actions'->'Discover services'.
Web Presence registrácia
V Service discovery nájdite Web Presence zatlačením tlačidla "Register" sa zobrazí formulár s možnosťami.
Web Presence registrácia
Pri URL type je možné zvoliť dve možnosti:

  1. Jabber ID - táto voľba zabezpečí dostupnosť výstupov web presence modulu použitím loginu na jabber.sk
  2. Random ID - táto voľba zabezpečí dostupnosť výstupov web presence modulu náhodne vygenerovaného čísla

Pri Output type je možné zvoliť viacero možností:

  1. Icon Theme - touto voľbou je možné zmeniť predvolenú voľbu sád obrázkov pre znázornenie statusu
  2. XML - táto voľba zabezpečí dostupnosť výstupov web presence modulu vo formáte XML, ktorý je možné využiť najmä pre použitie externými aplikáciami
  3. JavaScript - táto voľba zabezpečí dostupnosť JavaScript kódu, ktorý definuje hodnoty premenných, ktoré je možné využívať v JavaScript kóde
  4. Text - táto voľba zabezpečí dostupnosť status správy vo formáte čistého textu
  5. Avatar - táto voľba zabezpečí dostupnosť obrázka, ktorý je avatarom tohto účtu

Potvrdzovacia správa
Samotná registrácia je potvrdená správou zo servera, v ktorej sú uvedené aj názorné príklady dotazov na jednotlivé položky. Pre dotazy na server jabber.sk je nutné časť týchto príkladov z potvrdzovacej správy upraviť. Príklady použitia pre server jabber.sk sú popísané nižšie.

Príklady

V príkladoch použitia je použitý názov účtu testing@jabber.sk - výskyty tohto názvu je potrebné zameniť názvami vášho účtu.

Random vs. Jabber ID

V prípade použitia RID v URI adrese dotazu na web presence modul nie je použitý názov účtu. Náhodne vygenerované RID je pridelené po registrácii a je vypísané v správe z tejto registrácie.
- linka pre získanie status správy pomocou JID - http://www.jabber.sk/presence/jid/testing/jabber.sk/text/
- linka pre získanie status správy pomocou RID - http://www.jabber.sk/presence/rid/2333340498778719121459480803360555947/...

Typy výstupov

Ikona statusu
   - linka pre získanie status ikony pomocou JID - http://www.jabber.sk/presence/jid/testing/jabber.sk/image/
      - v tomto prípade bude použitá téma, ktorá bola vybratá pri registrácii
   - linka pre získanie status ikony pomocou JID so zvolením témy - http://www.jabber.sk/presence/jid/testing/jabber.sk/image/theme/gnome
      - ako názov témy je možné zvoliť ktorúkoľvek, ktorá je k dispozícii v registračnom formulári
XML
   - linka pre získanie status ikony pomocou JID - http://www.jabber.sk/presence/jid/testing/jabber.sk/xml/
Príklad výstupu:

<presence>
<resource name="Gajim" show="available" priority="50">olala</resource>
</presence>

JavaScript
   - linka pre získanie JavaScript kódu pomocou JID - http://www.jabber.sk/presence/jid/testing/jabber.sk/js/
Príklad výstupu:

var jabber_resources=[ {name:'Gajim', priority:50, show:'available', long_show:'available', status:'olala', image:'http://jabber.sk:5280/presence/image/3d-dot1/available' }];

Text
   - linka pre získanie textu status správy pomocou JID - http://www.jabber.sk/presence/jid/testing/jabber.sk/text/
Príklad výstupu:

olala

Avatar
   - linka pre získanie avatar obrázka pomocou JID - http://www.jabber.sk/presence/jid/testing/jabber.sk/avatar/
Výstupom je avatar obrázok daného účtu.