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