Overview

The AVChat Module for Drupal 7 handles the integration between a Drupal 7 web site and the AVChat video chat software.

If you’re looking for something specific just hit Ctrl+F on your browser.

Installation Instructions

Download & extract archives

Download these 2 archives from your private client/trial area to your computer:

  1. AVChat 3.0.zip contains AVChat
  2. avchat3_drupal_modules.zip contains the Drupal modules

Extract the 2 archives somewhere on your computer. Here’s their contents:

Media Server Application

Once we’ve downloaded & unzipped everything the next thing we need to do is to setup the media server app to which AVChat will connect to.

AVChat uses a media server to send all the audio video and text data between users. AVChat supports the 3 major media servers:

  • Red5
  • Adobe Media Server
  • Wowza

Here’s how to install the avchat30 app on each one of them:

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

On Linux, chmod the new avchat30 folder to 666.

For versions of Red5 1.0.7 or higher one additional change needs to be made:

  1. Go to /Your_Red5_Install_Directory/webapps/avchat30/WEB-INF
  2. Open red5-web.xml with any text editor
  3. Uncomment line 37

Restart the Red5 server.

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 AMS installation.

On Linux, chmod the new avchat30 folder to 666.

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.

Restart the Wowza server.

Module & AVChat installation

Upload files to your website

Connect using an FTP client to your website and:

  1. upload the avchat3 folder from avchat3_drupal_modules.zip/drupal7.x_module to /sites/all/modules/
  2. upload the contents of the Files to upload to your web site folder from the AVChat archive to /sites/all/modules/avchat3/

Folder permissions

If your website’s hosted on a Linux server CHMOD the uploadedFiles and tokens folders to 777.

Edit /sites/default/settings.php

Edit /sites/default/settings.php and search for # $cookie_domain = '.example.com'; (line 340 on Drupal 7.42). Remove the # sign and replace .example.com with your domain name. Save.

After making the change the line with the $cookie_domain variable should look like this:

$cookie_domain = 'yourwebsite.com';

Complete installation

Activate the module

Now open your Drupal’s admin area in a web browser, click on Modules in the top menu and scroll down to the CHAT section where you need to enable the new AVChat3 module by clicking the empty checkbox at the left of it and then on [Save Configuration].

Connect AVChat to the media server app

Two new menu items will show up in your Drupal menus:

  • Flash Video Chat in the main menu
  • AVChat 3 Module Settings in the top admin menu

Click on AVChat 3 Module Settings, a list of AVChat 3 settings will show up including the RTMP Connectionstring field.

Set it to the connection string for your new media server app like this:

  • rtmp://media-server-ip/avchat30/_definst_

scroll to the bottom and press Save configuration.

Enter the chat and insert the license key

Now close the Modules modal and click on Flash Video Chat link in the main menu to open the page with AVChat on it. The pre-filled AVChat login screen will show up, click [Enter Chat]. AVChat will now connect to the media server and ask you for the license key.

Enter the key (It’s in your private client/trial area) and press [Submit].

Deep integration

When accessing AVChat logged in to the website the user name in the AVChat login section will be automatically filled with your Drupal username. If the user role you belong to has the permission to access AVChat 3 as admin, the admin interface of AVChat 3 will be loaded.

Module Features

Access the AVChat admin area

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. .

To give other people access to the AVChat admin interface do the following:

  1. Go to Modules -> AVChat3 (it’s in the CHAT section at the bottom)
  2. Click on the Permissions link to the right
  3. Tick the checkboxes for the roles you want to give access to in the Allow this user role to access the chat as admins line.
  4. Scroll to the bottom and click Save permissions

Unce a user has access to the admin area of AVChat he just has to log in your website and click on the Flash Video Chat link. AVChat’s admin interface is automatically loaded.

Open AVChat in a pop up

You might want AVChat to open in a pop up window to make it easier for your users to browse your website while in the chat.

  1. In the top admin menu click on AVChat 3 Module Settings
  2. In the Chat will open section check the In popup option
  3. Scroll to the bottom and click Save configuration

Limiting features to certain user roles

Drupal 7 user roles

By default Drupal 7 comes with 3 user roles:

  • anonymous users or visitors
  • authenticated users or logged in users
  • administrator

On top of that you can add your own custom user roles from People -> PERMISSIONS -> Roles.

Limiting AVChat features

To control what AVChat features (creating rooms, sending PM’s, viewing webcams, etc.) are available to each user role click on People in the top menu and then on the Permissions tab.

All user roles will be shown horizontally while all the AVChat features you can turn on and off will be shown vertically.

Allowing visitors to enter AVChat

  1. Go to Modules -> AVChat3 (it’s in the CHAT section at the bottom)
  2. Click on the Permissions link to the right
  3. Tick the checkbox for the ANONYMOUS USER role in the Allow this user role to access the chat interface line.
  4. Scroll to the bottom and click Save permissions

Location of AVChat files

All the AVChat files including:

  • all the module files
  • index.swf and admin.swf
  • language files
  • themes
  • audio/video quality profile files
  • avc_settings.xml
  • integration.php

are located in /sites/all/modules/avchat3/.

GPL License

The AVChat Module for Drupal is licensed under the GNU General Public License, version 2.

Once you purchase the module you can modify it and distribute it as long as you keep it under the GPL.

We are not affiliated with or endorsed by the Drupal Project or its trademark owners.