Table of Contents
The default smileys images are stored in the
lib/images/smileys/ directory and configured in the
conf/smileys.conf file. Wiki admins can configure their own smileys, see below.
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
localinside the smileys-dir
and put the imagefiles into it (make sure the images are readable by the webserver). The default dokuwiki smileys are about 24 pixels tall.
- Create a custom smiley-config file at
and prefix each image filename with “
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.png # or eventually disable a smiley by mentioning the key, without image path. DELETEME
Notes and hints
- It is good practice to surround your own text macros with colons (“:”), like “
- Because it is reserved to mark a comment line, a hash (
#) needs to be escaped by a backslash (
\#). You can't use
$in the configuration file.
- Make sure to have a space before and after the smiley when adding to a wiki article (e.g. Test :NEW: smiley).
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|
|Kevin, modded by Andreas|
|Different sets: dokuwiki-smileys-local||Davidjimenez75|
User provided additional smileys packs
The following smileys packs were created by DokuWiki users, using a similar style to the default ones. If you like them place them in your local smiley directory (lib/images/smileys/local) and create/copy/adjust the config file (conf/smileys.local.conf). Remember to touch “conf/local.php” to refresh WYSIWYG editor cache.