The Smilies Plugin :-)

Smilies are common in e-mail messages and bulletin board posts. They are used to convey an emotion, such as a smile :-) or a frown :-( . This plugin automatically converts certain smilies to a nice small icon.

Here is the list of smilies supported by this plugin. To add others, attach new icons to this topic and tweak the table below.

Notation Image Description
:) :-) :smile: smile smile
:( :-( :frown: frown, sad smile frown, sad smile
:D :-D :biggrin: big grin big grin
8-) :cool: cool cool
;) ;-) :wink: wink wink
;( ;-( :cry: cry cry
(:I :sweat: sweating sweating
:I :-I :speechless: indifferent, speechless indifferent, speechless
:* :-* :kiss: kiss kiss
:P :-P :p :-p :tongue: stick out tongue stick out tongue
:o :-o :blush: embarrassment, blush embarrassment, blush
:^) :wonder: wondering wondering
I-) :snooze: sleepy, snooze sleepy, snooze
I-( :dull: dull dull
:love: I love it! I love it!
]:) ]:-) >;-) :evilgrin: :devilish: evil grin evil grin
:talk: talking talking
I() I-() :yawn: yawn yawn
:& :-& :puke: puke puke
:doh: :eek: doh doh
:@ :-@ :angry: angry angry
:wasntme: oops, wasn oops, wasn't me
:party: party party
:S :-S :s :-s :confused: :worried: worried, confused worried, confused
:mmm: joy joy
8-I B-I :nerd: nerd nerd
:-X :lipssealed: my lips are sealed my lips are sealed
:hi: me waving me waving
:call: call me back call me back
>:-) :devil: evil evil
:angel: angel angel
:envy: envy envy
:wait: hey, wait a sec hey, wait a sec
:hug: bear, hug bear, hug
:bear: bear, hug bear, hug
:makeup: makeup, lips makeup, lips
:giggle: covered laugh covered laugh
:clap: clapping hands clapping hands
:? :-? :think: thinking thinking
:bow: bow bow
:rofl: rolling on the floor laughing rolling on the floor laughing
:whew: whew whew
:wew: whew whew
:happy: happy happy
:smirk: smirk smirk
:nod: nod nod
:shake: shake shake
:punch: punch punch
:emo: emo emo
:yes: :ok: yes yes
:no: no no
:handshake: handshake handshake
:heart: heart heart
:brokenheart: broken heart broken heart
:mail: mail mail
:flower: flower flower
:rain: rain rain
:sun: sun sun
:time: time time
:music: music music
:movie: movie, film movie, film
:phone: phone phone
:coffee: coffee coffee
:pizza: pizza pizza
:cash: cash cash
:muscle: muscle muscle
:cake: cake cake
:beer: beer beer
:drink: drink drink
:dance: dance dance
:ninja: ninja ninja
:star: star star
:morning: morning morning
:finger: finger finger
:bandit: bandit bandit
:drunk: drunk drunk
:smoke: smoke smoke
:toivo: tovio tovio
:rock: rock rock
:headbang: :mad: head bang, getting mad head bang, getting mad
:bug: bug bug
:foobar: foobar foobar
:poolparty: pool party pool party
:swear: swear swear
:tmi: tmi tmi
:heidy: heidy heidy
:malthe: malthe malthe
:tauri: :rolleyes: tauri tauri
:priidu: priidu priidu
:skull: dead, deadly, doom dead, deadly, doom

SmiliesPlugin Global Settings

You can override the default settings for the plugin by defining the following preferences.
Preference Meaning Default
SMILIESPLUGIN_TOPIC The name of the topic containing your Smilies. Use format web.topic. SmiliesPlugin
SMILIESPLUGIN_FORMAT The way the emoticon is displayed. You can use $emoticon (e.g. :D), $url (e.g. %ATTACHURL%/biggrin.gif) and $tooltip (e.g. "big grin").
<img
    class='smily'
    src='$url'
    alt='$tooltip'
    title='$tooltip'
     />
If possible, use single quotes for html attributes

Plugin Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. "Extensions Operation and Maintenance" Tab -> "Install, Update or Remove extensions" Tab. Click the "Search for Extensions" button. Enter part of the extension name or description and press search. Select the desired extension(s) and click install. If an extension is already installed, it will not show up in the search results.

You can also install from the shell by running the extension installer as the web server user: (Be sure to run as the webserver user, not as root!)
cd /path/to/foswiki
perl tools/extension_installer <NameOfExtension> install

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See https://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Plugin Info

Change History:  
17 Sep 2015: (2.03) Foswikitask:Item13725: Remove height from css for better compatibilty.
Foswikitask:Item13726: Restore legacy icons to avoid broken links.
25 Jun 2015: (2.02) Foswikitask:Item13475: Restore skull markup. Released with Foswiki 2.0.
27 Feb 2014: modernized code and icon set
05 Oct 2012: use single quotes to enable use of smilies within Macros
05 Dec 2011: Version released with Foswiki 1.1.4. Minor code cleanup.
11 Apr 2011: Version released with Foswiki 1.1.3. Only a minor change related to how the plugin is being upgraded
04 Aug 2010: Foswikitask:Item9415 - Minor documentation updates
20 Sep 2009: Small documentation update. Included with Foswiki 1.0.7
13 Jan 2009: Removed default preferences from this topic
04 Jan 2009: Foswiki version - Fixed the use of SMILIESPLUGIN_TOPIC so you can create your own smily collection that does not get overwritten when upgrading Foswiki
21 Nov 2007: Doc improvements
16 Mar 2005: Fixed typo "scull"
5 Mar 2005: 1.004 Crawford Currie prepared for Dakar
21 Nov 2004: Added benchmarks (no code changes)
21 Aug 2004: Fixed tooltip for Netscape; added "sealed lips", "thumbs up", "yes" "no", "in love", "skull"
16 Feb 2004: Added "devil" and "devilwink" smilies (by TWiki:Main.CrawfordCurrie)
26 Feb 2003: Added "indifferent" smilie
20 Oct 2002: Fixed STDERR warning for non-initialized Plugin
20 Apr 2002: Improved performance; removed non-standard Plugin API dependencies; added standard plugin topic content -- TWiki:Main.PeterThoeny
23 Nov 2001: Added TOPIC and FORMAT setting
10 Jun 2001: Packaged into ZIP
28 Feb 2001: Initial version
Dependencies: None


Related Topics: DefaultPreferences, SitePreferences, Plugins

PackageForm edit

Author ProjectContributor
Version 2.03
Release 17 Sep 2015
Repository https://github.com/foswiki/distro
Copyright Copyright (C) 2008-2014 Foswiki Contributors. Copyright (C) 2001-2007 Andrea Sterbini, Peter Thoeny, peter@thoeny.org and TWiki Contributors.
License GPL (GNU General Public License)
Home Foswiki:Extensions/SmiliesPlugin
Support Foswiki:Support/SmiliesPlugin
This topic: System > Category > AdminDocumentationCategory > Plugins > SmiliesPlugin
Topic revision: 17 Sep 2015, ProjectContributor
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback