component2Add my vote for this tag export1Add my vote for this tag publish2Add my vote for this tag user_interface2Add my vote for this tag create new tag
, view all tags

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 (twiki.org)

Name Image URL
Delicious delicious.png http://delicious.com/post?url=$link&title=$title&notes=$summary
Digg digg.png http://digg.com/submit?phase=2&url=$link&title=$title&bodytext=$summary
E-mail email.png mailto:?subject=$title&body=$link
Facebook facebook.png http://www.facebook.com/share.php?u=$link&t=$title
FriendFeed friendfeed.png http://www.friendfeed.com/share?title=$title&link=$link
Google Plus googleplus.png https://plus.google.com/share?url=$link
Google Bookmarks googlebookmark.png http://www.google.com/bookmarks/mark?op=edit&bkmk=$link&title=$title&annotation=$summary
LinkedIn linkedin.png http://www.linkedin.com/shareArticle?mini=true&url=$link&title=$title&source=$site&summary=$summary
Live live.png https://favorites.live.com/quickadd.aspx?marklet=1&url=$link&title=$title
MisterWong misterwong.png http://www.mister-wong.com/addurl/?bm_url=$link&bm_description=$title&plugin=soc
Mixx mixx.png http://www.mixx.com/submit?page_url=$link&title=$title
NewsVine newsvine.png http://www.newsvine.com/_tools/seed&save?u=$link&h=$title
Ping.fm ping.png http://ping.fm/ref/?link=$link&title=$title&body=$summary
Posterous posterous.png http://posterous.com/share?linkto=$link&title=$title&selection=$summary
Reddit reddit.png http://reddit.com/submit?url=$link&title=$title
RSS rss.png http://twiki.org/cgi-bin/view/Plugins/WebRss
Simpy simpy.png http://www.simpy.com/simpy/LinkAdd.do?href=$link&title=$title
Slashdot slashdot.png http://slashdot.org/bookmark.pl?title=$title&url=$link
StumbleUpon stumbleupon.png http://www.stumbleupon.com/submit?url=$link&title=$title
Technorati technorati.png http://technorati.com/faves?add=$link
Twitter twitter.png http://twitter.com/home?status=$title%20-%20$link
Yahoo! Bookmarks yahoomyweb.png http://bookmarks.yahoo.com/toolbar/savebm?u=$link&t=$title&opener=bm&ei=UTF-8&d=$summary
Yahoo! Buzz yahoobuzz.png http://buzz.yahoo.com/submit/?submitUrl=$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 ShareMePlugin.zip 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/ShareMePlugin.pm 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, TWiki.org
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: http://TWiki.org/cgi-bin/view/Plugins/ShareMePlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/ShareMePluginDev
Appraisal: http://TWiki.org/cgi-bin/view/Plugins/ShareMePluginAppraisal

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 attachments
I Attachment History Action Size Date Who Comment
Unknown file formatmd5 ShareMePlugin.md5 r10 r9 r8 r7 r6 manage 0.2 K 2012-12-02 - 01:10 PeterThoeny  
Compressed Zip archivetgz ShareMePlugin.tgz r10 r9 r8 r7 r6 manage 24.5 K 2012-12-02 - 01:09 PeterThoeny  
Compressed Zip archivezip ShareMePlugin.zip r10 r9 r8 r7 r6 manage 30.4 K 2012-12-02 - 01:09 PeterThoeny  
Unknown file formatEXT ShareMePlugin_installer r3 r2 r1 manage 4.3 K 2012-12-02 - 01:09 PeterThoeny  
Edit | Attach | Watch | Print version | History: r10 < r9 < r8 < r7 < r6 | Backlinks | Raw View | Raw edit | More topic actions
Topic revision: r10 - 2013-10-16 - PeterThoeny
  • Learn about TWiki  
  • Download TWiki
This site is powered by the TWiki collaboration platform Powered by Perl Hosted by OICcam.com Ideas, requests, problems regarding TWiki? Send feedback. Ask community in the support forum.
Copyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.