> For the complete documentation index, see [llms.txt](https://enginethemes.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enginethemes.gitbook.io/docs/qaengine/community-chat-box-plugin-v1.0.md).

# Community Chat Box Plugin V1.0

### Introduction

* Community Chat Box Plugin is a plugin allow the users to able to communicate realtime. It use Pusher library to push message instantly.
* Community Chat Box plugin can be only used for **ForumEngine Theme and QAEngine theme**.
* You need to register Pusher account and get API to make the plugin work.
* The messages will not be stored in database to avoid spam or crash the database.

#### Register Pusher

1. You access to this site for registering and get API Pusher information:

<https://pusher.com/>

2. Register account and confirm your email address
3. Click to create channel

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421a9bd2c0242f32c67350/file-E9wdCU86ii.png)

3. Fill the information for your app and click to create app button

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421acf260b8506bdffd0a4/file-9wJpYQKvol.png)

5. Click to app keys to get API information ( Note : Please store the API information in safe place )

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421b0c9887d43d29d3dd23/file-b00A3Etq9W.png)

#### Set up Plugin

Go to Chat Box Settings and enter the API information which you get from Pusher.

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421d0e260b8506bdffd0ae/file-Tkwe0ALMNU.png)

Please make sure that you enter the correct information.

**Channel name: you must avoid special character and should make it like a slug ( no space , no special character)**

You can also change the other settings:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421db0660767033b4c99e6/file-DE9kAK7Ooa.png)

For example : you must not offend other users , spam , spread bad news, scam,....

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421e07d2c0242f32c6735d/file-YuODGRHbfL.png)

You can also replace text with the built-in option:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421e22660767033b4c99e7/file-I9LakbmSZg.png)

Especially, you can change the color of the Chat Box with the available options:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/65421e62d2c0242f32c6735f/file-oYkpZauwNA.png)

**Add to header menu**

You can go to Appearance > Menus > Add items to header menu like this:

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/654af466398d235676f609c7/file-1kRkFTR2e4.png)

![](https://d33v4339jhl8k0.cloudfront.net/docs/assets/56c6e208c697915005a72a5f/images/654af495cd50485c29971296/file-DB5486mKmq.png)