Adding Fonts to Siebel Open UI

This topic describes how to add custom fonts to Siebel Open UI. Although you can add custom fonts, it is recommended that your Siebel Open UI deployment use only Web-safe fonts because you might not be able to control font usage. For example, assume you deploy a custom font to all users in your company, and that you also add this font to Siebel Open UI. Assume that one of your Siebel Open UI users chooses this font in a text editor in Siebel Open UI, and then sends this text in an email message to an external customer who has not installed this custom font on their computer. In this situation, your Siebel Open UI user can read the font but the external customer cannot read it.

Using Web-safe fonts helps to make sure that any browser or other client, such as a desktop computer or mobile device, can correctly render the text that your users provide, regardless of how each user configures font usage in their individual browsers or clients, or of the level of font customization that exists in your deployment environment. For more information about Web-safe fonts, see the topic that describes Web Safe Font Combinations at http://www.w3schools.com/cssref/css_websafe_fonts.asp.

To add fonts to Siebel Open UI

Create a JavaScript file that adds your custom font:
1. Create a new JavaScript file named ckeditorfontadditions.js, and then save this file in the custom folder.
  For more information about this folder, see Organizing Files That You Customize.
2. Add the following code to the file that you created in Step a. This code adds the fonts that Siebel Open UI displays in the Font picklists when the user edits text in the client:
```
if (typeof(SiebelAppFacade.CKEDITOREXTN) == "undefined") {   
  Namespace('SiebelAppFacade.CKEDITOREXTN');   
  (function() {   
    SiebelApp.EventManager.addListner("postload", ckeditorextn, this);   
    var updatedFont = "";   
    function ckeditorextn() {   
      try {   
        if (CKEDITOR &&   
          CKEDITOR.config.font_names !== updatedFont) {   
          CKEDITOR.config.font_names = CKEDITOR.config.font_names +   
            'font_families'   
          updatedFont = CKEDITOR.config.font_names;   
        }   
      } catch (error) {   
        // Nothing to do.   
      }   
    }   
  }());   
}
```
  where:
  - CKEDITOR.config.font_names is a predefined function that Siebel Open UI uses to store the list of fonts that it uses.
  - font_families specifies one or more font families that Siebel Open UI uses to render the font.
  - catch (error) catches any error that might occur when Siebel Open UI attempts to render the fonts that you specify. If an error occurs, then Siebel Open UI uses a predefined font to display the control.
  For this example, use the following code for font_families:
```
';Calibri/Calibri, Verdana, Geneva, sans-serif;'
```
  For more information about how to specify the font family, see Specifying Font Families.
Administer the manifest:
For more information about how to do this step, see Configuring Manifests.
1. Log in to the client as an administrator.
2. Navigate to the Administration - Application screen, and then the Manifest Files view.
3. In the Files list, add the file that you created in Step 2.
  You add the following record:
```
siebel/custom/ckeditorfontadditions.js
```
4. Navigate to the Administration - Application screen, and then the Manifest Administration view.
5. In the UI Objects list, add a new record. Use values from the following table.
  
  Type Usage Type Name
  
  Application
  
  Common
  
  PLATFORM INDEPENDENT
6. In the Object Expression list, add the following subexpression.
  
  Field Value
  
  Group Name
  
  Leave empty.
  
  Expression
  
  Desktop
  
  Level
  
  1
  
  Operator
  
  Leave empty.
  
  Web Template Name
  
  Leave empty.
7. In the Files list, add the file that you created in Step 2.
  You add the following record:
```
siebel/custom/ckeditorfontadditions.js
```
8. Refresh the manifest. Log out of the client, and then log back in to the client.
Verify that Siebel Open UI added your custom fonts:
1. Navigate to the Administration Communications screen, and then the All Templates view.
2. In the Compose Template section, in the Text window, click the Font drop-down, and then make sure the Font list displays the font that you specified in Step 1, Step b.

Field	Value
Group Name	Leave empty.
Expression	Desktop
Level	1
Operator	Leave empty.
Web Template Name	Leave empty.