2.1 Installing FCChat|
Instructions for installing FCChat may vary, depending on your installation type.
A tutorial that guides you through the process of installing and configuring the chat client may be found in the User Guide
2.2 Accessing the FCChat Configuriation
The location of the FCChat configuration depends on your installation type. For WordPress, Joomla 1.6+, Drupal 7+, or PhpBB 3+ installations, the configuration is built into the dashboard for your site adminstration. (For wordpress users, go to Settings >> FCChat Settings
from the wp dashboard)
For other installation types, the recommended method for configuring your chat is to use the global configuration template (FCChat/config/global.config.js
). A tutorial on this method may be found here
. Alternatively, site administrators with these installation types may edit the main configuration file (FCChat/config/config.js
2.3 Configuriation Parameters Explained
2.3 Additional Client Configuration topics: Setting up Images/Avatars.
A full discussion of FCChat configuration parameters follows. These parameters may be found in the FCChat Settings page (for installations with built in configuration settings) and/or in the main configuration file (FCChat/config/config.js).
2.2.1 Connecting to the chat server
2.2.2 FCChat and jQuery version
The connection parameters are shown below:
Once you have activated FCChat
, you will receive the chat_id
values that will allow you to make a connection to the chat server. Enter those values in your configuration, as the above example shows.
In FCChat version 3.x it is not really necessary to change the port
from their defualt values.
2.2.3 Global Configuration
Version info shown below:
fields convey the current version of FCChat.
parameter indicates the version of jQuery that FCChat is using. FCChat will load the required version of jQuery if it is not already present in the web page, or if the version in the page is older than the one specified by the parameter.
This section allows you to set up a global configuration template file (global.config.js), which may be placed outside the fcchat folder. The global configuration template allows you install updates more easily, because the configuration settings contained within the template carry over from one version to the next. Installations which have a built in configuration, such as WordPress and Joomla, generally do not make use of this file. For more details, see Using the global configuration template for seemless updates
// GLOBAL CONFIGURATION
should be enabled if you are using the global configuration file.
is the full path to the global configuration file. ie. http://yoursite.com/global.config.js
This should be set only if you wish to place the global.config.js file somewhere other than the root of your site.
Branding section shown below:
small_logo:"", //around 16x16
big_logo:"", //around 80x80
startText:"Click here to join our chat.",
loginText:"Please please sign using your site account.",
full_page_loading:"Yourdomain chat will load momentarily",
full_page_login:"Welcome to Yourdomain chat. Sign in to enter.",
A 16×16 (approx) logo for your site. Insert the full path to the image file. ie. http://www.mysite.com/image.png.
A 80×80 (approx) logo for your site. Insert the full path to the image file. ie. http://www.mysite.com/image.png.
The title displayed on the embedded widget..
Title displayed on the branding bar. Add the branding bar to the toolbar by inserting ‘fullpage:logo’ into toolbar_items field below.
Width of the branding bar.
Text displayed by the widget when it starts up.
Text displayed by the login panel when user integration is enabled.
A message that is displayed when a user opens the ChatCenter window. The message could contain instructions and/or a welcoming message.
Text displayed when the full page chat is loading.
Text displayed if the full page chat requires signin.
2.2.6 User Integration
Permisions section shown below:
When true, guests are required to login to gain access to the chat.
If no, guests may not send chats in the rooms (they can still observe).
Allow guest accounts to use the video chat.
Videoconferencing can be accessed only in rooms designated for video chat.
2.2.7 Alignment of dialog boxes with respect to the widget.
The user integration section allows you to sync your site user accounts with the chat. Refer to the FCChat User Guide
for info on how to set up user integration.
// USER INTEGRATION
Specifies the type of integration.
The URL of your site’s login page. The user will be redirected here if they have not signed in.
2.2.8 Setting the Default Language
The alignment of dialog boxes depends on where the widget has been placed in the page. For instance, if the widget is in the right sidebar, then the best alignment is “left”, so that the dialogs open more toward the center of the page.
// Align Online, New messages and Friends boxes
alignment:"auto", // "left","right", or "auto
Choices are “left”,”right”, or “auto”. The “auto” setting automatically detects alignment
2.2.9 Setting the Style Templates
Language Section shown below:
//LANGUAGE (templates located in the languages folder)
to the name of the language file you want (for instance, english.js). The language templates are in the fcchat/languages
folder, so make sure a file for your language exists before setting this parameter.
Style Template Section shown below:
// STYLE TEMPLATES
to the name of the style template file you want (for instance, widget_default_header.js). The widget style templates are found in the fcchat/styles
folder, and they are prefixed by the word “widget”. The widget templates offer differing themes and or configurations of the embedded FCChat widget
to the name of the style template file you want (for instance, toolbar_default.js). The toolbar style templates are found in the fcchat/styles
folder, and they are prefixed by the word “toolbar”. The toolbar templates offer differing themes and or configurations of the floating toolbar
to the name of the style template file you want (for instance, chatcenter_light_gray.js). Application window templates are found in the fcchat/styles
folder as well. They are prefixed by the word “chatcenter”. The application window templates offer different themes for the application window
2.2.11 Embedded Widget Control Configuration
Quickstyling Section shown below:
// QUICK STYLING
Quickstyling offers a way to quickly customize the basic style and layout of the chat to fit your site’s needs. It is designed to be quicker and easier to implemenent than other methods of customization (namely, editing the style templates directly, or using the Template Overrides Api
). However, the drawback is that it lacks the level of control associated with these other methods. We will not give details of each parameter’s function here. Instead, refer to this tutorial as an example of correct usage: Styling the chat with Quickstyling
2.2.12 Toolbar Configuration: Show/Hide the Toolbar
Embedded Control Section shown below:
//Embedded control box
The parameters above control certain aspects of the embedded FCChat widget
, if set to false, will display the widget in the flow of page elements. This is the default setting. If set to true, the widget will be displayed at a fixed location (coordinate) within the page. If you set this parameter to true, you must also set the desired coordinates. In order to set the x,y coordinates, do the following:
a) Open the current widget style template file, located in the styles directory of your FCChat installation, with a text editor (ie fcchat/styles/wiget_default_header.js
). To see which style template you are currently using, refer to the styles section
of the config file. For wordpress users, use the plugin editor, in the wordress administration screen, to open/edit these files. Plugins >> Editor
Find the following text within the widget style template:
top:0, //for absolute positioning
left:310, //" "
b) Set top:<Y_COORDINATE>,
(Where <Y_COORDINATE> is a number representing the distance from the top of the page to the chat widget, in pixels.)
c) Set left:<X_COORDINATE>,
(Where <X_COORDINATE> is a number representing the distance from the left side of the page to the chat widget, in pixels.)
, if set to false, will hide the embedded control. Use this mode if you only wish to display the toolbar
, sets the amount of spacing around the widget control.
2.2.13 Toolbar Configuration Continued: Desktop/Laptop Options
// TOOLBAR OPTIONS
Set to false in order to hide the toolbar
2.2.14 Toolbar Configuration Continued: Options for mobile browsers
Configuration shown below (some comments have been removed for clarity):
toolbar_layout:0, // 0 = compact | 1 = full width
toolbar_default_display:1, // 1 = normal | 0 = minimized
The parameters above control certain aspects of the floating toolbar
in desktop or laptop environments.
has two settings: 0 (The toolbar will only take up enough space on the page as is necessary to show all of its components. The toolbar may be minimized in this mode.) , 1 (The toolbar will extend accross the full width of the web page. The toolbar may not be minimized in this mode.)
sets the location of the floating toolbar. Choices are “topleft”, “topright”, “bottomleft”, and “bottomright”.
Attempts to create space for the toolbar at the top of a web page, by pushing other page elements down. The purpose of this setting is so that the toolbar, when placed in the topleft or topright position, will not overlap other page elements.
contains a list of items that will be displayed in the toolbar. The order that items appear in this list is also the order that they will be rendered in the toolbar. The list MUST contain “friendscenter”. The other items in the list are optional. To see what other items are available, refer to the Adding Toolbar Items
has two settings: 1 (fully extended) , or 0 (minimized).
adds custom buttons to the toolbar. Refer to this tutorial for a full discussion: Custom Buttons for the Toolbar
2.2.14 Chatcenter window modes
Configuration shown below (some comments have been removed for clarity):
// MOBILE TOOLBAR OPTIONS
mobile_toolbar_mode:2, // 0 - simplified, 1 - regular, 2 - auto choose
mobile_banner_position:"bottomleft", // Choices are bottomleft and topleft
fixed_toolbar_position:"bottomleft", // Choices are bottomleft and topleft
// MOBILE TABLET/LARGE DISPLAY OPTIONS
// MOBILE PHONE/SMALL DISPLAY OPTIONS
// --END MOBILE BROWSER OPTIONS
The parameters above control certain aspects of the toolbar
when viewed from a mobile platform such as a mobile phone or tablet. For more information on mobile integration, read the Mobile Integration Tutorial
If set to 1, all the items in the toolbar items list will be shown. If set to 0, then only the “friendscenter” item will be shown. If set to 2, the the chat will choose between one of the two previous options, based on available screen width. This mode does not apply when the toolbar is running in the “mobile banner” mode.
enables the “mobile banner” mode, which is a mode of operation optimized for small screen devices. In this mode, the toolbar will automatically resize itself to fit in the available display window. This mode is available for small screen devices which have full fixed positioning support, such as iphone/ipod ios 6+, android 4+ phones, and blackberry 7+ phones..
Choices are “bottomleft” and “topleft”.
A regex containing a list of devices to be prohibited from using this mode. This has been included because the “mobile banner” mode may not display correctly on some devices. The regex is matched against the browser’s user agent string. An example would be: mobile_banner_exclude:/ipod|iphone|ipad/i,
enables the “fixed toolbar” mode, which is the standard way of displaying the toolbar. In this mode, the toolbar will be fixed at the top or bottom of the page, and will scale with the page contents. This mode is available for devices which have full fixed positioning support, such as iphone/ipod ios 6+, android 4+ phones, and blackberry 7+ phones.
Choices are “bottomleft” and “topleft”.
Attempts to create space for the toolbar at the top of a web page, by pushing other page elements down. The purpose of this setting is so that the toolbar, when placed at the top of the page, will not overlap other page elements.
A regex containing a list of devices to be prohibited from using this mode. This has been included because the “fixed toolbar” mode may not display correctly on some devices. The regex is matched against the browser’s user agent string. An example would be: fixed_toolbar_exclude:/ipod|iphone|ipad/i,
The “static banner” mode is the same as the “fixed toolbar” mode above, except that the static banner is not “fixed” and will scroll with the page. This is a fallback mode for devices that do not support fixed positioning.
The height of the banner, when running in this mode.
sets the location of the toolbar relative to the top left corner of the viewing window.
A regex containing a list of devices to be prohibited from using this mode. This has been included because the “static banner” mode may not display correctly on some devices. The regex is matched against the browser’s user agent string. An example would be: static_banner_exclude:/ipod|iphone|ipad/i,
contains a list of items that will be displayed in the toolbar, when shown in a mobile device with sufficient screen width, as determined by the chat. The order that items appear in this list is also the order that they will be rendered in the toolbar. The list MUST contain “friendscenter”. The other items in the list are optional. To see what other items are available, refer to the Adding Toolbar Items
contains a list of items that will be displayed in the toolbar, when shown in a mobile device with a small screen width, as determined by the chat. The order that items appear in this list is also the order that they will be rendered in the toolbar. The list MUST contain “friendscenter”. The other items in the list are optional. To see what other items are available, refer to the Adding Toolbar Items
2.2.15 Chatcenter window size
Chatcenter window modes section shown below:
// CHATCENTER WINDOW MODES
chatcenter_layout:0, // 0 - Chatrooms and Messages 1 - messages only
If set to 0, the chat window will operate in “ChatCenter mode”, that is, both chat rooms and private messages will be available to users. If this is set to 1, the chat window will operate in “MsgCenter mode”. In this mode, no chatrooms will be available. The MsgCenter mode is intended for sites that want to user the instant messageing service exclusively.
If this option is set to true, when you click on a chat room from the “Chat Rooms” Dialog box, the chatroom will open in a separate tab (full page), instead of in the Chatcenter application window.
, if set to true, enables a user to access the split screen mode
, either from the options panel, or from the maximize button on the ChatCenter window.
2.2.16 Parameters relating to chat rooms and chat messages
Chatcenter window size section shown below:
// CHATCENTER WINDOW SIZE
determines the width of the Chatcenter application window.
determines the height of the Chatcenter application window. The baseline height of the ChatCenter window is 568 px. An offset of -80, as shown above, reduces the height to 568-80, or 488px. The maximum height the chat window can attain is 573 px..
sets the height of the Chat Room panel. If the parameter is positive, more space will be allocated for the Chat Room panel, and less for the Messages panel. A negative value produces the opposite affect. The Chat Room overall height may not be smaller than 200px.
2.2.17 Setting the location of the full page chat
2.2.18 Environmental variables
CHAT ROOM PARAMS section shown below:
// CHAT ROOM PARAMS
disabled_room_msg:"You must be a member to enter this room.",
When set to true, Clicking “Chat Rooms” will open the default chat room (pointed to by default_room_index) directly, bypassing the chat room list.
The index of the default room. 0 is the index of the first room. Rooms are indexed in the order they were created, not by their position in the room list.
The usage of these parameters are explained in the tutorial, Setting up member only rooms
is the maximum number of chat messages a room may contain before automatically refreshing itself. Limiting the number of chat messages in this way improves the performance of the chat in a high usage room. A smaller number means better performance, but at the same time, more refreshes. A refresh involves reducing the number of displayed messages in the room to min_room_messages
. The refresh occurs silently and unobtrusively, so that the chatters will not be distracted by it.
is the number of message a room will contain after an automatic refresh. It should be a number between 0 and room_message_limit
is the maximum size of a single chat message.
2.2.19 Enabling/disabling the new user prompt
Environmental section shown below:
fixed_support_regex:/cpu os [6-9]|iphone os [6-9]|android [4-9]|bb10| (?=.*blackberry)(?=.*version/[7-9])/i,
determines whether the chat is on or off.
When this is enabled, the browser tab will serve to alert the user when new messages arrive.
When this is enabled, chat history pages will not be available.
If this is set to true, the word ‘typing…’ will appear next to a user’s name when they are typing a message.
If this is set to true, the date and time will be attached to all current chat messages. This is the default setting, however, individual users may also set this parameter through the options panel.
If this is set to true, the chat will provide sound alerts when a user sends a message, enters room or exits a room. This is the default setting, however, individual users may also set this parameter through the options panel.
A regex containing a list of mobile device identifiers. This regex is matched against the browser’s user agent string.
A regex containing a list of tablet identifiers. This regex is matched against the browser’s user agent string.
A regex containing a list of mobile device identifiers which are known to fully support fixed positioning. This regex is matched against the browser’s user agent string.
2.2.20 Enabling/disabling the nickname prompt
User prompt section shown below:
// Prompt user to sign in to chat
is set to true by default. When a new user comes to your site, an info bubble will pop up next to the toolbar, inviting them to participate in the chat. If you want to disable this, set the above parameter to false.
2.2.21 Letting users connect with Facebook
Nickname section shown below:
// Prompt guests to enter a nickname
is set to true by default. When a new user comes to your site, and opens the chat interface, they will be asked to enter a nickname for their guest account (or alternatively, to sign in). Only guest accounts are prompted in this way. Set to false to disable.
2.2.22 Setting up Country Flags
Facebook Connect section shown below:
//ALLOW FACEBOOK LOGINS
: If true, users will have the option of connecting to the chat with their Facebook account.
: The url of the proxy server that provides the Facebook Connect interface.
2.2.23 User Profiles
Country Flags section shown below:
//get your free api key from http://ipinfodb.com/register.php
turns the country flag option on or off.
FCChat uses 2 different geolocation services to determine a visitors country: HostIP and IPInfoDB. IPInfoDB requires an api key to access their service, which you can obtain for free from http://ipinfodb.com/register.php
. It seems that IPInfoDB is the better of the two services, so you really do need to get an api key if you want to take full advantage of the country flag option. Please do not use our api key
, there is a limit the the request load that can be placed on a single api key.
Note: You need to have PHP installed on your site to use the country flag option.
2.2.24 Configuration of Images, Avatars, and Smileys
Profiles section shown below:
Refer to. Importing user profiles
, for the proper usage of this parameter.
2.2.25 Games Options
IMAGES AVATARS SMILEYS section shown below:
//IMAGES AVATARS SMILEYS
current_domain:"fastcatsoftware.com", // set this to your domain
If this option is set to true. Users will be able to upload images from their hard drive to your site, and display these images in their chat messages.
If this option is set to true, users will be able to provide a link to an image located on another site, and display this image in their chat messages. If false, users may only link to images residing on the current domain, specified by the current_domain
The current domain, ie. fastcatsoftware.com (don’t include http or www). Images links in chat messages are always allowed if they originate from within the current domain.
This parameter is for use with sites that have integrated their user accounts with the chat. If true, FCChat will utilize (when available) a user’s site avatar when they connect with their site account.
The scripting environment of your site. Choices are “php” and “asp”.
Location of the avatar storage folder. If blank, the default location is used.
Location of the images storage folder. If blank, the default location is used.
Location of the smileys storage folder. If blank, the default location is used. More info on smileys can be found in the section, Setting Up Smileys
FCChat images are stored in the directory ‘FCChat/html/images’ and avatars in ‘FCChat/html/images/avatars’. Set write permissions for both of these directories if you allow user to upload images/avatars. (For Linux: 777 or -rwxrwxrwx within your FTP Client)
The height, in pixels, of the avatar image displayed next to a user’s screen name.
Allow users to change their avatar.
If true, the avatar image is displayed next to a user’s screen name in their chat messages. If false, it is not. Note: This does not turn off avatars in the side panels (online, Friends, Room Members).
2.2.26 Setting up Smileys
Games section shown below:
//GAME ID'S should match game names in language file
Set to false if you want to disable two player games.
A list of game ids. This list should match the list of game names found in the language file. Each id corresponds to a different game, for instance, 2 is chess, 1 is backgammon, etc. The order of the ids determine the ordering of the games in the games menu. Refer to the come2play.com developer documentation for more info on available games.
2.2.27 Setting up the video chat
Smileys Section shown below:
* IMPORTANT-READ THIS: In smileys, You
* must escape any single quotes with three backslashes.
* ie, a wink emoticon '-) must be encoded as \'-)
A formatted list of smileys.
You may add your own custom smileys to the chat or download them from any number of free smiley sites on the web. Place your smiley images in the directory: FCChat/html/images/smileys. To use these smileys in the chat, edit the parameter above as follows:
See also Changing the size of the smiley panel
smileys:[[‘SMILEY_IMAGE_NAME_1’, ‘EMOTICON_1′,’SMILEY_IMAGE_HEIGHT_1’], [‘SMILEY_IMAGE_NAME_2’, ‘EMOTICON_2′,’SMILEY_IMAGE_HEIGHT_2’], …,[‘SMILEY_IMAGE_NAME_N’, ‘EMOTICON_N’,’SMILEY_IMAGE_HEIGHT_N’]],
SMILEY_IMAGE_NAME_1 is the name of your first smiley image, ie. happyface.gif.
EMOTICON_1 is the text you want to associate with this smiley, ie. :-).
SMILEY_IMAGE_HEIGHT_1 is the height, in pixels, of your first smiley image.
You must enter these three parameters for each smiley you want to include. Be vary careful that you use the correct syntax. A mistake in syntax may result in an error which will prevent the chat from being displayed. It is recommended that you make a backup copy of the config file before editing smileys, so that you have something to revert back to. Note: You must escape any single quotes in your emoticons by preceding them with a three backward slashes ( \’ )
Below is an example of a correctly formatted smiley list, which includes three smileys.
2.2.28 Translator Configuration
Video Section shown below:
The video chat client is disabled by default. If you signed up for a video chat account, you will need to set the video_enabled
parameter to true in order to enable it.
Defines the kind of video chat access that will be available on the site. This parameter takes four values: 0 – no access, 1 – private video chat only, 2 – public video chat only, 3 – both public and private video chat.
Sets the maximum number of simultaneous streams that the chat client will allow.
Width (in pixels) captured by a user’s webcam,
Height (in pixels) captured by a user’s webcam,
Width (in pixels) captured by a user’s webcam when high definition is available,
Height (in pixels) captured by a user’s webcam when high definition is available,
Capture rate (frames per second)
Higher quality means less compression. Range is 0-100.
Show the audio video icon next to rooms which allow video chat. This icon is only meaningful if you have set videoconerence_only_in_designated_rooms
Increasing capture_width, capture_height and quality
will increase the video resolution. Increasing fps
will make the video appear less choppy.
Of course, increasing any of these values will also increase the video bandwidth consumption, which may degrade the quality of the video for users with slow connections.
2.2.29 Transliteration Configuration
Translator Section shown below:
Enables/disables the translator.
If you want all chats translated into a specific language by default, set this to true. Otherwise, no default translation will take place. A user may override any default settings by selecting/deselecting a translation language in the options panel.
A two letter language code representing the default translation language. The list of available language codes is found in the current ChatCenter style template (fcchat/styles/
folder). The list of language names may be found in the current language file (fcchat/languages/
The base url of the translation api.
The application id used to make requests to the translation service. You can use the default value provided, but at some point, you may want to get your own appID. Go to http://www.microsofttranslator.com/dev/ in order to sign up for your free appID.
Translator Section shown below:
Enables/disables the translateration service.
The transliteration service is powered by Google. The FCChat transliteration application automatically loads all available languages into the transliteration menu.
2.2.31 Miscellaneous Configuration Variables
Cookies Section shown below:
cookie_expires:1, //0 - end of session //1 - never
FCChat sets cookies on the user’s browser to maintain application state.
takes 2 values. 0 – cookies expire at the end of the session (when the user closes the browser). 1 – cookies never expires.
The other cookie related parameters above set the names of the cookies that FCChat uses. Ordinarily, you will not need to change these settings. The only instance in which it is necessary to change the cookie names is if you are running 2 or more different versions of FCChat on the same domain, which required different application states. Then you must change the cookie names for each version, in order to avoid conflics.
MISC Section shown below:
dir: window["fc_chat_path"] || "/FCChat/",
Allow users to post links to external sites.
When a user presses the ‘Help’ button, they are directed to this link, By default, help_link points to this manual.
If true, the help link will be shown.
If true, the user list link will be shown.
If true, the room settings panel will automatically open after the ChatCenter window has loaded.
Enables/disables window “pinning”. Application windows may be pinned/unpinned from their fixed position on the screen. A pinned window remains in place as a user scrolls up and down the page. An unpinned window scrolls with the page. The pin icon at the top left corner of the application window toggles the pin state.
Sets the default “pin state” of the application windows. When true, windows open in the “pinned” state by default.
When this is enabled, the chat will preload all of its images. This may make image transitions a bit smoother; however, it will increase bandwidth consumption. (Default: false)
If set to true, the toolbar will not be shown on the page.
If set to ‘test’, FCChat will determine whether the user’s browser is capable of running Flash. The other values this parameter can take are true or false, but these are really only used for debugging purposes.
If set to ‘test’, FCChat will determine whether the user’s browser is capable of running HTML5 websockets. The other values this parameter can take are true or false, but these are really only used for debugging purposes.
When this is set to 0, you must click on a screen-name in order to view the userbox. When it is set to 1, the userbox will pop up automatically when you hover over a screen-name (Default: 0)
Many of the elements of FCChat use the z-index property for stacking. To avoid potential conficts with page elements, and to make sure that the chat window is not hidden by page elements, the base z-index of FCChat elements is adjustable. Raising the value of this parameter brings the chat window closer to the foreground of the page. (Default: 0)
The last three parameters in this section should not be changed under ordinary operation of the chat.
See also 2.2.24 Configuration of Images, Avatars, and Smileys
2.3.1 Creating Avatar Galleries.
In order to create an custom avatar gallery, you will need to obtain some avatar images and upload them to the directory FCChat/html/images/avatars. You will find many free avatar gallery sites on the web, which you may use to stock your avatar gallery. Alternatively, you can create your own avatars.
To designate a particular avatar image as the default avatar, rename the file default.gif. (The default avatar must be a gif image.)
2.3.2 Setting Server Side Image/Avatar Properties
In fcchat/html/config/php_config.php (or asp_config.asp), you are given the following options:
ALLOW_UPLOADS If this option is enabled, users may upload their own avatars from their computer’s hard drive.
USE_GRAVATAR If this option is enabled, users may link to their Gravatar avatars.
USE_BOARD_AVATARS Depricated. If this option is enabled, users may link their forum avatar to the chat.
USE_GALLERY If this option is enabled, users may choose an avatar from the gallery of avatar images located in the html/images/avatars folder.
MAX_IMAGE_SIZE The maximum size of uploaded images, in kilobytes.
IMAGE_WIDTH/IMAGE_HEIGHT The maximum width and height of uploaded avatars. The two parameters must have the same value.
MAX_DIR_SIZE The maximum size (in bytes) of the upload directory. When this limit is exceeded, no further uploads will be allowed.
2.3.1 Changing the size of the smiley panel.
It is recommended that you use template overrides to change the width and height of the smiley panel; though, if necessary, you may also edit the style templates directly.
Cut and paste the following into the template overrides section of your FCChat configuration (or, if you do not have a built in configuration, into the template overrides section of global.config.js file):
Change the width and height numbers to whatever you want.
2.4 Additional Client Configuration topics: Page Level Configuration.
When you change the configuration variables in FCChat/config/config.js
, these changes are applied globally to all pages in which the toolbar is installed. If you wish to have a special configuration for a particular page, you need to use page level configuration.
In order to employ page level configuration, insert a script tag into the body section of your web page.
Let’s say, for instance, that you want to change the greeting on a particular page. Simply place the configuration variable ‘autoGreet’ between the script tags, as follows:
Because you are referencing ‘autoGreet’ outside the configuration file, you need to preface if with FCChatConfig.
2.5 Chat Client Style Templates
2.5.1 Embedded Widget Style Template
2.5.2 Floating Toolbar Style Template
In order to change the style parameters of the embedded chat widget
, go to the fcchat/styles
folder and open the current widget style template (To see which widget style template you are currently using, refer to the styles section
of the config file).
2.5.3 ChatCenter Style Template
In order to change the style parameters of the floating toolbar
, go to the fcchat/styles
folder and open the current toolbar style template (To see which toolbar style template you are currently using, refer to the styles section
of the config file).
In order to change the style parameter of the ChatCenter Window
, go to the fcchat/styles
folder and open the current ChatCenter style template (To see which ChatCenter style template you are currently using, refer to the styles section
of the config file).
2.6 FCChat Administration
FCChat comes with a built in administration panel. There are two levels of administrative privileges, administrators and moderators. Administrators are granted full privileges. Moderators are granted a limited set of privileges.
2.6.1 Getting to the Administration Panel.
2.7 Toolbar Items
Administrators and moderators gain access to the administration panel through their user dialog box. Open the chat panel and click on your screen name. If you have administrative privileges (ie. if the words <admin> or <mod> appear next to your screen name), you will see, in your user dialog box, a link that says ‘mod’. Click on this link and you will be taken to the administration panel.
2.6.2 Administration Panel Layout.
A view of the administration panel. Click to enlarge
188.8.131.52 Search Window. (A)
2.6.3 Administrative Functions
In this window, the results of your search queries are displayed.184.108.40.206 User Search Box. (B)
Search for a particular user, or a group of users, with the User Search box. A search consisting of the letter ‘a’, for instance, will bring up all users whose screen names begin with ‘a’.
220.127.116.11 Common Query Select Box (C)
Select from the following queries:
1) Show all users
18.104.22.168 User Administration Window. (D)
2) Show globally blocked users (Users that have been blocked from chatting in all rooms)
3) Show users blocked from sending private chats.
4) Show auto-blocked users (users that have been automatically blocked by the system for possible spamming activities)
5) Show users blocked in current room.
6) Show blocked IPs (only administrators have access to this function)
7) Show Moderators
8) Show Administrators
9) Show Chat Text Filter (only administrators have access to this function)
10) Show Screen Name Filter (only administrators have access to this function).
Load a user into the User Administration Window by clicking on their name in the Search Window. Moderate the activities of individual users through this window. (See 22.214.171.124 Single User Moderation
126.96.36.199 Add to Blocked IPs (E)
Adds to the list of (permanently) blocked IPs. You may display this list by selecting ‘Show blocked IP’s’ from (C). The ‘remove’ option after each member of the list allows you to remove that item from the list.
188.8.131.52 Add word/phrase to chat text filter (F)
Adds a word or phrase to the chat text filter list. You may display this list by selecting ‘Show Chat Text Filter’ from (C). The ‘remove’ option after each member of the list allows you to remove that item from the list. The chat will filter (block) any sequence of characters you enter from being used in chat messages; thus, you must be carefull when entering a short phrase. For instance, entering ‘ant’ into the filter would block ‘ant’, ‘plant’, ‘antimony’, and any other phrase containing the sequence ‘ant’. A maximum of 50 characters is allowed per phrase.
184.108.40.206 Add word/phrase to screen name filter (G)
Adds a word or phrase to the screen name filter list. You may display this list by selecting ‘Show Screen Name Filter’ from (C). The ‘remove’ option after each member of the list allows you to remove that item from the list. The chat will filter (block) any sequence of characters you enter from being used in screen names; thus, you must be carefull when entering a short phrase. For instance, entering ‘ant’ into the filter would block ‘ant’, ‘grant’, ‘anthony’, and any other screen name containing the sequence ‘ant’.
220.127.116.11 Reboot Chat. (H)
Reboots the chat server. This will clear all rooms and delete all users. The reboot does not happen immediately. Instead, clicking ‘Reboot Chat’ schedules the server to reboot itself within the next 300 seconds. This function is not cancellable.
18.104.22.168 Update Select Server Configuration Variables. (I,J,K,L)
You may update the values of the server configuration variables ‘guestNames’, ‘showTyping’, ‘useAvatars’, and ‘showNewestMessages’. See also 22.214.171.124 Setting Server Configuration Variables
126.96.36.199 User Integration (M,N)
See also 188.8.131.52 Setting Up user integration
184.108.40.206 Switch Administrator. (O)
Takes you to a login screen where you may sign in to the administration panel as a different user.
220.127.116.11 File Editor (P)
You may edit the configuration and style files using the file editor. See also 18.104.22.168 Using the File Editor
22.214.171.124 Server Configuration Viewer. (Q)
From this window, you may view you current chat server configuration, specified by the file FCChatserver/conf/chatserver.config
, which is located on the machine hosting your chat server. If you are not physically hosting the chat server yourelf, this file is not directly editable. In this situation, you may only make changes to the chat server configuration through the administration panel controls, or by contacting your chat server host, and asking them to manually update the file.
126.96.36.199 Room Administration (Create/Edit/Delete/Clear)
(Administrator privileges required)
From the administration panel, open the “Options” dialog in the Chat Room Window to view the room list. You will see the above functions clearly marked.
188.8.131.52 Censor Chat Message
When in the administration panel, the word ‘Censor’ appears next to each chat message in the Chat Room Window. Click on this to censor the associated chat message. When a message is censored, the entire message is replaced by the phrase **Comment Deleted**.
184.108.40.206 Add/Remove Blocked IPs
(Administrator privileges required)
220.127.116.11 Add/Remove A Phrase from the Chat Text Filter
Use the ‘Block IP’ control to add an IP to the blocked IP list. IPs blocked in this way are blocked permanently. (There is a second way to block an individual user’s IP. See 18.104.22.168.5 Block User’s IP
). To remove a blocked IP, select ‘Show Blocked IPs’ from the Common Queries Select Box. A list of blocked IPs will appear. Beside each one, you will see the remove option.
(Administrator privileges required)
Use the ‘Add word/phrase to chat text filtered Phrase’ control to add a word or phrase the chat text filter. Adding a word to this filter automatically censors that word in chat messages. A censored word, such as ‘dirty’, for instance, will appear in chats as *****. The chat will filter (block) any sequence of characters you enter from being used in chat messages; thus, you must be carefull when entering a short phrase. For instance, entering ‘ant’ into the filter would censor ‘ant’, ‘plant’, ‘antimony’, and any other phrase containing the sequence ‘ant’. To remove a word from the word filter, select ‘Show Chat Text Filter’ from the Common Queries Select Box. A list of filtered phrases will appear. Beside each phrase, you will see the remove option.
22.214.171.124 Add/Remove A Phrase from the Screen Name Filter
(Administrator privileges required)
Use the ‘Add word/phrase to screen name filter’ control to add a word or phrase the screen name filter. Adding a word to this filter automatically blocks any user from signing in with a screen name whose characters contain the filtered phrase. The chat will filter (block) any sequence of characters you enter from being used in screen names; thus, you must be carefull when entering a short phrase. For instance, entering ‘ant’ into the filter would block ‘ant’, ‘grant’, ‘anthony’, and any other screen name containing the sequence ‘ant’. To remove a word from the screen name filter, select ‘Show Screen Name Filter’ from the Common Queries Select Box. A list of filtered phrases will appear. Beside each phrase, you will see the remove option.
126.96.36.199 Reboot Chat
(Administrator privileges required)
188.8.131.52 Setting Server Configuration Variables
(Administrator privileges required)
184.108.40.206 Setting up User Integration
You may edit a few select server configuration variables via the administration panel — ‘guestNames, ‘showTyping’, ‘useAvatars’, and ‘showNewestMessages’. See also, 220.127.116.11 Update Select Server Configuration Variables. (I,J,K,L)
above. The other variables found in the server configuration file cannot be edited through the administration panel They must be changed by directly editing the file. Since you do not have direct access to the server configuration file, if the need arises, you may contact a Fastcat representative and we will update your configuration file for you.
18.104.22.168 Using the File Editor
Please refer to the User guide
for tutorials concerning user integration, or contact Fastcat support for more info.
Coming Soon. Please contact Fastcat support for more info about this topic.
22.214.171.124 Single User Moderation
The functions below are accessible after loading a user into the User administration Window. To do this, perform a search for a user, and click on their name in the Search Window.
126.96.36.199.1 Block in Room(s)
You may block a user from chatting in any particular room, or globally (in all the rooms at once) if you have enough privileges.
188.8.131.52.2 Release Auto Blocks
This function releases the auto-block placed on a user.
An auto-block may be generated when the system suspects that a user is attempting to spam with private chat messages. An auto-block blocks a user from sending private chats for a period equal to autoLockingInterval, a configuration variable found in chatserver.config, whose default value is 900 seconds. Auto-blocks are controlled by two additional configuration parameters, offlineUserMsgThreshold and blockThreshold, whose definitions are given in chatserver.config.
184.108.40.206.3 Boot User
This function disconnects a user from the chat server. It does not prevent them from returning, however. If you want to keep them from coming back you must use this in conjunction with IP blocking.
220.127.116.11.4 Delete all Messages
This Function censors all a user’s chat messages at once. Administrators have this privilege by default. Administrators may grant or revoke this privilege from moderators. The affect of this command is not instantaneous, unlike single message censorship. End users will not notice any change until they refresh and reload their chat panels. Thus, if you need something removed instantaneously, use single message deletion.
18.104.22.168.5 Block User’s IP
This function is for use by administrators only. You may place two types of IP blocks on users, a temporary block, lasting for 30 minutes, and a permanent block. Most of the time you will want to use the temporary block, since permanent blocks can potentially make the chat inaccessible to more than just the intended recipient of the block. To remove an IP block, select ‘Show blocked IPs’ in the Common Query Select Box. When the list of blocked IPs appears, select the remove option from the IP you want to delete from the list.
22.214.171.124.6 Promote to Moderator
Note:Simply blocking a user’s IP will not remove them from the chat if they are already connected. You must use this command in conjunction with the Boot User Command in order to ‘Kick and Ban’ a user.
126.96.36.199.7 Promote to Administrator
Administrators may promote user to moderator status. They may also assign or revoke the following privileges:
1) Allow/Deny global message blocking.
2) Allow/Deny private message blocking.
3) Allow/Deny Delete all messages privilege.
The site administrative account (this is the first account that appears in the server conifiguration file, usually named admin) may grant/revoke administrator status.
188.8.131.52.8 Set Title
Administrators may assign a title to user accounts, such as “Staff”, “Customer Support”, “Senoir Member”, “Guest Speaker” etc. in order to highlight special accounts
184.108.40.206.9 Change password
Administrators may change the password of their own account, or acccount with less privileges than them.
2.7.1 Adding toolbar items
, above, contains a comma separated list of items that will be displayed in the toolbar. The order that items appear in this list is also the order that they will be rendered in the toolbar. The list MUST contain “friendscenter”. The other items in the list are optional.
Premade toolbar items are found in the fcchat/toolbar_items/
folder. The items will change over time, but we present, here, the ones that are present at the time of this writing. To include a toolbar item, add the colon separated path to the toolbar item, to the toolbar_items
For instance, the social_media item is located in the social_media/
subfolder, so when you add it to the list you will write “social_media:social_media”
(The actual file name is social_media.js, but you will omit the .js part).
The wp_search (wordpress search) item is located in the search/wordpress/
subfolder, so when you add it to the list you will write “search:wordpress:wp_search”
Do not add any content from the custom_buttons/
subfolder. This is a special folder reserved for creating customized buttons.
Here are some the the available items:
The interface to the chat.
Opens a dialog containing a list of sharing options.
A search function for wordpress sites. Opens a search dialog.
A search function for wordpress sites, where the search input appears in the menu.
Adds the branding bar to the toolbar. The branding bar can be configured from the FCChat Configuration (specifically, in the BRANDING section).