Go to main content
1/14
Contents
Title and Copyright Information
Preface
Audience
Related Documents
Document Revision History
Documentation Accessibility
1
Convergence Customization Concepts
Customization Overview
Directory Placeholders Used in This Guide
Key Features of Customization
Skills Required for Customizing Convergence
About Convergence Customization Workflow
Enabling the Customization Framework
Customizing Convergence
Restarting the GlassFish Server
Possible Problems
About the Customization Examples
Enabling Customization in the Convergence Server
Customization Directory Structure
Creating the Customization Directory
Convergence c11n_sample directory
Customizing Different Domains
Defining Which UI Components Are Customized
To Enable the mail.CreateMessage Widget
Technical Overview
About How Topics Apply to My Customizations
About Convergence Architecture Customization Support
Convergence Customization Booting
Customization Loading Order at Run Time
Loading Order for Multiple Domains
Loading Order Across All Domains
Directory Layout
Dojo Basics
Using the Debugging Directory to Customize Convergence
About Dojo Statements Map to the Convergence Directory Structure
Preserving Custom Widgets During Upgrades
Preserving Themes During Upgrades
Preserving Dojo Widgets During Upgrades
Consolidating Convergence Customizations to Preserve Client Performance
About the custom-useroptions.properties Mapping File
Structure of custom-useroptions.properties Mapping File
2
Enabling and Disabling Customization
About Enabling Customization for the Deployment, Domains, and Users
Enabling Customization for the Convergence Deployment
Enabling or Disabling Customization for an Individual User
Enabling or Disabling Customization for an Individual Domain
3
About Convergence UI Widgets
Location of Javascript Widgets
Common Widgets
Mail Widgets
Address Book Widgets
Calendar Widgets
Instant Messaging Widgets
Audio/Visual Widgets
Options Widgets
4
Working with the Convergence UI
Customization Requirements
Theme Customization Features
Default Themes Included with Convergence
About the Basic Theme
Basic Theme Properties
JSON Reference for Customizing Themes
Example Theme.json File
Customizing Layout HTML Pages
Creating and Customizing login.html
Creating and Customizing login.html in a Hosted Domain
Modifying the Login Page Welcome Message
Creating and Customizing main.html
Configuring the Per-Domain Main Page
Creating and Customizing calendar.html
Setting a Theme in an Anonymous Calendar
Customizing Anonymous Calendar Date and Time Format
Integrating Third-Party Applications
Integrating HelloConvergence into Convergence
About Adding a New Language
Adding a New Language in Convergence
Adding a New Language that Does Not Currently Exist in the Dojo Toolkit
Sample Custom l10n Resource File
Adding a Label for the New Language to the Global Options Language Menu
Adding a Label for the New Language to the Convergence Login Page
Setting Help for Unsupported Locales in the Convergence Banner
5
Convergence UI Customization Examples
Customization Requirements
Modifying a Specific Theme
Hiding a Single Theme
Creating a New Theme
Making a Newly Created Theme the Default
Adding a Logo to All Themes
Adding a Logo to the Right Side of the Banner
Making the Banner Logo a Clickable Link
Handling Large Logos in Gradient Themes
Re-Sized Gradient Banner Samples
Customizing the Dark Blue Theme
Adding and Removing Fonts from the Editor Menu
Changing an Icon in the Service Selector
Displaying and Printing the Japanese Yen Symbol
Modifying the Document Title and the Convergence Text in the Banner
Changing Names and Labels in the Convergence UI
Removing or Changing the Product Name on the Mail HTML Page
Displaying a Password Policy in the Convergence UI
Hiding the Quick Actions Menu
6
Convergence Messaging Customization Examples
Customization Requirements
Changing the Mail Forward Default from As Attachment to Inline
Changing Default Folder Mappings for Sent and Deleted Messages
Changing From: Address to Only Include Email Address
Changing or Removing the Signature Separator
Modifying Mail Folder Icons in the Service Navigator
Removing Folder Sharing and Subscribing Menu Options
Removing the Local Account Mail Forwarding Option
Removing the Move Button in the Mail Open Folder
Removing the Reply-To Address Option
Restricting OutGoing Mail with Local Account Identity Parameters
Hiding User-Created Folder Names
Adding Additional Spell Checker Dictionaries
Customizing the Attachment Blacklist and Whitelist
7
Convergence Calendar Customization Examples
Customization Requirements
Displaying a Complete Title in Calendar List Views
Adding or Modifying Calendar Time Zones
Categorizing Calendar Events with Text or Background Colors
Disabling Event Balloon User Input Saving as Event Description
Disabling Quick Parsing Calendar Capabilities
Removing the Attachment Button in the New Task Tab
Removing Reservations from the New Event Tab
Disabling Calendar Event Notification by SMS
8
Convergence Address Book Customization Examples
Customization Requirements
Changing the Corporate Directory Name
Displaying Additional Address Book Attributes When Adding Contacts to an Invitation
Displaying Additional Address Book Attributes When Adding Resources to an Invitation
Removing the Copy To Button
Removing the Google Maps Link
Importing or Exporting Address Book Information in a Custom Language
9
Convergence Instant Messaging Customization Examples
Customization Requirements
Displaying Multi-Network Icons in Federated Instant Messaging
10
Convergence Options Customization Examples
Customization Requirements
Disabling External POP Account Access
Enabling or Disabling the Modification of Identity Settings
Redirecting Users to Another Page to Change Password
Removing Change Password, Vacation Message, and Calendar Notification Options
Removing Default Language List in General Options
Removing Languages from Language List in General Options
Customizing the Default Alert Sounds
11
Custom Convergence Modules
Scripting on this page enhances content navigation, but does not change the content in any way.