view mod_webpresence.wiki @ 371:bdac3ad25bce

mod_dwd: Add wiki page
author Kim Alvefur <zash@zash.se>
date Fri, 28 Jun 2013 18:35:40 +0200
parents c27f27ba8b58
children 528721aaea46
line wrap: on
line source

#summary Display your online status in web pages
#labels Stage-Stable

= Introduction =

Quite often you may want to publish your Jabber status to your blog or website. mod_webpresence allows you to do exactly this.

= Details =

This module uses Prosody's built-in HTTP server (it does not depend on mod_httpserver). It supplies a status icon representative of a user's online state.

= Installation =

Simply copy mod_webpresence.lua to your modules directory, the image files are embedded within it. Then add "webpresence" to your modules_enabled list.

= Usage =

Once loaded you can embed the icon into a page using a simple `<img>` tag, as follows:

{{{<img src="http://prosody.example.com:5280/status/john.smith" />}}}

Alternatively, it can be used to get status name as plaint text, status message as plain text or html-code for embedding on web-pages.

To get status name in plain text you can use something like that link: {{{http://prosody.example.com:5280/status/john.smith/text}}}

To get status message as plain text you can use something like following link: {{{http://prosody.example.com:5280/status/john.smith/message}}}

To get html code, containig status name, status image and status message  (if set):
{{{http://prosody.example.com:5280/status/john.smith/html}}}

All other 
= Compatibility =
||0.9||Works||
||0.8||Works||
||0.7||Works||
||0.6||Works||

= Todo =

  * JSON?
  * Display PEP information (maybe a new plugin?)
  * More (free) iconsets
  * Internal/external image generator (GD, ImageMagick)