********************************************
WOW BULLETIN BOARD INTEGRATION FOR FLASHCHAT
********************************************

This file describes the steps required to integrate FlashChat into a WOW Bulletin Board. The normal installation procedure, as described in the FlashChat readme.txt file, does NOT apply in this case.

YOU MUST FOLLOW THESE STEPS PRECISELY!


STEP 1:
Open the "common.php" file within the "inc" folder of your FlashChat distribution, and make sure that "wowCMS.php" is the ONLY uncommented line relating to CMS integration. I recommend that you use TextPad (www.textpad.com) as your plain text editor - NOT Windows Notepad or WordPad.

Thus, the common.php file will have something similar to this:

//include_once(INC_DIR . 'cmses/defaultCMS.php');
//include_once(INC_DIR . 'cmses/statelessCMS.php');
//include_once(INC_DIR . 'cmses/phpNukeCMS.php');
//include_once(INC_DIR . 'cmses/postNukeCMS.php');
//include_once(INC_DIR . 'cmses/xoopsCMS.php');
//include_once(INC_DIR . 'cmses/vbulletinCMS.php');
//include_once(INC_DIR . 'cmses/xmbCMS.php');
//include_once(INC_DIR . 'cmses/ipbCMS.php');
include_once(INC_DIR . 'cmses/wowCMS.php');

Thus, "//" appears before all the CMS references EXCEPT for the WOW reference. Double slashes are how programmers "comment-out" a line, thus deactivating it.

STEP 2:
On your web server, create a new folder called "FlashChat" as a sub-folder of the WOW directory (the directory that contains WOW's index.php file). Copy all of the files in the "chat" folder from the FlashChat distribution to the newly created FlashChat directory.

In other words, you should now have a folder called "FlashChat" which resides in the primary directory of WOW, and within the "FlashChat" directory you have that actual FlashChat files... for example:

.../upload/FlashChat/index.php
.../upload/FlashChat/install.php
.../upload/FlashChat/inc/
.../upload/FlashChat/sql/
.../upload/FlashChat/templates/
...etc for other files in the "chat" folder of your FlashChat distribution.

CHMOD the /FlashChat/inc/config.srv.php file to a world-writable format, like 777. This will ensure that the FlashChat installer can write configuration data to the config.srv.php file. If you are unsure of how to do this, please contact your website administrator.

STEP 3:
Using your web browser, open the .../FlashChat/install.php file, and accept the provided values. These values will probably look familiar to you since they should draw from your current WOW configuration. If the values do not look familiar, then go back to steps 1 & 2 and make sure that you have done those steps correctly.

If the values are correct, submit the form to create database tables that are required for FlashChat.

STEP 4:
Go back to the WOW folder on your web server

In the 'themes' directory, repeat 1) for each theme you have installed:

1) Open main_templates.txt, and find the following text:

    <SPAN DIR="$text_direction">$logged_in_as - <A CLASS="nummessages" HREF="$base_dir/pm.php?folder_id=100">$num_messages</A> &nbsp; [<A CLASS="nummessages" HREF="$base_dir/login.php?out=1">%logout</A>]</SPAN>

   Replace it with:

    <SPAN DIR="$text_direction">$logged_in_as - <A CLASS="nummessages" HREF="$base_dir/pm.php?folder_id=100">$num_messages</A> &nbsp; <A CLASS="nummessages" HREF="FlashChat/flashchat.php">FlashChat</A> &nbsp; [<A CLASS="nummessages" HREF="$base_dir/login.php?out=1">%logout</A>]</SPAN>


2) Open lib.php, and find the following text (near the end of the file):

	if (init())
	{
		if ((!defined("NO_LANGUAGE_FILES")) and (USER_LANGUAGE != LANGUAGE))
			require("languages/" . USER_LANGUAGE . "/lg_main.php");
		$TEMPLATES = extract_templates("themes/" . USER_THEME . "/main_templates.txt");
	} 

	Replace it with:

	if (init())
	{
		if ((!defined("NO_LANGUAGE_FILES")) and (USER_LANGUAGE != LANGUAGE))
			require("languages/" . USER_LANGUAGE . "/lg_main.php");
		$TEMPLATES = extract_templates(dirname(__FILE__)."/themes/" . USER_THEME . "/main_templates.txt");
	} 


Be very careful that you paste this text correctly, since this is a very easy place to introduce PHP syntax errors, which could make your WOW forum stop running.


STEP 5:
Close all instances of your web browser.

Then, restart your browser, and open the WOW main page. Upon logging in, you'll see the FlashChat link in the main Member Bar. Logging in as a standard WOW user will now auto-login to FlashChat, and logging into WOW as an Administrator or Moderator will auto-login to FlashChat as a chat moderator.


If you notice any errors in these steps, or have any suggestions for improvement, please post a message on the TUFaT.com support forum, located at http://www.tufat.com

Thank you for using FlashChat!