Extension:AddThis

MediaWiki extensions manual - list

AddThis

Adds an AddThis widget as a portlet to sidebar and displays expanded widget as a toolbar in articles. Expanded widget toolbar is also available using <addthis /> tag.

Author(s)

Gregory Varnum (Varnent^talk)

Last version

1.0.1 (2012-01-06)

MediaWiki

1.17, 1.18, 1.19, 1.20

License

GPL

Download

Download snapshot (Git master)
Git ^[?]:

Release notes

Example

Article on WikiQueer

Parameters
$wgAddThispubid, $wgAddThisBackground, $wgAddThisSidebar, $wgAddThisHeader, $wgAddThisMain, $wgAddThisBorder, $wgAddThisSBServ, $wgAddThisHServ

Tags
<addthis />

Hooks used
SkinBuildSidebar ArticleViewHeader ParserFirstCallInit

Description [edit]

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 <addthis /> tag. This allows you to have things like Facebook's "Like" or "Recommend" button, a button for Tweeting, Google +'ing, etc.

Usage [edit]

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 <addthis /> 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

Download [edit]

You can download the extension directly from the MediaWiki source code repository (browse code). You can get:

One of the extensions tags

Not all extensions have tags. Some extensions have tags for each release, in which case those tags have the same stability as the release. To download a tag

Go to the tags list
Click the name of the tag you want to download
Click "snapshot"

The latest version of one of the extensions branches

Each extension has a master branch containing the latest code (might be unstable). Extensions can have further branches as well.

Go to the branches list
Click the branch name
Click "snapshot"

A snapshot made during the release of a MediaWiki version.

This might be unstable and is not guaranteed to work with the associated MediaWiki version.

Download snapshot

After you've got the code, save it into the extensions/AddThis directory of your wiki.

If you are familiar with git and have shell access to your server, you can obtain the extension, with all its tags and branches, as follows:

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/AddThis.git

Installation [edit]

Requirements [edit]

The following requirements must be satisfied for the AddThis extension to work.

MediaWiki 1.17 or newer (due to usage of ResourceLoader)
- Works best with MediaWiki 1.19 or newer (due to sporadic problems loading in MW 1.17-1.18)

Install the extension [edit]

Add the following to LocalSettings.php:

require_once("$IP/extensions/AddThis/AddThis.php");

Additional configuration parameters are below.

For example, you can disable the article header toolbar by adding this to LocalSettings.php:

$wgAddThisHeader = false;

While it does not appear to be required, it is highly recommended that you register an AddThis account and enter your user/profile id number to LocalSettings.php ^[1]:

$wgAddThispubid = 'ra-xxxxxxxxxxxxxxxxxxx';

Default configuration [edit]

Screenshot of article header toolbar

Screenshot of sidebar portlet

Defaults

$wgAddThispubid      = '';
$wgAddThisBackground    = '#f6f6f6';
$wgAddThisBorder         = '#a7d7f9';
$wgAddThisSidebar        = true;
$wgAddThisHeader         = true;
$wgAddThisMain           = true;
$wgAddThis = array(
        'addressbarsharing' => false,
);
 
$wgAddThisSBServ = array(
        array(
                'service' => 'compact',
        ),
        array(
                'service' => 'facebook',
        ),
        array(
                'service' => 'twitter',
        ),
        array(
                'service' => 'google_plusone',
                'attribs' => 'g:plusone:count="false" style="margin-top:1px;"',
        ),
        array(
                'service' => 'email',
        ),
);
 
$wgAddThisHServ = array(
        array(
                'service' => 'facebook',
        ),
        array(
                'service' => 'twitter',
        ),
        array(
                'service' => 'google_plusone',
                'attribs' => 'g:plusone:count="false" style="margin-top:1px;"',
        ),
        array(
                'service' => 'linkedin',
        ),
        array(
                'service' => 'tumblr',
        ),
        array(
                'service' => 'stumbleupon',
        ),
        array(
                'service' => 'reddit',
        ),
        array(
                'service' => 'email',
        ),
);

Configuration parameters [edit]

Parameter	Default	Description
$wgAddThispubid		AddThis Profile ID - does not appear to be required, but is recommended
$wgAddThisBackground	#f6f6f6	Background color for AddThis toolbox displayed in article header
$wgAddThisBorder	#a7d7f9	Border color for AddThis toolbox displayed in article header
$wgAddThisSidebar	true	Display AddThis widget as sidebar portlet
$wgAddThisHeader	true	Display AddThis widget toolbar in article header
$wgAddThisMain	true	Display AddThis widget toolbar on the main page
$wgAddThis['addressbarsharing']	false	Enable AddThis Address Bar Sharing
$wgAddThisSBServ[0]['service']	compact ^[2]	Service code for 1st button in sidebar
$wgAddThisSBServ[0]['attribs']		Settings for 1st button in sidebar
$wgAddThisSBServ[1]['service']	facebook	Service code for 2nd button in sidebar
$wgAddThisSBServ[1]['attribs']		Settings for 2nd button in sidebar
$wgAddThisSBServ[2]['service']	twitter	Service code for 3rd button in sidebar
$wgAddThisSBServ[2]['attribs']		Settings for 3rd button in sidebar
$wgAddThisSBServ[3]['service']	google_plusone	Service code for 4th button in sidebar
$wgAddThisSBServ[3]['attribs']	g:plusone:count="false" style="margin-top:1px;"	Settings for 4th button in sidebar
$wgAddThisSBServ[4]['service']	email	Service code for 5th button in sidebar
$wgAddThisSBServ[4]['attribs']		Settings for 5th button in sidebar
$wgAddThisHServ[0]['service']	facebook	Service code for 1st button in article header after AddThis icon (which cannot be moved in the header)
$wgAddThisHServ[0]['attribs']		Settings for 1st button in article header
$wgAddThisHServ[1]['service']	twitter	Service code for 2nd button in article header after AddThis icon
$wgAddThisHServ[1]['attribs']		Settings for 2nd button in article header
$wgAddThisHServ[2]['service']	google_plusone	Service code for 3rd button in article header after AddThis icon
$wgAddThisHServ[2]['attribs']	g:plusone:count="false" style="margin-top:1px;"	Settings for 3rd button in article header
$wgAddThisHServ[3]['service']	linkedin	Service code for 4th button in article header after AddThis icon
$wgAddThisHServ[3]['attribs']		Settings for 4th button in article header
$wgAddThisHServ[4]['service']	tumblr	Service code for 5th button in article header after AddThis icon
$wgAddThisHServ[4]['attribs']		Settings for 5th button in article header
$wgAddThisHServ[5]['service']	stumbleupon	Service code for 6th button in article header after AddThis icon
$wgAddThisHServ[5]['attribs']		Settings for 6th button in article header
$wgAddThisHServ[6]['service']	reddit	Service code for 7th button in article header after AddThis icon
$wgAddThisHServ[6]['attribs']		Settings for 7th button in article header
$wgAddThisHServ[7]['service']	email	Service code for 8th button in article header after AddThis icon
$wgAddThisHServ[7]['attribs']		Settings for 8th button in article header

↑ Your id is on your settings page
↑ compact = AddThis icon used to access full AddThis popup menu

Common service codes [edit]

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

aim
baidu
bitly
blip
blogger
care2
delicious
digg

email
evernote
facebook
fark
farkinda
google_plusone
identica
linkedin

myspace
orkut
reddit
stumbleupon
tumblr
twitter
xing
zingme

Known to not work [edit]

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?

Development [edit]

Release notes [edit]

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 (<AddThis />) 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 [edit]

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

Wish list [edit]

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/

Ideas being considered [edit]

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 [edit]

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

Extension:AddThis

Contents

Description [edit]

Usage [edit]

Download [edit]

Installation [edit]

Requirements [edit]

Install the extension [edit]

Default configuration [edit]

Configuration parameters [edit]

Common service codes [edit]

Known to not work [edit]

Development [edit]

Release notes [edit]

Planned features [edit]

Wish list [edit]

Ideas being considered [edit]

Requests by developer [edit]

See also [edit]

Navigation menu

Personal tools

Namespaces

Variants

Views

Actions

Search

Navigation

Support

MediaWiki.org

Development

Print/export

Toolbox