Before you upgrade…

You will need command line access (SSH) to run php commands for this upgrade process. 

Upgrading

1. Upload Gixaw Chat 2.5 to the same folder where version 2.0 of the chat is installed. Overwrite any duplicate files.

2. Once all files are uploaded, go to the command line and type the following command:
   php core/manage.php site/upgrade

3. Remove all existing files from the data/files and data/assets folder. 

Your chat is now upgraded to version 2.5! If you encounter any error, please feel free to contact us.

1. First you need to create a file called gixawremote_custom.php. It should contain your PHP code with the following flow:

<?php
require_once(realpath(dirname(__FILE__)).DIRECTORY_SEPARATOR.’gixawremote.php’);

if (/* user is not logged in */) {
    /*
       Show or redirect to the login form of your application.
       Once logged in, redirect the user back to the same url, with exactly same querystring.
       It’s important that querystring remains the same or return_to_gixaw function won’t work.
   */
}
else {
   /*
       User is logged in! We need to send it’s information back to
       Gixaw installation which sent us here.

      The $data array should have the information about the logged in user.
      The required keys are given below.
   */
    $data = array(
            ’external_id’ => $user_id,
            ’display_name’ => $nick_or_display_name,
            ’group_name’ => $group_name,
    );

    return_to_gixaw($data);
}

?>

Accepted keys for $data (array passed to return_to_gixaw function).

Required keys:

external_id - this is the integer or string used to uniquely identify this user, usually it would be the “id” field in your database table.
display_name - display name (or nick name) for this user
group_name - group name for this user, if your database does not store group names then it is advised to use Administrator for admin user, Moderator for the selected few and Member for the rest.

Optional keys:

profile_full_name - full name
profile_email_address - email address
profile_dob - date of birth
profile_gender - gender
profile_home_phone - home phone
profile_work_phone - work phone 

2. Upload it to anywhere on your web site where your application exists (e.g http://www.yourdomain.com/gixawremote_custom.php)
3. Log into the admin area of Gixaw Chat and open Membership > Integrations.
4. Click Enable Integrations (if not enabled already).
5. Add a new integration in the admin area and fill in the following details:
   1. Integration Name as anything you wish to.
   2. Integration URL as http://www.yourdomain.com/gixawremote_custom.php
   3. Integration Logout URL as http://www.yourdomain.com/
   4. Leave Integration Secret Key as it is.
   5. Integration Charset same as your charset of your site. If you’re not sure what it is, leave this blank.
6. Once created, click the Download link against the integration (in admin area) to download gixawremote.php file.
7. Upload gixawremote.php to the same directory where you uploaded gixawremote_custom.php.
8. In the Gixaw Chat admin area, click Make Default link against this integration.
    

Your integration is activated! Your members will automatically be logged into the chat now.

We also provide integration services to our customers. For any custom integrations, contact us.

Gixaw Chat can be seamlessly integrated with your vBulletin user database. Please follow the instructions below:

1. Download the vBulletin integration package.
2. Upload gixawremote_vb.php to your vBulletin forums directory.
3. Log into the admin area of Gixaw Chat and open Membership > Integrations.
4. Click Enable Integrations (if not enabled already).
5. Add a new integration in the admin area and fill in the following details:
   1. Integration Name as anything you wish to.
   2. Integration URL as http://www.yourdomain.com/forums/gixawremote_vb.php
   3. Integration Logout URL as http://www.yourdomain.com/forums/
   4. Leave Integration Secret Key as it is.
   5. Integration Charset same as your charset of vBulletin site. If you’re not sure what it is, leave this blank.
6. Once created, click the Download link against the integration (in admin area) to download gixawremote.php file.
7. Upload gixawremote.php to /forums vBulletin directory.
8. In the Gixaw Chat admin area, click Make Default link against this integration.
    

Your integration is activated! Your vBulletin members will automatically be logged into the chat now.

Gixaw Chat can be seamlessly integrated with your phpBB 3 user database. Please follow the instructions below:

1. Download the phpBB3 integration package.
2. Upload gixawremote_phpbb3.php to your phpbb3 forums directory.
3. Log into the admin area of Gixaw Chat and open Membership > Integrations.
4. Click Enable Integrations (if not enabled already).
5. Add a new integration in the admin area and fill in the following details:
   1. Integration Name as anything you wish to.
   2. Integration URL as http://www.yourdomain.com/forums/gixawremote_phpbb3.php
   3. Integration Logout URL as http://www.yourdomain.com/forums/
   4. Leave Integration Secret Key as it is.
   5. Integration Charset same as your charset of phpBB3 site. If you’re not sure what it is, leave this blank.
6. Once created, click the Download link against the integration (in admin area) to download gixawremote.php file.
7. Upload gixawremote.php to /forums phpBB3 directory.
8. In the Gixaw Chat admin area, click Make Default link against this integration.
    

Your integration is activated! Your phpBB 3 members will automatically be logged into the chat now.

Gixaw Chat can be seamlessly integrated with your Invision Power Board user database. Please follow the instructions below:

1. Download the IPB integration package.
2. Upload gixawremote_ipb.php to your invision power board directory.
3. Log into the admin area of Gixaw Chat and open Membership > Integrations.
4. Click Enable Integrations (if not enabled already).
5. Add a new integration in the admin area and fill in the following details:
   1. Integration Name as anything you wish to.
   2. Integration URL as http://www.yourdomain.com/forums/index.php?autocom=gixawremote_ipb
   3. Integration Logout URL as http://www.yourdomain.com/forums/
   4. Leave Integration Secret Key as it is.
   5. Integration Charset same as your charset of IPB site. If you’re not sure what it is, leave this blank.
6. Once created, click the Download link against the integration (in admin area) to download gixawremote.php file.
7. Upload gixawremote.php to /forums/sources/components_public directory.
8. In the Gixaw Chat admin area, click Make Default link against this integration.
    

Your integration is activated! Your invision power board members will automatically be logged into the chat now.

This guide assumes that your wordpress blog is installed at http://blog.yourdomain.com/. In any other case, please change this address to the URL where your wordpress is installed.

1. Download the wordpress integration package.
2. Upload gixawremote_wordpress.php to your wordpress directory. It should be accessible at http://blog.yourdomain.com/gixawremote_wordpress.php.
3. Log into the admin area of Gixaw Chat and open Membership > Integrations.
4. Click Enable Integrations (if not enabled already).
5. Add a new integration in the admin area and fill in the following details:
   1. Integration Name as anything you wish to.
   2. Integration URL as http://blog.yourdomain.com/gixawremote_wordpress.php
   3. Integration Logout URL as http://blog.yourdomain.com/
   4. Leave Integration Secret Key as it is.
   5. Integration Charset same as your charset of wordpress site. If you’re not sure what it is, leave this blank.
6. Once created, click the Download link against the integration (in admin area) to download gixawremote.php file.
7. Upload gixawremote.php to your wordpress directory. It should be accessible at http://blog.yourdomain.com/gixawremote.php.
8. In the Gixaw Chat admin area, click Make Default link against this integration.
    

Your integration is activated! Your wordpress members will automatically be logged into the chat now.

1. Download the joomla integration package.
2. Upload com_gixawremote_joomla folder to the “components” directory of your joomla.
3. Log into the admin area of Gixaw Chat and open Membership > Integrations.
4. Click Enable Integrations (if not enabled already).
5. Add a new integration in the admin area and fill in the following details:
   1. Integration Name as anything you wish to.
   2. Integration URL as http://www.yourdomain.com/index.php?option=com_gixawremote_joomla
   3. Integration Logout URL as http://www.yourdomain.com/index.php
   4. Leave Integration Secret Key as it is.
   5. Integration Charset same as your charset of joomla site. If you’re not sure what it is, leave this blank.
6. Once created, click the Download link against the integration (in admin area) to download gixawremote.php file.
7. Upload gixawremote.php to /components/com_gixawremote_joomla directory of your joomla.
8. In the Gixaw Chat admin area, click Make Default link against this integration.

Your integration is activated! Your joomla members will automatically be logged into the chat now.

Integration is supported with any third-party application, whether it is a popular CMS/bulletin board or a custom application. The profile information and user access level of members is also integrated. You may even integrate the chat if your membership database and Gixaw Chat are hosted on remote servers.

Integration is not only supported with software edition but also works great with hosted edition.

Please select the application you wish to integrate with:

1. Joomla
2. WordPress
3. vBulletin
4. phpBB 3
5. Invision Power Board

 If you wish to integrate with any other application, please contact us.

The following installation procedure assumes that the URL of the software will be www.example.com/chat

Before you upgrade…

Please make sure your web server meets the system requirements.

Pre-requisites

1. The “upload” folder in the gixaw chat zip file contains all the files that you need to upload to your web server in order to upgrade from version 1.0 to version 2.0.

   ALL the files and folders in the “upload” folder should be uploaded to your existing directory containing Gixaw Power Chat version 1.0 files. So e.g. if your current directory is located such as:
   /wwwroot/chat/
   /wwwroot/chat/index.php
   /wwwroot/chat/templates
   /wwwroot/chat/……….. etc,

   You should upload the files and folders in the Gixaw Chat 2.0 “upload” folder at
   /wwwroot/chat/*.*

   No files/folders will be over-written except index.php file. You should let the new index.php file replace the old one.

2. You can obtain your version 2.0 license file the following way:
   1. Log into the client area with your account.
   2. All the licenses files for your orders will be displayed on the home page. Download the one you’re looking for.
   3. Upload the license file in /data/licenses folder of the chat.

Upgradation

1. Make sure the following file permissions are met:

2. Path	Type	Permission
   /chat/data	Directory	0777
   /chat/data/assets	Directory	0777
   /chat/data/db	Directory	0777
   /chat/data/uploads	Directory	0777
   /chat/data/licenses	Directory	0777

3. Once the permissions are set, point your browser to http://www.example.com/chat/install/index.php
4. The installer will guide you through the rest of the process. If you are using MySQL as your database engine, please make sure you have the MySQL hostname, username, password and database name.

If you encounter any error, please feel free to contact us.