Cisco Jabber for Windows 9.7 Installation and Configuration Guide

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Book Contents
Find Matches in This Book
Available Languages
Download Options

Book Title

Cisco Jabber for Windows 9.7 Installation and Configuration Guide

Chapter Title

Customize Cisco Jabber for Windows

Results

Updated:
July 22, 2014

Chapter: Customize Cisco Jabber for Windows

Customize Cisco Jabber for Windows

Review what features you can customize after installation. Learn how to change these features to meet your organizational requirements.

Custom Emoticons

Applies to: Cisco Jabber for Windows

You can add custom emoticons to Cisco Jabber for Windows by creating emoticon definitions in an XML file and saving it to the file system.


Note
To achieve optimal results, your custom emoticons should conform to the following guidelines:

  • Dimensions: 17 x 17 pixels

  • Transparent background

  • PNG file format

  • RGB colors

Procedure

Step 1

Create a file named emoticonDefs.xml with any text editor.

Step 2

Specify the emoticon definitions as appropriate in emoticonDefs.xml.

See Emoticon Definitions for more information on the structure and available parameters for emoticonDefs.xml.

Step 3

Save and close emoticonDefs.xml.

Step 4

Save emoticonDefs.xml in the appropriate directory on the file system.

Cisco Jabber for Windows loads emoticon definitions from the following directories on the file system.

  • The directory can differ depending on your operating system

    • For 32-bit operating systems:

      • Program Files\Cisco Systems\Cisco Jabber\Emoticons

      • Program Files\Cisco Systems\Cisco Jabber\CustomEmoticons

    • For 64-bit operating systems:

      • Program Files(x86)\Cisco Systems\Cisco Jabber\Emoticons

      • Program Files(x86)\Cisco Systems\Cisco Jabber\CustomEmoticons

    The Emoticons folder contains the default emoticons for Cisco Jabber for Windows and the default emoticonDefs.xml.

    The CustomEmoticons folder does not exist by default. Administrators can create this folder to contain custom emoticon definitions to include in organizational deployments.

    Emoticons that you define in the CustomEmoticons folder take precedence over emoticon definitions in the default Emoticons folder.

  • %USERPROFILE%\AppData\Roaming\Cisco\Unified Communications\Jabber\CSF\CustomEmoticons

    This folder contains custom emoticon definitions for individual instances of Cisco Jabber for Windows.

    Emoticons that you define in this directory take precedence over emoticon definitions in the CustomEmoticons folder in the installation directory.

Step 5

Restart Cisco Jabber for Windows.

Cisco Jabber for Windows loads the custom emoticon definitions in emoticonDefs.xml.


Remember
Custom emoticon definitions are available to users only if they are defined locally in emoticonDefs.xml. If you send custom emoticons to users who do not have the same emoticon definitions, those users receive the default keys, not the icons; for example:

  1. User A defines a custom emoticon in emoticonDefs.xml.

    The custom emoticon definition exists only on User A's local file system.

  2. User A sends that custom emoticon to User B.

  3. User B receives only the default key for the custom emoticon. User B does not receive the icon.

Emoticon Definitions

Cisco Jabber for Windows loads emoticon definitions from emoticonDefs.xml.

The following XML snippet shows the basic structure for the emoticon definitions file:
<emoticons>
 <emoticon defaultKey="" image="" text="" order="" hidden="">
  <alt></alt>
 </emoticon>
</emoticons>
The following table describes the elements and attributes for defining custom emoticons:
Element or attribute Description
emoticons

This element contains all emoticon definitions.
emoticon

This element contains the definition of an emoticon.
defaultKey

This attribute defines the default key combination that renders the emoticon.

Specify any key combination as the value.

This attribute is required.

defaultKey is an attribute of the emoticon element.

image

This attribute specifies the filename of the emoticon image.

Specify the filename of the emoticon as the value. The emoticon image must exist in the same directory as emoticonDefs.xml.

This attribute is required.

Cisco Jabber for Windows supports any icon that Internet Explorer can render, including .jpeg, .png, and .gif.

image is an attribute of the emoticon element.

text

This attribute defines the descriptive text that displays in the Insert emoticon dialog box.

Specify any string of unicode characters.

This attribute is optional.

text is an attribute of the emoticon element.

order

This attribute defines the order in which emoticons display in the Insert emoticon dialog box.

Specify an ordinal number beginning from 1 as the value.

order is an attribute of the emoticon element.

This attribute is required. However, if the value of hidden is true this parameter does not take effect.

hidden

This attribute specifies whether the emoticon displays in the Insert emoticon dialog box.

Specify one of the following as the value:
true
Specifies the emoticon does not display in the Insert emoticon dialog box. Users must enter the key combination to render the emoticon.
false
Specifies the emoticon displays in the Insert emoticon dialog box. Users can select the emoticon from the Insert emoticon dialog box or enter the key combination to render the emoticon. This is the default value.

This attribute is optional.

hidden is an attribute of the emoticon element.

alt

This element enables you to map key combinations to emoticons.

Specify any key combination as the value.

For example, if the value of defaultKey is :), you can specify :-) as the value of alt so that both key combinations render the same emoticon.

This element is optional.

Remember
The default emoticons definitions file contains the following key combinations that enable users to request calls from other users:

  • :callme

  • :telephone
These key combinations send the callme emoticon, or communicon. Users who receive this emoticon can click the icon to initiate an audio call. You should include these key combinations in any custom emoticons definition file to enable the callme emoticon.

Emoticon Definition Example

<emoticons>
 <emoticon defaultKey=":)" image="Emoticons_Smiling.png" text="Smile" order="1">
  <alt>:-)</alt>
  <alt>^_^</alt>
 </emoticon>
 <emoticon defaultKey=":(" image="Emoticons_Frowning.png" text="Frown" order="2">
  <alt>:-(</alt>
 </emoticon>
</emoticons>

Create Custom Embedded Tabs

You create custom embedded tabs to display HTML content in the client interface.

You define custom embedded tabs as part of your client configuration file. See the Custom Embedded Tabs section for more information.

Was this Document Helpful?

FeedbackFeedback

Contact Cisco