You are on page 1of 7

JoomlafacebookChat tutorial

Component written by: Marco Biagioni Tutorial prepared by: Verified by: Release version: Jacopo Sagramoso Marco Biagioni '1.0.6

-07/01/11 10/01/11

1 di 7

Indice generale
INTRODUCTION................................................................................................................................3 INSTALLATION.................................................................................................................................4 Warnings .........................................................................................................................................4 To install the chat on a site located in subfolders............................................................................5 PANEL CONFIGURATION...............................................................................................................5 CREATING PERSONAL FILE LANGUAGE....................................................................................6 FRONT END........................................................................................................................................6 SUPPORT.............................................................................................................................................7

2 di 7

INTRODUCTION
The component JoomlafacebookChat is a chat "Facebook like" for Joomla! The component is native for Joomla 1.0, 1.5 and 1.6. The component JoomlafacebookChat is free, and functionalities are fully similar for different versions of Joomla!

Features free version Ajax technology to update the chat, Chat with users registered and logged in to the site, Manage users in separate windows, Ability to set user status (Available, Busy, Invisible), Ability to set a descriptive message of the user's status, Managing configuration parameters for the update time of the messages and users list,

Management of the configuration parameters for the language (English, Italian, ecc),
Ability to create files for other languages in an easy and fast mode, Managing settings for deleting old messages still in database, Features sounds for incoming messages and for new clients connected,

Ability to go offline without logging out from the site, ,


Audio Test.

3 di 7

INSTALLATION
The installation of the component is fully plug & play:

enter the site administrator,

menu "Install" click on "Components" , look for the downloaded package on your PC from the button "Browse" , click the button "Upload File & Install".

The component will thus focus on the entire Joomla! site in a hidden module.

Warnings The component during the installation creates a hidden module, in the version of Joomla 1.0 it isnt visible in the list of modules, but in later versions it appears as a module without title. It is important to never modify this module directly from the Joomla! list ofmodules. The default module is assigned to a common position of the templates of various versions of Joomla! If the template you are using does not have the position, it can be assigned andchanged directly from the configuration panel of component. The module regardless of the positionselected is always positioned in a static way in the footer. NOTE: Changing the position of the module could also prove useful in cases where in the site is already in use another javascript library which could lead to conflict (Mootools, Prototype).

4 di 7

To install the chat on a site located in subfolders With the release 1.0.6.1, you can also use the component on joomla installations located in subfolders. Requirement is that the tag <base href="www.mysite.it/subfolders" /> is present immediately after the <head> tag in the template file you're using. The <base> tag for all versions of Joomla! is included by default if SEF URL engine is turned on. If instead URL rewriting system is turned off it's necessary specify it by hand making attention at the final slash that must be placed.

PANEL CONFIGURATION
To access the control panel you must enter in the administration of Joomla! - Components - Fbchat.

NOTE: The default settings do not normally need to be changed by excluding the language file Language translations can set the language from the first drop-down list (Actually, in January 2011, are set only two languages: English - Italian),

FBChat module allows you to assign the position of the module (see "Warnings" par. Installation), Chat refresh defines the parameters for updating the messages in seconds, Chat users list refresh defines the update (seconds) for the users list,

5 di 7

Time to Consider user offline define the time interval from the last message sent by a user whose account is to be considered offline, Audio on/off allows you to enable or disable the audio for incoming messages and new users in chat , Garbage on/off llows you to enable or disable deleting of obsolete messages from the database, Max messages lifetime efines the maximum time in seconds of the life of a message on database, is obviously related to "Garbage", Garbage probability is the probability that any request to cancel message starts, Show backlink permit to set if to show or not in frontend our backlink.

CREATING PERSONAL FILE LANGUAGE


The creation of a new language file is extremely simple:

access the language file via FTP or by using components such as JoomlaXplorer, The language file is located at: ... / httpdocs / components / com_fbchat / languages / it is advisable to make a copy of an existing language file and rename the file name according to the language, open the file and change the values of strings enclosed in quotes: var = chionline 'Users Online';

IMPORTANT: DO NOT delete or modify any variable name! We ask those who proceeded to translate the file into other languages to send it to info@2punti.eu and make it available for others. Please send the renamed file with the translated language.

FRONT END
In the front end component is always visible in the footer as a light gray bar, clicking on "Online users" you can see the users connected to the chat (logged on site) and you can click on their name to open conversation. The gear that is on the right of the bar opens up the chat options:

ability to set the user state clicking on the icons (available, busy, invisible); write a description status message in the text field, you must click on "Set" or press Enter test the audio.
6 di 7

SUPPORT
For any support requirements for:

reporting bugs, requests for customization, Implementing new features

you can receive support through the site 2punti.eu url: http://www.2punti.eu/support.html

7 di 7

You might also like