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