LinkedInPlugin

Add LinkedIn Widgets to your Foswiki

Share this foswiki plugin on LinkedIn

Usage

Share on LinkedIn

To add a share this topic link, using defaults, just add %SHARE% : %SHARE{}%

Macro parameters:

• url - url linking to what you're sharing - default to the current topic
• title - a title for the share - defaults tto the topic name
• source - who's sharing it - default to your wikiname
• summary - a summary..

LinkedIn requires shared URL's to be publically accessible.

LinkedIn user profile

To add a Link, or an inline LinkedIn profile, use the %!PROFILE% macro:

%PROFILE{}%

Macro parameters:

• type - inline, hover, click, (LEGACY:popup becomes (hover))
• user - user to lookup - defaults to the logged in user's wikiname. (if set to disabled, then will only show a profile if a url is specified in the url parameter (ie opt in mode))
• url - can be used to over-ride the automatic attempt to use the user parameter to create a LinkedIn public profile url - important for when someone of the same name registered first, so your user's profile name is not simply firstname lastname. (note that when using the skin setting below, you can over-ride the url by setting LinkedInURL UserForm field (requires a locally customised %SystemWeb%.UserForm) on that user's topic.)

Skin Support.

If you install this plugin and are using a current release of Foswiki::Extensions.WidgetsSkin, the side bar will automatically have a share this topic widget added.

similarly, if you're using Widgets skin, or PatternSkin, everyone's user topics can have the LinkedIn user profile widget automatically added by pre-pending linkedin to the skin path:

• Set SKIN=linkedin,famfamfam,pattern

The Widget it set to opt-in mode by default - no profile will be shown unless the user sets a LinkedInURL field on their UserForm (which requires cusomtisation) This default can be changed by setting the following on the SitePreferences topic:

   * Set LINKEDINPLUGIN_DEFAULTPROFILE=%BASETOPIC% 

Adding Linked In URL field:

Follow the instructions at UserForm, and add

| Linked In URL | text | 40 | | Optional: Url for your LinkedIn user profile: http://www.linkedin.com/in/username | |

WidgetsSkin blocks

Share with LinkedIn

http://www.linkedin.com/shareArticle?mini=true&url=%URLENCODE{%SCRIPTURL{view}%/%BASEWEB%/%BASETOPIC%}%&title=%URLENCODE{%QUERY{Summary}%}%&summary=new%20foswiki%20linkedin%20plugin&source=Foswiki
---+++ widget-linkedinshare
%STARTSECTION{"widget-linkedinshare"}%<div class="widget-linkedinshare widget">
   <h2 class="widget-header">Share</h2>
   <div class="widget-content">
%SHARE{url="%SCRIPTURL{view}%/%BASEWEB%/%BASETOPIC%" title="%BASETOPIC%" summary="%BASETOPIC%"}%
   </div>
</div>%ENDSECTION{"widget-linkedinshare"}%

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.

Info

Author(s):	Foswiki:Main.SvenDowideit - http://fosiki.com
Copyright:	SvenDowideit@fosiki.com © 2011
License:	GPL (Gnu General Public License 3)
Release:	1.0.4
Version:	12488 (2011-09-08)
Change History:
08 Sept 2011:	change to LinkedIn's updated (and incompatible) way of requesting user profile
03 May 2011:	fix up WidgetsSkin widget url for sharing
17 April 2011:	LinkedInURL field to allow user to set their LinkedIn profile url, and add opt-in or opt-out default
29 March 2011:	add an over-ride profile url parameter for non-customised or non-unique names
28 March 2011:	initial release
Dependencies:	None
Home page:	http://foswiki.org/bin/view/Extensions/LinkedInPlugin
Support:	http://foswiki.org/bin/view/Support/LinkedInPlugin