///////////////////////////////////////////////////////////////
// //
// 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 MercuryBoard and configure itself to use the same
database as MercuryBoard. 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 MercuryBoard directory. After uploading
you need to be able to access the chat room by going to
http://yoursite.com/MercuryBoarddirectory/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 MercuryBoard and your board WILL NOT FUNCTION. We are not
responsible for damage to your board if you overwrite the MercuryBoard 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/MercuryBoarddirectory/x7chatdirectory/install.php.
Of course you must replace "yourwebsite.com" with the actual address of
your site, "/MercuryBoarddirectory" 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 MercuryBoard, 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 MercuryBoard.
1. Login to the MercuryBoard Admin Panel and click on "Edit HTML Templates"
under the Skins section. Click "Universal" and find the section
"Welcome Message - Logged In". Make the following changes to that section.
2. Find:
--------------------------------------------------------------
{$mercury->etable}
--------------------------------------------------------------
3. Replace with
--------------------------------------------------------------
| Chat |
{$mercury->etable}
--------------------------------------------------------------
4. In the code that you just added, find (it occurs twice)
--------------------------------------------------------------
"./chat"
--------------------------------------------------------------
5. and change chat to the name of the directory that you put X7 Chat in. (Leave the ./)
6. In the "Welcome Message - Logged In" box find each occurance of "20%" and change it to "16%". (occurs 6 times)
7. Click the "Edit Templates" button below the section to save the changes.
Step 5) If you would like to display the number of users in the chat room
next to the chat link on your MercuryBoard, please follow the instructions in this
step.
1. Login to the MercuryBoard Admin Panel and click on "Edit HTML Templates"
under the Skins section. Click "Universal" and find the section
"Welcome Message - Logged In". Make the following changes to that section.
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. Click the "Edit Templates" button below the section to save the changes.
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.