To add a feature-rich chat room to your Elgg, please refer to the following instructions.
Firstly, please download Elgg chat module, and uncompress the package.
Installation Level: Intermediate
Installation Time: ~5 Minutes
Then, copy: folder elgg_mod_for_123flashchat/123flashchat/
To: <elgg root directory>/mod/123flashchat
Secondly, activate the chat module.
Please login Elgg Admin Panel-> Configure-> Plugins
Click "Activate" button.
Thirdly, configure module
Please login Elgg Admin Panel-> Configure-> Settings-> 123 Flash Chat -> Chat Setting
1. Chat Server Mode
If you choose Chat Server Host By Your Own, please set Auth-URL by the instructions that mentions from the fourth step.
If you choose Chat Server Host By 123 Flash Chat, not only you need to set Auth-URL by the instructions that mentions from the fifth step, but also write your Chat Client Location.
Or you choose Chat server Host By 123 Flash Chat For Free, please fill in your chat room name. (If you leave room name as blank, the default room name's value will be your domain's name.)
2. The following data of the chat room can display on chat page to attract more users to join chatting.
Total rooms, total connections, online users
Chat room list
Online user list
The 2 types of data can be individually disabled to display if you need. And there is no show room list option in the free hosted mode.
3. Various chat clients and different open modes
You need to choose a chat client according to your need, as following:
Standard Chat (standard, with full features),
Html Chat (simple and neat)
Avatar Chat (with walking cartoon figures).
4. Change size, language and skin
You can change chat window size, language and a proper skin to match your website.
Multiple skins options are available:
5. Live show and profile Setting
Optional live show is available for paid users, and you can set the live show chat skin and the room whose chat content will be displayed in the home page.
Elgg profile can be integrated to the chat.
Forthly, integrate your chat with Elgg user database.
1. Elgg Admin Panel-> Configure-> Settings-> 123 Flash Chat-> Admin Panel, log in the chat Admin Panel ->System Settings-> Integrate Panel.
2. Server Settings-> Integration-> DataBase-> SELECT: URL-> edit.
3. Change URL
http://<elgg install directory>/modules/?r=123_flash_chat/login&username=%username%&password=%password%
4. Restart chat server at System Management -> Restart
The following image describes how auth-URL integration works.
The Auth-URL application will perform as the communicating medium of the chat server and the database, i.e.: in fact, when a user logs on a chat server, the server won't connect to the user database directly, instead, it will send the username and password to the Auth- URL. Then the Auth- URL requests the database to authenticate the user. Finally, the Auth- URL will return the feedback to the chat server in a predefined way, whether approved or declined.
Fifthly, if you want to show the chat information in every page, please do the following steps:
1. Modify file: <Elgg root directory>/views/default/page/layouts/ones_siderbar.php
Find:
<div class="elgg-sidebar">
<?php
echo elgg_view('page/elements/sidebar', $vars);
After add:
/* 123 FLASH CHAT CODE START */
require_once(elgg_get_plugins_path().'123flashchat/pages/123flashchat/sidebar.php');
require_once(elgg_get_plugins_path().'123flashchat/lib/functions.php');
global $CONFIG;
$queryguid = "SELECT * FROM objects_entity WHERE title = '123flashchat'";
$chatobject = get_data_row($queryguid);
$query = "SELECT * FROM private_settings WHERE entity_guid = $chatobject->guid";
$chatSettingarray = get_data($query);
foreach ($chatSettingarray as $key => $value)
$chatSetting = (object)$chatSetting;
echo getSideBar($chatSetting);
/* 123 FLASH CHAT CODE END */
2. Modify file: <Elgg root directory>/mod/123flashchat/pages/123flashchat/index.php
Find:
$sidebar = getSideBar($chatSetting);
Change it to:
//$sidebar = getSideBar($chatSetting);
$sidebar = '';
Integration done, enjoy your chat,
if you have any questions about chat room, please visit http://www.123flashchat.com/faq.html.
You can also send email to support@123flashchat.com, we offer free integration service for license buyer and yearly hosting buyer. |
