Advanced Customization

 


How to Create/Edit Customizations

ISL Online allows you to create and apply different customizations. This sections explains how to create new/modify existing customization on your ISL Conference Proxy.

Note: Please make sure you have the latest ISL Conference Proxy, modules and programs installed. ISL Light 3.2.0a or newer is required.

  • Create New Customization

To create new customization please follow these steps:

  1. Login to your ISL Conference Proxy administration (http://localhost:7615/conf).
  2. Go to Configuration - Advanced - Customize.
  3. Click Create new customization button.
  4. Enter customization name.
  5. If you wish to view more settings tick the Show expert settings checkbox.
  6. Click Save when you are done.
  • Edit Existing Customization

To modify an existing customization please follow these steps:

  1. Login to your ISL Conference Proxy administration (http://localhost:7615/conf).
  2. Go to Configuration - Advanced - Customize.
  3. Click on one of the existing customization's button.
  4. Modify the desired settings. 
  5. If you wish to view more settings tick the Show expert settings checkbox.
  6. Click Save when you are done.

Change The Name of the Executable Files

You can also change the names of ISL Online products. You can for example change the name of your ISL Light executable file. 

To change the name of ISL Light executable add the following parameter in the Extra query p. for ISL Light entry:

changebase=MyCompanySupport 

You can change the "MyCompanySupport" string to whatever name you wish to have. Note: The parameter has to be URL Encoded. 

In the same manner you can also change the names of other ISL products by setting the appropriate setting:

  • Extra query p. for ISL Light: Customize the name of ISL Light executable file.
  • Extra query p. for ISL Light Client: Customize the name of ISL Light Client executable file.
  • Extra query p. for ISL Light Desk: Customize the name of ISL Light Desk executable file.
  • Extra query p. for ISL AlwaysOn: Customize the name of ISL AlwaysOn executable file.
  • Extra query p. for ISL AlwaysOn Connect: Customize the name of ISL AlwaysOn Connect executable file.
  • Extra query p. for ISL Pronto: Customize the name of ISL Pronto executable file.
  • Extra query p. for ISL Player: Customize the name of ISL Player executable file.
  • Extra query p. for ISL Groop: Customize the name of ISL Groop executable file.
  • Extra query p. for ISL Network Start: Customize the name of ISL Network Start executable file.
  • Extra query p. for ISL Tester: Customize the name of ISL Tester executable file.
  • Extra query p. for ISL WebStart: Customize the name of ISL WebStart executable file.

Change all Appearances of ISL Light Strings to your Desired Strings

Find the Substitute ISL Light translations entry and enter desired strings for your ISL Light program. Note: If you can't see the Substitute ISL Light translations entry check the Show expert settings checkbox.

Example:

The following lines will change all appearances  of ISL Light Client and ISL Light Desk strings to the specified strings in the ISL Light program.

ISL Light Client=MyCompanySupport Client&ISL Light Desk=MyCompanySupport Desk 



ISL Light=MyCompany ISL Light&Log In=Please Log  Me In&Forgot Password?=Did you forgot your password? 


 

ISL Light Customization (.INI) File

Colors Section

This setting enables you to define colors used in ISL Light action buttons, notifications and URL links. 

  • success: Defines the background color for action button
  • success_dark: Defines the background color for action button in pressed state
  • action_button_text: Defines the text color used in action button
  • notify_notification_background: Defines the background color for notifications
  • notification_text: Defines the text color used in notifications
  • url_link: Defines the text color used in URL links


Templates Section

This setting enables you to define custom templates in ISL Light.

  • copy_url_template: Defines the URL link, which is generated when copying the ISL Light session link


Bellow you can see an example of ISL Light .INI customization file:

[Colors]
success=#2a94e3
success_dark=#2071b0
action_button_text=#FFFFFF
notify_notification_background=#FFEC7F
notification_text=#6C6C6C
url_link=#2BABE2

[Templates]
copy_url_template=https://mycompanyname.islonline.net/?sessioncode={code}


Bellow you can see an example how your ISL Light application will look like after applying this color scheme.



Advanced Customization - Unified Approach

ISL Light version 4.3.0 brings you support for ISL Conference Proxy customization settings, which were previously only available in mobile platforms. Customization settings for ISL Light desktop and ISL mobile applications are now unified. The customization will be applied on mobile platforms and also in ISL Light desktop application.

  • Change ISL Light Branding Images

    ISL Light allows you to replace default GUI images with your custom images.  
    You can change the following images in your ISL Light application:
    • keyvisual.png: Defines the main ISL Light icon  (412 x 412 - used on iOS/Android and 320x320 -used in ISL Light desktop)
    • app_icon.png: Defines the main ISL Light icon  (192 x 192 - used on iOS/Android and 96x96 -used in ISL Light desktop)
    • company_logo.png: Defines the main ISL Light Logo icon  ( 75 x 18 - used on iOS/Android and 98x22 -used in ISL Light desktop)
    • app_icon_notification_white.png: Defines the main ISL Light notification icon, which is only used on Android devices (24 x 24-used on Android). Note: app_icon_notification_white.png must be white color with transparent background and is applied only on devices running Android version 6.0.0 and above.

 

 

It is also possible to specify platform localization, which will be used on a certain platform instead of using one common icon for all platforms (mobile and desktop). To define the platform you need to add the appropriate suffixes to your png images (e.g _ios, _android, _desktop)

Example:

Common icon: keyvisual.png

Platform localized icons:

  • keyvisual_ios.png
  • keyvisual_android.png
  • keyvisual_desktop.png - used for ISL Light 4 on all platforms


In order to apply these customization images, zip all the images to .zip file and upload the zipped file to ISL Light custom images (ZIP) setting.

  • Change ISL Light Color Branding

Apart from images, you can also modify colors or create custom templates by creating a .ini file. The content of the .ini file must be in adhere to a certain  structure. For more details how to create the branding file see the "ISL Light Customization (.INI) File" section above. 

Once you have created the file, upload it to ISL Conference Proxy customization under ISL Light customization (INI) setting.


Advanced Customization - Compatibility Approach

  • Change ISL Light Branding Images

You can change three images in ISL Light 4:

keyvisual.png (320x320), logo.png (96x96), logo_brand.png (98x22):

 

 

Find the Custom qml branding (ZIP) setting and upload a .zip file of your three images.

  • Change ISL Light Color Branding

Apart from images, you can also modify colors. Create a file called branding.ini. The content of branding.ini file must be in the following structure:

[Colors]

success=#b9d300

success_dark=#939e00

action_button_text=#333333

For more details how to create the branding file see the "ISL Light Customization (.INI) File" section above. Once you have created the file, compress it into a .zip file and upload it to ISL Conference Proxy customization under Custom qml branding (ZIP) setting.



Was this article helpful?