view mod_bookmarks/README.markdown @ 3677:90f88a643973

mod_bookmarks2: Add new module. This is the result of hacking during the Stockholm XMPP Sprint, for compatibility with older clients only doing Private XML XEP-0048. This module shouldn’t be loaded at the same time as mod_bookmarks, as both implement Private XML to achieve their conversion.
author Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
date Sat, 28 Sep 2019 14:27:13 +0200
parents bc67519803f5
children 3c4cef6be45b
line wrap: on
line source

---
labels:
- 'Stage-Alpha'
summary: Synchronise bookmarks between Private XML and PEP
...

Introduction
------------

This module fetches users’ bookmarks from Private XML and pushes them
to PEP on login, and then redirects any Private XML query to PEP.  This
allows interop between older clients that use [XEP-0048:
Bookmarks](https://xmpp.org/extensions/xep-0048.html) in its [1.0
version](https://xmpp.org/extensions/attic/xep-0048-1.0.html) and
recent clients which use it in
[PEP](https://xmpp.org/extensions/xep-0163.html).

This behavior is described in [XEP-0411: Bookmarks Conversion].

Configuration
-------------

Simply [enable it like most other
modules](https://prosody.im/doc/installing_modules#prosody-modules), no
further configuration is needed.

Compatibility
-------------

  ------- ---------------
  trunk   Works
  0.11    Works
  0.10    Does not work
  0.9     Does not work
  ------- ---------------