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 Joomla! and AVChat

The AVChat Integration Kit for Joomla! handles the integration between your Joomla! web site and the AVChat 3 video chat software.

Joomla! is the first CMS with which AVChat was ever integrated, and, to this day, it's the one we devote the most time to.

If you like our AVChat Integration Kits for Joomla! don't forget to rate them and review them in the Joomla! Extensions Directory.

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

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

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

1. Installation Instructions

First you have to download 2 archives from your private client/trial area on nusofthq.com to your computer. These 2 archives are

  • AVChat 3.0.zip (contains media server files for Red5/FMIS/Wowza and AVChat Standalone)
  • avchat3_joomla_integrationKits_UNZIPFIRST.zip (contains the 4 components: one for Joomla! 1.0, one for 1.5, one for Joomla! 1.6, 1.7 and 2.5 and one for Joomla! 3.x)

Extract the 2 archives somewhere on your computer. We will use files from both archives.

After installation, the first time you will log in the video chat you will be asked or a license key, it's in your 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 1.2 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 1.2 below

Now that we've got that out of the way, let's move on to installing the actual AVChat Component on Joomla!.

Back to top

1.2.1 Installing the AVChat Component on Joomla! 1.0

  1. Login to your Joomla! 1.0 administrator area (http://yourJoomla!WebSite.com/administrator/) and go to Installers -> Components.
  2. Click the Browse button and select the Joomla! 1.0 component zip file (com_avchat3.zip) and then click the Upload and Install button. You should see a success message.
  3. Now using a FTP program go to the /components/com_avchat3/ folder on your web server and put in there the contents of the folder named Files to upload to your web site from the AVChat 3.0.zip archive.
  4. Open /components/com_avchat3/avc_settings.xml in a text editor, and set the value of the connectionstring variable like this:
    <value>rtmp://mymediaserver.com/avchat30/_definst_</value>
    where mymediaserver.com is the domain name or IP of the server where your media server is installed.
  5. Chmod the uploadedFiles folder to 777 (otherwise the upload function might not work)
  6. Create a new folder tokens (components/com_avchat3/tokens) and CHMOD it to 777 (otherwise we might have token generation issues later on)
  7. Close the FTP program cause we don't need it anymore!
  8. Back in the Joomla!
  9. administrator area go to Components->AVChat 3->Login as Administrator into AVChat 3
  10. Type a user name, click [Connect], the video chat will connect to the media server. Once the connection succeeds you will be asked for the license key:
    license key request screen
    enter the key (it's in your client/trial area) and press [Submit]
  11. Now, that the component and video chat is install let's add a link to the video chat in one of the front end menus:
    1. Go to Menus -> Main Menu.
    2. Click on the NEW icon at the top right of the screen
    3. on the page that opens up select component from the top right list
    4. click the NEXT icon
    5. on the new page give the new menu item a name and select AVChat from the components list
    6. set the access level to Public (this controls who sees the chat link in the menu, visitors are still not allowed to join by default)
    7. click the SAVE icon at the top right of the screen.

    Now your members (and visitors, depending on the access level selected above) will see the new menu entry and that entry will take them to the video chat.

Back to top

1.2.2 Installing the AVChat Component on Joomla! 1.5

  1. Login to your Joomla! 1.5 administrator area (http://yourJoomla!WebSite.com/administrator/) and go to Extensions -> Install/Uninstall.
  2. Click the Browse button next to the Upload Package File file field and select the Joomla! 1.5 component zip file (avchat3_joomla_integrationKits_UNZIPFIRST\joomla1.5.x\joomla1.5.x_component\com_avchat3.zip) and then click the Upload File & Install button. You should now see a success message.
  3. Using a FTP program go to the Joomla! installation folder/components/com_avchat3/ on your web server and copy there the contents of the folder named Files to upload to your web site from the AVChat 3.0.zip archive.
  4. Open /components/com_avchat3/avc_settings.xml in a text editor, and set the value of the connectionstring variable like this:
    <value>rtmp://mymediaserver.com/avchat30/_definst_</value>
    where mymediaserver.com is the domain name or IP of the server where your media server is installed.
  5. CHMOD the /components/com_avchat3/uploadedFiles folder to 777 (otherwise the upload function might not work)
  6. Create a new folder tokens (components/com_avchat3/tokens) and CHMOD it to 777 (otherwise we might have token generation issues later on)
  7. Close the FTP program.
  8. Go back in the Joomla! 1.5 administrator area. Go to Components->AVChat 3->Login as Administrator into AVChat 3.
  9. Type a user name, click [Connect] , the video chat will connect to the media server. Once the connection succeeds you will be asked for the license key:
    license key request screen
    enter the key (it's in your client/trial area) and press[Submit]
  10. In order to add a link to the video chat in the front end menu, follow these steps:
    1. Go to Menus -> Main Menu.
    2. Click on the NEW icon button at the top right of the screen
    3. On the page that opens up in the Select Menu Item Type list click AVChat.
    4. Insert a name in the Title menu item and then click Save .
    5. In the Menu Item manager[mainmenu] select desired Access Level.
    6. Access Level controls who sees the chat link in the menu. Default is public but it can be changed by clicking on Public. Visitors are not allowed to join by default.
    7. Click the SAVE icon at the top right of the screen.

      Now your users (and visitors, depending on the access level selected above) will see the new menu entry and that entry will take them to a page in your web site with the AVChat video chat embedded.

Back to top

1.2.3 Installing the AVChat Component on Joomla! 1.6, 1.7 and 2.5

  1. Login to your Joomla! 1.6, 1.7, 2.5 administrator area (http://yourJoomlaWebSite.com/administrator/) and go to Extensions -> Extensions Manager.
  2. Click the Browse button and navigate to the location of the component: zip file (avchat3_joomla_integrationKits_UNZIPFIRST\ joomla1.6.x-2.5.x\ joomla1.6.x_1.7.x_2.5.x_component\ com_avchat3.zip and then click the Upload File & Install button. You should see a success message.
  3. In the Joomla! administration area go to: Components/Avchat 3. There is a warning about permissions and settings not being set. Click the Options button. In the AVChat General Settings-> RTMP Connection String set value to:
    rtmp://mymediaserver.com/avchat30/_definst_
    where mymediaserver.com is the domain name or the ip of the server where you have the media server installed and running.
  4. Chose Save and Close. This returns you to the AVChat 3 Admin interface. The previous message has now been replaced with a message that informs you the avchat files are missing.
  5. Using a FTP program, go to the Joomla! installation folder/components/com_avchat3/chat/ on your web server and place there the contents of the folder named Files to upload to your web site from the AVChat 3.0.zip archive.
  6. CHMOD the /components/com_avchat3/chat/uploadedFiles folder to 777 (otherwise the upload function might not work)
  7. Create a new folder tokens (components/com_avchat3/chat/tokens) and CHMOD it to 777 (otherwise we might have token generation issues later on)
  8. Close the FTP program.
  9. Return to the Joomla! Administration menu:Components->AVChat 3 and click Connect in the AVChat 3 tab. The video chat will connect to the media server. Once the connection succeeds you will be asked for the license key:
  10. license key request screen
    enter the key (it's in your client/trial area) and press [Submit].
  11. To add AVChat to the main menu follow these steps:
    1. In the admin area go to Menus->Main Menu-> Add new Menu Item
    2. In the menu Item Type field, click on the Select button
    3. A window will appear. Click on AVCHAT 3
    4. Add menu Title. Verify the status to be Published
    5. Select desire access level from the Acces list
    6. Click on Save & Close on the top menu.

    Now your users (and visitors, depending on the access level) will see the new menu entry and that entry will take them to a page in your web site with the AVChat video chat embedded.

  12. In order to set Permissions for each group here are a few basic steps to get you started:
    1. Go to Components->AVChat 3 Configuration->Permission tab
    2. As you see, all permissions are set to Inherited. This means that the particular user is not allowed to use that feature unless is part of SuperUsers group
    3. Most common users are Registered users. In order to allow them basic access to chat follow these simple steps:
      1. Set Allow Access to the Chat's User Interface to "Allowed"
      2. Set Allow Users to Join Other Rooms to "Allowed"
      3. Set Allow Users to Send Messages in Text Chat Area to "Allowed"
      4. Click on Save.
  13. Back to top

1.2.4 Installing the AVChat Component on Joomla! 3.x

  1. Login to your Joomla! 3.X administrator area (http://yourJoomlaWebSite.com/administrator/) and go to Extensions -> Extensions Manager.
  2. Click the Browse button and navigate to the location of the component: avchat3_joomla_integrationKits_UNZIPFIRST/joomla3.0.x-3.1.x/ joomla 3.0.x-3.1.x_component/ com_avchat3.zip
  3. Click the Upload & Install button. You should see a success message.
  4. Go to Joomla! 3.1 Administration Area: Components/Avchat 3/You should see a warning about permissions not being set. Click the Options button. In the AVChat 3 General Settings: RTMP Connection String, set value to: rtmp://mymediaserver.com/avchat30/_definst_ where mymediaserver.com is the domain name or the ip of the server where you have a media server installed and running.
  5. Chose Save and Close . This returns you to the AVChat 3 Admin interface. The previous message has now been replaced with a message that informs you the avchat files are missing.
  6. Using an FTP program, go to the Joomla! installation folder/components/com_avchat3/chat/ on your web server and copy there the contents of the folder named Files to upload to your web site from the AVChat 3.0 Build[no] archive.
  7. CHMOD the /components/com_avchat3/chat/uploadedFiles folder to 777 (otherwise the upload function might not work)
  8. Create a new folder tokens (components/com_avchat3/chat/tokens) and CHMOD it to 777 (otherwise we might have token generation issues later on).
  9. Close the FTP program.
  10. Return to the Joomla Administration menu: Components->AVChat 3 and click Connect in the AVChat 3 tab. The Video Chat will connect to the media server. Once the connection succeeds you will be asked for the license key:
  11. license key request screen
    enter the key (it's in your client/trial area) and press [Submit].
  12. To add AVChat to the main menu follow these steps:
    1. in the admin area go to Menus->Main Menu-> Add new Menu Item
    2. In the menu Item Type field, click on the Select button
    3. A window will appear. Click on AVCHAT 3
    4. Add menu Title. Verify the status to be Published
    5. Select desire access level from the Acces list
    6. Click on Save & Close on the top menu.

    Now your users (and visitors, depending on the access level selected above) will see the new menu entry and that entry will take them to a page in your web site with the AVChat video chat embedded.

  13. In order to set Permissions for each group here are a few basic steps to get you started:
    1. Go to Components->AVChat 3 Configuration->Permission tab
    2. As you see, all permissions are set to Inherited. This means that the particular user is not allowed to use that feature unless is part of SuperUsers group
    3. Most common users are Registered users. In order too allow them basic access to chat follow thse simple steps:
      1. Set Allow Access to the Chat's User Interface to "Allowed"
      2. Set Allow Users to Join Other Rooms to "Allowed"
      3. Set Allow Users to Send Messages in Text Chat Area to "Allowed"
      4. Click on Save.

Back to top

2. Accessing the AVChat admin interface in Joomla!

The AVChat admin interface allows you to kick and ban users, view private discussions, log in as hidden, close, open and delete rooms, change the license key, etc. .




For Joomla 1.6, 1.7, 2.5 and 3.x

The AVChat admin area can be acessed in both the Joomla! backend (Components-> AVChat) and in the frontend (Main Menu -> Video Chat) by users beloging to groups that have permisssion to access it.

Users from the Super User group (admin) always have access to it.

To grant access to other groups follow these steps:

    1. Login the Joomla! backend as a Super User
    2. Go to Components -> AVChat -> Options -> Permissions
    3. Click on the user group you want to grant access to
    4. Set to Allow the following permission " Allow access to the Chat's Admin Interface"
      Change permission to diferent user levels to access the admin interface of AVChat
    5. Press Save
    6. Now the Calculated Setting on the right should be set to Allowed
    7. That's it.


Please note that only users part of the Super Users can edit the AVChat permissions as instructed above.

Notes:
a) Even if the Super User gives permission for a user group to enter the Joomla! backend, that user group will not gain access to the AVChat admin interface. Such access can be given to him from the AVChat Component's Options menu by Super Users.


b) If you give a certain user group permission to access the admin area of AVChat, then he can access that through front-end and backend as well (if he has permissions to backend, of course).

c) BY default Managers and Administrators do not have access to the Components part of the backend so if given permission to acess the AVChat admin area they need to acess it trough the frontend OR they must be given permissions to acess the Components area in the backend.

Here is a tutorial on how to allow Managers and Administrators access to the Components area in the Joomla! backend and thus have access to the AVChat Component:

  1. Login as a Super User in the Joomla! backend area
  2. Go to Site -> Global Configuration -> Permissions
    Managing Joomla! user groups to view the AVChat Component in the Joomla! backend
  3. Click the Manager user group and set the Access Administration Interface permission to Allowed.
  4. The Administrators user group will automatically inherit the permission.
  5. Click Save
Now Managers and Administrators will have access to the AVChat Component in the Joomla! backend:
joomla 1.6 avchat3 admin menu

For Joomla 1.5

Joomla! 1.5 has 3 user groups (levels) for the administrators backend: Manager, Administrator and Super Users. Every user that belongs to one of those 3 user groups can access the AVChat admin area.

So, Super Administrators, Administrators and Managers can all access the AVChat Admin Interface by going to Components -> AVChat 3 -> Login As Administrator in to AVChat 3 .

Here's a screenshot of the menu:

logging in as administrator in AVChat

OK, but how can we limit their powers? We don't want Managers to be able to change the license key!

To do that (and this applies to all limitations) you need to:

  1. Login via FTP to your Joomla! web site
  2. Edit components/com_avchat3/ integration.php
  3. Find these lines of code:
    if ($user->get('gid') == '18'){
    //REGISTERED USERS permissions
    }else if ($user->get('gid') == '19'){
    //AUTHOR permissions
    }else if ($user->get('gid') == '20'){
    //EDITOR permissions
    }else if ($user->get('gid') == '21'){
    //PUBLISHER permissions
    }else if ($user->get('gid') == '23'){
    //MANAGER permissions
    }else if ($user->get('gid') == '24'){
    //ADMINISTRATOR permissions
    }else if ($user->get('gid') == '25'){
    //SUPER ADMINISTRATOR permission
    }
  4. and add $avconfig['adminCanAccessSettings']=0; in the MANAGER permissions block:

    }else if ($user->get('gid') == '23'){
    //MANAGER permissions
    $avconfig['adminCanAccessSettings']=0;
    }
  5. Save and update integration.php on your web server with the newly modified one.

$avconfig['adminCanAccessSettings']=1 means users (admins) logged in trough the admin interface can not access the Settings panel from where you can change the license key:
settings panel

You can do that for all the settings in avc_settings.php and for all 7 (fixed) user levels in Joomla! not just for the MANAGERS group. avc_settings.php also contains detailed explanations for each setting.

Back to top

3. Location of AVChat files in a Joomla! installation

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

Joomla 1.5 and 1.0: Joomla! installation folder/components/com_avchat3/

Joomla 1.6, 1.7, 2.5 and 3.x: Joomla! installation folder/components/com_avchat3/chat/

In those folders you will also find some special integration files like integration.php. These contain all the logic behind the integration. They modify the default values in avc_settings.php for some settings (profile URL, user name, permissions, etc.) depending on the logged in user/browser requesting them.

Back to top

4. Opening up video chat in a popup

There are two ways to open the AVChat Video Chat Component for Joomla! in a pop up:

4.1 METHOD 1 : Using Joomla!’s default method:

  • Log in the administrator area of Joomla!.
  • Go to Menus -> Main Menu
  • Edit the AVChat link
  • When editing the link, set the Target Window option to  New without Navigation (screenshot below)
  • Click Save.

editing the AVChat link in the menu

4.2 METHOD 2 : An awesome method that allows you to control the size of the pop up in Joomla 1.0-1.5:

  • Login to your web site via FTP and go to
    • /components/com_avchat3/avchat3.php (in Joomla! 1.0 or 1.5)
  • Find the object & embed HTML tags (highlighted with blue below in Joomla! 1.0):object and embed html code
  • And also highlighted with blue here for Joomla! 1.5:object and embed html code
  • And replace them (the entire blue area) with this HTML code:

    Joomla 1.0 and 1.5: <a href=”javascript:void(0);” onclick=”window.open(’/components/com_avchat3/index.html’, ‘AVChat’, ‘menubar=0, resizable =0, width=900, height=650′);”>Launch Video Chat</a>

  • Save the file and make sure you upload it back to the web server.

You can change the size of the pop up by editing the width and height properties in the html code above.

 

Back to top

5. Placing ads around the video chat

Placing ads around the video chat is simple. The video chat itself is actually a Flash .swf file embedded in a HTML file. In that HTML file you can place anything: links, images, AdWords ads, banners, etc. .

In the case of the AVChat Component for Joomla! the default HTML file embedding the index.swf file (main video chat file) is:

Joomla! 1.0 and 1.5:

Joomla installation folder/components/com_avchat3/avchat.php

Joomla! 1.6 and 1,7:

Joomla! installation folder/components/com_avchat3/views/avchat3/default.php

In the case you're using the open in pop-up solution method mentioned at point 4.2 above the HTML file to look for is:

Joomla! 1.0 and 1.5:

Joomla! installation folder/components/com_avchat3/index.html

Joomla 1.6, 1.7, 2.5 and 3.x:

Joomla! installation folder/components/com_avchat3/chat/index.html

So to add ads around your video chat in Joomla! 1.5:

  1. Connect to your web site using FTP
  2. Go to /components/com_avchat3/
  3. Edit or avchat.php with a text editor
  4. Place your ad code in it
  5. Save and upload back to web server

A little bit of HTML knowledge might be required tough to properly place the ads above, below or to the sides of the video chat.

Back to top

6. Joomla!'s user groups and limiting features for specific user groups

For Joomla! 1.6, 1.7, 2.5 and 3.x

Joomla! 1.6, 1.7, 2.5 and 3.x come with 10 default user groups and the possibility to add more:

Joomla! 1.6 default user groups

Each user in Joomla! 1.6, 1.7, 2.5 and 3.x must be part of at least one group. A user can be part of more than 1 group.

You can give access to chat admin interface for each user group, by selecting Allowed for the permission Allow Access to the Chat's Admin Interface. Super Users logged in the backend will have access to the admin interface (admin.swf).

joomla 1.6 allow avchat 3 admin

To limit powers for a certain user group you need to edit the permissions for the user group in the Permissions Tab:

joomla 1.6 allow avchat 3 admin

If you change a setting, it will apply to the active group and all child groups. If you're editing a child group the permissions set in the parent group might affect the permissions in the child group. The calculated final permission is in the "Calculated Setting" column. Here are the possible values for each setting and how they pass on to child groups:

  • Inherited means that the permissions from the parent group will be used.
  • Denied means that no matter what the parent group's setting is, the group being edited cannot take this action.
  • Allowed means that the group being edited will be able to take this action (but if this is in conflict with the parent group it will have no impact; a conflict will be indicated by Not Allowed (Locked) under Calculated Settings).

For example, if we want web site users part of the Registered user group (and all its child groups) to not be able to create rooms:

  • Login as administrator
  • Go to Components -> AVChat 3 -> Options -> Permissions -> Registered -> Allow users to create rooms -> Select Denied -> Click Save.
  • This screenshot is similar to what you will see when changing the above permission:

allow users to create rooms permission

Joomla! 1.5

There are 7 FIXED user groups in Joomla! 1.5, 3 for the administrators area and 4 for the public front end:

Administrator groups:

  • Managers
  • Administrators
  • Super Administrators

Public front end groups:

  • Registered
  • Author
  • Editor
  • Publisher

Each user in Joomla! 1.5 can only be part of one group!

When editing or adding a user in Joomla! 1.5 you can select the group he is part of:
joomla groups selection

Managers, Administrators and Super Administrators logged in the backend will have access to the admin interface (admin.swf). Limiting their admin features has been discussed at Chapter 2 above.

Registered, Authors, Editors and Publishers will have access to the user interface (index.swf). Limiting their features depending on the group the user belongs to is 100% similar to the way limitations work for admins.

For example, if we want web site users part of the Registered user group to not be able to create rooms:

  1. Login via FTP to your Joomla! web site
  2. Edit components/com_avchat3/ integration.php
  3. Find these lines of code:
    if ($user->get('gid') == '18'){
    //REGISTERED USERS permissions
    }else if ($user->get('gid') == '19'){
    //AUTHOR permissions
    }else if ($user->get('gid') == '20'){
    //EDITOR permissions
    }else if ($user->get('gid') == '21'){
    //PUBLISHER permissions
    }else if ($user->get('gid') == '23'){
    //MANAGER permissions
    }else if ($user->get('gid') == '24'){
    //ADMINISTRATOR permissions
    }else if ($user->get('gid') == '25'){
    //SUPER ADMINISTRATOR permission
    }
  4. and add $avconfig['createRoomsEnabled']=0; in the REGISTERED permissions block:

    }else if ($user->get('gid') == '18'){
    //REGISTERED permissions
    $avconfig['createRoomsEnabled']=0;
    }
  5. Save and update integration.php on your web server with the newly modified one.

$avconfig['createRoomsEnabled']=0; means users logged in trough the user interface will not have the option to create rooms.

You can do that for all the settings in avc_settings.php and for all 7 (fixed) user levels in Joomla! not just for the REGISTERED group. avc_settings.php contains detailed explanations for each setting.

Back to top

7. Allowing visitors to join the video chat and limiting their abilities

Allowing visitors to join the video chat in Joomla! (1.6, 1.7, 2.5 and 3.x)

By default the AVChat Component for Joomla! does not allow visitors of your web site to enter the video chat.

To allow visitors into the chat in Joomla! 1.6, 1.7, 2.5 and 3.x you have to:

  1. Login as a Super User (admin account) in the backend
  2. Go to Components -> AVChat 3
  3. Click on the Options button at the top right
  4. Go to the Permissions tab
  5. For the Public user group:
    • Set "Allow Access to the Chat's User Interface" to "Allowed" (see screenshot below)
    • Set "Allow Users to Join Other Rooms" to "Allowed"
    • Set "Allow Users to Send Messages in Text Chat Area" to "Allowed"
  6. Click SAVE

allow visitors to login into the chat

Visitors will now be able to join the video chat, enter any room and send text chat messages.

They will also have the option to choose their user name and gender before joining the video chat.

Limiting their abilities

The Public user group represents visitors and guests. From the above mentiones Permissions list you can enable or disable any feature for the Public user group.

For example to allow users to upload files to rooms set the "Allow users to Send Files to Rooms" to "Allowed" and press "Save".

You can even give them access to the admin area of AVChat :).

Allowing visitors to join the video chat in Joomla! 1.0 and 1.5

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

In order to allow visitors to access the chat follow these steps:

  1. Login via FTP to your Joomla! web site
  2. Edit components/com_avchat3/ integration.php
  3. Set $allowVisitors = 1; (it's on line 12)
  4. Save and upload integration.php back to the web server

Visitors will have the option to choose their user name and gender before joining the video chat.

Limiting their abilities in the video chat, in Joomla 1.0 and 1.5

Limiting what visitors can do in the video chat is done pretty much the same way you limit the abilities of admins and members.

For example if I want to limit the amount of free video time/ day (freeVideoTime var in avc_settings.php) to 3600 seconds/day I do the following:

  1. Login via FTP to your Joomla! web site
  2. Edit components/com_avchat3/ integration.php
  3. Find these lines of code (they're at the bottom, this is the block of code which contains the limits for visitors):
    else if ($allowVisitors){
    //Allow access to visitors
    $avconfig['username']='';
    $avconfig['changeuser']=1;
    $avconfig['loginPageURL'] = JPATH_BASE;
    ...
    } ;

  4. and add $avconfig[freeVideoTime]=3600; above $avconfig['username']=''; like this:

    else if ($allowVisitors){
    //Allow access to visitors
    $avconfig[freeVideoTime]=3600;
    $avconfig['username']='';
    $avconfig['changeuser']=1;
    $avconfig['loginPageURL'] = JPATH_BASE;
    ...
    } ;
  5. Save and update integration.php on your web server with the newly modified one.

The same process applies to all the variables in avc_settings.php. Remember, the values of variables in avc_settings.php are the default ones and they can and are overwritten by the values set trough integration.php.

Back to top

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

Changing the size of AVChat:

Joomla! 3.x & Joomla! 1.6, 1.7, 2.5:

    Pop-Up mode:
  1. Go to Components->AVChat3->Options->AVChat3 Open Method
  2. In the Popup Height text field insert desired height
  3. In the Popup Width text field insert desired width
  4. Click on Save & Close button.

    Embed mode:
  1. Using an FTP program, go to Joomla! installation folder-> components-> com_avchat3-> views-> avchat3-> tmpl-> default.php
  2. Open the file in a text/php editor
  3. Go to line that starts with swfobject and after myContent are two default values that can be changed:
    1. 100% that represents the width
    2. 600 that represents the height

    Joomla 1.5 Embed Mode:

  1. Using a Using an FTP program, Go to Joomla! installation folder-> components-> com_avchat3->avchat3.php
  2. Open the file in a text/php editor
  3. Go to line that starts with swfobject and after myContent are two default values that can be changed:
    1. 100% that represents the width
    2. 600 that represents the height
  4. Changing the AVChat's background color:

    Using a FTP client, go to:
  5. In Joomla! 3.x & Joomla 1.6, 1.7, 2.5: Joomla!_Install_Directory-> components-> com_avchat3->views-> avchat3-> tmpl-> default.php
  6. In Joomla! 1.5: Joomla!_Install_Directory-> components-> com_avchat3->avchat3.php
  7. Open the file in a text/php editor

  8. Search for bgcolor and enter the value you want.
  9. Editing the Popup Button Image field in Joomla! 3.x & Joomla! 1.6, 1.7, 2.5

    By default Joomla! 3.x & Joomla! 1.6, 1.7, 2.5, when opening in popup mode, displays a text link in the frontend in order to access the AVChat window. But it can be set to display an image of your chosing instead of the link. This can be accomplished in the following manner:

    1. Using a FTP application upload your image to your Joomla! installation. I recommend using the same folders AVChat uses in order to avoid possible path problems.
    2. Go to Joomla! backend => Components => AVChat 3
    3. Click on the Options button, go to AVChat 3 Open Method tab
    4. In the field Popup Button Image URL insert the absolute path to the image you want to display.
    5. If the image you want to use as a link instead of the text link is located in the chat folder, simply insert this line in the field:
      • components/com_avchat3/chat/yourimagename.jpg
    6. Click the Save & Close button.

    In order to modify the dimensions of your image, follow these steps:
    1. Using a FTP program navigate to the following file:
    2. Joomla!_Install_Directory-> components-> com_avchat3->views-> avchat3-> tmpl-> default.php
    3. Open the file in a php/text editor
    4. Search for img
    5. In the same line find the width="" and height=""
    6. Insert the values you want inside the quotes
    7. Save and exit the file.

    For further customization of the AVChat design, you can find here all the details you need.

Back to top

9. Who's Chatting Module for Joomla! 1.5

In the avchat3_joomla_integrationKits_UNZIPFIRST.zip archive, under joomla1.5.x you will also find a folder named joomla1.5.x_whos_chatting_module . It contains an archive named mod_avchat3.zip.

It's a module for your Joomla! 1.5 web site that shows in the side bar a list of the users online in the video chat at that time.

To install it:

  1. Log in to your Joomla! 1.5 administrators area and
  2. Go to Extensions -> Install/Uninstall .
  3. In the Upload Package File area browse for mod_avchat3.zip
  4. Click Upload File & Install (you should now get a success message: Install Module Success).
  5. Now go to Extensions -> Module Manager, you should see the Who is chatting now? module in the list.
  6. Enable it by clicking the big red X sign:joomla who's chatting module activation
  7. Done, now it will show up on your web site:Who's online module in Joomla! 1.5 web site

When using the JomSocial, Community Builder or EasySocial component the list will also show the profile pictures of the users and a link to their profile.

If you want to play with the code or change the looks of the module , the module files (after installation) are in modules/mod_avchat3 with the most important file being modules/mod_avchat3/tmpl/default.php as it controls the HTML code used to display the list of users.

This module uses the external users list generated by AVChat, so you need to login as a user in the video chat trough the front end of Joomla! before the Who's Chatting Module will start showing who's online.

Back to top

10. Who's Chatting Module for Joomla! 1.6, 1.7, and 2.5

In the avchat3_joomla_integrationKits_UNZIPFIRST.zip archive, under joomla1.6.x-2.5.x you will also find a folder named joomla1.6.x_1.7.x_2.5.x_mod_avchat3online. It contains an archive named mod_avchat3online.zip.

It's a module for your Joomla! 1.6, 1.7, or 2.5 web site that shows in the side bar a list of the users online in the video chat at that time.

To install it:

  1. Log in to your Joomla! 1.6, 1.7 or 2.5 administrator area and
  2. Go to Extensions -> Extension Manager .
  3. In the Upload Package File area browse for mod_avchat3online.zip
  4. Click Upload& Install (you should now get a success message: Install Module Success).
  5. Now go to Extensions -> Module Manager, you should see the Video Chat online users module in the list.
  6. Enable it by clicking the big red circle sign:joomla who's chatting module activation
  7. Once activated, click on its name. The module edit form will appear.
  8. First thing to do is select the position on page. Click on select position an choose from the list where you want the module to be displayed
  9. Choose who you want to have access to it
  10. Scroll the page and choose the pages you want to be displayed in.
  11. Click Save & Close
    Joomla! 1.6 module edit form
  12. Done, now it will show up on your web site:
    Who's online module in Joomla! 1.6 web site

Back to top

11. Who's Chatting Module for Joomla! 3.x

In the avchat3_joomla_integrationKits_UNZIPFIRST.zip archive, under joomla 3.0.x-3.1.x you will also find a folder named joomla3.0.x_mod_avchat3online. It contains an archive named mod_avchat3online.zip.

It's a module for your Joomla! 3.x web site that shows in the side bar a list of the users online in the video chat at that time.

To install it:

  1. Log in to your Joomla! 3.x administrator area and
  2. Go to Extensions -> Extension Manager .
  3. In the Upload Package File area browse for mod_avchat3online.zip
  4. Click Upload& Install (you should now get a success message: Install Module Success).
  5. Now go to Extensions -> Module Manager, you should see the Who's online in chat module in the list. Click on it
  6. Enable it by clicking on the Published button
  7. Now you have to select the position on page. Click on select position an choose from the list where you want the module to be displayed.We recommend position-7 since it represents the right column in the default Joomla! template (protostar).
  8. Choose who you want to have access to it
  9. Now move to the Menu Assignement tab and choose the pages you want to be displayed in.
  10. Click Save & Close
  11. Done, now it will show up on your web site:
    Who's online module in Joomla! 1.6 web site

Back to top

12. Logged in Users Module for Joomla! 1.6, 1.7 or 2.5

In the avchat3_joomla_integrationKits_UNZIPFIRST.zip archive, under joomla1.6.x-2.5.x you will also find a folder named joomla1.6.x_1.7.x_2.5.x_mod_avchat3status. It contains an archive named mod_avchat3status.zip.

It's a module for your Joomla! 1.6, 1.7 and 2.5 web site that shows in the administrator status bar the number of users online in the video chat at that time.

To install it:

  1. Log in to your Joomla! 1.6, 1.7 or 2.5 administrator area and
  2. Go to Extensions -> Extension Manager .
  3. In the Upload Package File area browse for mod_avchat3status.zip
  4. Click Upload& Install (you should now get a success message: Install Module Success).
  5. Now go to Extensions -> Module Manager, you should see the mod_avchat3status module in the list.
  6. Enable it by clicking the big red circle sign.
  7. Once activated, click on its name. The module edit form will appear.
  8. First thing to do is select the position on page. Click on select position an choose from the list the status position.
  9. Click Save & Close
  10. Done, now it will show up on your administrator area of your web site:
    Who's online module in Joomla! 1.6 web site administrator area

Back to top

13. How to update AVChat files on an existing Joomla! (1.6-3.x) installation

We make new versions of AVChat independently from the Joomla! integration kits, that's why it's necessary to update the AVChat and not the integration kit. Here's how to do it:

  1. Connect through FTP to your Joomla! website.
  2. Navigate to components\com_avchat3\chat
  3. Upload the contents of the folder "Files to upload to you website" from the AVChat delivery archive into the above folder(components\com_avchat3\chat). Overwrite all files.
  4. Done!

Note: New versions of AVChat also come with media server files so you must update those too! Just overwrite the old ones with the new ones.

Back to top

14. How to update the AVChat Component files on an existing Joomla! (1.6-3.x) installation

We make new versions of the AVChat Component independently from the actual AVChat software, that's why it's necessary to update the component and not the AVChat software itself. Here's how to do it:

  1. Login as Super Admin in your Joomla! backend.
  2. Go to Extensions -> Extension Manager (Install tab)
  3. Click Chose File
  4. Browse your computer for the new AVChat Component for Joomla! archive
  5. Click on Upload & Install
  6. A blue success message will show up.
  7. Go to Components -> AVChat -> Options
  8. Make sure all your permissions and settings are correct!
  9. Click on Save and Close
  10. Done!

Back to top

15. Editing gender icons

In order to edit gender icons go to:

  • Joomla! 3.x & Joomla 1.6, 1.7, 2.5: InstallationDirectory/components/com_avchat3/chat/genders.xml
  • Joomla! 1.5: InstallationDirectory/components/com_avchat3/genders.xml
  • Open the file in a text/xml editor

    Here is a basic guide that will help you understand how to modify the file:

  • gender id ="": Here we set the gender id
  • label = "" : The label is the name that will be visible in AVChat
  • iconUrl"gender_icons/yournewicon.png": here we set the path to your new icon.
  • adminOnly="": Can have two values: false means is available for public, true means that is for admin only
  • sortPriority="": Specifies the level of priority for the new gender.

Back to top

16. Editing Faceboook login in chat window

Facebook is by default enabled. In order to disable it, follow this steps:
  • Joomla! 3.x & Joomla! 1.6, 1.7, 2.5:
  • Using a FTP client, go to Joomla!_Install_Directory->components->com_avchat3->chat->avc_settings.xml
  • Open the file in a text/xml editor
  • Search for enableOtherAccountOptions title
  • In the value field replace 1 with 0
    • Joomla! 1.5:
  • Using a FTP client, go to Joomla!_Install_Directory->components->com_avchat3->avc_settings.xml
  • Open the file in a text/xml editor
  • Search for enableOtherAccountOptions title
  • In the value field replace 1 with 0
  • Back to top

    17. Allow users to login with their Facebook account on Joomla! 1.6-2.5 and 3.x

    By default, Facebook login is enabled, but in order to connect to the Facebook servers, you need to have an application registered under the same domain as your website. Follow the following steps to configure the Facebook login:

    1. Go and sign up for a Facebook API Key at:  http://developers.facebook.com
    2. Create new Facebook app. Facebook will automatically generate an App ID/API Key that will look similar to this '41365952003784'Facebook API Key
    3. Be sure to complete the field from "Website with Facebook login" under "Select how your website integrate with Facebook"
    4. Go to Joomla! backend => Components => AVChat 3
    5. In the Option tab, go to AVChat 3 General Settings
    6. You will find there the Facebook Applicaion ID field. Place there your personal App ID from above.
    7. Click Save & Close.

    Back to top

    18. Adding a Membership Badge

    Membership badges represent a user with special privilegies. This user can have a Gold/Premium/Paid status that will be marked in the users list. By default, Joomla 1.6, 1.7, 2.5 & Joomla 3.x have included a field in backend that will allow administrators to define a membership badge. In order to add a badge follow these steps:

    1. Go to Joomla! administration area->Components->Avchat 3
    2. Click on the Options button
    3. In the AVChat3 General Settings tab look for Gold/Premium/Paid Membership Badge URL field
    4. Insert the absolute path, to the image you want to be the badge, in the field
    5. Click Save & Close button.

    Back to top

    19. AVChat Components for Joomla! and GPL

    The AVChat Video Chat Components are licensed under the GPL v2 in accordance with the JED requirements. Once you buy the integration kits you can modify them and distribute them as long as you keep it under the GPL.

    Back to top

    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