Long Awaited New AVChat Build (3396) Is Here. Check out the blog post!

Support Garage

Get Help With Your AVChat Products & Services

Getting started with WordPress and AVChat

The AVChat Video Chat Plugin PRO for WordPress handles the integration between your WordPress 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 you to control different features for every user role so that your chat will be exactly yhe way you want it
  • MultiSite support
  • BuddyPress support: BuddyPress avatars will be used and BuddyPress users profiles can be accessed directly from AVChat

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 WordPress is on this page so if you're looking for something specific just hit Ctrl+F on your browser.

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

1. Installing the AVChat Video Chat Plugin PRO for WordPress

First you have to download 2 archives from the client/trial area on http://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_wordpress_plugins_pro.zip (contains 1 plugin for WordPress 3.x)

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.

Extract the 2 archives somewhere on your computer and follow Steps 1.1 and 1.2 mentioned below.

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.

Starting with build 2060 that supports the mobile client for Red5 ,disable some of the Red5 logs, because when someone connects from the mobile client, Red5 will generate a lot of logs. To do this go in the installation directory of your Red5 server -> conf – > logback.xml, and here edit the following 2 settings:
<logger name=”org.red5.io”>
<level value=”DEBUG” />
</logger>

Change the level value from “DEBUG” to “INFO”.

<logger name=”org.red5.server.adapter.MultiThreadedApplicationAdapter”>
<level value=”OFF”/>
</logger>

Change the level value from “DEBUG” to “OFF”.

Restart the Red5 server

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

FMIS 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

AMS/FMIS hosting from influxis.com

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

1.2.1 Installing the AVChat Video Chat Plugin PRO for WordPress

  1. Connect to your web site hosting account using FTP
  2. Upload the avchat-3-pro folder (from avchat3_wordpress_plugins_pro.zip) to your /wp-content/plugins folder
  3. Upload the contents of the folder named Files to upload to your web site (from the AVChat 3.0.zip archive) to /wp-content/plugins/avchat-3-pro/
  4. Chmod the /wp-content/plugins/avchat-3-pro/uploadedFiles folder to 777 (otherwise the upload function might not work)
  5. Create a new folder tokens (/wp-content/plugins/avchat-3-pro/tokens) and CHMOD it to 777 (otherwise we might have token generation issues later on)
  6. Activate the plugin from the admin area
  7. Enter the rtmp connectionstring in Settings -> AVChat 3 . It should look like this:
    rtmp://myFMSserver.com/avchat30/_definst_

    where myFMSserver.com is the domain name or ip of the server where your media server is installed.
  8. Create a new page with this content: [chat]
  9. Login to the video chat. The first time you will be asked for the license key ( it's in your client/trial area on avchathq.com).
  10. That's it you're logged in the AVChat video chat.

Back to top

2. Accessing the AVChat admin interface in WordPress

If you have access to the AVChat admin area (see who has access), then the admin interface will be loaded by default when you access the chat page. You will just have to be logged in with your admin username and password and access the chat page in the website.

Back to top

3. Who has access to the video chat admin interface

By default , the superadmin always has access to AVChat admin interface. If you want other user roles to have access to AVChat admin interface, follow these steps:

  1. Go to WordPress backend .
  2. Go to Settings -> AVChat3 .
  3. In the Permissions section , you will have the option to select which user role has access to the admin interface of the chat (Check the "Can access admin chat").
  4. Be sure to click on the Update Options button.
  5. Change permission to diferent user roles to access the admin interface of AVChat

Back to top

4. Location of AVChat and plugin files

Everything is in /wp-content/plugins/avchat-3-pro/.

Back to top

5. Opening up the video chat in a pop up

  1. Go to WordPress admin area.
  2. Go to Settings -> AVChat3 .
  3. In the General Settings section , you will have the option to select the desired preferences for openning the chat.
  4. Change the display mode of the AVChat

Back to top

6. Placing ads around the video chat

As the video chat is embeded into a WordPress page, the ads that are usualy around your WordPress page will also be provided along the side of the chat.

If you have any questions about the placement of ads, please don't hesitate to contact support@nusofthq.com

Back to top

7. WordPress's user roles and limiting features for specific user roles

By default, there are 5 user roles in WordPress : Administrator, Editor, Author, Contributor and Subscriber. In build number 1925 we added the support for the Visitors as well. You can change the default settings by following the next steps:

  1. Go to WordPress admin area.
  2. Go to Settings -> AVChat3.
  3. In the Permisions and Settings sections you will have the option to select the desired preference for every user role .

You can add new user roles by installing this plugin: User Role Editor

Back to top

8. Allowing visitors to join the video chat

By default, visitors are allowed in the chat but if you want you can deny them access.

You can prevent visitors from entering the chat by logging in to the WP backend area > Settings > AVChat 3 and uncheck the Can access chat option for the Visitors column.

Visitor's usernames

Visitors get a random username (for example "user_7261") but they can modify it in the login screen. To prevent them from modifying it edit integration.php from the plugin installation folder and at the bottom set $avconfig['changeuser'] = 0 instead of $avconfig['changeuser'] = 1.

Back to top

9. Allow users to login with their Facebook account

To enable Facebook Login you will need to create an Facebook Application from where you will get an App ID. You cand follow the next steps to accomplish this.

  1. Go and Register as a Developer at: http://developers.facebook.com
    Facebook register as a developer
  2. Click + Create New App
    Facebook create new app
  3. Insert your application name (App Name), select the category and pres Continue
    Facebook create new app
  4. After presing the Continue button you will be redirected to the application page where you will find the App ID. Don't forget to enter your website URL in Website with Facebook Login
    Facebook App ID

  5. Facebook App ID
    Facebook App ID
  6. Now that you have your Facebook App ID, in your website, go to your WordPress Admin -> Settings -> AVChat 3 Video Chat PRO
    General Settings in WordPress
  7. Set the option Allow Facebook/Twitter Connection to true and insert you Facebook App ID
  8. Press Update Options

Back to top

10. Changing the looks of AVChat to better fit your WordPress web site

10.1 Changing the background color

The background color of AVChat is defined in the HMTL web page that embeds the AVChat swf file. In this case it's in the: /wp-content/plugins/avchat-3-pro/avchat3.php file. If you want your website to have only this color, then you have to delete the background image URL from style.css because the image has priority over color.

  1. In order to change the color of the user interface you will need to open avchat3.php in a text editor, go to the end of the page and change the value of the bgcolor property here :

    • bgcolor : "#272727"
  2. Save the file and upload it back to the server.
  3. Done!

Here is an example that will result in a black background:

bgcolor : "#000000"

#000000 is the hexadecimal value for black.

10.2 Changing the background image

Changing the design & looks of AVChat is made through a single file: style.css. Here you can change the background image, fonts, etc.

  1. Navigate to the /wp-content/plugins/avchat-3-pro/style.css file and locate the .backgroundArea{ ... } section. It should be the first.
  2. Change this line from "summertime.swf" to whatever image or animated background you want(the image should be located in the same location as the style.css):
    backgroundImageUrl: summertime.swf ;
  3. Save the file and upload it to the server.
  4. Done!

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

The style.css is located in the same folder where the WordPress Plugin is installed in /wp-content/plugins/avchat-3-pro/

Back to top

11. AVChat Plugin for WordPress and GPL

The AVChat Video Chat Plugin is licensed under the GPL v2 or later. Once you buy the plugin you can modify it and distribute it as long as you keep it under the GPL.

Back to top

12. Removing the plugin

While logged in as and admin in the WP backend go to Plugins and click Deactivate followed by Delete for the AVChat PRO plugin.

This will remove the wp-content/plugins/avchat-3-pro folder and all it's contents.

The plugin's database holding the permissions for each user role and general settings will still remain tough. To remove it delete the wp_avchat3_general_settings and the wp_avchat3_permissions tables.

You might also want to remove the page holding the [chat] tag that was replaced by the plugin with the AVChat 3 software

Back to top

13. Updating the plugin when a new version is available

First you should download the new archive from your private client area on http://avchathq.com

Then we need to remove the old version. While logged in as and admin in the WP backend go to Plugins and click Deactivate followed by Delete for the AVChat PRO plugin. This will remove the wp-content/plugins/avchat-3-pro folder and all it's contents.

You will now have to re-install the plugin and upload the AVChat 3 client side files again to the wp-content/plugins/avchat-3-pro folder, for more details check out the client side installation instructions.

Any existing settings or permissions will be kept. Any new settings or permissions added by the new version will most probably be empty, make sure you configure them as you wish for each user role from Settings > AVChat Video Chat PRO

Back to top

14. Multisite support

WP has a special mode called Multisite. This mode has been introduced in 2010 in WP 3.0.

Starting with build 2359 the plugin adds support for installations of WordPress with multisite on.

A new WP user role is present in multisite setups:

Super Admin – somebody with access to the site network administration features and all other features.

In such an installation the plugin can either be network activated for all sites or individually activated.

After installation, the super admin can network activate it for all the websites or he can activate it individually for each of his websites.

If My Sites > Network Admin > Dashboard > Settings > Network Settings > Enable administration menus > [ ]Plugins is checked then other nework users can independently activate it for their websites too.

Network Activation

When network activated it can not be individually deactivated

When network activated you must visit the Settings > AVChat 3 Video Chat PRO page for each of the websites in the network for the permissions tables for AVChat3 to be created. Otherwise in the front end you will find the following error:

Warning: Invalid argument supplied for foreach() in /home/observer/public_html/wp-content/plugins/avchat-3-pro/avchat3.php on line 86
							
When using a standard WP installation (non multisite) or when individually activating the plugin for each sub site in the network the tables are created at activation.

Network Users

When used in a multiste setup, the plugin will show a new column (role) in the Settings > AVChat Video Chat PRO area called Network users. These are users who belong to the network but they do not belong to any other website on the network other than their own. They have no role in other websites than their own.

Permissions and Settings

Each site on the nework can control the permissions and settings individually. This also means that each site on the network has to have their own connectionstring. It is possible for 2 or more websites to use the same connectionstring, in this case they will share the rooms and users list,etc. .

Back to top

15. Allow users to login with their Twitter account

To enable Twitter Login for your video chat you will need to create a Twitter Application that will provide you with a Consumer Key and an Consumer Secret. You can follow the next steps to accomplish this.

  1. Go to https://dev.twitter.com/apps and click on the Create a new applcation button
    twitter new app
  2. Complete the form:
    • Name - enter the name of your application
    • Description - insert the description
    • Website - enter your website URL
    • Press Create your Twitter application!

    twitter new app form
  3. After completed the form you will be redirected to the application page, there you will find your Consumer key and Consumer secret
    twitter new app page
  4. Now that you have your Consumer key and Consumer Secret, in your website, go to your WordPress Admin -> Settings -> AVChat 3 Video Chat PRO
    General Settings in WordPress
  5. Set the option Allow Facebook/Twitter Connection to true
  6. Insert your Consumer key in Twitter Consumer Key option and Consumer secret in Twitter Consumer Secret
  7. Press Update Options

Back to top

16. Extended short code functionality

To display AVChat 3 in your WordPress page or posts, you will use the short code [chat].

You can extend the functionality of short code by adding the following options:

  1. dropInRoom:r0 - this option allows you to define the rooms ids (r0, r1, r2 etc) in which users will be droped when entering the chat
  2. showOnlyRooms:r0 - this options allows you to define the rooms that users will be able to see
  3. roomsListEnabled:1 - you can disable (0), enable (1) or hide (2) the rooms list button in the top bar

This extended short code allows you to display AVChat 3 in multiple WordPress pages or posts with different rooms and options.

Back to top

Get personalized help

Customers with an active Support & Updates Plan can submit support requests to our knowledgeable techs via the 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 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