This is a space filler.
create new tag
view all tags

Share-Me Plugin

Google Plus Facebook LinkedIn Twitter

Add a bar of icons to share a TWiki page on popular social media sites and bookmarking sites such as Digg, Facebook, StumbleUpon, Twitter.

Syntax Rules

Add %SHAREME% anywhere in a TWiki page or preferably in a TWiki skin:

Write this: Renders as: (if installed) Simulated example:
%SHAREME% Delicious Facebook StumbleUpon Twitter

Optionally, a list of social media sites (defined below) can be specified, such as:
%SHAREME{"Delicious, Facebook, StumbleUpon, Twitter"}%.

Social Media Sites

This table defines the social media sites. The following variables can be used in the URL column:

  • $link: Link of the TWiki topic
  • $title: Spaced out topic name
  • $summary: Topic summary
  • $site: Site host name (

Name Image URL
Delicious delicious.png$link&title=$title&notes=$summary
Digg digg.png$link&title=$title&bodytext=$summary
E-mail email.png mailto:?subject=$title&body=$link
Facebook facebook.png$link&t=$title
FriendFeed friendfeed.png$title&link=$link
Google Plus googleplus.png$link&title=$title
Google Bookmarks googlebookmark.png$link&title=$title&annotation=$summary
LinkedIn linkedin.png$link&title=$title&source=$site&summary=$summary
Live live.png$link&title=$title
MisterWong misterwong.png$link&bm_description=$title&plugin=soc
Mixx mixx.png$link&title=$title
NewsVine newsvine.png$link&h=$title ping.png$link&title=$title&body=$summary
Posterous posterous.png$link&title=$title&selection=$summary
Reddit reddit.png$link&title=$title
RSS rss.png
Simpy simpy.png$link&title=$title
Slashdot slashdot.png$title&url=$link
StumbleUpon stumbleupon.png$link&title=$title
Technorati technorati.png$link
Twitter twitter.png$title%20-%20$link
Yahoo! Bookmarks yahoomyweb.png$link&t=$title&opener=bm&ei=UTF-8&d=$summary
Yahoo! Buzz yahoobuzz.png$link&submitHeadline=$title&submitSummary=$summary&submitCategory=science&submitAssetType=text

Plugin Settings

Plugin settings are stored as preferences variables. To reference a plugin setting write %<plugin>_<setting>%, such as %SHAREMEPLUGIN_SHORTDESCRIPTION%

  • One line description, is shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Icon bar to share TWiki pages on popular social media sites such as Facebook, StumbleUpon, Twitter

  • Topic that defines the social media sites: (default: This topic)

  • Default site icons shown in %SHAREME%, subset of the ones defined in the Social Media Sites section:
    • Set DEFAULTSITES = Twitter, Delicious, Digg, Facebook, Google Bookmarks, LinkedIn, Reddit, StumbleUpon

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the TWiki server.

  • Download the ZIP file from the Plugin Home (see below)
  • Unzip in your twiki installation directory. Content:
File: Description:
data/TWiki/ShareMePlugin.txt Plugin topic
data/TWiki/ShareMePlugin.txt,v Plugin topic repository
lib/TWiki/Plugins/ Plugin Perl module
pub/TWiki/ShareMePlugin/*.png 16x16 pixel icons of social networking sites
  • Configure the Plugin:
    • Run the configure script to enable the plugin
    • Overload the plugin settings as needed. Do not change the plugin page, but create settings in the TWikiPreferences page. For example, to overload the DEFAULTSITES setting, create a SHAREMEPLUGIN_DEFAULTSITES in the TWikiPreferences page.
  • Test if the installation was successful: Twitter Delicious Digg Facebook Google Bookmarks LinkedIn Reddit StumbleUpon

Plugin Info

Plugin Author: TWiki:Main.PeterThoeny,
Copyright: 2010-2012 TWiki:Main.PeterThoeny
2010-2012 TWiki:TWiki.TWikiContributor
License: GPL ( GNU General Public License)
Plugin Version: 2012-12-01
Change History:
2012-12-01: TWikibug:Item6962: Add Google+ share icon & link
2012-11-15: TWikibug:Item7020: Categorize SHAREME TWiki Variable
2011-07-10: TWikibug:Item6725: Change global package variables from "use vars" to "our"
2010-12-04: TWikibug:Item6616: Fix to use BASETOPIC instead of TOPIC when referencing topics. This allows to add SHAREME in an included topic, such as TopMenuSkinTopBar of TWiki:Plugins.TopMenuSkin
2010-06-06: XHTML validation fixes; moving CSS to HTML head using TWiki::Func::addToHEAD
2010-01-16: Doc fixes
2010-01-09: Initial version
TWiki Dependency: $TWiki::Plugins::VERSION 1.1
CPAN Dependencies: none
Other Dependencies: none
Perl Version: 5.008
Benchmarks: GoodStyle 99%, FormattedSearch 100%, ShareMePlugin 100%
Plugin Home:
This plugin is inspired by Sociable plugin for WordPress. Some GPLed icons have been taken from that plugin.

Related Topics: VarSHAREME, TWikiPlugins, DeveloperDocumentationCategory, AdminDocumentationCategory, TWikiPreferences

Topic revision: r2 - 09 Mar 2016 - VictorKamau
This site is powered by the TWiki collaboration platform Powered by Perl This site is belongs to and is hosted by Kenya Forestry Research Institute (KEFRI)Copyright 2015-2018 by the contributing authors.
All material on KEFRI Knowledge Management System is the property of the contributing authors.
Ideas, requests, problems regarding this topic or the KMS System? Send feedback