How Do I Add Custom Emoticons with Cisco Jabber for Windows?

Organization Administrator only

How do I add Custom Emoticons with Cisco Jabber for Windows?

How do I create Custom Emoticons in Cisco Jabber for Windows?

Can I have Custom Emoticons with Cisco Jabber for Windows?


Solution:

Organization Administrator only

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. 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

Follow the steps below to add Custom Emoticons:

  1. Create a file named emoticonDefs.xml with any text editor.
  2. Specify the emoticon definitions as appropriate in emoticonDefs.xml.
    Note: See Emoticon Definitions for more information on the structure and available parameters for emoticonDefs.xml.
  3. Save and close emoticonDefs.xml.
  4. Save emoticonDefs.xml in the appropriate directory on the file system.
    Note: Cisco Jabber for Windows loads emoticon definitions from the following directories on the file system:
    • Program Files\Cisco Systems\Cisco Jabber\Emoticons
      • This folder contains the default emoticons for Cisco Jabber for Windows and the default emoticonDefs.xml.
    • Program Files\Cisco Systems\Cisco Jabber\CustomEmoticons
      • This 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.
  5. Restart Cisco Jabber for Windows.


Note: 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:

  • User A defines a custom emoticon in emoticonDefs.xml. The custom emoticon definition exists only on User A's local file system.
  • User A sends that custom emoticon to User B.
  • 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 attributeDescription
emoticonsThis element contains all emoticon definitions.
emoticonThis 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.
Specify any key combination as the value.
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.

textThis 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.
orderThis 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.
altThis 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.

 

­

Was this article helpful?