Extension:AddThis

The AddThis extension adds an AddThis widget as a portlet to the sidebar and displays expanded widget as toolbar in the upper right corner of articles - just below the article's title and the site's tagline. Expanded widget toolbar can also be inserted using the  tag. This allows you to have things like Facebook's "Like" or "Recommend" button, a button for Tweeting, Google +'ing, etc.

Usage
By default, the sidebar is set to appear on all pages.

By default, the toolbar will appear in the header of all articles in a content namespace.

Using the  tag, you can:
 * Display the toolbar on pages in non-content namespaces
 * Display the toolbar when it has been disabled in LocalSetting.php
 * Display the toolbar on places other than the page header

Installation
Works best with MediaWiki 1.19 or newer (due to sporadic problems loading in MW 1.17-1.18). MediaWiki 1.17 or newer is however a minimum requirement (due to usage of ResourceLoader).

Common service codes
Here are a list of commonly used service codes you can use in the above ['service'] parameters:

Known to not work

 * pinterest
 * Image, rather than content, oriented and so hard to implement for a wiki
 * Will investigate further if there's interest - possibly for displaying just on File pages?

Release notes

 * 1.0.1 : Support for AddThis Address Bar Sharing
 * Additional code clean-up
 * Switched from reddit as a preferred service to digg
 * Will not be making these often as wikis should set their own preferred services - but we will make tweaks based on AddThis service trends and your feedback


 * 1.0: Stable release
 * 1.0f : Moved to Wikimedia Subversion server
 * Switched to using arrays per feedback - ty Johnduhart!
 * Numerous code cleanup and enhancements by Johnduhart - again, thank you!


 * 1.0e : Setting ($wgAddThisMain) to disable appearance on main page (default is set to display on main page)
 * Cleaned up code and moved closer to matching MW's coding conventions


 * 1.0d : Addition of tag () for displaying article header toolbar widget on page outside of the main article namespace or for use on wikis with the header toolbar otherwise disabled
 * Improved localization - toolbar now uses language file as well


 * 1.0c : Enable/disable settings for both the sidebar ($wgAddThisSidebar) and article header toolbar ($wgAddThisHeader) widgets
 * 1.0b : Use of ResourceLoader for css rather than loading within extension - fixes bug reported on MW1.18
 * Addition of Russian language to language file - thank you Unikum111!


 * 1.0a : Initial release

Planned features

 * Pinterest "Pin-it" button on file pages
 * Your requests and ideas are welcome

Wish list

 * Your requests and ideas are welcome
 * Ability to disallow the extension on certain pages (for example it's not needed on templates and other housekeeping pages)
 * Ability to move the header box anywhere on the page with CSS, preferably to be on the RHS across from the Page Title/
 * Rather than using localsettings.php to set which links appear in the widget, is it possible to defer to the user's AddThis preferences? This actually works already, sort of: When I include my AddThis Profile ID, my AddThis-pref'd sidebar appears. However, the localsettings.php version also appears. If I try to disable using $wgAddThisHeader = false, both are disabled. (Edited to add: Simple workaround is to suppress the extension-generated sidebar via .addthis_toolbox display:none, leaving the AddThis-generated widget to appear. But I'd prefer to not load the suppressed code in the first place.)

Ideas being considered
Time will be spent on these if folks show interest on the wish list or talk page
 * Setting to change default namespaces to display page header toolbar on
 * Setting via LocalSetting.php and tag to change toolbar display from the right side to the left

Requests by developer

 * Add any wishes to wish list or request on talk page
 * Please test on wikis and report back via talk page
 * Requires at least MW1.17 due to use of ResourceLoader
 * Suggestions from developers are especially welcome! Contributions included will be credited as co-authors
 * Language translations will be credited