We've stopped the development and sale of AVChat on 1st of September 2018. Tech support has ended on 30 November 2018.
For similar products we recommend looking into WebRTC based alternatives like https://appear.in or TokBox Video Chat Embeds.
Outdated
Go to our new documentation at http://docs.avchat.net

Support Garage

Get Help With Your AVChat Products & Services

Getting started with vldPersonals and AVChat

The AVChat Extension for vldPersonals handles the integration between your vldPersonals web site and our AVChat software. Here's what it will do:

  • user name integration
  • profile url integration
  • profile image integration
  • placement of video chat within the web site (user and admin interface)
  • allows for different features for different vldPersonals member groups (by manually editing an external .php file).

If you cannot find the answer you’re looking for here, we encourage you to try our FAQ or forums. There's also more documentation regarding AVChat in the documentation area for the main standalone version.

All the specific documentation regarding vldPersonals is on this page so if you're looking for something specific just hit Ctrl+F on your browser.

Here are the vldPersonals related topics we will cover on this page:

1. Installing the AVChat Extension for vldPersonals

First you have to download 2 archives from the client/trial area on avchathq.com to your computer. These 2 archives are:

  • AVChat 3.0.zip (contains media server files for Red5/FMIS/Wowza and AVChat Standalone)
  • avchat3_vldpersonals2x_extension.zip (contains the integration files for vldPersonals)

Extract the 2 archives somewhere on your computer to have all the files handy! We will use files from both archives!

After you follow the installation instructions below, the first time you will log in the video chat you will be asked for a license key. That's in your private client/trial area.

Back to top

1.1 Setting up the avchat30 application on the media server

First you need to install the avchat30 app on your media server. If you don't know what a media server is check out the requirements. If you already have a media server (Red5, FMIS, FMIS hosting, Wowza) here's what you need to do:

Red5 installed on a dedicated server or VPS

Upload the avchat30 folder from the Files to upload to your media server (Red5) folder to the webapps folder of your Red5 installation (C:\Program Files\Red5\webapps on Win, /opt/red5/webapps/ on Linux)

Chmod the new avchat30 folder to 777.

Restart the Red5 server

You're done, move to step below

Wowza installed on a dedicated server or VPS

Upload the applications, lib and conf folders from the Files to upload to your media server (Wowza) folder to the root folder of your Wowza Media Server installation: C:\Program Files\Wowza Media Systems\Wowza Media Server Pro 1.7.2\ on my computer.

Restart the Wowza server

You're done, move to step below

AMS installed on a dedicated server or VPS

Upload the avchat30 folder (you will find it in your AVChat archive in the Files to upload to your media server (FMS) folder) to the applications folder of your FMIS installation (C:\Program Files\Macromedia\Flash Media Server\applications on Windows, /opt/macromedia/fms/applications/ on Linux)

Chmod the new avchat30 folder to 777

You're done, move to step below

Now that we've got that out of the way, let's move on to installing the AVChat Component on Joomla! 3.1, 3.0, 2.5, 1.7, 1.6, 1.5 and 1.0 .

Back to top

1.2 Installing the actual AVChat Extension for vldPersonals

  1. Login via FTP to your web site and copy the chat and includes folders from the avchat3_vldpersonals2x_extension.zip archive to your web site's root folder
  2. Copy templates/ext.avchat3.tpl file from the avchat3_vldpersonals2x_extension.zip archive to your templates/[YOUR_CURRENT_TEMPLATE_FOLDER]
  3. Now go to the folder where you unzipped the latest AVChat3 archive and copy all the content from Files to upload to your website to the chat folder that you just copied
  4. Open [your site root]/chat/avc_settings.xml in a text editor and set the value of
    <connectionstring>
       <value>rtmp://media-server-ip-address/avchat30/_definst_</value>
    </connectionstring>
  5. Chmod the uploadedFiles folder to 777 (otherwise the upload function might not work)
  6. Chmod the tokens folder(plugins/AVChat3/includes/tokens) to 777
  7. To add the Who's Chatting Block edit [your site root]/templates/[your template]/homepage.tpl (in our case, the template is the default one, webby2) and after:

    <div class="block blogs">
    {blogs:limit=5,cache_time=0}
    </div>
    <div class="clear"></div>


    add these lines:

    <h3>Users in video chat</h3>
    <div class="block">
    {avchat3:}
    </div>
  8. Edit [your site root]/includes/cp.php and add these code lines:
    case 'avchat3':
    $TEMPLATE->assign("active_module", "avchat3");
    include SYS_PATH . 'includes/cp/cp.avchat3.php';
    break;


    you can place the lines at the bottom of the script/page right before these lines:
    default:
    $TEMPLATE->assign("active_module", "members");
    include SYS_PATH . 'includes/cp/cp.dashboard.php';
    break;

  9. OPTIONAL STEP Adding a link to open the chat in the top menu (a link is already on the homepage).
    Open [your site root]/templates/[your template]/header.tpl (in our case, the template is the default one, webby2)

    and after:
    <!-- IF settings.enable_picture_rating -->
    <li>{anchor:url1="hotornot/",url2="index.php?m=hotornot",name="core|menu_rate"}</li><!-- ENDIF -->

    add this line:
    <li><a href="javascript:void(0);" onclick="window.open('{top.virtual_path}chat','FlashVideoChat', 'status=0,width=980,height=500')" title="Enter chat rooms">Enter chat rooms</a></li>
  10. Now lets add a link in the admin area. Open [your site root]/includes/templates/header.tpl (this is the header template for the admin area of vldPersonals) in a text editor and after this line:
    <td class="menuRow1_{ifelse:active_module,"settings","settings","general"}" nowrap><a class="menuRow1" href="{virtual_cp_path}index.php?m=settings">{lang:"core","menu_settings"}</a></td>
    add the following line of code:

    <td class="menuRow1_{ifelse:active_module,"avchat3","settings","general"}" nowrap><a class="menuRow1" href="{virtual_cp_path}index.php?m=avchat3">FlashVideoChatAdmin</a></td>

Back to top

2. Accessing the AVChat admin interface in vldPersonals

not yet implemented. coming soon

3. Location of AVChat files in a vldPersonals installation

All the AVChat Standalone files including language files, audio/video quality profile files, avc_settings.php and, well, everything else are on your vldPersonals web site in:

[your site root]/chat/

In there you will also find some special integration files like integration.php, these contain all the logic behind the integration! How they work is that they modify the default values in avc_settings.php depending on the logged in user/browser requesting them.

4. Opening up the video chat in a pop up

not yet implemented. coming soon

5. Placing ads around the video chat

Bummer, we're still writing this one...

6. vldPersonals's member groups and AVChat

vldPersonals ships with 6 member groups: Admins, Regular, Paid members, Guests, Pending and Canceled members.

To set up different features/limits for each members group on vldPersonals, follow the steps bellow.
Login via FTP to your web site and take a look at this file: [your site root]/chat/integration.php .

Starting with line 86 you will see this code:


switch ($member_group_id) {

   case 1: //Admins
      $avconfig['createRoomsEnabled'] = '1'; //can create rooms
   break;

   case 2: //Regular members
      $avconfig['createRoomsEnabled'] = '1'; //can create rooms
   break;

   case 3: //Guests
      $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
   break;

   case 4: //Pending members
      $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
   break;

   case 5: //Paid members
      $avconfig['createRoomsEnabled'] = '1'; //can create rooms
   break;

   case 6: //Canceled members
      $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
   break;

   default: //Guests
      $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
   break;

}

You can add there any feature/limit setting available in [your site root]/chat/avc_settings.xml independently for each member group!

By default the createRoomsEnabled feature is enabled for Admins, Regular and Paid members.

To add a new member group, you can follow these steps:

  1. Log into your vldPersonals Control Panel
  2. Go to Settings -> Member GroupsMember Groups in vldPersonals
  3. Click Add groupAdd Member Group in vldPersonals
  4. Enter the Name for the new member gropupAdd Member Group in vldPersonals
  5. Press Submit

After you create the new group, is time to tell AVChat about it.

  1. Log into your vldPersonals Control Panel and go to Settings -> Member Groups
  2. On the following page you will find a table with all the Member Groups. Locate the group that you have created and write down the ID.Member Groups in vldPersonals
  3. Login via FTP to your web site and open the file [your site root]/chat/integration.php, starting with line 96 you will see the code:
    switch ($member_group_id) {

       case 1: //Admins
          $avconfig['createRoomsEnabled'] = '1'; //can create rooms
       break;

       case 2: //Regular members
          $avconfig['createRoomsEnabled'] = '1'; //can create rooms
       break;

       case 3: //Guests
          $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
       break;

       case 4: //Pending members
          $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
       break;

       case 5: //Paid members
          $avconfig['createRoomsEnabled'] = '1'; //can create rooms
       break;

       case 6: //Canceled members
          $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
       break;

       default: //Guests
          $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
       break;

    }
  4. Add these code lines, replace MEMBER_GROUP_ID with your group id:
       case MEMBER_GROUP_ID: //custom group
          $avconfig['createRoomsEnabled'] = '1'; //can create rooms
       break;

    you can place the lines before these code:
       default: //Guests
          $avconfig['createRoomsEnabled'] = '0'; //can't create rooms
       break;

  5. Save the file on your website server.

7. Allowing guests (visitors) to join the video chat

By default the AVChat Extension for vldPersonals does not allow visitors of your web site to enter the video chat. Only signed in users are allowed in the video chat.

To allow visitors/guests to join the video chat login via FTP to your web site and edit at this file: [your site root]/chat/integration.php.

At the begining of the file you need to set the variable "allowVisitors" to 1 like this: $allowVisitors = 1;

Save the file and upload it back to your web site.

8. Changing the looks of AVChat to better fit your vldPersonals web site

Changing the design of AVChat is explained in detail in the documentation for the standalone version.

When working with the vldPersonals Extension keep in mind that AVChat is installed in [your site root]/chat/ so all the files you need to edit (like style.css for fonts and colors, avc_settings.php for the background image,) are there.

Also the HTML code used to embed the video chat throughout is in :
[your site root]/chat/index.php (and [your site root]/chat/admin.php for the admin interface) so if you want to change the size of the video chat in the html page (or the size of the popup window) or the background color this is the file you need to edit.

Get personalized help

Customers with an active support & updates plan can submit support requests through their private client area.

Enter client area

Support forums

Ask other customers for advice on features, customization and running a community in our peer-to-peer support forums.

Visit AVChat forum

Installation service

Should you need help installing the softare we can help you install both AVChat and the media server through our installation services.

Find out more