Reactions Extension

The Reactions Extension allows users to express their reactions ("react") to posts with emojis.

Federation

User reactions are (like every other entity) federated to all followers, and can be displayed to clients depending on the privacy settings of the associated Note.

Entity Definition

Name
type
Required
Required
Type
string
Description
Must be pub.versia:reactions/Reaction.
Name
author
Required
Required
Type
URI
Description
URI of the User that is reacting.
Name
object
Required
Required
Type
URI
Description
URI of the Note attached to the reaction.
Name
content
Required
Required
Type
string
Description
Emoji content of reaction. May also be arbitrary text, or Custom Emoji if supported.
Clients are encouraged to disfavour text in favour of emoji where possible.

Example Entity

{
    "id": "6f27bc77-58ee-4c9b-b804-8cc1c1182fa9",
    "type": "pub.versia:reactions/Reaction", 
    "uri": "https://example.com/actions/6f27bc77-58ee-4c9b-b804-8cc1c1182fa9",
    "created_at": "2021-01-01T00:00:00.000Z",
    "author": "https://example.com/users/6e0204a2-746c-4972-8602-c4f37fc63bbe", 
    "object": "https://example.com/publications/f08a124e-fe90-439e-8be4-15a428a72a19",
    "content": "😀",
}

Note Collections

The Likes extension adds the following collections to the Note entity:

reactions: A URI Collection of all the reactions to the note.

{
    "type": "Note",
    ...
    "collections": {
        ...
        "pub.versia:reactions/Reactions": "https://example.com/publications/f08a124e-fe90-439e-8be4-15a428a72a19/reactions"
    }
}

Interaction Types

This section only applies to implementors of the Interaction Controls Extension.

This extension registers the following interaction types:

pub.versia:reactions#React, for adding a Reaction to a Note.