Mercurial > libervia-backend

comparison doc/components.rst @ 3892:ba78cc0c8d59

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc (components/AP gateway): "reactions": fix 371
author Goffi <goffi@goffi.org>
date Wed, 31 Aug 2022 17:07:03 +0200
parents 18ff4f75f0e6
children 199598223f82
comparison
equal deleted inserted replaced
3891:989df1047c3c 3892:ba78cc0c8d59
673 .. _XEP-0277 § Repeating a Post: https://xmpp.org/extensions/xep-0277.html#repeat 673 .. _XEP-0277 § Repeating a Post: https://xmpp.org/extensions/xep-0277.html#repeat
674 674
675 Noticed/Like 675 Noticed/Like
676 ~~~~~~~~~~~~ 676 ~~~~~~~~~~~~
677 677
678 AP's ``Like`` activity is converted on the XMPP side to "`Pubsub Attachment`_", which is 678 AP's ``Like`` activity is converted on the XMPP side to "`XEP-0470 (Pubsub
679 currently a "protoXEP", i.e. a specification proposed as a standard (not yet reviewed by 679 Attachments)`_". ``Like`` is converted to ``noticed`` attachment, meaning that it used in
680 `XMPP Council`_). ``Like`` is converted to ``noticed`` attachment, meaning that it used in
681 to indicate that something has been seen and taken into account, without really indication 680 to indicate that something has been seen and taken into account, without really indication
682 if the content is liked or disliked (see Pubsub Attachment § Foreword: `"noticed" instead 681 if the content is liked or disliked (see XEP-0470 § Foreword: `"noticed" instead of "like"
683 of "like" or "favourite"`_ for the rational). 682 or "favourite"`_ for the rational).
684 683
685 As usual, conversion is done in both ways. 684 As usual, conversion is done in both ways.
686 685
687 .. _Pubsub Attachment: https://xmpp.org/extensions/inbox/pubsub-attachments.html 686 .. _XEP-0470 (Pubsub Attachments): https://xmpp.org/extensions/xep-0470.html
688 .. _XMPP Council: https://xmpp.org/about/xmpp-standards-foundation/ 687 .. _XMPP Council: https://xmpp.org/about/xmpp-standards-foundation/
689 .. _"noticed" instead of "like" or "favourite": https://xmpp.org/extensions/inbox/pubsub-attachments.html#noticed-foreword 688 .. _"noticed" instead of "like" or "favourite": https://xmpp.org/extensions/xep-0470.html#noticed-foreword
689
690 Reactions
691 ~~~~~~~~~
692
693 Reactions are not specified in `base ActivityPub specification`_. However `Pleroma`_, a
694 software implemeting ActivityPub, implements them using a non standardised (yet?)
695 ``EmojiReact`` activity. Liberva AP Gateway use it to handle reactions.
696
697 On the XMPP side, `XEP-0470 (Pubsub Attachments)`_ is once again used.
698
699 Libervia also implements `XEP-0444 (Message Reactions)`_ for messages, but because Pleroma
700 doesn't handle reactions for direct messages, this is not used in the Libervia AP gateway.
701 If in the future an AP implementation uses reactions on direct messages, it will be
702 straightforward to add it in the AP gateway.
703
704 .. _base ActivityPub specification: https://www.w3.org/TR/activitypub/
705 .. _Pleroma: https://pleroma.social/
706 .. _XEP-0444 (Message Reactions): https://xmpp.org/extensions/xep-0444.html
690 707
691 Using the Component (for developers) 708 Using the Component (for developers)
692 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 709 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
693 710
694 Publication of AP items can be tested using the following method (with can be accessed 711 Publication of AP items can be tested using the following method (with can be accessed
710 727
711 $ li debug bridge method -c APSend '"{\"node\": \"https://example.net/@pierre/106986412193109832\", \"content\": \"A lille hello from XMPP\"}","pierre\\40example.net@ap.example.org", "louise"' 728 $ li debug bridge method -c APSend '"{\"node\": \"https://example.net/@pierre/106986412193109832\", \"content\": \"A lille hello from XMPP\"}","pierre\\40example.net@ap.example.org", "louise"'
712 729
713 Note the double escaping, one for the shell argument, and the other to specify JSON 730 Note the double escaping, one for the shell argument, and the other to specify JSON
714 object. 731 object.
715