Combining OpenID, OAuth and FacebookConnect signup in one application
Python
Pull request Compare This branch is 2 commits ahead, 303 commits behind flashingpumpkin:master.
Latest commit 11d9677 Jan 30, 2010 Mike Krieger Updating info
Permalink
Failed to load latest commit information.
socialregistration
.gitignore
AUTHORS Removed two hyves files Dec 19, 2009
LICENSE Social registration application for django Oct 5, 2009
MANIFEST.in updated MANIFEST.in and setup.py to include templates and templatetags Nov 27, 2009
README
requirements.txt
setup.py

README

==========================
Django Social Registration
==========================

Note
============

This fork modifies the original socialregistration project to work with
GoogleAppEngine through appenginepatch

Django Social Registration enables developers to add alternative registration
methods based on third party sites.

Requirements
============
django
oauth
python-openid
pyfacebook

Installation
============

#. Add the *socialregistration* directory to your *PYTHON_PATH*.
#. Add *socialregistration* to your *INSTALLED_APPS* settings of Django.
#. Add *socialregistration.urls* to your *urls.py* file.

Configuration
=============

Facebook Connect
----------------
#. Add *FACEBOOK_API_KEY* and *FACEBOOK_SECRET_KEY* to your settings file
representing the keys you were given by Facebook.
#. Add *socialregistration.auth.FacebookAuth* to *AUTHENTICATION_BACKENDS* in your settings file.
#. Add 'facebook.djangofb.FacebookMiddleware' to *MIDDLEWARE_CLASSES* in your settings file.
   -> http://wiki.developers.facebook.com/index.php/User:PyFacebook_Tutorial#Add_the_middleware

#.  Add tags to your template file:

    {% load facebook_tags %}
    {% facebook_button %}
    {% facebook_js %}

#. If you wish on using the pyfacebook library to do API calls instead of the JavaScript
   lib, add *socialregistration.middleware.FacebookMiddleware* to *MIDDLEWARE_CLASSES*

Twitter
-------
#. Add the following variables to your *settings.py* file with the values you
were given by Twitter:

    TWITTER_CONSUMER_KEY
    TWITTER_CONSUMER_SECRET_KEY
    TWITTER_REQUEST_TOKEN_URL
    TWITTER_ACCESS_TOKEN_URL
    TWITTER_AUTHORIZATION_URL

#. Add *socialregistration.auth.TwitterAuth* to *AUTHENTICATION_BACKENDS* in your settings file.

#. Add tags to your template file:
    {% load twitter_tags %}
    {% twitter_button %}

Other OAuth Services
--------------------
There is an example of how FriendFeed integration could work.
*socialregistration.models* provides a *FriendFeedProfile* model to save account
data, *socialregistration.auth* provides examples for different auth backends for
different service providers, *socialregistration.utils* provides a Twitter
and FriendFeed interface and *socialregistration.urls* provides examples based
on Twitter and FriendFeed how to hook in more OAuth based services.

OpenID
------
#. Add *socialregistration.auth.OpenIDAuth* to *AUTHENTICATION_BACKENDS* in your settings file.
#. Add tags to your template file:
    {% load openid_tags %}
    {% openid_form %}

Logging users out
-----------------
You can use the standard {% url auth_logout %} url to log users out of Django.
Please note that this will not log users out of third party sites though.
When using Facebook Connect, it is recommended to follow the FBConnect developer
wiki ->
    http://wiki.developers.facebook.com/index.php/Connect/Authorization_Websites#Logging_Out_Users
    <a href="#" onclick="FB.Connect.logoutAndRedirect('{% url auth_logout %}')">Logout</a>

Other Information
-----------------
If you don't wish your users to be redirected to the setup view to create a username but rather have
a username generated for them, set *SOCIAL_GENERATE_USERNAME* in your settings file to True