view mod_webpresence/README.markdown @ 5424:b45d9a81b3da

mod_http_oauth2: Revert role selector, going to try something else Back out f2c7bb3af600 Allowing only a single role to be encoded into the grant takes away the possibility of having multiple roles in the grant, one of which is selected when issuing an access token. It also takes away the ability to have zero roles granted, which could be useful e.g. when you only need OIDC scopes.
author Kim Alvefur <zash@zash.se>
date Sun, 07 May 2023 19:40:57 +0200
parents f5005d256877
children
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)