react-rumbletalk

A React library for RumbleTalk group chats. Your platform for creating engaging messaging chat rooms for online events, web-site, platforms, and more.

Features

React compatibility
CSS Customization
Polls
Create multiple rooms
Video calls
Approve message mode (Q&A)
Backend agnostic
Voice and audio messages
Embed images, videos and files
Private messaging
Text formatting - bold, italic, strikethrough, underline, and code
Online / offline user status
Different themes
Embed directly into your website
Mute all

Installation

Using npm:

npm i react-rumbletalk

Setup

Import RumbleTalk to your application

import RumbleTalk from 'react-rumbletalk';

Component usage

Use this in any of your js/jsx or ts/tsx file where you would like to place the chat

Basic use

<RumbleTalk hash="chat-hash" width="{700}" height="{500}" />

Floating

<RumbleTalk
  floating
  hash="chat-hash"
  side="right"
  image="https://d1pfint8izqszg.cloudfront.net/images/toolbar/toolbar.png"
  counter="14:23"
/>

Option	Type	Default	Description
hash	string		The hash string which defines the chat to be loaded
width	number	700	Size of the width of the chat in pixels
height	number	500	Size of the height of the chat in pixels
floating	boolean	false	Displays the chat in a floating manner or else it is fixed
side	string	right	If floating is true, sets which side of the window will the floating chat be displayed, can only be either 'left' or 'right'
image	string	default image	If floating is true, sets the image used for the floating chat
counter	string	14:23	If floating is true, top:left coordinates of the counter/number of users in the chat

Service usage

These are the available methods you can use in the chat by importing the RumbleTalk file

Note: To use this feature, you need to create a reference to the RumbleTalk component by using this.ref = React.createRef() for class component or ref = React.useRef() for functional component and add it to the component like this ref={this.ref} or ref={ref}

Methods

login(data)

this.ref.current.login({
    hash: hash,
    username: username,
    password: password,
    callback: (response) => {
        ...
    }
});

Used to log into your chat

logout(data)

this.ref.current.logout({
  hash: hash,
  username: username,
});

Used to log out from your chat

logoutCB(data)

this.ref.current.logoutCB({
    hash: hash,
    username: username,
    callback: (reason) => {
        ...
    }
});

Used to execute a callback functino when the user logs out of the room

openPrivateChat(data)

this.ref.current.openPrivateChat({
  hash: hash,
  username: username,
});

Used to open a private chat with a specific user.