Differences

This shows you the differences between two versions of the page.

--- smileys [2013-01-14 20:50] – [User provided additional smileys] Klap-in
+++ smileys [2018-12-05 22:16] – davidjimenez75
@@ Line 3: / Line 3: @@
 ===== 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.
+[[DokuWiki]] can convert text smileys to their graphically equivalent. The 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.
 ===== Customize smileys =====
@@ Line 12: / Line 14: @@
   - 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>
+An example configuration file could look like this: <code>
 # Custom Smileys
-# Images are seend from the smiley directory lib/images/smileys/
+# Images are seen relatively from the smiley directory lib/images/smileys/
 # TEXT_TO_REPLACE       FILENAME_OF_IMAGE
 #
 :MYFACE:                local/i_am_so_pretty.jpg
+# or eventually disable a smiley by mentioning the key, without image path.
+DELETEME
 </code>
@@ Line 25: / Line 30: @@
   * 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.
+  * 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 the default ones. If you like them place them in your smiley directory and adjust the config file.
+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 ^
@@ Line 50: / Line 56: @@
 | {{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]] |
+| [[https://github.com/davidjimenez75/dokuwiki-smileys-local|dokuwiki-smileys-local]] | [[user>davidjimenez75|Davidjimenez75]]|
+=====See also=====
+  * [[config|Configuring DokuWiki]]