This guide will help you through the installation process and get CometChat running on your site.

Installation is very straight forward, only taking about 5 minutes from uploading the files to viewing the CometChat bar on your site.

Before you begin, you will need an FTP client, if you do not have one, you can download a free client like FileZilla.

You do not need programming knowledge to install CometChat, but a working knowledge of FTP functions is a plus.

This guide assumes that you have successfully downloaded the latest release of CometChat and have the zip file “unzipped” and ready to go. If not, you can download the package from the CometChat Client Area.

The instructions will term the zip file you downloaded as


At this point, you should have the zip archive and find a single folder- cometchat.

If you don’t know already, find out the folder in which phpBB is installed.

If you access your phpBB site via, then look for the webroot directory.

The webroot directory is usually public_html or www, but this varies from server to server so if you’re unsure, contact your hosting provider.

Using your FTP client, copy the /cometchat folder inside your phpBB folder. e.g.


Step 1

You should now run the installer file through your web browser by entering the URL into your browser’s address bar (if you have followed our example, type in, naturally substituting for your web address).

If the installation was completed successfully, you will receive the link for CometChat Admin Panel.

Also the page may display a list of files and folders which may require additional permissions. Please CHMOD those files/folders to 777.

Step 2

Login to CometChat Admin Panel and click on the Install CometChat tab. Follow the on-screen instructions and copy the code that you need to add to your site.

Docked Layout

If you using the Docked Layout, you need to edit your site template.

  1. Edit /Styles/STYLEFOLDERNAME/template/overall_header.html
  2. Immediately after the opening <head> tag add the copied HTML code:
<link type="text/css" href="/cometchat/cometchatcss.php" rel="stylesheet" charset="utf-8">
<script type="text/javascript" src="/cometchat/cometchatjs.php" charset="utf-8"></script>"

Don’t forget to login into the phpBB Administration Panel and under the General Tab, select the Purge Cache option to clear the cache.

Embedded Layout

If you are using the Embedded Layout, you can add the copied HTML code into any site page.

Step 1: Configuration

Step 1: Assign the following variables to includes->functions.php inside page_header() function

"CC_AVATAR" => $user->data["user_avatar"],
"CC_USERID" => $user->data["user_id"],

Step 2: Add the following code to styles -> -> template-> overall_header.html before tag

  var chat_name = "{S_USERNAME}";
  var chat_id = "{CC_USERID}";
  var chat_avatar = "{CC_AVATAR}";
  var chat_link = "{BOARD_URL}memberlist.php?mode=viewprofile&u={CC_USERID}";

Step 2: Add CometChat

Select a layout of your choice and click on “Add To Site” button to proceed.

  • Was this helpful?
  • Yes   No