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

===== Usage =====

[[DokuWiki]] can convert text smileys to their graphically equivalent. Smileys images are stored in the ''lib/images/smileys/'' directory and configured in the ''[[devel:smileys.conf|conf/smileys.conf]]'' file.

===== Customize smileys =====

To add your own smileys, and make them upgrade-safe as well, you should follow this 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)
  - Create a custom smiley-config file at <code>conf/smileys.local.conf</code> and prefix each image filename with "''local/''..."

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

===== 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 [[devel:caching|purge the cache]], then refresh your page.

===== User provided additional smileys =====

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 ^
| {{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?75|}} | [[jjasghar@gmail.com|JJ Asghar]] |