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

• AVChat 3.0.zip (contains media server files for Red5/FMIS/Wowza and AVChat Standalone)
• avchat3_phpfox30x_module.zip (contains the module files)

Extract the 2 archives somewhere on your computer to have all the files handy! We will use files from both archives!

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.

Back to top

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:

Back to top

1. Copy include and module folders from avchat3_phpfox30x_module (extract avchat3_phpfox30x_module.zip) to the root of your PHPFox installation
2. copy from the AVChat3.0.zip unzipped archive the contents of the Files to upload to your website folder into [your site]/module/avchat3/include/plugin/ .
3. Chmod the [your site]/module/avchat3/include/plugin/uploadedFiles folder to 777 (otherwise the upload function might not work)
4. Chmod the [your site]/module/avchat3/include/plugin/tokens folder to 777 (otherwise we might have token generation issues later on)
5. Now login as admin in the PHPFox admin area
6. Go to Extensions->Product->Import Products and you will be prompted to install AVChat3 Module for PHPFox
7. Click on Install
8. After installation go to Settings->Manage Settings->Avchat3 (from Module Settings section) and complete the RTMP Connectionstring field with your connection string rtmp://myFMSserver.com/avchat30/_definst_

DONE!!!

You will now find a link to the AVChat 3 Module for PHPFox in the main menu!

Back to top

If you want to log in as hidden, kick/ban users, close/delete rooms, view users IP's and a lot of other stuff that makes you feel like GOD you will have to use the AVChat admin interface, here's how to access it:

From the front end of the web site:

• go to Video Chat link in the main menu. The AVChat admin interface will automatically load if you have access to it. By default, users that are part of the Administrators and Staff user groups have access to the admin area of AVChat. To allow more user groups to access the admin area of AVChat 3 see Part 6 below.

Back to top

[your site]/module/avchat3/include/plugin/

Back to top

1. From Admin CP click on Settings -> Manage Settings:
2. Click on General AVChat 3 Settings
3. Under Open Method select popup:
   
4. Click on Submit at the bottom of the page

 

Back to top

You can use Ad module from PHPFox to place ads in the video chat page. Follow these steps to acomplish this.

1. Log into your PHPFox AdminCP
2. Go to Modules -> Create New Campaign, a form will show up
   
3. Select the Banner Type (HTML or Image) you want to show on your video chat page
4. If you have selected Image you will need to select a file (JPG, GIF, PNG) from your computer and set a Banner Link for it. If HTML, you must enter the HTML code in textarea.
5. Enter the name of your campaign (Campaign Name)
6. From Module Placement select Avchat3
7. From Placement select in which Block you want your ad to be shown (Block 2 if you want your ad to be shown above the video chat, Block 4 under the chat, Block 1 in the left side, Block 3 for right side - see "View Site Layout" for better understanding)
8. Press Submit!

After completing these steps, your Video Chat page should look like this:

Back to top

Each user in PHPFox belongs to a user group.

PHPFox ships with 4 default user groups that can not be removed: Administrators, Registered User, Guest and Staff.

To manage user group settings (screenshots from PHPFox3):

1. first log into your AdminCP
2. Go to Users -> Manage User Groups (under User Group Manager):
3. Click the arrow in front of the user group you want to change AVChat permissions for
4. Click on Manage User Settings:
   
5. Click AVChat3

The permissions for AVChat 3 will load up

Pretty neat huh? :)

Change the permissions for that specific user group and click SAVE.

Back to top

By default, AVChat3 Module for PHPFox allows your guests to enter in video chat. You can follow the next steps to prevent this.

1. First log into AdminCP
2. Go to Users -> Manage User Groups (under User Group Manager)
3. Click the down arrow in front of the Guest group and then Manage User Settings
4. On the left side you will find a list with all modules, click Avchat3 to view the settings
5. Check No in Allow user in this usergroup to access the chat.
   

Back to top

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

When working with the PHPFox 3.x Module keep in mind that AVChat is installed in [your site]/module/avchat3/include/plugin/ , so all the files you need to edit (like style.css for fonts and colors, avc_settings.php for the background image) are there.

The files that contains the embed code for the AVChat Flash .swf files (the ones you need to edit in order to change the size or background color of AVChat in PHPFox) are:

• module\avchat3\template\controller\index.html.php user interface
• module\avchat3\template\controller\admincp\index.html.php admin interface

Back to top

We have this great tutorial that shows you how to display on every page of your web site who is in the video chat, their profile picture and a link to their profile:

1. Login as admin and go to Admin CP
2. Go to Extension -> Module -> Add Component
3. Complete the form:
   • Product: Select AVChat3 Module for PHPFox 3
   • Module: Select AVChat3
   • Component: chatters
   • Type: Select Block
   • Active: Yes
     
4. Press Submit
   
5. Got to CMS >> Blocks >> Add New Block
6. Complete the form (see Image 2):
   • Product: Select AVChat3 Module for PHPFox 3
   • Module: Select AVChat3
   • Title: You can choose the title. We choose: Online Chatters
   • Type: Select PHP Block File
   • Controller: Here you can choose the page to display the Who's chatting module. We wanted to display the module on the member's dashboard: -- core.index-member
   • Component: The component we created in Step 1:-- chatters
   • Placement: We choose on the right side: Block 1
   • Can drag and drop: It's up to you
   • Active: Yes
   • Allow access: We allowed all user groups.
7. Press Submit.
   
8. After completing these steps, go to Your site >> Dashboard. You should see the "Who's chatting" block on the right of your site:

This module uses the external users list generated by AVChat, so you need to login as a user in the video chat trough the front end of PHPFox! before the Who's Chatting Module will start showing who's online.

Back to top

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
   
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 AdminCP -> Settings -> Manage Settings and click Facebook Connect
6. Insert your Facebook App ID in Application ID option and press Submit
   
7. Go to AdminCP -> Settings -> Manage Settings and click General AVChat 3 Settings
   
8. Set the option Allow Facebook/Twitter Connection to true
   
9. Press Submit!

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 applcation 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 AdminCP -> Settings -> Manage Settings
   
5. Click on General AVChat 3 Settings
6. Set the option Allow Facebook/Twitter Connection to true
7. Insert your Consumer key in Twitter Consumer Key option and Consumer secret in Twitter Consumer Secret
   
8. Press Submit!

Back to top