Simple integration of social sharing widgets (such as AddThis) in Django projects.
Python
Latest commit 86f6073 Apr 29, 2011 @lettertwo Updated readme
Permalink
Failed to load latest commit information.
socialsharing Initial commit. Apr 29, 2011
README.markdown Updated readme Apr 29, 2011
setup.py Initial commit. Apr 29, 2011

README.markdown

Socialsharing

This project is a simple integration of various social sharing services for quick integration into Django projects. See the list of supported sharing in the Usage section below.

Installation

Add socialsharing to INSTALLED_APPS in settings.py.

Usage

addthis

The addthis templatetag will insert the necessary scripts to make use of the AddThis widget.

Basic usage:

{% addthis pubid=xxxxxxxxxx %}

or with ADDTHIS_PUBID defined in settings.py:

{% addthis %}

The only required argument is pubid. You may optionally provide a global setting for this by adding ADDTHIS_PUBID = xxxxxx to your settings.py. Setting this value means that you can omit the pubid argument when invoking the templatetag.

Optional settings:

share_url: The url to share. Pass this argument to override the default AddThis value (the URL of the page being viewed). Example:

{% addthis 'http://myurl.com' %}

track_clickback: From the AddThis docs:

Set to true to allow us to append a variable to your URLs upon sharing. 
We'll use this to track how many people come back to your content via links 
shared with AddThis. Highly recommended.

default value is True.
Note: You may optionally set ADDDTHIS_TRACK_CLICKBACK = False to always force this value to False.

To enable tracking via Google Analytics:

  • add ADDTHIS_GA_TRACKING_ENABLED = True to your settings.py
  • add ADDTHIS_GA_TRACKER = UA-XXXXXX-X to your settings.py

Note: If you don't set ADDDTHIS_GA_TRACKER, the template tag will attempt to fall back to GA_TRACKING_CODE (which is used by Django-HTML5Boilerplate).