Pronto! XIMSS Client

The client provides you access to all CommuniGate Pro "services" enabled for your Account and Domain:

Mail

If this Service is enabled, you can read and compose new E-mail messages.

WebCal

If this Service is enabled, you can review and update your Calendar information.

Signal

If this Service is enabled, you can send and receive Instant Messages and Presence information.

WebSite

If this Service is enabled, you can manage your File Storage.

PBX

If this Service is enabled, you can make and receive phone calls.

The Pronto! client can be easily integrated into a "portal" environment, allowing a user to enter a Pronto! session without explicitly entering the username and/or password data.

To start Pronto!, direct the browser to the following URL:

[http|https]://server[:port]/Pronto/[?parameters]

server

the CommuniGate Pro server/cluster address

parameters

URL parameters. The following parameters are supported:

username

the user Account name (for Auto Login).

password

the user Account password (for Auto Login). This is not a secure Auto-Login method, and it should be avoided.

sid

a SessionID for a WebUser or XIMSS session the specified user Account has already opened. It will be used for Auto-Login.

hideLogin

if this parameter value is yes, and the username and password/sid parameters are specified, the Pronto! Auto Login will take place without displaying the Pronto! Login screen.

useHTTPBinding

if this parameter value is yes, the Pronto! XIMSS session will be established using HTTP binding instead of a direct TCP connection.

Customizing logos

The image files contained in the Pronto4 skin can be customized to add custom logos or login scree pictures.

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.

customlogo125x37.png

Rotates with the CommuniGate Pro logo on the login page. Size: 125x37pixels, background: transparent.

loginlogo110.png

The logo used in the AIR-based version of Pronto4

Customizing preloaders

Pronto preloaders are simple .swf files which are executed during application initialization and can be created with Flash Professional easily. Two templates are provided in the archive. One of the sample preloaders includes logo and displays progress as a text. The second one displays no text and no logo, so it can be used without modifications if you need to get Pronto! installation without the Pronto logo.

The archive also includes the basic ActionScript code that make preloaders tick. Any preloader should have at least a public property progress (of a numeric type). Optionally, a preloader can have public property loadingText, which is a String. These two properties are already used in the Preloader.as script in example preloaders.

To replace Pronto preloader, the custom preloader.swf should be installed into Pronto4 skin of the domain.

Creating color schemes

Pronto4 provides the built-in color scheme editor. To start it right click on the Preferences button to select the "Show customization panel" command. The workflow is as follows:

1. The work in progress can be saved at any time. The design is stored in the account file storage.
2. The color scheme being designed can be downloaded using the Download button. The resulting file can be uploaded to the Pronto4 skin to be immediately available to the users.
3. The name of the scheme can be made more user-friendly and ready for localization process. The user-friendly names are retrieved from the LookLabels dictionary in strings.data of the Pronto4 skin. If the custom Pronto4 skin does not have yet a custom strings.data file, one needs to be created with just the LookLabels dictionary inside:
   LookLabels = {
     special_scheme = "For color blind";
     spec2 = "High Contrast";
   };
4. If the new scheme should be used by default, rename it to strings.look-default.data and upload it to the skin

Customizing toolbar icons

The toolbar icons are stored inside the mailloadassets.zip archive in Pronto4 skin as plain .png files. To override default ones, simply download the archive from the skin, store modified icons into it and upload back to the skin.

Adding buttons to taskbar

You can add multiple buttons to Pronto! taskbar that point to external pages, they will show up near Preferences/Logout buttons. To add them, you need to modify two dictionary parameters in strings.data:

AdditionalProntoButtons

Specify buttons to add. The entry name is displayed on the button, the value is an URL used as a link.

AdditionalProntoButtonNames

(optional) Specify localized labels for custom buttons. Entry names should correspond to entries in AdditionalProntoButtons, and the value is the localized button label.

URLs specified in AdditionalProntoButtons can contain the following templates, which are substituted by Pronto! when user clicks on the button:

%%ID%%

Replaced by sessionID

%%accountName%%

Replaced by accountName, no domain part

%%domainName%%

Replaced by domain of the account

%%fullAccountName%%

Replaced by full account name: user@domain

%%realName%%

Replaced by user's real name (taken from <session/> XIMSS response)

Customizing File Sharing URL Scheme

When a user shares a file in his file storage (this also happens when a user sends a file over IM), the link to the file is based on the user session properties: if the user is connected over HTTPS, https:// link will be created, otherwise Pronto! will create http:// link. If the user is connected over unusual port (like 8100), it'll be also added to the link.

Sometimes it is desired to specify URL scheme and port that should be used for creating these links regardless of the user's session properties. To do so, you need to specify the following parameters (both are optional) in strings.data:

FileSharingURLScheme

URL scheme to be used in shared file links. Either http or https

FileSharingURLPort

Port number to be used in shared file links

Customizing login page

The following parameters in strings.login.data skin file control the appearance of Pronto AIR login page:

ShowSecureSelector

Set to "YES" to enable display of the "secure" checkbox.

UseSecureConnection

Set to "YES" to force secure connection to the server when the option to select the secure connection mode is hidden.

EnableCustomSignUp

Set to "YES" to use a custom sign-up page.

CustomSignUpURL

Set to the string with the URL to use as the custom sign-up page.

ShowLanguageSelector

Set to "YES" to enable language selector on the login page.

Customizing single-window mode

The following parameter in strings.shell.data skin file control the appearance of main Pronto view in single-window mode:

SingleWindowModeIMPosition

If specified and value is "left" IM panel would be placed at the left, otherwise at the right side of the view.

The Pronto! Mobile applications installed on iOS and Android devices support Push notifications which could be sent by the CommuniGate Pro server via APNs (Apple Push Notification Service) and FCM (Firebase Cloud Messaging) servers. When Instant Message or incoming call is directed to the user Account, the CommuniGate Pro server checks if there are any APNs or FCM tokens of the Pronto! Mobile application stored on the server for this Account and sends the Push notification requests to the APNs and FCM servers for all found tokens of the Account iOS and Android devices.

The Push notification received by the Pronto! Mobile application is displayed on the user mobile device and contains brief information about the pending call or Instant Message, such as sender Name or Address and a part of the message body. The Push notifications allow Pronto! Mobile application to wake up if it was inactive and immediately receive the incoming call or Instance Message.

To be able to send Push notification requests the APNs provider certificate and FCM server key are required. Please contact CommuniGate Systems technical support to request these key and certificate.

Open the Preferences page of the Account Settings:

Send Push Notifications

If this option is enabled, the server sends Push notification requests for each incoming call or Instant Message directed to this Account. Otherwise, Push notifications are not sent.