annotate mod_bookmarks2/README.markdown @ 4876:0f5f2d4475b9

mod_http_xep227: Add support for import via APIs rather than direct store manipulation In particular this transitions PEP nodes and data to be imported via mod_pep's APIs, fixing issues with importing at runtime while PEP data may already be live in RAM. Next obvious candidate for this approach is rosters, so clients get immediate roster pushes and other special handling (such as emitting subscribes to reach the desired subscription state).
author Matthew Wild <mwild1@gmail.com>
date Tue, 18 Jan 2022 17:01:18 +0000
parents 810b0e17d3aa
children 2718652c18ca
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
3677
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
1 ---
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
2 labels:
4852
810b0e17d3aa mod_bookmarks2: Update Compatibility table
Kim Alvefur <zash@zash.se>
parents: 4851
diff changeset
3 - 'Stage-Merged'
4834
7ed2467c9bb5 mod_bookmarks2: Add simple support for legacy PEP queries
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 4278
diff changeset
4 summary: Synchronise bookmarks between Private XML, legacy PEP, and PEP
3677
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
5 ...
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
6
4851
0ceb2f223b30 mod_bookmarks2: Add a notice of inclusion in prosody-trunk
Kim Alvefur <zash@zash.se>
parents: 4834
diff changeset
7 ::: {.alert .alert-info}
0ceb2f223b30 mod_bookmarks2: Add a notice of inclusion in prosody-trunk
Kim Alvefur <zash@zash.se>
parents: 4834
diff changeset
8 This module has been merged into Prosody as
0ceb2f223b30 mod_bookmarks2: Add a notice of inclusion in prosody-trunk
Kim Alvefur <zash@zash.se>
parents: 4834
diff changeset
9 [mod_bookmarks][doc:modules:mod_bookmarks]. Users of Prosody **trunk**
0ceb2f223b30 mod_bookmarks2: Add a notice of inclusion in prosody-trunk
Kim Alvefur <zash@zash.se>
parents: 4834
diff changeset
10 should switch to that.
0ceb2f223b30 mod_bookmarks2: Add a notice of inclusion in prosody-trunk
Kim Alvefur <zash@zash.se>
parents: 4834
diff changeset
11 :::
0ceb2f223b30 mod_bookmarks2: Add a notice of inclusion in prosody-trunk
Kim Alvefur <zash@zash.se>
parents: 4834
diff changeset
12
3677
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
13 Introduction
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
14 ------------
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
15
4834
7ed2467c9bb5 mod_bookmarks2: Add simple support for legacy PEP queries
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 4278
diff changeset
16 This module fetches users’ bookmarks from Private XML (or legacy PEP) and
7ed2467c9bb5 mod_bookmarks2: Add simple support for legacy PEP queries
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 4278
diff changeset
17 pushes them to PEP on login, and then redirects any Private XML query (or
7ed2467c9bb5 mod_bookmarks2: Add simple support for legacy PEP queries
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 4278
diff changeset
18 legacy PEP) to PEP. This allows interoperability between older clients that
7ed2467c9bb5 mod_bookmarks2: Add simple support for legacy PEP queries
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 4278
diff changeset
19 use [XEP-0048](https://xmpp.org/extensions/xep-0048.html) and recent clients
7ed2467c9bb5 mod_bookmarks2: Add simple support for legacy PEP queries
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents: 4278
diff changeset
20 which use [XEP-0402](https://xmpp.org/extensions/xep-0402.html).
3677
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
21
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
22 Configuration
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
23 -------------
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
24
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
25 Simply [enable it like most other
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
26 modules](https://prosody.im/doc/installing_modules#prosody-modules), no
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
27 further configuration is needed.
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
28
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
29 Compatibility
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
30 -------------
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
31
4852
810b0e17d3aa mod_bookmarks2: Update Compatibility table
Kim Alvefur <zash@zash.se>
parents: 4851
diff changeset
32 ------- -----------------------------------------
810b0e17d3aa mod_bookmarks2: Update Compatibility table
Kim Alvefur <zash@zash.se>
parents: 4851
diff changeset
33 trunk [Merged][doc:modules:mod_bookmarks]
3677
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
34 0.11 Works
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
35 0.10 Does not work
90f88a643973 mod_bookmarks2: Add new module.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
diff changeset
36 0.9 Does not work
4852
810b0e17d3aa mod_bookmarks2: Update Compatibility table
Kim Alvefur <zash@zash.se>
parents: 4851
diff changeset
37 ------- -----------------------------------------