TIP SocialSharePlugin is not installed on Foswiki.org.

SocialSharePlugin

Social Share Buttons

Summary

This plugin allows you to render so-called social share buttons. Clicking on such a button will allow you to share content on other social network in oder to promote the content the social share button is on. Supported ways to share content are:

  • Buffer
  • Delicious
  • Digg
  • Email
  • Facebook
  • Google
  • LinkedIn
  • Pinboard
  • Pinterest
  • Pocket
  • Reddit
  • StumbleUpon
  • Tumblr
  • Twitter
  • WhatsApp
  • WordPress
  • Xing

Buttons may be rendered for each of them or a subset using the %SOCIALSHARE macro. Additionally this plugin supports a way to present a modal dialog with all social buttons on it.

Examples

You type:

%SOCIALSHARE{width="42em"}%

You get:

SocialShareSnapshot1.png

You type:

%SOCIALSHARE{type="icons" tooltips="on"}%

You get:

SocialShareSnapshot2.png

You type:

%BUTTON{"%MAKETEXT{"Share"}%" icon="fa-share-alt" class="socialShareButton"}%

You get:

Share

... and - when SocialSharePlugin is installed - on click it will open a dialog (using System.JQueryBlockUI) displaying a list of social share buttons. See the below screenshot.

Syntax

%SOCIALSHARE{"<services>" ...}%

In most cases it is sufficient to just list the services you want a social button for. The actual implementation is then predefined in the socialshare.tmpl template. However, you may still want to take over control and create the button by yourself. This will require detailed knowledge about the way social networks construct share links.

Parameter Description Default
"...", services a list comma separated of services to render buttons for (see the list of IDs above) all of them, or a subset as configured in $Foswiki::cfg{SocialSharePlugin}{Services}
type    
tooltips boolean flag to switch on/off jQuery-ui tooltips on the buttons; if left off then the browser's native tooltip will still be used off
url    
tags    
title, topictitle    
text    
media    
topic    
web    
include    
exclude    
format    
header    
footer    
separator    

Skin integration

For PatternSkin there is a skin overlay that will all add a "Share" button to the topic toolbox at the top right. Change your SitePreferences by adding the social ID to the SKIN setting, for example like this:

   * Set SKIN = social, pattern

You might have other extra skin overlays in place already (such as natedit, metacomment, topicinteraction, and/or solr. In that case just prepend social to the SKIN setting to mix in the functionality.

SocialShareSnapshot3.png

For NatSkin no extra provisions are required. The "Share" feature is already integrated into the "More" menu.

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. Use "Find More Extensions" to get a list of available extensions. Select "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 http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Dependencies

NameVersionDescription
Foswiki::Plugins::RenderPlugin>=4.00Required

Change History

19 Jan 2017 initial public release

Topic attachments
I Attachment Action Size Date Who Comment
SocialSharePlugin.md5md5 SocialSharePlugin.md5 manage 174 bytes 19 Jan 2017 - 11:20 MichaelDaum  
SocialSharePlugin.sha1sha1 SocialSharePlugin.sha1 manage 198 bytes 19 Jan 2017 - 11:20 MichaelDaum  
SocialSharePlugin.tgztgz SocialSharePlugin.tgz manage 172 K 19 Jan 2017 - 11:20 MichaelDaum  
SocialSharePlugin.zipzip SocialSharePlugin.zip manage 177 K 19 Jan 2017 - 11:20 MichaelDaum  
SocialSharePlugin_installerEXT SocialSharePlugin_installer manage 5 K 19 Jan 2017 - 11:20 MichaelDaum  
SocialShareSnapshot1.pngpng SocialShareSnapshot1.png manage 22 K 19 Jan 2017 - 11:20 MichaelDaum  
SocialShareSnapshot2.pngpng SocialShareSnapshot2.png manage 8 K 19 Jan 2017 - 11:19 MichaelDaum  
SocialShareSnapshot3.pngpng SocialShareSnapshot3.png manage 121 K 19 Jan 2017 - 11:19 MichaelDaum  
Topic revision: r1 - 19 Jan 2017, MichaelDaum - This page was cached on 09 Apr 2017 - 02:16.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License