prosody-modules
d194d1012fd3
mod_webpresence/README.markdown
Software / code / prosody-modules
File
mod_webpresence/README.markdown @ 5931:d194d1012fd3
Updating dox for mod_rest. Ideas expressed / clarified:
1) Making clear that mod_rest isn't to be installed under VirtualHosts AND as a component.
2) Understanding some of the implications of this choice:
A) Changes to user authentication
B) How it affects subdomains
3) More consistent use of domain names for clarity.
4) Using different heading sizes to show scope of section.
Essentially, I added all the tidbits I had to clarify in getting this to work in my
own example.
| author | Ben Smith <bens@effortlessis.com> |
|---|---|
| date | Mon, 13 May 2024 13:25:13 -0700 |
| parent | 2734:f5005d256877 |
| child | 5588:f16720087ef2 |
line wrap: on
line source
--- labels: - 'Stage-Stable' summary: Display your online status in web pages ... 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 ============= ----- ------- trunk Works 0.10 Works 0.9 Works 0.8 Works 0.7 Works 0.6 Works ----- ------- Todo ==== - Display PEP information (maybe a new plugin?) - More (free) iconsets - Internal/external image generator (GD, ImageMagick)
