Smileys

DokuWiki can convert text smileys to their graphically equivalent. The default imagesplugin-autotooltip__default plugin-autotooltip_bigOpmaakregels (syntax)

DokuWiki ondersteunt eenvoudige opmaakregels om gegevensbestanden zo leesbaar mogelijk te maken. Deze pagina bevat alle mogelijke regels die u kunt gebruiken om uw teksten vorm te geven. Kijk naar de broncode van deze pagina door op de knop and the user defined images are automatically shown in the Smiley picker of the toolbar.

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.

Instead of using .gif based pixel graphics DokuWiki versions since Igor 2022 release use SVG smileys based on the Twemoji project.

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). The default dokuwiki smileys are about 24 pixels tall.

2. 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:

conf/smileys.local.conf

# 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

• It is good practice to surround your own text macros with colons (“:”), like “:REPLACEME:”
• 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.
• 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.
• Make sure to have a space before and after the smiley when adding to a wiki article (e.g. Test :NEW: smiley).

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
	Cyrille37
Different sets: dokuwiki-smileys-local	Davidjimenez75

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.

Smileys pack image	url	created by
	dokuwiki-tags-en	Davidjimenez75
	emojione-faces	Davidjimenez75
	github-tags-en	Davidjimenez75
	openmoji32-faces	Davidjimenez75

More examples at https://github.com/davidjimenez75/dokuwiki-smileys-local

• Configuring DokuWiki