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

• AVChat 3.0 Build xxxx.zip (contains media server files for Red5/FMIS/Wowza and AVChat Standalone)
• avchat3_wordpress_plugins_pro.zip (contains 1 plugin for WordPress 4.x)

After installation, the first time you will log in the video chat you will be asked for a license key. You can find it in your client area.

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

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:

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 xxx.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 encounter token generation issues later on)
6. Activate the plugin from the admin area, like you would do with any other WordPress plugin. After activation, a new menu will appear, Video Chat PRO with AVChat icon right under Settings.
7. Enter the rtmp Connection String in Video Chat PRO -> Settings . It should look like this:
   rtmp://my-media-server.com/avchat30/_definst_ where my-media-server.com is the domain name or IP address of your server where your media server is installed.
8. Create a new WordPress page with any title you'd like (usually Chat) and place this tag in the body area: [chat]
9. Login to the video chat by accessing WordPress backend -> Video Chat PRO -> Enter Chat or simply visit the newly created page in frontend. The first time you will be asked for the license key. You can find it in your client area on nusofthq.com
10. That's it! You're logged in the AVChat video chat. Have fun chatting!

Back to top

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

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 Video Chat PRO -> Settings .
3. In the User Roles & Permissions tab, 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.

Back to top

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

Back to top

1. Go to WordPress admin area.
2. Go to Video Chat PRO -> Settings .
3. In the Plugin Settings section , you will have the option to select the desired preferences for opening the chat.

Back to top

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

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 Video Chat PRO -> Settings.
3. In the User Roles & Permisions tab you will have the option to select the desired preference for each user role.

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

Back to top

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

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

1. Go and Register as a Developer at: http://developers.facebook.com
   
2. Click + Create New App
   
3. Insert your application name (App Name), select the category and pres Continue
   
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
   



5. Now that you have your Facebook App ID, in your website, go to your WordPress Admin -> Video Chat PRO -> Facebook & Twitter Login
   
6. Insert your Facebook App ID
   
7. Press Update Options

Back to top

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

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

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

First you should download the new archive from your client area on nusofthq.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 Video Chat PRO > User Roles & Permissions tab.

Back to top

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 > Community PRO 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

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 application button
   
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!
   
   
3. After completed the form you will be redirected to the application page, there you will find your Consumer key and Consumer secret
   
4. Now that you have your Consumer key and Consumer Secret, in your website, go to your WordPress Admin -> Video Chat PRO -> Facebook & Twitter Logins tab
   
5. Insert your Consumer key in Twitter Consumer Key option and Consumer secret in Twitter Consumer Secret
   
6. Press Update Options

Back to top

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