strapi-plugin-reactions

KO | EN

gitlite — search

#javascript #hacktoberfest #go #linux #macos #nodejs #awesome #kubernetes #vue #security #mcp #ios #openai #open-source

strapi-plugin-reactions

(★ 23)

All-in-One reactions plugin for any Content Type. Simple & flexible.

strapi-plugin-reactions 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center" width="150px">
  <img style="width: 150px; height: auto;" src="https://www.sensinum.com/img/open-source/strapi-plugin-reactions/logo.png" alt="Logo - Strapi Reaction plugin" />
</div>
<div align="center">
  <h1>Strapi - Reactions plugin</h1>
  <p>All-in-One reactions plugin for any Content Type. Simple & flexible</p>
  <a href="https://www.npmjs.org/package/strapi-plugin-reactions">
    <img alt="GitHub package.json version" src="https://img.shields.io/github/package-json/v/VirtusLab-Open-Source/strapi-plugin-reactions?label=npm&logo=npm">
  </a>
  <a href="https://www.npmjs.org/package/strapi-plugin-reactions">
    <img src="https://img.shields.io/npm/dm/strapi-plugin-reactions.svg" alt="Monthly download on NPM" />
  </a>
  <a href="https://circleci.com/gh/VirtusLab-Open-Source/strapi-plugin-reactions">
    <img src="https://circleci.com/gh/VirtusLab-Open-Source/strapi-plugin-reactions.svg?style=shield" alt="CircleCI" />
  </a>
  <a href="https://codecov.io/gh/VirtusLab-Open-Source/strapi-plugin-reactions">
    <img src="https://codecov.io/gh/VirtusLab-Open-Source/strapi-plugin-reactions/coverage.svg" alt="codecov.io" />
  </a>
</div>

---

A plugin for [Strapi Headless CMS](https://github.com/strapi/strapi) that provides flexible &amp; configurable reactions experience to any Content Types.

### Table of Contents

1. [💎 Versions](#-versions)
2. [✨ Features](#-features)
3. [⏳ Installation](#-installation)
4. [🖐 Requirements](#-requirements)
5. [🔧 Basic configuration](#-configuration)
6. [🔧 GraphQL Configuration](#-gql-configuration)
7. [🕸️ Public API - REST](#%EF%B8%8F-public-rest-api-specification)
8. [🕸️ Public API - GraphQL](#%EF%B8%8F-public-graphql-api-specification)
9. [🔌 Enrich service for Strapi extensions](#-enrich-service-for-strapi-extensions)
10. [💬 FAQ](#-faq)
11. [🤝 Contributing](#-contributing)
12. [👨‍💻 Community support](#-community-support)

## 💎 Versions
- **Strapi v5** - (current) [v2.x](https://github.com/VirtusLab-Open-Source/strapi-plugin-reactions)
- **Strapi v4** - [v1.x](https://github.com/VirtusLab-Open-Source/strapi-plugin-reactions/tree/strapi-v4)

## ✨ Features

- **Public REST & GraphQL API:** Listing, setting, unsetting, toggling and much more via *REST* or *GraphQL* API. Easy to integrate with.
- **Any Content Type relation:** Reactions can be used to any of your Content Types without any special configuration.
- **Emoji &amp; Image reactions:** You can define reaction types using predefined set of [Emoji](https://github.com/ealush/emoji-picker-react) or use your own.
- **Content Manager Injection Zone:** Making use of Strapi built-in batteries like *Injection Zones* to provide you highers user experience. Visual representation of reactions counter for any Content Types - useful!
- **Developer Experience boosted:** A dedicated *Enrich* service provided to let you extend your Content API controllers by a single line to get reactions per each!

**Request a feature by [raising an issue](https://github.com/VirtusLab-Open-Source/strapi-plugin-reactions/issues/new).**

## ⏳ Installation

### Prerequisites

#### Database connection update

Because of Emoji usage, you will need (or maybe you already did it because of earlier requirements) to extend the database connection section in your Strapi project configuration.

```ts
// config/database.ts
// config/<env>/database.ts

connection: {
    charset: 'utf8mb4',
    collation: 'utf8mb4_unicode_ci',
    // your database credentials
}
```

Based on this specific charset, your emoji reactions are going to be saved in the database like a charm. See the [reference issue](https://github.com/strapi/strapi/issues/10676#issuecomment-1642204275) raised on Strapi repository.

### Via command line

(Use **yarn** to install this plugin within your Strapi project (recommended). [Install yarn with these docs](https://yarnpkg.com/lang/en/docs/install/).)

```bash
yarn add strapi-plugin-reactions@latest
```

After successful installation you've to re-build your Strapi instance. To archive that simply use:

```bash
yarn build
yarn develop
```

or just run Strapi in the development mode with `--watch-admin` option:

```bash
yarn develop --watch-admin
```

The **Reactions** plugin should appear in the **Settings** section of Strapi after you run app again.

As a next step you must configure your the plugin by adding types of reactions you want to use. See [**Configuration**](#🔧-configuration) section.

All done. Enjoy 🎉

## 🖐 Requirements

Complete installation requirements are exact same as for Strapi itself and can be found in the documentation under [Installation Requirements](https://docs.strapi.io/developer-docs/latest/getting-started/introduction.html).

**Minimum environment requirements**

- Node.js `>=18.0.0 <=20.x.x`
- NPM `>=6.x.x`

In our minimum support we're following [official Node.js releases timelines](https://nodejs.org/en/about/releases/).

**Supported Strapi versions**:

- Strapi v5.10.3 (recently tested)
- Strapi v5.x

**Plugin dependencies**
- `@strapi/plugin-graphql` - required to run because built-in support for GraphQL handled by this plugin

**We recommend always using the latest version of Strapi to start your new projects**.

## 🔧 Configuration

To start your journey with **Reactions plugin** you must first setup types of reactions using the dedicated Settings page.

There is no need to provide any specific changed in the plugin configuration files extept enabling it.

```ts
export default () => ({
  //...
  reactions: {
    enabled: true,
    config: {
      gql: {...},
    },
  },
  //...
});
```
### Properties
- `gql` - If you're using GraphQL that's the right place to put all necessary settings. More **[ here ](#gql-configuration)**

## 🔧 GQL Configuration
Using reactions with GraphQL requires both plugins to be installed and working. You can find installation guide for GraphQL plugin **[here](https://docs.strapi.io/developer-docs/latest/plugins/graphql.html#graphql)**. To properly configure GQL to work with reactions you should provide `gql` prop. This should contain union types that will be used to define GQL response format for your data while fetching:

> **Important!**
> If you're using `config/plugins.{js,ts}` to configure your plugins , please put `reactions` property before `graphql`. Otherwise types are not going to be properly added to GraphQL Schema. That's because of dynamic types which base on plugin configuration which are added on `bootstrap` stage, not `register`. This is not valid if you're using `graphql` plugin without any custom configuration, so most of cases in real.

```gql
related: ReactionRelated
```

This prop should look as follows:

```ts
gql: {
    reactionRelated: ['<your GQL related content types>'],
},
```

for example:

```ts
gql: {
    reactionRelated: ['Page', 'BlogPost'],
},
```
where `Page` and `BlogPost` are your type names for the **Content Types** you're using reactions with.

## 👤 RBAC

Plugin provides granular permissions based on Strapi RBAC functionality.

### Mandatory permissions

For any role different than **Super Admin**, to access the **Reactions settings** you must set following permissions:

- _Plugins_ -> _Reactions_ -> _Reactions: Read_ - gives you the basic read access to **Reactions settings**
- _Plugins_ -> _Reactions_ -> _Reactions: Change_ - you're able to change the configuration of plugin
- _Plugins_ -> _Reactions_ -> _Reactions: Admin_ - you're able to perform administrator action in the global scope of a plugin

## Data models

### Reaction kind / type
```json
{
  "documentId": "njx99iv4p4txuqp307ye8625",
  "name": "Like",
  "slug": "like",
  "emoji": "👍",
  "emojiFallbackUrl": "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f44d.png",
  "createdAt": "2023-09-14T20:13:01.649Z",
  "updatedAt": "2023-09-14T20:13:01.670Z",
  "icon": null
}
```

### Reaction

```json
{
  "documentId": "njx99iv4p4txuqp307ye8625",
  "kind": { // Type of reaction, not provided when listing by exact kind
    "documentId": "njx99iv4p4txuqp307ye8625",
    "slug": "like",
    "name": "Like" 
  },
  "user": { // User who trigger reaction, not provided when listing by exact user
    "documentId": "njx99iv4p4txuqp307ye8625",
    "username": "Joe Doe",
    "email": "jdoe@sample.com",
  },
  "userId": "32", // Custom User ID provided if X-Reactions-Author header passed
  "createdAt": "2023-09-14T20:13:01.649Z",
  "updatedAt": "2023-09-14T20:13:01.670Z",
}
```

## 🕸️ Public REST API specification

### Get reaction kinds / types

_GraphQL equivalent: [Public GraphQL API -> Get reaction kinds / types](#get-reaction-kinds--types-1)_

`GET <host>/api/reactions/kinds`

Return a list of available reaction kinds to use on the end user interface and expose for interaction with users.

**Example URL**: `https://localhost:1337/api/reactions/kinds`

**Example response body**

```json
[
  {
  "documentId": "njx99iv4p4txuqp307ye8625",
  "name": "Like",
  "slug": "like",
  "emoji": "👍",
  "emojiFallbackUrl": "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f44d.png",
  "createdAt": "2023-09-14T20:13:01.649Z",
  "updatedAt": "2023-09-14T20:13:01.670Z",
  "icon": null
  },
  // ...
]
```

### List all reactions associated with Content Type

_GraphQL equivalent: [Public GraphQL API -> List all reactions associated with Content Type](#list-all-reactions-associated-with-content-type-1)_

`GET <host>/api/reactions/list/single/<single type UID>?locale=<locale code>`
`GET <host>/api/reactions/list/collection/<collection type UID>/<documentId>?locale=<locale code>`

Return all reactions associated with provided Collection / Single Type UID and Content Type Document ID with following combinations:
- all - if you're not providing the user context via `Authorization` header
- all related with Strapi user - if call is done with user context via `Authorization` header
- all related with non-Strapi user - if call is done with user ID via `X-Reactions-Author` header

**Example URL**: `https://localhost:1337/api/reactions/list/single/api::homepage.homepage?locale=en`
**Example URL**: `https://localhost:1337/api/reactions/list/collection/api::post.post/njx99iv4p4txuqp307ye8625?locale=en`

**Example response body**

```json
[
  {
    "documentId": "njx99iv4p4txuqp307ye8625",
    "createdAt": "2023-09-14T20:13:01.649Z",
    "updatedAt": "2023-09-14T20:13:01.670Z",
    "kind":{
      "documentId": "njx99iv4p4txuqp307ye8625",
      "slug": "like",
      "name": "Like"
    },
    "user":{ // Added if Strapi user context provided to identify who made such reaction
      "documentId": "njx99iv4p4txuqp307ye8625",
      "username": "mziarko+1@virtuslab.com",
      "email": "mziarko+1@virtuslab.com"
    },
    "userId": 17 // Added if non-Strapi user context provided to identify who made such reaction
  },
  // ...
]
```

### List all reactions associated with particular user

_GraphQL equivalent: [Public GraphQL API -> List all reactions associated with particular user](#list-all-reactions-associated-with-particular-user-1)_

`GET <host>/api/reactions/list/user`
`GET <host>/api/reactions/list/user/<user id>`

Return all reactions associated with provided user:
- for logged in user - if call is done with user context via `Authorization` header
- for specific Strapi user ID - if you're not providing the user context via `Authorization` header and you're providing the user context via `user-id` url param
- for specific non-Strapi user ID - if you're not providing the user context via `Authorization` header and you're providing the user context via `X-Reactions-Author` header

**Example URL**: `https://localhost:1337/api/reactions/list/user`
**Example URL**: `https://localhost:1337/api/reactions/list/user/1`

**Example response body**

```json
[
  {
    "documentId": "njx99iv4p4txuqp307ye8625",
    "createdAt": "2023-09-14T20:13:01.649Z",
    "updatedAt": "2023-09-14T20:13:01.670Z",
    "kind":{
      "slug": "like",
      "name": "Like"
    },
    "related":{
      "documentId": "njx99iv4p4txuqp307ye8625",
      "id": 1,
      "locale": "en",
      //...
    }
  },
  // ...
]
```

### List all reactions of kind / type associated with Content Type

_GraphQL equivalent: [Public GraphQL API -> List all reactions of kind / type associated with Content Type](#list-all-reactions-of-kind--type-associated-with-content-type-1)_

`GET <host>/api/reactions/list/<type slug>/single/<single type UID>?locale=<locale code>`
`GET <host>/api/reactions/list/<type slug>/collection/<collection type UID>/<documentId>?locale=<locale code>`

Return all reactions of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID with following combinations:
- all - if you're not providing the user context via `Authorization` header
- all related with Strapi user - if call is done with user context via `Authorization` header
- all related with non-Strapi user - if call is done with user ID via `X-Reactions-Author` header

**Example URL**: `https://localhost:1337/api/reactions/list/like/single/api::homepage.homepage?locale=en`
**Example URL**: `https://localhost:1337/api/reactions/list/like/collection/api::post.post/njx99iv4p4txuqp307ye8625?locale=en`

**Example response body**

```json
[
  {
    "documentId": "njx99iv4p4txuqp307ye8625",
    "createdAt": "2023-09-14T20:13:01.649Z",
    "updatedAt": "2023-09-14T20:13:01.670Z",
    "user":{ // Added if Strapi user context provided to identify who made such reaction
      "documentId": "njx99iv4p4txuqp307ye8625",
      "username": "mziarko+1@virtuslab.com",
      "email": "mziarko+1@virtuslab.com"
    }
  },
  "userId": 17 // Added if non-Strapi user context provided to identify who made such reaction
  // ...
]
```

### List all reactions of kind associated with particular user

_GraphQL equivalent: [Public GraphQL API -> List all reactions of kind associated with particular user](#list-all-reactions-of-kind-associated-with-particular-user-1)_

`GET <host>/api/reactions/list/<type slug>/user`
`GET <host>/api/reactions/list/<type slug>/user/<user id>`

Return all reactions of specific kind associated with provided user:
- for logged in user - if call is done with user context via `Authorization` header
- for specific Strapi user ID - if you're not providing the user context via `Authorization` header and you're providing the user context via `user-id` url param
- for specific non-Strapi user ID - if you're not providing the user context via `Authorization` header and you're providing the user context via `X-Reactions-Author` header

**Example URL**: `https://localhost:1337/api/reactions/list/like/user`
**Example URL**: `https://localhost:1337/api/reactions/list/like/user/1`

**Example response body**

### Set reaction for Content Type

_GraphQL equivalent: [Public GraphQL API -> Set reaction for Content Type](#set-reaction-for-content-type-1)_

`POST <host>/api/reactions/set/<type slug>/single/<single type UID>?locale=<locale code>`
`POST <host>/api/reactions/set/<type slug>/collection/<collection type UID>/<documentId>?locale=<locale code>`

Create reaction of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID.

To identify the reaction author, you must provide **one** of the following headers:

- `Authorization` – use this header if you want to set a reaction for a Strapi user.
- `X-Reactions-Author` – use this header if you want to set a reaction for a non-Strapi user. The value can be any identifier that uniquely distinguishes the reaction author in your system.

**Example URL**: `https://localhost:1337/api/reactions/set/like/single/api::homepage.homepage?locale=en`
**Example URL**: `https://localhost:1337/api/reactions/set/like/collection/api::post.post/njx99iv4p4txuqp307ye8625?locale=en`

**Example response body**

```json
{
  "documentId": "njx99iv4p4txuqp307ye8625",
  "createdAt": "2023-09-14T20:13:01.649Z",
  "updatedAt": "2023-09-14T20:13:01.670Z",
  "relatedUid": "api::post.post:njx99iv4p4txuqp307ye8625"
}
```

### Unset reaction for Content Type

_GraphQL equivalent: [Public GraphQL API -> Unset reaction for Content Type](#unset-reaction-for-content-type-1)_

`DELETE <host>/api/reactions/unset/<type slug>/single/<single type UID>?locale=<locale code>`
`DELETE <host>/api/reactions/unset/<type slug>/collection/<collection type UID>/<documentId>?locale=<locale code>`

Delete reaction of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID.

To identify the reaction author, you must provide **one** of the following headers:

**Example URL**: `https://localhost:1337/api/reactions/unset/like/single/api::homepage.homepage?locale=en`
**Example URL**: `https://localhost:1337/api/reactions/unset/like/collection/api::post.post/njx99iv4p4txuqp307ye8625?locale=en`

**Example response body**

```json
true
```

### Toggle reaction for Content Type

_GraphQL equivalent: [Public GraphQL API -> Toggle reaction for Content Type](#toggle-reaction-for-content-type-1)_

`POST <host>/api/reactions/toggle/<type slug>/single/<single type UID>?locale=<locale code>`
`POST <host>/api/reactions/toggle/<type slug>/collection/<collection type UID>/<documentId>?locale=<locale code>`

Toggle reaction of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID.

To identify the reaction author, you must provide **one** of the following headers:

**Example URL**: `https://localhost:1337/api/reactions/toggle/like/single/api::homepage.homepage?locale=en`
**Example URL**: `https://localhost:1337/api/reactions/toggle/like/collection/api::post.post/njx99iv4p4txuqp307ye8625?locale=en`

**Example response body**

```json
{
  "documentId": "njx99iv4p4txuqp307ye8625",
  "createdAt": "2023-09-14T20:13:01.649Z",
  "updatedAt": "2023-09-14T20:13:01.670Z",
  "relatedUid": "api::post.post:njx99iv4p4txuqp307ye8625"
}

// or

true
```

### Possible scenarios
1. No reaction set yet - Calling `toggle` for a reaction sets that reaction.
2. Same reaction already set - Calling `toggle` for a reaction that is already set will **unset** it (result: no reaction).
3. Different reaction already set - If another reaction is set, calling `toggle` for a new reaction will **switch** to that reaction: the specified reaction becomes set, and any previously set reactions of that type are unset.

## 🕸️ Public GraphQL API specification

**Testing**

> To test all queries and understand the schemas use GraphQL Playground exposed by `@strapi/plugin-graphql` on `http://localhost:1337/graphql`

### Get reaction kinds / types

_REST API equivalent: [Public REST API -> Get reaction kinds / types](#get-reaction-kinds--types)_

Return a list of available reaction kinds to use on the end user interface and expose for interaction with users.

**Example request**

```graphql
query {
  reactionKinds {
      slug
      name
      emoji
    icon {
      url
    }
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionKinds": [
      {
        "slug": "like",
        "name": "Like",
        "emoji": "👍",
        "icon": null
      }
    ]
  }
}
```

### List all reactions associated with Content Type

_REST API equivalent: [Public REST API -> List all reactions associated with Content Type](#list-all-reactions-associated-with-content-type)_

Return all reactions associated with provided Collection / Single Type UID and Content Type Document ID with following combinations:
- Query `reactionsList` – returns all reactions for the specified document. No `Authorization` header is required (public access).
- Query `reactionsListPerUser` – returns reactions added by a specific author. One of the following headers is required:
  - `Authorization` – to fetch reactions for a Strapi user.
  - `X-Reactions-Author` – to fetch reactions for a non-Strapi user, identified by any custom author ID.

**Example request**

```graphql
query {
  reactionsList(uid: "api::post.post", documentId: "njx99iv4p4txuqp307ye8625", locale: "en") {
    documentId
    kind {
      slug
      name
      emoji
    }
    user {
      email
    }
  }
}
```

```graphql
query {
  reactionsListPerUser(uid: "api::post.post", documentId: "njx99iv4p4txuqp307ye8625", locale: "en") {
    documentId
    kind {
      slug
      name
      emoji
    }
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionsList": [
      {
        "documentId": "njx99iv4p4txuqp307ye8625",
        "kind": {
          "slug": "like",
          "name": "Like",
          "emoji": "👍"
        },
        "user": {
          "email": "mziarko+1@virtuslab.com"
        },
        "createdAt": "2023-09-14T20:13:01.670Z"
      }
    ]
  }
}
// --------------------------------
{
  "data": {
    "reactionsListPerUser": [
      {
        "documentId": "njx99iv4p4txuqp307ye8625",
        "kind": {
          "slug": "like",
          "name": "Like",
          "emoji": "👍"
        },
        "createdAt": "2023-09-14T20:13:01.670Z"
      }
    ]
  }
}
```

### List all reactions associated with particular user

_REST API equivalent: [Public REST API -> List all reactions associated with particular user](#list-all-reactions-associated-with-particular-user)_

Return all reactions associated with provided user:
- Query `reactionsListAllPerUser` – one of the following headers is required:
  - `Authorization` – to fetch reactions for a Strapi user.
  - `X-Reactions-Author` – to fetch reactions for a non-Strapi user, identified by any custom author ID.

**Example request**

```graphql
query {
  reactionsListAllPerUser {
    documentId
    createdAt
    kind {
      slug
    }
    related {
      documentId
      id
      locale
    }
  }
}
```

```graphql
query {
  reactionsListAllPerUser(userId: 1) {
    documentId
    createdAt
    kind {
      slug
    }
    related {
      documentId
      id
      locale
    }
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionsListAllPerUser": [
      {
        "documentId": "njx99iv4p4txuqp307ye8625",
        "createdAt": "2023-09-14T20:13:01.670Z",
        "kind": {
          "slug": "like"
        },
        "related": {
          "documentId": "njx99iv4p4txuqp307ye8625",
          "id": 1,
          "locale": "en"
        }
      }
    ]
  }
}
```

### List all reactions of kind / type associated with Content Type

_REST API equivalent: [Public REST API -> List all reactions of kind / type associated with Content Type](#list-all-reactions-of-kind--type-associated-with-content-type)_

Return all reactions of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID with following combinations:
- Query `reactionsList` – returns all reactions for the specified document. No `Authorization` header is required (public access).
- Query `reactionsListPerUser` – returns reactions added by a specific author. One of the following headers is required:
  - `Authorization` – to fetch reactions for a Strapi user.
  - `X-Reactions-Author` – to fetch reactions for a non-Strapi user, identified by any custom author ID.

**Example request**

```graphql
query {
  reactionsList(kind: "like", uid: "api::post.post", documentId: "njx99iv4p4txuqp307ye8625", locale: "en") {
    documentId
    user {
      email
    }
    createdAt
  }
}
```

```graphql
query {
  reactionsListPerUser(kind: "like", uid: "api::post.post", documentId: "njx99iv4p4txuqp307ye8625", locale: "en") {
    documentId
    createdAt
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionsList": [
      {
        "documentId": "njx99iv4p4txuqp307ye8625",
        "user": {
          "email": "mziarko+1@virtuslab.com"
        },
        "createdAt": "2023-09-14T20:13:01.670Z"
      }
    ]
  }
}
// --------------------------------
{
  "data": {
    "reactionsListPerUser": [
      {
        "documentId": "njx99iv4p4txuqp307ye8625",
        "createdAt": "2023-09-14T20:13:01.670Z"
      }
    ]
  }
}
```

### List all reactions of kind associated with particular user

_REST API equivalent: [Public REST API -> List all reactions of kind associated with particular user](#list-all-reactions-of-kind-associated-with-particular-user)_

Return all reactions of specific kind associated with provided user:
- Query `reactionsListAllPerUser` – one of the following headers is required:
  - `Authorization` – to fetch reactions for a Strapi user.
  - `X-Reactions-Author` – to fetch reactions for a non-Strapi user, identified by any custom author ID.

**Example request**

```graphql
query {
  reactionsListAllPerUser(kind: "like") {
    documentId
    createdAt
    related {
      documentId
      id
      locale
    }
  }
}
```

```graphql
query {
  reactionsListAllPerUser(kind: "like", userId: 1) {
    documentId
    createdAt
    related {
      documentId
      id
      locale
    }
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionsListAllPerUser": [
      {
        "documentId": "njx99iv4p4txuqp307ye8625",
        "createdAt": "2023-09-14T20:13:01.670Z",
        "related": {
          "documentId": "njx99iv4p4txuqp307ye8625",
          "id": 1,
          "locale": "en"
        }
      }
    ]
  }
}
```

### Set reaction for Content Type

_REST API equivalent: [Public REST API -> Set reaction for Content Type](#set-reaction-for-content-type)_

Create reaction of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID.

To identify the reaction author, you must provide **one** of the following headers:

**Example request**

```graphql
mutation reactionSet {
  reactionSet(
    input: {
      kind: "like",
      uid: "api::post.post",
      documentId: "njx99iv4p4txuqp307ye8625",
      locale: "en"
    }
  ) {
    documentId
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionSet": {
      "documentId": "njx99iv4p4txuqp307ye8625"
    }
  }
}
```

### Unset reaction for Content Type

_REST API equivalent: [Public REST API -> Unset reaction for Content Type](#unset-reaction-for-content-type)_

Delete reaction of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID.

To identify the reaction author, you must provide **one** of the following headers:

**Example request**

```graphql
mutation reactionUnset {
  reactionUnset(
    input: {
      kind: "like",
      uid: "api::post.post",
      documentId: "njx99iv4p4txuqp307ye8625",
      locale: "en"
    }
  ) {
    documentId
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionUnset": {
      "documentId": null
    }
  }
}
```

### Toggle reaction for Content Type

_REST API equivalent: [Public REST API -> Toggle reaction for Content Type](#toggle-reaction-for-content-type)_

Toggle reaction of specific kind / type associated with provided Collection / Single Type UID and Content Type Document ID.

To identify the reaction author, you must provide **one** of the following headers:

**Example request**

```graphql
mutation reactionToggle {
  reactionToggle(
    input: {
      kind: "like",
      uid: "api::post.post",
      documentId: "njx99iv4p4txuqp307ye8625",
      locale: "en"
    }
  ) {
    documentId
  }
}
```

**Example response body**

```json
{
  "data": {
    "reactionToggle": {
      "documentId": "njx99iv4p4txuqp307ye8625"
    }
  }
}

// or

{
  "data": {
    "reactionToggle": {
      "documentId": null
    }
  }
}
```

## 🔌 Enrich service for Strapi extensions

### Enrich One

You can use this service method for example in your **Strapi Content API** `findOne` method to enrich the metadata of retrieved entity by associated reactions.

What is important, service method does not modify default `data` schema of **Strapi Content API**. All additions are made in the `meta` property in the form of:

```json
// ...
"meta": {
  // ...
  "reactions": {
    "<type slug>": [
      // list of reactions
    ],
    // ...
  }
}
```

#### Example extension
```ts
// src/api/post/controllers/post.ts

'use strict';

/**
 *  post controller
 */

import { factories } from '@strapi/strapi'

export default factories.createCoreController('api::post.post', ({ strapi }) => ({
  async findOne(ctx) {
    const response = await super.findOne(ctx);

return strapi
      .service('plugin::reactions.enrich')
      .enrichOne('api::post.post', response);
  },
}));
```

#### Example response
```json
{
  "data":{
    "documentId": "njx99iv4p4txuqp307ye8625",
    "attributes":{
      // Content type attributes 
    }
  },
  "meta":{
    "reactions":{
      "like":[{
          "documentId": "njx99iv4p4txuqp307ye8625",
          "createdAt": "2023-09-14T20:13:01.649Z",
          "updatedAt": "2023-09-14T20:13:01.670Z",
          "relatedUid": "api::post.post:2",
          "kind":{
            "documentId": "njx99iv4p4txuqp307ye8625",
            "name": "Like",
            "slug": "like",
            "emoji": "👍",
            "emojiFallbackUrl": "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f44d.png",
            "icon": null
          },
          "user":{
            "documentId": "njx99iv4p4txuqp307ye8625",
            "username": "mziarko+1@virtuslab.com",
            "email": "mziarko+1@virtuslab.com"
          }
        },
        // ...
      ],
    // ...
    }
  }
}
```

### Enrich Many

You can use this service method for example in your **Strapi Content API** `find` method to enrich the metadata of retrieved entities set by associated reactions.

What is important, service method does not modify default `data` schema of **Strapi Content API**. All additions are made in the `meta` property in the form of:

```json
// ...
"meta": {
  // ...
  "reactions": {
    "<content type id>": {
      "<type slug>": [
        // list of reactions
      ],
      // ...
    }
  }
}
```

#### Example extension
```ts
// src/api/post/controllers/post.ts

'use strict';

/**
 *  post controller
 */

import { factories } from '@strapi/strapi'

export default factories.createCoreController('api::post.post', ({ strapi }) => ({
  async find(ctx) {
    const response = await super.find(ctx);

return strapi
      .service('plugin::reactions.enrich')
      .enrichMany('api::post.post', response);
  },
}));
```

#### Example response
```json
{
  "data": [{
      "documentId": "njx99iv4p4txuqp307ye8625",
      "attributes":{
        // Content type attributes 
      }
    }, {
      "documentId": 2,
      "attributes":{
        // Content type attributes 
      }
    }
  ],
  "meta":{
    "reactions":{
      "njx99iv4p4txuqp307ye8625": {
        "like":[{
            "documentId": "njx99iv4p4txuqp307ye8625",
            "createdAt": "2023-09-14T20:13:01.649Z",
            "updatedAt": "2023-09-14T20:13:01.670Z",
            "relatedUid": "api::post.post:2",
            "kind":{
              "documentId": "njx99iv4p4txuqp307ye8625",
              "name": "Like",
              "slug": "like",
              "emoji": "👍",
              "emojiFallbackUrl": "https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f44d.png",
              "icon": null
            },
            "user":{
              "documentId": "njx99iv4p4txuqp307ye8625",
              "username": "mziarko+1@virtuslab.com",
              "email": "mziarko+1@virtuslab.com"
            }
          },
          // ...
        ],
      // ...
      },
      "2": {}
    }
  }
}
```

## 💬 FAQ

### Import / Export

**Q:** I'm exporting / moving data between environments. Will I lost all reactions?

**A:** No you won't lost anything. Reactions plugin is based on real relations (Polymorphic relations) and all the data should be exported / moved and re-indexed properly on your new environment.

_The only thing you might need to do after import is described below_ ⬇️

---

**Q:** I've imported data to the new instance and I'm not seeing reaction linked to my Content Types or they are wrong. What to do?

**A:** Most probably after the import unique identifiers of your Content Types has changed according to the new environment.

You might need to use one of special admin actions for the Reactions plugin like **"Synchronize associations"**. To get access to it, you must be **Super Admin** or have assigned **Settings: Admin permission** to any of your roles.

This is *not destructive* action and it just goes through all existing Reactions and update their search key according to linked Content Type UID and ID like `api::post.post:njx99iv4p4txuqp307ye8625`.

---

## 🤝 Contributing

Feel free to fork and make a Pull Request to this plugin project. All the input is warmly welcome!

1. Clone repository

```
   git clone git@github.com:VirtusLab-Open-Source/strapi-plugin-reactions.git
   ```

2. Run `install` & `watch:link` command

```ts
   // Install all dependencies
   yarn install

// Watch for file changes using `plugin-sdk` and follow the instructions provided by this official Strapi developer tool
   yarn watch:link
   ```

3. Within the Strapi project, modify `config/plugins.{js,ts}` for `imgix`

```ts
//...
'reactions': {
  enabled: true,
  //...
}
//...
```

4. Run your Strapi instance

## 👨‍💻 Community support

For general help using Strapi, please refer to [the official Strapi documentation](https://strapi.io/documentation/). For additional help, you can use one of these channels to ask a question:

- [Discord](https://discord.strapi.io/) We're present on official Strapi Discord workspace. Find us by `[VirtusLab]` prefix and DM.
- [Slack - VirtusLab Open Source](https://virtuslab-oss.slack.com) We're present on a public channel #strapi-molecules
- [GitHub](https://github.com/VirtusLab-Open-Source/strapi-plugin-reactions/issues) (Bug reports, Contributions, Questions and Discussions)
- [E-mail](mailto:strapi@virtuslab.com) - we will respond back as soon as possible

## 📝 License

[MIT License](LICENSE.md) Copyright (c) [VirtusLab Sp. z o.o.](https://virtuslab.com/) &amp; [Strapi Solutions](https://strapi.io/).

strapi-plugin-reactions

strapi-plugin-reactions 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

strapi-plugin-reactions

strapi-plugin-reactions 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README