The Pronto! application uses files stored in the selected Web Application Skin.
All Pronto! Skin names have the Pronto- prefix, while the Pronto Skin menus list these skins without that prefix.
When a new Skin Pronto-glass is created, it it seen to the users as the glass Pronto! Skin.
Pronto! Skins contain the files listed below. By uploading different versions of these files into different Skins, you can make Pronto! change
its look and feel depending on the Pronto Skin selected.
- loginlogoimage.png
- The main logo on the login page. Size: 350x117 pixels, background: transparent.
- loginimage.png
- Login page "screenshot image". Size: 440x340 pixels, background: opaque.
- logosmallimage.png
- The main screen logo in the top left corner. Size: 90x30 pixels, background: transparent.
- customlogosmall.png
- Rotates with the CommuniGate Pro logo in the right bottom corner of the main screen. Size: 90x30 pixels, background: transparent.
- customlogomedium.png
- Rotates with the CommuniGate Pro logo on the login page. Size: 145x50pixels, background: transparent.
- style.swf
- This file controls most of the Pronto! display elements.
- dialtone.wav, busy.wav, ringing.wav, ringalert.wav
- Dialer sounds. Sample rates: 44100, 22050, 11025, or 5512.5; bits: 8 or 16; channels: mono or stereo; format: RIFF (not RIFX) PCM; compression: none.
Some Pronto! components are implemented as separate modules. Each Pronto! module consists of two Skin files -
name.def (the module descriptor) and name.swf (the module code), where name is the module name.
The Pronto! application builds the available module list by reading all .def files visible in the selected Skin.
To disable some module name, upload an empty name.def file into the target Skin.
Login Options
The
LoginOptions dictionary in the selected Skin "strings" file controls the Pronto! Login page fields.
The following dictionary elements are used:
- LanguageMenu
- If this element is not NO, the Login page presents the Languages menu.
- ForgotPassword
- If this element is not NO, the Login page presents the "Forgot your password?" option link.
Custom Buttons
Custom buttons can be presented in the top toolbar next to the "Log Out" button.
Each buttons is linked to some URL, and if the button is clicked, a new browser window with the specified URL is opened.
Custom buttons should be specified using the AdditionalProntoButtons dictionary in the selected Skin "strings" file.
The dictionary key is an internal button name, while the dictionary value is a string with the URL associated with that button.
Example (2 buttons: WebSearch and WebShop):
AdditionalProntoButtons = {
WebSearch = "http://www.search-company.dom";
WebShop = "http://www.shop-company.dom";
};
The URL string can contain "macro combinations", which are substituted with the actual data before
the URL is used. The following "macro" are supported:
- %%ID%%
- the current XIMSS session identifier
- %%accountName%%
- the session Account name (URL-encoded)
- %%domainName%%
- the session Account Domain name (URL-encoded)
- %%fullAccountName%%
- the session Account full name (in the accountName@domainName form (URL-encoded)
- %%realName%%
- the session Account "real name" (URL-encoded)
Example:
AdditionalProntoButtons = {
"My Site" = "http://www.mysite.dom/%%ID%%/?name=%%realName%%";
};
ID a string with the unqiue identifier of this session accountName a string with the session Account name domainName a string with the name of the Domain the session Account belongs to
filesRef a string with the URL prefix needed to retrieve files from the session Skin fullAccountName a string with the session Account full name: accountName@domainName
The custom button titles are translated using the AdditionalProntoButtonNames dictionary in the selected Skin "strings" file.
(each lagunage-specific file can have a different dictionary).
Example (for 2 buttons: WebSearch and WebShop):
AdditionalProntoButtonNames = {
WebSearch = "Search";
WebShop = "My Shopping";
};
The following Pronto! components use the
External Banner System:
- EMail
- The banner area above the message list (type=prontoEmailTop),
between the message list and the message preview area (type=prontoEmailTop),
below the message preview area (type=prontoEmailBottom).
The Banner data returned with the External Banner System is expected to be a dictionary with the following elements:
- bgcolor
- a "web-formatted" color string, such as #066 or navy
- contentType
- the banner image format (jpeg, gif, png)
- data
- the banner image data, specified in one of the following formats:
- [base64data] - the base64Data string is base64-encoded binary image file data.
- skin:fileName - fileName specifies the name of a Skin banner image file.
- http://url - an HTTP URL for the banner image file.
- timePeriod
- a string or a number specifying the banner display time (in seconds). When this time is up, the component re-sends the request to get a new banner to display.
- vsize
- a string or a number specifying the banner image height (in pixels)
- width
- (optional) a string or a number specifying the banner image width (in pixels)
- onClick
- (optional) the URL to open when the user clicks the banner.
If an External Banner System response for some banner type is empty or its timePeriod element is zero or absent,
the new banner is not displayed, the existing banner (if any) is removed, and
the component stops sending External Banner System requests for banners of that type.
CommuniGate® Pro Guide. Copyright © 1998-2009, Stalker Software, Inc.
