view mod_vjud/README.markdown @ 4326:f6fdefc5c6ac

mod_roster_command: Fix subscription when the "user JID" is a bare domain. Do not attempt to update the roster when the user is bare domain (e.g. a component), since they don't have rosters and the attempt results in an error: $ prosodyctl mod_roster_command subscribe proxy.example.com contact@example.com xxxxxxxxxxFailed to execute command: Error: /usr/lib/prosody/core/rostermanager.lua:104: attempt to concatenate local 'username' (a nil value) stack traceback: /usr/lib/prosody/core/rostermanager.lua:104: in function 'load_roster' /usr/lib/prosody/core/rostermanager.lua:305: in function 'set_contact_pending_out' mod_roster_command.lua:44: in function 'subscribe'
author Boris Grozev <boris@jitsi.org>
date Tue, 05 Jan 2021 13:15:00 -0600
parents ea6b5321db50
children 0aee099f270d
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: 'XEP-0055: Jabber Search'
...

Introduction
============

Basic implementation of [XEP-0055: Jabber Search].

Details
=======

This module has two modes. One mode requires users to opt-in to be
searchable, then allows users to search the list of those users. The
second mode allows search across all users.

Usage
=====

First copy the module to the prosody plugins directory.

Then add "vjud" to your modules\_enabled list:

        modules_enabled = {
                        -- ...
                        "vjud",
                        -- ...
            }

Alternatively, you can load it as a component:

        Component "search.example.com" "vjud"

(Some old clients require this)

Configuration
=============

  Option       Default    Description
  ------------ ---------- --------------------------------
  vjud\_mode   "opt-in"   Defines how the module behaves

Compatibility
=============

  ------- ---------------------------------
  0.8     Works, but only the opt-in mode
  0.9     Works
  trunk   Works
  ------- ---------------------------------

Note that the version for 0.8 and 0.9 are slightly different.