This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
Introduction
============

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:

https://github.com/mattsnider/Djagno-Social-User

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 admin@mattsnider.com.

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 setup.py install

Dependencies
============

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

django 1.3 or greater
Django-Social-User
LinkedIn-API-JSON-Client
twython

Usage Guide
===========

Add to both dependencies to your INSTALLED_APPS:

INSTALLED_APPS = [
...
'django_simple_social',
'django_social_user',
...
]

Update the DB:

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

Register any social network backends you want to use in your settings.py:

AUTHENTICATION_BACKENDS = (
'django_simple_social.backends.FacebookBackend',
'django_simple_social.backends.LinkedInBackend',
'django_simple_social.backends.TwitterBackend',
...
'django.contrib.auth.backends.ModelBackend')

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

FACEBOOK_CONSUMER_KEY = 'asdf' # this is the APP_ID
FACEBOOK_CONSUMER_SECRET = 'asdf'
LINKED_IN_CONSUMER_KEY = 'asdf'
LINKED_IN_CONSUMER_SECRET = 'asdf'
TWITTER_CONSUMER_KEY = 'asdf'
TWITTER_CONSUMER_SECRET = 'asdf'

Run the backend autodiscover in urls.py:

import django_simple_social; django_simple_social.autodiscover()

Include references to Django-Social-User urls in urls.py:

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

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>

Todo
====

~~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
Release History

Release History

0.1.10

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.9

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.8

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.7

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.6

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django-simple-social-0.1.10.macosx-10.8-intel.exe (72.3 kB) Copy SHA256 Checksum SHA256 any Windows Installer Nov 18, 2013
django_simple_social-0.1.10-py27-none-any.whl (8.9 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Nov 18, 2013
django-simple-social-0.1.10.tar.gz (7.1 kB) Copy SHA256 Checksum SHA256 Source Nov 18, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting