AVChat - Community PRO Plugin
Community PRO plugin for WordPress
Community PRO plugin for WordPress
The Community PRO Video Chat Plugin for WordPress handles the integration between your WordPress web site and the AVChat video chat platform.
The plugin will handle the following:
All the documentation regarding the Community PRO plugin is on this page so if you’re looking for something specific use the menu on the right or search within this page by pressing Ctrl+F on your keyboard. The main AVChat documentation is here.
First, you will need the two archives downloaded from your client area:
Save and extract the archives somewhere on your computer.
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:
Here’s how to install the
avchat30 app on each one of them:
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:
red5-web.xmlwith any text editor
Restart the Red5 server.
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.
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.
To install the plugin, you will need to be logged in as admin on your website. Once logged in:
Go to the Plugins page, section Add New in your WordPress backend:
Press the Upload Plugin button:
Press Choose File and select the avchat3_wordpress_plugins_pro.zip file:
Press Install Now and wait for the setup to finish:
Before activating the plugin, you will have to upload the AVChat client files on your server. To do so, you will need FTP (or SFTP) access to your server.
Go ahead and open your favorite FTP Client. Navigate to /wp-content/plugins: You should see a new folder called avchat-3-pro. Open it.
Also open the folder on your computer containing the AVChat client files (the ones from the AVChat 3.0 Build xxxx.zip archive): Copy all the files in the Files to upload to your website folder inside the avchat-3-pro folder:
Make sure you change the permissions on the tokens and uploadedFiles folders to
You can now activate the plugin. Once activated, a new menu item is added to your WordPress Dashboard: Community PRO .
You now need to insert the connection string. The connection string looks like this:
Add your connection string in the Connection string field:
Scroll down and press Save
Now go to Enter Chat to access the chat interface:
You will be asked for the license key. You can get your license key from your client area:
The installation is complete and you should be able to see the chat interface:
In order for your users to access the chat, it must be accessible from a page on your website. The Community PRO plugin will allow you to embed the chat easily, using a shortcode in a post or page.
To embed the chat in a page:
Press Add New and give your page a title.
[chat]shortcode in your page body and press Publish:
Going to this page will allow you and your users to access AVChat:
The Community PRO plugin for WordPress allows you to control permissions for each user role. By default, there are 5 user roles predefined on every WordPress installation:
You can also handle permissions for non-registered users (visitors).
For example, if you want to disable access for visitors, you will have to uncheck the Can access chat box under Visitors:
The admin interface is visible to all the users that have the permission to access it (see User Roles and Permissions).
If you access the chat from a page in which AVChat is embedded, the integration plugin will automatically detect if the user has access to the admin interface, and will show it accordingly.
If you access the chat from your WordPress Dashboard (Community PRO > Enter Chat), you will get access to the admin interface.
All the files are in the
By default, AVChat will be embedded where you place the
[chat] shortcode. However, you have the possibility of opening AVChat in a popup window.
To do so, go to Community PRO > Settings and find How AVChat opens.
Change the opening method to Popup and press Save.
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.
After pressing the Create App 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
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.
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 Community PRO plugin. This will remove the wp-content/plugins/avchat-3-pro folder and all its 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.
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 Community PRO > User Roles & Permissions tab.
While logged in as and admin in the WordPress backend go to Plugins and click Deactivate followed by Delete for the Community 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
community_pro_permissions and the
community_pro_general_settings tables (
wp_avchat3_permissions in 3.0 version of the plugin or older).
You might also want to remove the page holding the
[chat] tag that was replaced by the plugin with the AVChat 3 software
WordPress has a special mode called Multisite. This mode has been introduced in 2010 in WordPress 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 network users can independently activate it for their websites too.
When the plugin is network activated, it can not be individually deactivated.
When the plugin is network activated you must visit the Settings > Community 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 WordPress installation (non multisite) or when individually activating the plugin for each sub site in the network the tables are created at activation.
When used in a multisite setup, the plugin will show a new column (role) in the Settings > Community 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.
Each site on the network can control the permissions and settings individually. This also means that each site on the network has to have their own connection string. It is possible for 2 or more websites to use the same connection string, in this case they will share the rooms and users list,etc. .
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:
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.