**************************************************************************
** dolphin 7.x: Web Portal System                                       **
** Module for 123 Flash Chat Server software                            **
** ==============================================                       **
**                                                                      **
** Copyright (c) by TopCMM 					        **
** Daniel Jiang (support@123flashchat.com)          			**
** http://www.topcmm.com						**
** http://www.123flashchat.com                                          **
** http://www.boonex.com/                                               **
**                                                                      **
**************************************************************************



####################################################################################################################
## Notes:                                                                                                         ##
##                                                                                                                ##
##     IMPORTANT!!!!                                                                                              ##
##     If you need to use the chat service on a local machine, before installing this module, please              ##
##     download 123FlashChat Server software first from this page:                                                ##
##     http://www.123flashchat.com/download.html                                                                  ##
##     You may get the latest free demo version of 123 flash chat server software at there.                       ##
##                                                                                                                ## 
##     And get professional support from: http://www.123flashchat.com/support.html                                ##
##     We provide online forum support, email support, online live support, and phone support                     ##
##     etc.                                                                                                       ##
##                                                                                                                ##
##     Good luck and have a nice day!                                                                             ##
##                                                                                                                ##
####################################################################################################################
## Before Adding This MOD To Your dolphin, You Should Backup All The Files Related To This MOD                    ##
####################################################################################################################


Step 1, Install module files to your dolphin:


        File Copy 

            copy 123flashchat.php                     to                  <dolphin installed directory>/123flashchat.php
            copy login_chat.php                       to                  <dolphin installed directory>/login_chat.php
            copy folder flashchatconf/                to                  <dolphin installed directory>/



Step 2, Add a 123 Flash Chat button in the dolphin admin panel

            1. OPEN: Dolphin Admin Panel -> Builders ->  Navigation Menu Builder;

            2. Create a NEWITEM -> click and set it:

               System Name  -> Vedio Chat 
               Language Key -> _flashchat
               Default Name -> Vedio Chat
               URL          -> 123flashchat.php
               
            3. Save it               

Step 3, Configure chat module's running mode:
        
        1). Please choose the running mode according to your needs.
             
            Configuration path:                       <dolphin installed directory>/flashchatconf/config.php

            Configure the following parameters:
                                                      $running_mode
            Configuration reference:
                                                      $running_mode = 1; (only 1 or 2 or 3)


        2). Configure the parameters of the running mode you chose.


            1. Chat server is hosted by your own ($running_mode = 1).
            
                 If your chat is hosted by your own, 123FlashChat server software should be installed at first, 
                 please download 123FlashChat:  http://www.123flashchat.com/download.html. 

               Configuration path:                    <dolphin installed directory>/flashchatconf/config_local.php

               Configure the following parameters:
                                                  
                                                      $chat_group
                                                      $primary_server_host
                                                      $primary_server_port
                                                      $client_location    (your client URL: http://your domain or ip/client/)
						      $client_size_width
                                                      $client_size_height
                                                      $swf_file_name (modification is not recommended)
                            
               Configuration reference:
                                                      $chat_group            =  "default";
                                                      $primary_server_host   =  "localhost";
                                                      $primary_server_post   =  "51127";



             2. Chat server is hosted by 123flashchat.com ($running_mode = 2).

                 If your chat is hosted by 123Flashchat.com, no 123FlashChat server software is needed to be installed; 
                 you may connect to your host chat room directly.
               
               Configuration path:                    <dolphin installed directory>/flashchatconf/config_host.php

               Configure the following parameters:

                                                      $client_location  (http://host*.123flashchat/your host ID/)
                                                      $client_size_width
                                                      $client_size_height


 
             3. Chat server is hosted by 123flashchat.com free of charge ($running_mode = 3).

                 If you need to use this service, no 123FlashChat server software is needed to be installed, 
                 we will provide you free chat room, and you can choose the room name as you want.
            
               Configuration path:                    <dolphin installed directory>/flashchatconf/config_free.php

               Configure the following parameters:

               Configure the following parameters:

                                                      $room_name 
						      $client_size_width
                                                      $client_size_height

               Configuration reference:
                                                      $room_name              =  "YourRoomName";
                                                      (If you leave $room_name as blank, the default $room_name's value will be your domain's name)






Step 4, Integrate your chat with dolphin user database

        Intor: If you choose running mode 1 or mode 2, integration is needed, you may achieve this by following the instructions below.

            1. Log in the Admin Panel of your 123FlashChat server
               OPEN: System Settings -> Integrate Panel
 
            2. Find: DataBase -> SELECT: URL -> edit 
      
            3. Change URL:
                 http://<dolphin install directory>/login_chat.php?username=%username%&password=%password%

            4. Press OK to save your setting.
   
