Skip to main content

A generic system for interacting with remote APIs that need to create Django socials.

Project description


The Django-Simple-Social library downloads a collection of social network libraries and
provides automatic backends, and interfaces for working with them. The goal of this project is to simplify working with third-party apps and authorization tools, such as Facebook, LinkedIn, and Twitter.

Make sure you also read up on Djagno-Social-User, as it provides the foundational infrastructure for this library:

Keep in mind this library is still under development, so there may be breaking changes. I'll update the documentation anytime that happens, but feel free to contact me as well.

All functions and classes are documented inline. If you have additional questions, I can be reached on github or at

Getting started

Standard stuff applies to install. Use PIP to install with dependencies:

pip install django-simple-social

Or install from the command line:

python install


There many dependencies for this library, because it requires APIs for working with each social network:

django 1.3 or greater

Usage Guide

Add to both dependencies to your INSTALLED_APPS:


Update the DB:

python sqlall django_social_user > temp.sql
python dbshell < temp.sql
rm temp.sql

Register any social network backends you want to use in your


Add any required API keys (backend dependent) to, here are some examples:

FACEBOOK_CONSUMER_KEY = 'asdf' # this is the APP_ID

Run the backend autodiscover in

import django_simple_social; django_simple_social.autodiscover()

Include references to Django-Social-User urls in

urlpatterns = patterns('',
url(r'^social/', include('django_social_user.urls', namespace='django_social_user')),
(r'^admin/', include(,)

To begin the oauth process with a social network, expose the following link to an enduser:

<a href="{% url 'django_social_user:authenticate' 'facebook' %}">Sign in with Facebook</a>
<a href="{% url 'django_social_user:authenticate' 'linkedin' %}">Sign in with LinkedIn</a>
<a href="{% url 'django_social_user:authenticate' 'twitter' %}">Sign in with Twitter</a>


~~1. Support facebook~~
2. django_social_user should support South migrations
3. Support google
4. Support openid
5. Better error handling
6. Asynchronous/JS driven authentication, instead of browser redirects
7. Decouple APIs from this infrastructure and allow API customizatio

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-simple-social, version 0.1.10
Filename, size File type Python version Upload date Hashes
Filename, size django-simple-social-0.1.10.macosx-10.8-intel.exe (72.3 kB) File type Windows Installer Python version any Upload date Hashes View
Filename, size django_simple_social-0.1.10-py27-none-any.whl (8.9 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size django-simple-social-0.1.10.tar.gz (7.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page