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:
- Create a file named emoticonDefs.xml with any text editor.
- 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. - Save and close emoticonDefs.xml.
- 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.
- Program Files\Cisco Systems\Cisco Jabber\Emoticons
- 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 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. |
image |
This attribute specifies the filename of the emoticon image. |
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. true
false
|
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. |