Configuration

Configuring the Web Client

Although it is not mandatory, you can do some configuration and tweaks on the web client.

The most important configurations are the language to use on the client, and optionally the presence options.

Language

Since FOP version 2.20, you do not need to edit the index.html file. The language and a lot of other settings must be set in the presence.js file as described in the next section.

[snip]
    <script type="text/javascript" src="js/lang_en.js"> </script>
    <script type="text/javascript" src="js/presence.js"> </script>

    <script type="text/javascript" src="js/swfobject.js"></script>
    <script type="text/javascript" src="js/prototype.js"></script>
[snip]

Presence Options

The presence options are enumerated in the js/presence.js file, the default one is:

var presence = new Object();

presence['']               = '';
presence['Do not Disturb'] = '#FF8A8A';
presence['Out to lunch']   = '#57BCD9';
presence['Break']          = '#6094DB';
presence['Meeting']        = '#CDD11B';

You can set any number of options and their hex colors, do not remove the first 2 lines as they are mandatory... the empty presence is the one for "available" state.

This feature lets you select one of the options you define, and it will flag your extension with that color and a tooltip with the text description when someone mouse overs the presence icon. This way a receptionist will get a hint about your availability to take calls without the need to ring your phone.

There are a couple of more options to set in presence.js, these are global options, some of them can be overriden by the user preferences as set in the preferences pane:

var showLines = 2;
var notifyDuration = 6;
var warnClose          = true;
var dynamicLineDisplay = false;
var soundChat          = true;
var soundQueue         = true;
var soundRing          = true;
var displayQueue       = 'max'; // max or min
var pdateFormat        = 'ddd, HH:MM';
var disableVoicemail   = false; 
var language           = "en";
var voicemailFormat    = "wav";

showLines lets you select how many lines to display per button. You can reduce the number to 1, or increase it to 4. This setting is global and it will be applied to ALL extensions.

notifyDuration (2.10) lets you set the time in seconds to display inbound call notifications. You can increase the time or disable notifications completely by setting it to zero.

warnClose (2.20) set it to true to have a warning when leaving the fop2 page, or to false to disable the warning.

dynamicLineDisplay (2.20) this display mode will hide inactive lines for buttons, saving screen space. The drawback is that the display will not be even as some buttons will be higher than others if they have active lines.

soundChat (2.20) to enable or disable chat sounds.

soundQueue (2.20) to enable or disable new queued calls sound.

soundRing (2.20) to enable or disable the ringing sound.

displayQueue (2.20) Type of queue button display, can be set to "max" or "min". "max" displays all agentes and calls waitings in detail, while "min" shows just the agent and calls waiting count.

pdateFormat (2.20) format for date on notes.

disableVoicemail (2.20) to globally disable the voicemail explorer feature.

language (2.20) to set the global language.

voicemailFormat (2.20) the format for voicemail files, as configured in /etc/asterisk/voicemail.conf, set it to only one format if you have chosen more than one in the asterisk configuration.

Visual Phonebook

Important: FreePBX Installs

Since FOP version 2.22 the visual phonebook tables will be created automatically for you, there is no need to create a new database or edit the config.php file, so you can skip this step.

<?
// Database connection details 
$DBHOST = 'localhost';
$DBNAME = 'fop2';
$DBUSER = 'fop2';
$DBPASS = 'myPassw0rd';

$language="en";

// ---------------------------------------------------------
// Do not modify below this line
// ---------------------------------------------------------
..