Share-Me Plugin

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
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: r0 - 2012-12-02 - TWikiContributor
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    TWiki All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright & 2008-2023 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback
Note: Please contribute updates to this topic on at TWiki:TWiki.ShareMePlugin