strapi-plugin-comments 2.0.0-beta.6 → 2.0.0

package/README.md

@@ -1,8 +1,11 @@
-# Strapi v4 - Comments plugin - BETA
-
-<p align="center">
+<div align="center" width="150px">
+  <img style="width: 150px; height: auto;" src="public/assets/logo.png" alt="Logo - Strapi Comments plugin" />
+</div>
+<div align="center">
+  <h1>Strapi v4 - Comments plugin</h1>
+  <p>Powerful Strapi based comments moderation tool for you and your users</p>
   <a href="https://www.npmjs.org/package/strapi-plugin-comments">
-    <img src="https://img.shields.io/npm/v/strapi-plugin-comments/latest.svg" alt="NPM Version" />
+    <img alt="GitHub package.json version" src="https://img.shields.io/github/package-json/v/VirtusLab-Open-Source/strapi-plugin-comments?label=npm&logo=npm">
   </a>
   <a href="https://www.npmjs.org/package/strapi-plugin-comments">
     <img src="https://img.shields.io/npm/dm/strapi-plugin-comments.svg" alt="Monthly download on NPM" />
@@ -13,15 +16,38 @@
   <a href="https://codecov.io/gh/VirtusLab-Open-Source/strapi-plugin-comments">
     <img src="https://codecov.io/gh/VirtusLab-Open-Source/strapi-plugin-comments/coverage.svg?branch=master" alt="codecov.io" />
   </a>
-</p>
+  <a href="https://sharing.clickup.com/tl/xhcmx-83/strapiv-4-comments-roadmap">
+    <img src="https://img.shields.io/website?down_message=roadmap&label=product&up_message=roadmap&url=https%3A%2F%2Fsharing.clickup.com%2Ftl%2Fxhcmx-83%2Fstrapiv-4-comments-roadmap" />
+  </a>
+  <a href="https://sharing.clickup.com/b/xhcmx-63/strapiv-4-comments-board">
+    <img src="https://img.shields.io/website?down_message=board&label=product&up_color=blue&up_message=board&url=https%3A%2F%2Fsharing.clickup.com%2Fb%2Fxhcmx-63%2Fstrapiv-4-comments-board" />
+  </a>
+</div>
+
+---
+
+<div style="margin: 20px 0" align="center">
+  <img style="width: 100%; height: auto;" src="public/assets/preview.png" alt="UI preview" />
+</div>
+
 
-A plugin for [Strapi Headless CMS](https://github.com/strapi/strapi) that provides end to end comments feature with their moderation panel, bad words filtering, abuse reporting and more.
+A plugin for [Strapi Headless CMS](https://github.com/strapi/strapi) that provides end to end comments feature with their moderation panel, bad words filtering, abuse reporting and much more.
 
-### Versions
-- **Stable** - [v1.0.4](https://github.com/VirtusLab-Open-Source/strapi-plugin-comments)
-- **Beta** - v4 support - [v2.0.0-beta.x](https://github.com/VirtusLab-Open-Source/strapi-plugin-comments/tree/feat/strapi-v4)
+## ✨ Features
 
-### ⏳ Installation
+- **Comments Public REST + GraphQL API:** Elegant, entirely customizable and a fully extensible admin panel.
+- **Strapi &amp; generic users:** Support for built-in &amp; also generic non-Strapi users that might be the comments authors.
+- **Any Content Type relation:** Comments can by linked to any of your Content Types by default. Simply, you're controlling it.
+- **Moderation Panel:** Search & Filter through the bucket with your auditory comments. Manage them by blocking single ones or full threads. All in combined list &amp; hierarchical tree view of threads.
+- **Automated Bad Words filtering:** By detault end users are not allowed to post abusing comments where bad words have been used.
+- **Abuse Reporting & Reviewing:** Don't allow inferior language, react to reports from your community, send email notifiactions about abuse reports
+
+## ⚙️ Versions
+
+- **Strapi v4** - (current) - [v2.x](https://github.com/VirtusLab-Open-Source/strapi-plugin-comments)
+- **Strapi v3** - [v1.x](https://github.com/VirtusLab-Open-Source/strapi-plugin-comments/tree/strapi-v3)
+
+## ⏳ Installation
 
 (Use **yarn** to install this plugin within your Strapi project (recommended). [Install yarn with these docs](https://yarnpkg.com/lang/en/docs/install/).)
 
@@ -46,7 +72,7 @@ The **Comments** plugin should appear in the **Plugins** section of Strapi sideb
 
 Enjoy 🎉
 
-### 🖐 Requirements
+## 🖐 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).
 
@@ -58,38 +84,37 @@ In our minimum support we're following [official Node.js releases timelines](htt
 
 **Supported Strapi versions**:
 
-- Strapi v4.0.5 (recently tested)
+- Strapi v4.0.7 (recently tested)
 - Strapi v4.x
 
-(This plugin is not working with v3.x and not may work with the older Strapi v4 versions, but these are not tested nor officially supported at this time.)
+> This plugin is designed for **Strapi v4** and is not working with v3.x. To get version for **Strapi v3** install version [v1.x](https://github.com/VirtusLab-Open-Source/strapi-plugin-comments/tree/strapi-v3).
 
 **We recommend always using the latest version of Strapi to start your new projects**.
 
-## Features
-
-- **Comments Public API:** Elegant, entirely customizable and a fully extensible admin panel.
-- **Strapi &amp; generic users:** Support for built-in &amp; also generic non-Strapi users that might be the comments authors.
-- **Any Content Type relation:** Comments can by linked to any of your Content Types by default. Simply, you're controlling it.
-- **Moderation Panel:** Search & Filter through the bucket with your auditory comments. Manage them by blocking single ones or full threads. All in combined list &amp; hierarchical tree view of threads.
-- **Automated Bad Words filtering:** By detault end users are not allowed to post abusing comments where bad words have been used.
-- **Abuse Reporting & Reviewing:** Don't allow inferior language, react to reports from your community, send email notifiactions about abuse reports
-
-## Configuration
+## 🔧 Configuration
 To setup amend default plugin configuration we recommend to put following snippet as part of `config/plugins.js` or `config/<env>/plugins.js` file. If the file does not exist yet, you have to create it manually. If you've got already configurations for other plugins stores by this way, use just the `comments` part within exising `plugins` item.
 
 
 ```js
-    ...
-    comments: {
-        badWords: false,
-        moderatorRoles: ["Authenticated"],
-        approvalFlow: ['api::page.page'],
-        entryLabel: {
-            '*': ['Title', 'title', 'Name', 'name', 'Subject', 'subject'],
-            'api::page.page': ['MyField'],
+    module.exports = ({ env }) => ({
+        //...
+        comments: {
+            badWords: false,
+            moderatorRoles: ["Authenticated"],
+            approvalFlow: ['api::page.page'],
+            entryLabel: {
+                '*': ['Title', 'title', 'Name', 'name', 'Subject', 'subject'],
+                'api::page.page': ['MyField'],
+            },
+            reportReasons: {
+                'MY_CUSTOM_REASON': 'MY_CUSTOM_REASON',
+            },
+            gql: { 
+              // ...
+            },
         },
-    },
-    ...
+        //...
+    });
 ```
 
 ### Properties
@@ -97,12 +122,38 @@ To setup amend default plugin configuration we recommend to put following snippe
 - `moderatorRoles` - Optional list of names of roles. Users with those roles will be notified by email when a new abuse report is created. This feature requires a built-in [Strapi email plugin](https://docs.strapi.io/developer-docs/latest/plugins/email.html) configured.
 - `approvalFlow` - list of Content Types which are supporting approval flow. Values must be in format like `'api::<collection name>.<content type name>'`. For not included, posted comments are going to be immediately visible. 
 - `entryLabel` - ordered list of property names per Content Type to generate related entity label. Keys must be in format like `'api::<collection name>.<content type name>'`. Default formatting set as `*`.
+- `reportReasons` - set of enums you would like to use for issuing abuse reports. Provided by default `'BAD_LANGUAGE'`, `'DISCRIMINATION'` and `'OTHER'`.
+- `gql` - specific configuration for GraphQL. See [Additional GQL Configuration](#additional-gql-configuration)
 
 ## Additional GQL Configuration
+All you need to do is to install and enable `@strapi/plugin-graphql` for you instance based on the **[official Strapi v4 docs](https://docs.strapi.io/developer-docs/latest/plugins/graphql.html#configurations)** and decide if you would like to call it by anyone (open for world) or only by authenticated users (Strapi users).
+
+```json
+  {
+    // ...
+    gql: {
+      auth: true, // Default: false
+    },
+    // ...
+  }
+```
+
+### Properties
+- `auth` - does GraphQL Queries should be authenticated or not? Default: `false`
 
-> To be done
+### Queries
 
-## RBAC
+See [available GQL specification section](#public-graphql-specification).
+
+>  If `auth` is set to `true` you must provide relevant authentication headers to all requests like for example:
+>  
+> ```json
+> {
+>  "Authorization": "Bearer <your token here>"
+> }
+> ```
+
+## 👤 RBAC
 Plugin provides granular permissions based on Strapi RBAC functionality.
 
 ### Mandatory permissions
@@ -116,9 +167,8 @@ Feature / Capability focused permissions:
 - _Plugins_ -> _Comments_ -> _Reports: Read_ - allows you to see the list of issued abuse reports against comments
 - _Plugins_ -> _Comments_ -> _Reports: Moderate_ - allows you to review (resolve) issued abuse reports against comments
 
-## Public API Comment model
+## Base Comment model
 
-### Generic (non Strapi User)
 ```json
 {
     "id": 1,
@@ -127,52 +177,31 @@ Feature / Capability focused permissions:
     "blockedThread": true,
     "blockReason": null,
     "authorUser": null,
-    "authorId": "207ccfdc-94ba-45eb-979c-790f6f49c392",
-    "authorName": "Joe Doe",
-    "authorEmail": "jdoe@sample.com",
-    "authorAvatar": null,
-    "createdAt": "2020-07-14T20:13:01.649Z",
-    "updatedAt": "2020-07-14T20:13:01.670Z",
-    "related": {}, // Related content type entity
-    "reports": [] // Reports issued against this comment
-}
-```
-### Strapi User
-```json
-{
-    "id": 1,
-    "content": "My comment content",
-    "blocked": true,
-    "blockedThread": null,
-    "blockReason": null,
-    "authorUser": {
-        "id": 1,
-        "username": "Sample User",
-        "email": "user@sample.com",
-        "provider": "local",
-        "confirmed": true,
-        "blocked": false,
-        "role": 1,
-        "created_at": "2020-07-10T08:38:03.157Z",
-        "updated_at": "2020-07-10T08:38:03.170Z"
+    "removed": null,
+    "approvalStatus": "APPROVED", // Only in case of enabled approval flow. Default: null
+    "author": {
+        "id": "207ccfdc-94ba-45eb-979c-790f6f49c392", // For Strapi users id reflects to the format used by your Strapi
+        "name": "Joe Doe", // For Strapi users it is equal to 'username' field
+        "email": "jdoe@sample.com",
+        "avatar": null,
     },
-    "authorId": null,
-    "authorName": null,
-    "authorEmail": null,
-    "authorAvatar": null,
     "createdAt": "2020-07-14T20:13:01.649Z",
     "updatedAt": "2020-07-14T20:13:01.670Z",
     "related": {}, // Related content type entity
     "reports": [] // Reports issued against this comment
 }
-
 ```
 
-## Public API specification
+## 🕸️ Public REST API specification
+
+**Strapi Users vs. Generic authors**
+> Keep in mind that if you're using auth / authz your requests to setup proper user contexts it has got higher priority in order to take author data comparing to `author` property provided as part of your payload.
 
 ### Get Comments
 
-`GET <host>/comments/api::<collection name>.<content type name>:<entity id>`
+*GraphQL equivalent: [Public GraphQL API -> Get Comments](#get-comments-1)*
+
+`GET <host>/api/comments/api::<collection name>.<content type name>:<entity id>`
 
 Return a hierarchical tree structure of comments for specified instance of Content Type like for example `Page` with `ID: 1`
 
@@ -180,25 +209,29 @@ Return a hierarchical tree structure of comments for specified instance of Conte
 
 **Example response body**
 
-```
+```json
 [
     {
-        -- Comment Model fields ---,
+        // -- Comment Model fields ---,
         children: [
             {
-                -- Comment Model fields ---,
-                children: [...]
+                // -- Comment Model fields ---,
+                children: [
+                    // ...
+                ]
             },
-            ...
+            // ...
         ]
     },
-    ...
+    // ...
 ]
 ```
 
 ### Get Comments (flat structure)
 
-`GET <host>/comments/api::<collection name>.<content type name>:<entity id>/flat`
+*GraphQL equivalent: [Public GraphQL API -> Get Comments (flat structure)](#get-comments-flat-structure-1)*
+
+`GET <host>/api/comments/api::<collection name>.<content type name>:<entity id>/flat`
 
 Return a flat structure of comments for specified instance of Content Type like for example `Page` with `ID: 1`
 
@@ -206,15 +239,15 @@ Return a flat structure of comments for specified instance of Content Type like
 
 **Example response body**
 
-```
+```json
 [
     {
-        -- Comment Model fields ---
+        // -- Comment Model fields ---
     },
     {
-        -- Comment Model fields ---
+        // -- Comment Model fields ---
     },
-    ...
+    // ...
 ]
 ```
 
@@ -224,7 +257,9 @@ Return a flat structure of comments for specified instance of Content Type like
 
 ### Post a Comment
 
-`POST <host>/comments/api::<collection name>.<content type name>:<entity id>`
+*GraphQL equivalent: [Public GraphQL API -> Post a Comments](#post-a-comment-1)*
+
+`POST <host>/api/comments/api::<collection name>.<content type name>:<entity id>`
 
 Posts a Comment related to specified instance of Content Type like for example `Page` with `ID: 1`
 
@@ -233,23 +268,25 @@ Posts a Comment related to specified instance of Content Type like for example `
 **Example request body**
 
 *Generic (non Strapi User)*
-```
+```json
 {
-    "author": {
-        "id": "<any ID like value>",
-        "name": "Joe Doe",
-        "email": "jdoe@sample.com",
-        "avatar": "<any image url>"
-    },
+  "author": {
+      "id": "<any ID like value>",
+      "name": "Joe Doe",
+      "email": "jdoe@sample.com",
+      "avatar": "<any image url>"
+  },
 	"content": "My sample response",
 	"threadOf": 2, // id of comment we would like to start / continue the thread (Optional)
 }
 ```
 
 *Strapi user*
-```
+
+> Author is taken directly from the request context
+
+```json
 {
-	"authorUser": 1, // id of a author user. Optional in case of 'enableUsers: true' in the plugin configuration
 	"content": "My sample response",
 	"threadOf": 2, // id of comment we would like to start / continue the thread (Optional)
 }
@@ -257,9 +294,9 @@ Posts a Comment related to specified instance of Content Type like for example `
 
 **Example response body**
 
-```
+```json
 {
-    -- Comment Model fields ---
+    // -- Comment Model fields ---
 }
 ```
 
@@ -269,7 +306,9 @@ Posts a Comment related to specified instance of Content Type like for example `
 
 ### Update Comment
 
-`PUT <host>/comments/api::<collection name>.<content type name>:<entity id>/comment/<commentId>`
+*GraphQL equivalent: [Public GraphQL API -> Update Comments](#update-comment-1)*
+
+`PUT <host>/api/comments/api::<collection name>.<content type name>:<entity id>/comment/<commentId>`
 
 Updates a specified Comment content based on it `commentId` and related to specified instance of Content Type like for example `Page` with `ID: 1`
 
@@ -278,28 +317,30 @@ Updates a specified Comment content based on it `commentId` and related to speci
 **Example request body**
 
 *Generic (non Strapi User)*
-```
+```json
 {
-    "author": {
-        "id": "<any ID like value>"
-    },
+  "author": {
+      "id": "<any ID like value>"
+  },
 	"content": "My sample response"
 }
 ```
 
 *Strapi user*
-```
+
+> Author is taken directly from the request context
+
+```json
 {
-	"authorUser": 1, // id of a author user. Optional in case of 'enableUsers: true' in the plugin configuration
 	"content": "My sample response"
 }
 ```
 
 **Example response body**
 
-```
+```json
 {
-    -- Comment Model fields ---
+    // -- Comment Model fields ---
 }
 ```
 
@@ -310,7 +351,9 @@ Updates a specified Comment content based on it `commentId` and related to speci
 
 ### Delete Comment
 
-`DELETE <host>/comments/api::<collection name>.<content type name>:<entity id>/<commentId>?authorId=<authorId>`
+*GraphQL equivalent: [Public GraphQL API -> Delete Comment](#delete-comment-1)*
+
+`DELETE <host>/api/comments/api::<collection name>.<content type name>:<entity id>/<commentId>?authorId=<authorId>`
 
 Deletes a specified Comment based on it `commentId` and related to specified instance of Content Type like for example `Page` with `ID: 1`.
 
@@ -318,9 +361,9 @@ Deletes a specified Comment based on it `commentId` and related to specified ins
 
 **Example response body**
 
-```
+```json
 {
-    -- Empty Response ---
+    // -- Empty Response ---
 }
 ```
 
@@ -329,9 +372,11 @@ Deletes a specified Comment based on it `commentId` and related to specified ins
 - `409` - Conflict. Occurs when trying to delete a non existing comment.
 
 
-### Report abuse in the Comment
+### Issue Abuse Report against specified Comment
 
-`POST <host>/comments/api::<collection name>.<content type name>:<entity id>/comment/<commentId>/report-abuse`
+*GraphQL equivalent: [Public GraphQL API -> Issue Abuse Report against specified Comment](#issue-abuse-report-against-specified-comment-1)*
+
+`POST <host>/api/comments/api::<collection name>.<content type name>:<entity id>/comment/<commentId>/report-abuse`
 
 Reports abuse in specified Comment content based on it `commentId` and related to specified instance of Content Type like for example `Page` with `ID: 1` and requests moderator attention.
 
@@ -339,20 +384,20 @@ Reports abuse in specified Comment content based on it `commentId` and related t
 
 **Example request body**
 
-```
+```json
 {
 	"reason": "<reason enum>",
 	"content": "This comment is not relevant"
 }
 ```
 
-*Available reason enums:* `OTHER`, `BAD_WORDS`, `DISCRIMINATION`
+*Available reason enums:* `BAD_WORDS`, `OTHER`, `DISCRIMINATION` (want more? See [configuration section](#configuration).)
 
 **Example response body**
 
-```
+```json
 {
-    -- Comment Abuse Report fields ---
+    // -- Comment Abuse Report fields ---
 }
 ```
 
@@ -360,22 +405,332 @@ Reports abuse in specified Comment content based on it `commentId` and related t
 - `200` - Successful. Response with reported abuse.
 - `409` - Conflict. Occurs when trying to report an abuse to a non existing comment.
 
-## Examples
+## 🕸️ Public GraphQL specification
+
+**Strapi Users vs. Generic authors**
+> Keep in mind that if you're using auth / authz your requests to setup proper user contexts it has got higher priority in order to take author data comparing to `author` property provided as part of your payload.
+
+**Testing**
+> To test all queries and understand the schemas use GraphQL Playground exposed by `@strapi/plugin-graphql` on `http://localhost:1337/graphql`
+
+### Get Comments
+
+*REST API equivalent: [Public REST API -> Get Comments](#get-comments)*
+
+**Example request**
+
+```graphql
+query {
+  findAllFlat(
+    relation: "api::page.page:1"
+    filters: { content: { contains: "Test" } }
+  ) {
+        id
+        content
+        blocked
+        threadOf {
+            id
+        }
+        author {
+            id
+            name
+        }
+    }
+}
+```
+
+**Example response**
+
+```json
+{
+  "data": {
+    "findAllFlat": [
+      {
+        "id": 3,  
+        "content": "Test",
+        "blocked": false,
+        "threadOf": null,
+        "author": {
+          "id": "123456",
+          "name": "Joe Doe"
+        }
+      },
+      // ...
+    ]
+  }
+```
+
+### Get Comments (flat structure)
+
+*REST API equivalent: [Public REST API -> Get Comments (flat structure)](#get-comments-flat-structure)*
+
+**Example request**
+
+```graphql
+query {
+  findAllInHierarchy(relation: "api::page.page:1") {
+    id
+    content
+    blocked
+    children {
+      id
+      content
+    }
+    threadOf {
+      id
+    }
+    author {
+      id
+      name
+    }
+  }
+}
+```
+
+**Example response**
+
+```json
+{
+  "data": {
+    "findAllInHierarchy": [
+      {
+        "id": 1,
+        "content": "Test",
+        "blocked": false,
+        "children": [
+          {
+            "id": 6,
+            "content": "Text to search for"
+          },
+          // ...
+        ],
+        "threadOf": null,
+        "author": {
+          "id": "123456",
+          "name": "Joe Doe"
+        }
+      },
+      // ...
+    ]
+  }
+}
+```
+
+### Post a Comment
+
+*REST API equivalent: [Public REST API -> Post a Comment](#post-a-comment)*
+
+**Example request**
+
+```graphql
+mutation createComment {
+  createComment(
+    input: {
+      relation: "api::page.page:1"
+      content: "Hello World!"
+      threadOf: 3
+      author: { id: "12345678", name: "John Wick", email: "test@test.pl" } # Optional if using auth / authz requests
+    }
+  ) {
+    id
+    content
+    threadOf {
+      id
+    }
+    author {
+      id
+      name
+    }
+  }
+}
+```
+
+**Example response**
+
+```json
+{
+  "data": {
+    "createComment": {
+      "id": 34,
+      "content": "Hello World!",
+      "threadOf": {
+        "id": 3
+      },
+      "author": {
+        "id": "12345678",
+        "name": "John Wick"
+      }
+    }
+  }
+}
+```
+
+### Update Comment
+
+*REST API equivalent: [Public REST API -> Update Comment](#update-comment)*
+
+**Example request**
+
+```graphql
+mutation updateComment {
+  updateComment(
+    input: {
+      id: 34
+      relation: "api::page.page:1"
+      content: "I've changed it!"
+      author: { id: "12345678" } # Optional if using auth / authz requests
+    }
+  ) {
+    id
+    content
+    threadOf {
+      id
+    }
+    author {
+      id
+      name
+    }
+    createdAt
+    updatedAt
+  }
+}
+```
 
-Live example of plugin usage can be found in the [VirtusLab Strapi Examples](https://github.com/VirtusLab/strapi-examples/tree/master/strapi-plugin-comments) repository.
+**Example response**
+
+```json
+{
+  "data": {
+    "updateComment": {
+      "id": 34,
+      "content": "I've changed it!",
+      "threadOf": {
+        "id": 3
+      },
+      "author": {
+        "id": "12345678",
+        "name": "John Wick"
+      },
+      "createdAt": "2022-01-26T07:45:35.978Z",
+      "updatedAt": "2022-01-26T07:47:44.659Z"
+    }
+  }
+}
+```
 
-## Contributing
+### Delete Comment
+
+*REST API equivalent: [Public REST API -> Delete Comment](#delete-comment)*
+
+**Example request**
+
+```graphql
+mutation removeComment {
+  removeComment(
+    input: { 
+      id: 33, 
+      relation: "api::page.page:1", 
+      author: { id: "12345678" } # Optional if using auth / authz requests
+    }
+  ) {
+    id
+    removed
+  }
+}
+```
+
+**Example response**
+
+```json
+{
+  "data": {
+    "removeComment": {
+      "id": 33,
+      "removed": true
+    }
+  }
+}
+```
+
+### Issue Abuse Report against specified Comment
+
+*REST API equivalent: [Public REST API -> Issue Abuse Report against specified Comment](#issue-abuse-report-against-specified-comment)*
+
+**Example request body**
+
+```graphql
+mutation createAbuseReport {
+  createAbuseReport(
+    input: {
+      commentId: 34
+      relation: "api::page.page:1"
+      reason: BAD_LANGUAGE
+      content: "Rude language"
+    }
+  ) {
+    id
+    reason
+    content
+    related {
+      id
+      author {
+        id
+        name
+      }
+    }
+  }
+}
+```
+
+*Available reason enums:* `BAD_WORDS`, `OTHER`, `DISCRIMINATION` (want more? See [configuration section](#configuration).)
+
+**Example response**
+
+```json
+{
+  "data": {
+    "createAbuseReport": {
+      "id": 28,
+      "content": "Rude language",
+      "reason": "DISCRIMINATION",
+      "related": {
+        "id": 34,
+        "author": {
+          "id": "12345678",
+          "name": "John Wick"
+        }
+      }
+    }
+  }
+}
+```
+
+## 🧩 Examples
+
+Live example of plugin usage can be found in the [VirtusLab Strapi Examples](https://github.com/VirtusLab/strapi-examples/tree/master/strapi-v4-plugin-comments) repository.
+
+## 🤝 Contributing
+
+<div>
+  <a href="https://sharing.clickup.com/tl/xhcmx-83/strapiv-4-comments-roadmap">
+    <img src="https://img.shields.io/website?down_message=roadmap&label=product&up_message=roadmap&url=https%3A%2F%2Fsharing.clickup.com%2Ftl%2Fxhcmx-83%2Fstrapiv-4-comments-roadmap" />
+  </a>
+  <a href="https://sharing.clickup.com/b/xhcmx-63/strapiv-4-comments-board">
+    <img src="https://img.shields.io/website?down_message=board&label=product&up_color=blue&up_message=board&url=https%3A%2F%2Fsharing.clickup.com%2Fb%2Fxhcmx-63%2Fstrapiv-4-comments-board" />
+  </a>
+</div>
 
 Feel free to fork and make a Pull Request to this plugin project. All the input is warmly welcome!
 
-## Community support
+## 👨‍💻 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. Look for @cyp3r and DM.
+- [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-comments/issues) (Bug reports, Contributions, Questions and Discussions)
+- [E-mail](mailto:strapi@virtuslab.com) - we will respond back as soon as possible
 
-## License
+## 📝 License
 
 [MIT License](LICENSE.md) Copyright (c) [VirtusLab Sp. z o.o.](https://virtuslab.com/) &amp; [Strapi Solutions](https://strapi.io/).