DokuWiki can convert text smileys to their graphically equivalent. Smileys images are stored in the lib/images/smileys/ directory and configured in the conf/smileys.conf file.

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:

1. Create a new folder called local inside the smileys-dir

   lib/images/smileys/local

   and put the imagefiles into it (make sure the images are readable by the webserver)

2. Create a custom smiley-config file at

   conf/smileys.local.conf

   and prefix each image filename with “local/…”

An example configfile could look like this:

# Custom Smileys
# Images are seend from the smiley directory lib/images/smileys/
# TEXT_TO_REPLACE       FILENAME_OF_IMAGE
#
:MYFACE:                local/i_am_so_pretty.jpg

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

The following smileys were created by DokuWiki users, using a similar style 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