MGC Chatbox Evo 3.0.0 © Copyright 2008-2010
Readme
This mod can't be redistributed without the author authorization

Navigation
You wish to:
  1. Run a fresh install
    1. And import chats from another chatbox system >>
    2. Without importing chats >>
  2. Upgrade
    1. From the version 2.3.0 or newer >>
    2. From the version 1.0.0 up to 2.2.1 >>
    3. From a version prior to 1.0.0 >>
  3. Integrate the chatbox in IBProarcade >>
  4. Fix a display problem in one of your style [vB3] >>
  5. View the vBSeo rewrite rules for the chatbox >>
  6. Uninstall the chatbox >>
  7. View the copryright information >>
  8. Obtain more information or support >>

New install with importation of the chats from another chatbox system
Since the 2.0.0 version, it is possible to import chats from the following chatbox systems: Following are the instructions to follow in order to install the MGC Chatbox Evo while keeping the chats made by your users with another chatbox system on your forum:
  1. Upload the content of the Files folder in your forum root.
  2. Upload the content of the Images in each of your forum styles directories.
  3. Log into the admin control panel of your forum and import the product located in the Product folder.
  4. Go in the Download/Upload item of the Language manager menu and then:
    1. Select the English language file from the Lang folder.
    2. Select the forum language to overwrite.
    3. Set the Ignore language version option to YES.
    4. Launch the upload.
  5. The next step correspond to the import of the chats from another chatbox system:
    1. In the MGC Chatbox Evo menu of the admin control panel, click on the item Import scripts.
    2. Select one or multiples chatbox systems from which you want to import chats.
    3. Then click on Save to launch the import script.
    4. The script will run on standalone, just wait till it has finished.
  6. Once the import process is finished, you just have to set the permissions of your usergroups so that they can see the chatbox, configure the chatbox settings, manage the available commands and if necessary add channels.
  7. If you plan on using the option to display users number of chats in the postbit and/or in the profile, go in your admin control panel and run the update counter script from the chatbox menu in order that the older chats gets taken into account.

Fresh install without chats importing
Follow the following install instructions:
  1. Upload the content of the Files folder in your forum root.
  2. Upload the content of the Images in each of your forum styles directories.
  3. Log into the admin control panel of your forum and import the product located in the Product folder.
  4. Go in the Download/Upload item of the Language manager menu and then:
    1. Select the English language file from the Lang folder.
    2. Select the forum language to overwrite.
    3. Set the Ignore language version option to YES.
    4. Launch the upload.
  5. Installation is finished, you just have to set the permissions of your usergroups so that they can see the chatbox, configure the chatbox settings, manage the available commands and if necessary add channels.

Upgrade from the version 2.3.0 or newer
The upgrade instructions are the following:
  1. Upload the content of the Files folder in your forum root.
  2. Upload the content of the Images in each of your forum styles directories.
  3. Log into the admin control panel of your forum and import the product located in the Product folder.
  4. Go in the Download/Upload item of the Language manager menu and then:
    1. Select the English language file from the Lang folder.
    2. Select the forum language to overwrite.
    3. Set the Ignore language version option to YES.
    4. Launch the upload.
  5. You have succesfully upgraded your chatbox, you just have now to set the new permissions and options.
  6. If you plan on using the option to display users number of chats in the postbit and/or in the profile, go in your admin control panel and run the update counter script from the chatbox menu in order that the older chats gets taken into account.
  7. You are done.

Upgrade from the version 1.0.0 up to 2.2.1
The upgrade instructions are the following:
  1. Upload the content of the Files folder in your forum root.
  2. Upload the content of the Images in each of your forum styles directories.
  3. Log into the admin control panel of your forum and import the product located in the Product folder.
  4. Go in the Download/Upload item of the Language manager menu and then:
    1. Select the English language file from the Lang folder.
    2. Select the forum language to overwrite.
    3. Set the Ignore language version option to YES.
    4. Launch the upload.
  5. You have succesfully upgraded your chatbox, you just have now to set the new permissions and options.
  6. If you plan on using the option to display users number of chats in the postbit and/or in the profile, go in your admin control panel and run the update counter script from the chatbox menu in order that the older chats gets taken into account.
  7. To finish the upgrade, launch the script http://url_of_your_admincp/mgc_cb_evo.php?do=update_before_2.3.0 in your internet browser (replace url_of_your_admincp by the url of your admin control panel).

Upgrade from a version prior to 1.0.0
The changes introduced in the 1.0.0 version of the chatbox were far too deep, I thus have decided not to provide an import script for this version. As a consequence, you will be loosing all your chats while upgrading to this version.

The upgrade instructions are the following:
  1. In the products manager of the admin control panel, remove the two products of the chatbox (the basic one and the commands one).
  2. Upload the content of the Files folder in your forum root.
  3. Upload the content of the Images in each of your forum styles directories.
  4. Log into the admin control panel of your forum and import the product located in the Product folder.
  5. Go in the Download/Upload item of the Language manager menu and then:
    1. Select the English language file from the Lang folder.
    2. Select the forum language to overwrite.
    3. Set the Ignore language version option to YES.
    4. Launch the upload.
  6. You have succesfully installed the new version of the chatbox, you have to now set the usergroup permissions, options, commands and eventually create channels.
  7. If you plan on using the option to display users number of chats in the postbit and/or in the profile, go in your admin control panel and run the update counter script from the chatbox menu in order that the older chats gets taken into account.

Integration into IBProarcade
In order to display the chatbox on the IBProarcade pages, follow these instructions:
[vB3]
  1. In the admin control panel, go in the Display and positions of the chatbox.
  2. Activate the option Display the chatbox on defined pages in a var or Display the chatbox on defined pages below the navbar.
  3. In the pages list, add :



    and then validate.
  4. Open the arcade/functions/functions.php file and search for function do_output($output_array).
  5. After // add additional needed variables, add :



  6. Finally, if you are using te option to display the chatbox in a var, edit the ARCADE template and add :



    where you want the chatbox to appear.
[vB4]
  1. In the admin control panel, go in the Display and positions of the chatbox.
  2. Activate the option Display the chatbox on defined pages in a var or Display the chatbox on defined pages below the navbar.
  3. In the pages list, add :



    and then validate.
  4. In the templates list, add :



    and then validate.
  5. Finally, if you are using te option to display the chatbox in a var, edit the ARCADE template and add :



    where you want the chatbox to appear.

Display problem in some styles [vB3]
In some styles, you can encounter display problems because the chatbox uses an automatic insertion system in the templates based on specific variables that might not be present in your styles.

If you encounter such problems, follow these few steps (my example is based on the display of the chatbox at the bottom of the forum page but you can easily transpose it to another position causing problems):
  1. Go into the plugin manager of your admin control panel.
  2. Edit the plugin Chatbox display on forumhome.
  3. Replace $find = '$forumhome_markread_script';.
  4. By :



  5. Finally, go in the style manager and edit the FORUMHOME template.
  6. Add :



    before $footer.

Custom rewrite rules for vBSeo
Add the following rewrite rules for the chatbox in vBSeo :


Uninstall the chatbox
In order to correctly uninstall the chatbox, please follow carefully the following instructions:
  1. Remove the files of the chatbox in your forum folders.
  2. Remove the modifications you have done to the other forum templates for the chatbox.
  3. Uninstall the MGC Chatbox Evo product.
  4. Uninstall is now finished.

Information on the Copyright
In this version of the chatbox, a copyright now appears, you are not allowed to remove it! If you wish to obtain a branding free version, please visit: http://www.forumcoding.com

Further information
If you want to have more information on the chatbox, get newest version info, donwload button pack or even ask for support, feel free to visitu our forum: http://www.forumcoding.com