This is an old revision of the document!
Table of Contents
Smileys
Usage
DokuWiki can convert text smileys to their graphically equivalent. The default smileys images are stored in the lib/images/smileys/
directory and configured in the conf/smileys.conf
file.
Customize smileys
To add your own smileys, and make them upgrade-safe as well, you should follow these instructions instead of mixing them with the default-smileys from Dokuwiki-package:
- Create a new folder called
local
inside the smileys-dirlib/images/smileys/local
and put the imagefiles into it (make sure the images are readable by the webserver)
- Create a custom smiley-config file at
conf/smileys.local.conf
and prefix each image filename with “
local/
…”
An example configuration file could look like this:
# Custom Smileys # Images are seen relatively from the smiley directory lib/images/smileys/ # TEXT_TO_REPLACE FILENAME_OF_IMAGE # :MYFACE: local/i_am_so_pretty.jpg
Notes and hints
- It is good practice to surround your own text macros with colons (“:”), like “
:REPLACEME:
” - You can't use
#
or$
in the configuration file. - If your newly added smiley does not appear in your edit toolbar popup, it is almost always a problem of caching. You may have to purge the cache, then refresh your page.
User provided additional smileys
The following smileys were created by DokuWiki users, using a similar style to the default ones. If you like them place them in your smiley directory and adjust the config file.
Smiley image | created by |
---|---|
Toby | |
Toby | |
Jon Schneider | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
Kevin Locke | |
JJ Asghar | |
Hella Breitkopf | |
Hella Breitkopf | |
Kevin, modded by Andreas |