prosody-modules: mod_map/README.markdown@62480053c87b (annotated)

3500 262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	1	---
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	2	labels:
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	3	- 'Stage-Experimental'
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	4	summary: Prototype MAM summary
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	5	---
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	6
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	7	This is a prototype for an experimental archive summary API recently
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	8	added in [Prosody trunk](https://hg.prosody.im/trunk/rev/2c5546cc5c70).
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	9
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	10	# Protocol
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	11
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	12	::: {.alert .alert-danger}
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	13	This is not a finished protocol, but a prototype meant for testing.
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	14	:::
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	15
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	16	A basic query:
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	17
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	18	``` {.xml}
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	19	<iq id="lx7" type="get">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	20	<summary xmlns="xmpp:prosody.im/mod_map"/>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	21	</iq>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	22	```
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	23
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	24	Answered like:
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	25
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	26	``` {.xml}
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	27	<iq type="result" id="lx7">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	28	<summary xmlns="xmpp:prosody.im/mod_map">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	29	<item jid="juliet@capulet.lit">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	30	<count>3</count>
3657 d31fa28d9482 mod_map: Update example in README to reflect recent changes Kim Alvefur <zash@zash.se> parents: 3500 diff changeset	31	<start>2019-02-25T15:48:00+0100</start>
d31fa28d9482 mod_map: Update example in README to reflect recent changes Kim Alvefur <zash@zash.se> parents: 3500 diff changeset	32	<end>2019-08-23T01:39:50+02:00</end>
d31fa28d9482 mod_map: Update example in README to reflect recent changes Kim Alvefur <zash@zash.se> parents: 3500 diff changeset	33	<body>O Romeo, Romeo! wherefore art thou Romeo?</body>
3500 262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	34	</item>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	35	</summary>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	36	</iq>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	37	```
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	38
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	39	It can also take dataform and RSM parameters similar to a [filtered MAM
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	40	query](https://xmpp.org/extensions/xep-0313.html#filter).
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	41
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	42	E.g if the last message you received had an id `09af3-cc343-b409f` then
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	43	the following query would tell you who sent you messages since:
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	44
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	45	``` {.xml}
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	46	<iq id="lx8" type="get">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	47	<summary xmlns="xmpp:prosody.im/mod_map">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	48	<set xmlns="http://jabber.org/protocol/rsm">
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	49	<max>10</max>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	50	<after>09af3-cc343-b409f</after>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	51	</set>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	52	</summary>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	53	</iq>
262e68821f3f mod_map: Experimental module exposing MAM summary Kim Alvefur <zash@zash.se> parents: diff changeset	54	```

author	Matthew Wild <mwild1@gmail.com>
	Fri, 23 Sep 2022 22:41:15 +0100
changeset 5058	62480053c87b
parent 3657	d31fa28d9482
permissions	-rw-r--r--