Mercurial > libervia-backend
view doc/libervia-cli/pubsub_node_subscriptions.rst @ 3888:aa7197b67c26
component AP gateway: AP <=> XMPP reactions conversions:
- Pubsub Attachments plugin has been renamed to XEP-0470 following publication
- XEP-0470 has been updated to follow 0.2 changes
- AP reactions (as implemented in Pleroma) are converted to XEP-0470
- XEP-0470 events are converted to AP reactions (again, using "EmojiReact" from Pleroma)
- AP activities related to attachments (like/reactions) are cached in Libervia because
it's not possible to retrieve them from Pleroma instances once they have been emitted
(doing an HTTP get on their ID returns a 404). For now those cache are not flushed, this
should be improved in the future.
- `sharedInbox` is used when available. Pleroma returns a 500 HTTP error when ``to`` or
``cc`` are used in a direct inbox.
- reactions and like are not currently used for direct messages, because they can't be
emitted from Pleroma in this case, thus there is no point in implementing them for the
moment.
rel 371
author | Goffi <goffi@goffi.org> |
---|---|
date | Wed, 31 Aug 2022 17:07:03 +0200 |
parents | e597dbfbc4c6 |
children |
line wrap: on
line source
.. _libervia-cli_pubsub_node_subscriptions: ======================================================== pubsub/node/affiliations: nodes subscriptions management ======================================================== ``subscriptions`` is a subcommand handling the subscription to a node. Those commands can only be used by an owner of the node. get === Retrieve subscriptions to a node. If ``--public`` is used, only public subscriptions are retrieved (if target service supports `XEP-0465 Public Pubsub Subscriptions`). Public subscriptions are accessible to anybody, thus you can use this on a node even if you are not an owner of it (and thus would not normally be allowed to retrieve subscriptions). .. _XEP-0465 Public Pubsub Subscriptions: https://xmpp.org/extensions/inbox/pubsub-public-subscriptions.html example ------- Get subscription from ``some_node``:: $ li pubsub node subscriptions get -n some_node Retrieve public subscribers to the blog of Louise:: $ li pubsub node subscriptions get --public -s louise@example.org -n urn:xmpp:microblog:0 set === Set subscriptions to a node. Subscriptions are specified with ``-S JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...], --subscription JID [SUSBSCRIPTION] [JID [SUSBSCRIPTION] ...]`` where ``JID`` is the jid of the entity to change subscription state, and ``SUBSCRIPTION`` is a subscription state (on of ``subscribed``, ``pending``, ``none``) as specified in `XEP-0060 Subscription State`_. If ``SUBSCRIPTION`` is not specified, it default to ``subscribed``. .. _XEP-0060 Subscription State: https://xmpp.org/extensions/xep-0060.html#substates example ------- Subscribe Louise with her new address at ``louise@example.org`` and remove her subscription from old ``louise@example.com``:: $ li pubsub node subscriptions set -n some_node -S louise@example.org subscribed louise@example.com none