/////////////////////////////////////////////////////////////// // // // X7 Chat Installation Instructions - Version 2.0.0 // // // /////////////////////////////////////////////////////////////// ********************* ***** Contents ***** ********************* 1) Requirements 2) Pre-Install 3) Installation Instructions 4) Post-Install ********************* *** Requirements *** ********************* It is recommend that you use an FTP client for uploading and changing permissions on files and directories. For assistance in obtaining and using an FTP client please visit http://help.x7chat.com. X7 Chat requires that you have a properly configured HTTP server which supports PHP Version 4.2.2* or higher. X7 Chat also requires some type of database server. X7 Chat provides built in support for the following database servers: - MySql 3.23.54* or higher; Additional modules may be available at http://x7chat.com that will allow you to use different database servers. Instructions for installing these should come with them. If you are unable to find a module for your database, you may also program your own database module for X7 Chat to use. Intermediate to advanced knowledge of PHP is required to do this. Support is not provided, but documentation is available at http://help.x7chat.com under the developer section. * X7 Chat may function properly with some lower versions but Tech Support will not be provided to people who do not meet these system requirements. ********************* *** Pre-Install **** ********************* X7 Chat will automatically detect XMB and configure itself to use the same database as XMB. If you are an experienced user you may configure X7 Chat to use a different database during installation. Creating a database beforehand is not necessary. ********************* *** Installation *** ********************* Follow these steps to install X7 Chat: Step 1) Upload all of the files and directories included with this download to your webserver. You should put them in a new directory on your server named something appropriate like "chat". This new directory *MUST* be directly inside the XMB directory. After uploading you need to be able to access the chat room by going to http://yoursite.com/XMBdirectory/x7chatdirectory/install.php. Everything should be uploaded in BINARY mode**. WARNING: If you do not create a new directory to upload the X7 Chat files to you will overwrite your XMB and your board WILL NOT FUNCTION. We are not responsible for damage to your board if you overwrite the XMB files with the X7 Chat files. Step 2) CHMOD 777* the following files and directorys: - /logs/ - /mods/ - /uploads/ - /config.php Step 3) Visit http://yourwebsite.com/XMBdirectory/x7chatdirectory/install.php. Of course you must replace "yourwebsite.com" with the actual address of your site, "/XMBdirectory" with the actual path to your board and "/x7chatdirectory" with the actual path to the directory that you uploaded X7 Chat to. The install.php file will guide you through the rest of the installation process. While running the installation file it will automatically configure itself to integrate with XMB, leave the default settings on step 1 in order for this integration to work properly. Step 4) Follow these directions if you would like to add a link to the chat room on your XMB. 1. Open the XMB file header.php 2. Find: -------------------------------------------------------------- // Stats-link -------------------------------------------------------------- 3. Replace with -------------------------------------------------------------- $links[] = "\"Chat\" Chat"; // Stats-link -------------------------------------------------------------- 4. In the code that you just added, find -------------------------------------------------------------- "./chat" -------------------------------------------------------------- 5. and change chat to the name of the directory that you put X7 Chat in. (Leave the ./) 6. Upload the file chat.gif (included with X7 Chat in the install.XMB directory) into the directory /images/onepoint9/ on your server. Don't forget to reupload the header.php file to your server. Step 5) If you would like to display the number of users in the chat room next to the chat link on your XMB, please follow the instructions in this step. 1. Open the XMB file header.php 2. Find: -------------------------------------------------------------- Chat -------------------------------------------------------------- 3. Replace with -------------------------------------------------------------- Chat ( ) -------------------------------------------------------------- 4. In the code that you just added, find -------------------------------------------------------------- "./chat" -------------------------------------------------------------- 5. and change chat to the name of the directory that you put X7 Chat in. (Leave the ./) 6. Don't forget to reupload the header.php file to your server. Note: The counter may not work on all servers, if it does not function correctly change the code back to the way it was before starting Step 6. Assistance) If you need assistance with these instructions please visit http://help.x7chat.com. * If using a Windows server then the file needs to be made writeable by everyone. After installation set the file so it is no longer writeable to everyone. ** This is usually the default setting for FTP programs. If you don't know how to change it then chances are its already on BINARY. Images and sound files that are included with X7 Chat will not work unless they are uploaded in BINARY mode. ********************* *** Post-Install *** ********************* After installation you MUST deleted the install.php file. If you do not anybody can get administrator access. For added security you may change the permissions on config.php to their former values.