====== Smileys ======

[[DokuWiki]] can convert text smileys to their graphically equivalent. The [[wiki:syntax#text_to_image_conversions|default images]] 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 ''[[devel:smileys.conf|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 [[https://twemoji.twitter.com/|Twemoji]] project.

===== 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-dir <code>lib/images/smileys/local</code> 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 <code>conf/smileys.local.conf</code> and prefix each image filename with "''local/''..."

An example configuration file could look like this: <code - 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
</code>

===== Notes and hints =====

  * 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 [[devel:caching|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).

===== 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 ^
| {{wiki:usersmileys:new.gif}}                    | [[tobia.conforto@linux.it|Toby]] |
| {{wiki:usersmileys:todo.gif}}                   | [[tobia.conforto@linux.it|Toby]] |
| {{http://jonschneider.com/images/ActionItem.gif}} | [[jon.schneider@gmail.com|Jon Schneider]] |
| {{wiki:usersmileys:button-danger-yellow.png}}   | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-delete-yellow.png}}   | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-fixme-yellow.png}}    | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-note-yellow.png}}     | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-todo-yellow.png}}     | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-warning-yellow.png}}  | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-danger-red.png}}      | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-delete-red.png}}      | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-fixme-red.png}}       | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-note-red.png}}        | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-todo-red.png}}        | [[kwl7@cornell.edu|Kevin Locke]] |
| {{wiki:usersmileys:button-warning-red.png}}     | [[kwl7@cornell.edu|Kevin Locke]] |
| {{http://img845.imageshack.us/img845/9170/buttondraftyellow.png?80x15|}} | [[jjasghar@gmail.com|JJ Asghar]] |
| {{http://wiki.guug.de/lib/images/smileys/local/todo.gif?80x15}} | [[http://www.unixwitch.de|Hella Breitkopf]]|
| {{http://wiki.guug.de/lib/images/smileys/local/done.gif?80x15}} | [[http://www.unixwitch.de|Hella Breitkopf]]|
| {{http://img213.imageshack.us/img213/1667/buttontodo2yellow.png}} | Kevin, modded by [[user>schamane|Andreas]] |
| {{http://savoirscom1.comptoir.net/lib/images/smileys/todo_button.png}} | [[user>cyrille37|Cyrille37]] |
| Different sets: [[https://github.com/davidjimenez75/dokuwiki-smileys-local|dokuwiki-smileys-local]] | [[user>davidjimenez75|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.

^ Smileys pack image                                    ^ url ^ created by ^
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/dokuwiki-tags-en/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|dokuwiki-tags-en]] | [[user>davidjimenez75|Davidjimenez75]]|
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/emojione-faces/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|emojione-faces]] | [[user>davidjimenez75|Davidjimenez75]]|
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/github-tags-en/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|github-tags-en]] | [[user>davidjimenez75|Davidjimenez75]]|
| {{https://raw.githubusercontent.com/davidjimenez75/dokuwiki-smileys-local/master/openmoji32-faces/folder.jpg?450}} | [[https://github.com/davidjimenez75/dokuwiki-smileys-local|openmoji32-faces]] | [[user>davidjimenez75|Davidjimenez75]]|

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

=====See also=====
 
  * [[config|Configuring DokuWiki]]