Mercurial > prosody-modules
diff mod_webpresence/README.wiki @ 1782:29f3d6b7ad16
Import wiki pages
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Mon, 24 Aug 2015 16:43:56 +0200 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/mod_webpresence/README.wiki Mon Aug 24 16:43:56 2015 +0200 @@ -0,0 +1,43 @@ +#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) \ No newline at end of file