Icon Transformation
 | A rendering transformation to transform series of characters into icons (emoticons and others) |
| Type | JAR |
| Category | |
| Developed by | |
| Rating | |
| License | GNU Lesser General Public License 2.1 |
| Compatibility | XWiki 2.6RC1+ |
Table of contents
Description
Transforms some special characters representing icons into images. For example transforms the (:)) characters into a smiley: 
Here are the default mappings:
| Characters | Result |
|---|---|
| :) | |
| :( |  |
| :P |  |
| :D |  |
| ;) |  |
| (y) |  |
| (n) |  |
| (i) |  |
| (/) |  |
| (x) |  |
| (!) |  |
| (+) |  |
| (-) |  |
| (?) |  |
| (on) |  |
| (off) |  |
| (*) |  |
Customizations
It's possible to customize 2 things:
- Change the icon used to represent one of the default mappings
- Add new mappings so that other series of characters are recognized
- Remove default mappings
To make those changes, edit WEB-INF/lib/xwiki.properties and look for keys starting with the rendering.transformation.icon. prefix.
For example if you wish to change the icon used to represent :) so that it uses instead, you'd add or modify the following property like this:
The icons you can use and their names can be found in this Silk Icon Set Reference
If you wish to add a new mapping so that typing (h) generates a heart (
), you'd add:
. If you wish to remove a default mapping, simply redefine the emoticon with a blank value. For example to prevent (n) from displaying you'd add:
Prerequisites & Installation Instructions
This transformation is active by default so you should be able to use it right away.
If you wish to disable it or if someone disabled it and you need to re-activate it, edit WEB-INF/xwiki.properties, look for a property named rendering.transformations and make sure it's uncommented and contains the value icon.
For example:
