mod_pep

This page documents the new version of mod_pep introduced in 0.11.0. Previous version, present until 0.10, was renamed mod_pep_simple.

Often users will want to publish details about their mood, the music they are listening to or the activity they are currently taking part in. Enabling mod_pep will allow users to publish that information and have interested parties receive it.

Example uses:

Details

mod_pep implements XEP-0163. Since Prosody 0.11.0 it is based on the same PubSub library that powers mod_pubsub, which provide many more features than the minimal subset mandated by XEP-0163.

The previous version is available as mod_pep_simple for those that wish to have more performance in exchange for fewer advanced PubSub features .

Since the PubSub library supports access controls, mod_pep also allow users to decide who will have access to the various nodes. E.g. OMEMO key bundles are commonly made completely public while bookmarks are accessible only by the user themselves.

Usage

    modules_enabled = {
        -- Other modules
        "pep"; -- Enable mod_pep
    }

Configuration

Currenly only a single option for limiting the maximum number of items per pubsub node, which defaults to 256.

pep_max_items = 256

Example

    modules_enabled = {
        -- Other modules
        "pep"; -- Enable mod_pep
    }