AVChat SocialEngine 4 Add-on
Documentation covering the AVChat add-on for SocialEngine 4
Documentation covering the AVChat add-on for SocialEngine 4
The AVChat Video Chat Add-on for SocialEngine 4 handles the integration between your SocialEngine 4 community and our AVChat software:
The AVChat Module for SE4 is one of the best most advanced integration we have done! Why? because directly in SE4’s admin area you can control access to AVChat and its features based on the level of the user
If you like the AVChat Module for SocialEngine PHP 4 don’t forget to rate it and review it in the SE Community Addons area. You can also view our Developer Profile on socialengine.com.
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.
If you’re looking for something specific just hit Ctrl+F on your browser.
Download these 2 archives from your private client/trial area to your computer:
AVChat 3.0.zip
contains AVChatavchat3_socialengineall.zip
contains the SocialEngine add-onExtract the 2 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:
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:
/Your_Red5_Install_Directory/webapps/avchat30/WEB-INF
red5-web.xml
with any text editorRestart 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.
avchat3_socialengineall_UNZIPFIRST.zip
and select the module-avchat3-xxxx.tar
file from the socialengine_4.x
folder.videochat
folder from the socialengine_4.x
folder from the archive, to the root of your website.videochat
folder copy the contents of the folder named Files to upload to your web site
from the AVChat 3.0.zip
archive.
uploadedFiles
and tokens
folders to 777
avchat30
application on the media server. It should look like this:
rtmp://myFMSserver.com/avchat30/_definst_
where myFMSserver.com
is the domain name or ip of the your media server.Your AVChat installation is now configured to connect to the media server.
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. SocialEngine PHP 4 has 5 default member levels:
By default Moderators, Admins and Super Admins have access to the AVChat admin interface.
Access to the AVChat admin interface and what admin features each member level gets can be controlled from: Manage -> Member Level AVChat 3 Permision.
By default AVChat 3 is embedded in your Socialengine page but 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. While logged in the admin area of SE4:
Any ads can be placed around AVChat, including Google Ad-Sense.
You can place ads around:
To place ads around AVChat (or around the Open Chat Button if open popup open method is selected), you need to edit this file: application/modules/Avchat3/views/scripts/index/index.tpl
Where you can place the ads:
<?php if($this->open_method == 1){ ?>
<?php } ?>
SocialEngine 4 has 5 default member levels:
By default:
The default setup can be changed from: Manage -> Member Level AVChat 3 Permission
But access to AVChat is not the only thing you can control. What makes this integration so great is that you can control in detail to what AVChat features each member level has access to without leaving the SE4 admin area.
See screenshot with all the permissions that you can control individually for each member level:
By default the AVChat Module for SE4 does not allow visitors of your web site to enter the video chat. Only signed in users are allowed in the video chat.
By default SE4 considers visitors as part of its internal Public member level so to allow visitors in we need to allow access to AVChat for the Public member level:
Visitors will have the option to choose their user name and gender before joining the video chat.
The only way at this moment to change the title is by editing a file. In future updates we will add the option to change the title by editing a phrase in the SE4 phrase system.
What you have to do now to change the title:
application/modules/Avchat3/Controllers/
and open in a text editor IndexController.php
$this->view->avchat3_title = 'Flash Video Chat';
and change Flash Video Chat with what you want.This is a delicate task which requires editing a sensitive file, application/index.php
.
Before going further make sure that you BACKUP application/index.php
Let’s say that you want to access AVChat 3 by going to http://yourse4site.com/outstandingchat instead of http://yourse4site.com/avchat3. SE4 automatically creates the URL and it cannot be changed from the admin area. Editing the .htaccess file is a nightmare. So the easiest possible way is this:
application
and open in a text editor index.php
if($\_SERVER['REQUEST_URI'] == '/outstandingchat'){
$\_SERVER['REQUEST_URI'] = '/avchat3';
}
Save the file and that’s it. You can access now AVChat by going to http://youse4site.com/outstandingchat
videochat
as alias because videochat
holds the AVChat 3 standalone files that are used by the AVChat 3 SE4 module.if($\_SERVER['REQUEST_URI'] == '/se4folder/outstandingchat'){
$\_SERVER['REQUEST_URI'] = '/se4folder/avchat3';
}
SocialEngine Package Manager is responsible for all the packages in the SocialEngine system. It offers us an easy way for installing/upgrading a module or a widget. Next I will present a series of steps that can help you upgrade a module or widget easily.
Only visitors will have the option of connecting with Facebook to AVChat.
Follow the chapter Setup Facebook authentication in order to obtain your appid
that you will use in SocialEngine backend.
The main way you can configure the Add-on is from the specific backend settings page found at your_social_engine_site/admin/avchat3/settings/general
Additionally to this the Add-on can be configured directly from AVChat’s main config file (avc_settings.xml
) and the rest of the configuration files described here