Table of Contents
- 1. Introduction
- 1.1. How it Works
- 2. Quick Start - Setup and Integration
- 3. Running Example
- 4. Configuration and Administration
Gigya's Chat plugin enables users to chat and share activities in real time, making it suitable for online live events. With the Live Chat plugin users can:
- Join the conversation - Users are able to see all comments made by any chat member, even if they are not signed in. The chat is refreshed every five seconds, adding real-time commentary to the webcast.
- Engage with friends from multiple social networks - The Chat plugin supports signing in with one or more major social network identities, enabling users to chat with their friends across networks.
- Share their activities to drive traffic and "Buzz" - Chat comments are shared as status updates to the users' social network feeds, helping to drive social referral traffic back to the live event, and generating event buzz. Status updates include a linkback to the event site and sites can track referral traffic from these updates.
This guide walks through the Chat plugin setup and integration and serves as a reference document for the configuration and customization options.
How it Works
The Gigya Chat plugin is a plug-and-play plugin that is hosted by Gigya on a Saas model. Gigya's server infrastructure can handle enormous scale, supporting events with hundreds of thousands of unique, concurrent users.
The Chat plugin is comprised of a user panel and two chat tabs:
- Top panel - enables users to sign in using social network accounts to begin chatting.
- Everyone tab - shows live chat items publicly shared by all chat users in the event. Users can choose whether they want to share their messages with everyone or just with their friends.
- My Friends tab - Shows the messages shared by friends from one or more social networks.
The default look of the Chat plugin (logged-out state):
The default look of the Chat plugin (logged-in state):
In the logged-in state, the user panel includes:
- User's profile picture and name.
- Chat input box, where the users enter their chat messages.
- Make public checkbox, which provides an option to share the messages with everyone or only with the user's friends.
- Update networks checkbox, which provides an option to share a posted comment to social networks. If the user is logged into one network, the checkbox will be specific for the network to which the user is logged in, like in this case, "Update Facebook", otherwise the checkbox will be "Update networks".
Connecting to Multiple Networks
- To chat, users need to first connect to at least one social network. Currently supported social networks include: Facebook, Twitter, Yahoo, LinkedIn.
- After a user connects to one social network he can choose to connect to additional networks. Messages written by the user are syndicated to all the social networks to which the user is connected.
Quick Start - Setup and Integration
This section is a quick integration guide. Follow the step below to integrate the Chat plugin with its default settings into your site.
The integration process includes two stages:
- Setting up a new chat configuration on Gigya's website.
Note: This step is necessary only when integrating the first instance of the Chat plugin in your site. When integrating more instances, you can reuse the same settings and jump to stage 2.
- Copying the generated code from Gigya's website and integrating the code into your site .
Setting Up a New Chat Configuration
Every Chat plugin instance is identified by a category ID, which defines the chat configuration. You may define a group of Chat plugin instances that share the same category ID, i.e. same chat configuration. You may define one or more chat configurations (category IDs) for your domain. Each chat configuration may have different settings, such as different skins. The settings are defined on the server side and may be administrated using the Chat Setup section of Gigya's website.
Follow the steps below to create a new Chat configuration:
- Go to the Chat Setup section of Gigya's website. Please make sure you are signed in. The Chat Setup page may also be accessed by clicking "Settings" in the upper menu and then "Chat Setup" in the left menu.
- Click the Add new chat button:
- Enter a new chat name and select whether to use default settings or copy the settings from an existing chat:
If you selected to copy chat settings from another site, the new chat will use the same settings as in the chosen chat.
- Click "OK". A new chat configuration is created. Notice the newly created row in the Chat table:
The "Chat Settings" button leads to an administration screen that lets you change the default settings of the chat configuration.
Integrating the Chat Plugin Generated Code into Your Site
The simplest and fasted way to integrate the Chat plugin in your site is to copy the "Embed code" from the Chat table and paste it into the <body> part of your web page in which you want the plugin to appear.
Parameters to Note
- categoryID- Notice the category ID parameter in line 5. This category ID was generated by Gigya and is a unique identifier for the group of Chat plugin instances that share the same chat configuration.
- streamID - The stream ID parameter (optional) identifies a chat stream within a certain chat configuration. The default is an empty string, meaning that there is a single stream with an empty identifier. Two Chat plugins instances that share the same category ID and stream ID will show the same chat stream. On the other hand, two Chat plugins instances that share the same category ID but have different stream IDs, will have the same chat configuration but different chat streams. Note: streamID is limited to 150 characters.
Configuration and Administration
If you go back to the the Chat Setup page, in the Chat table, in the new row that you have created, you will see a "Chat Settings" button. Clicking this button leads to the Chat Settings page. This page is an administration screen that lets you change the default settings of the chat.
You may change the settings as you choose and then save them by clicking the "Save changes" button at the bottom of the page. The changes are saved in Gigya's database and take effect immediately. No code changes are required. For a page that is already loaded, refresh the page to see the change.
The Chat Settings include:
Choose whether to display all messages or only from today, choose whether the chat is enabled or read only, enter a moderation username and password.
Choose the networks to display as login options and change the Login title if you wish.
Choose whether to show the "Public" tab, choose whether to show the "Make Public" checkbox, and if you do show the "Make Public" checkbox, select its default status.
Social Network Publishing
Choose whether to show the "Update Network" checkbox and its default status, choose the published message options, including a default textbox watermark, title, and link URL.
Choose whether to enable links in feeds. If checked, links in the chat feed will appear as html links and will open a new window with the link. Also whether to c
Blocking IP Addresses and Chat Users
Chat moderators can block a user from a chat, and that user will then be blocked from all chat categories currently open or that will be opened in the future. Chat moderators can also block a user by their IP address, so all their chat messages will automatically be blocked without going through the moderation process.
In order to block a user, go to the Configuration section of the Chat Settings page. If this is your first time moderating this chat, you have to enter a moderation username and password, and then click the "Save Changes" button at the bottom of the page. Then click the "Moderator link" and enter the username and password you selected.
In the moderator panel you may block specific users, delete the chat or block specific IP addresses:
- A deleted chat message will continue to appear in users' browsers until they refresh the page.
- By default, the moderator panel loads without a stream ID. If you use stream IDs for your chats, you can add the stream ID manually to the URL of the moderation panel. In the address box, replace the 0 in "streamID=0" with the relevant stream ID.
Blocked Twitter Users
You can also block Twitter users by clicking the Add Twitter User and entering a Twitter ID, which must be comprised of alphanumerics only:
You can set the chat's skin in the Skin Settings page in Gigya's console. Go the Settings tab of the console and then click the "Skin Settings" in the side menu:
In this section you can edit the default skin or create a new one.
To create a new skin, click the "New Skin" button and enter a name:
After you click OK, the new skin will appear in the table. You can select it from the table and click the "Edit" button:
When in edit mode, you can change any of the chat's skin details that are shown here:
Gigya offers you the option to manage a custom black list of words and phrases to be filtered in chats, and to block IP addresses. You can read more in the Site Restrictions section, or go directly to the Site Restrictions on Gigya's site.
Exporting Chat Logs
Chat messages for the last four months are stored on Gigya's servers and may be exported as CSV files and saved at any time. Go to the Admin section of Gigya's website, click Export Chat logs, specify the necessary information and click Create Log: