django-twitter

HomePage: http://github.com/ahmontero/django-twitter

Author: Antonio Hinojo

Download: https://pypi.python.org/packages/source/d/django-twitter/django-twitter-0.1.0.tar.gz

        django-twitter allows your users to login into your application using Twitter in a easy way.

How To Use
==========
1. Add 'twitter' to your apps list

2. Include('twitter.urls') in your url app

3. Add in settings.py:
    CONSUMER_KEY = "your_consumer_key"
    CONSUMER_SECRET = "your_consumer_secret"
    CALLBACK_URL = 'your_awesome_url'

CONSUMER_KEY: You can obtain it from your Twitter account.
CONSUMER_SECRET: You can obtain it from your Twitter account.
CALLBACK_URL: is the url inside your application that should be shown when the authentication process went ok. It must be same as Twitter callback url.

4. Connect with tokens_received signal:

from twitter import signals

def tokens_received(sender, request, screen_name, oauth_token, oauth_token_secret, **kwargs):
    #Your stuff here

signals.tokens_received.connect(tokens_received)

How it works
============
To insert the link to Twitter, include this in your template : {% url twitter_begin_auth %} in a link.
When the user click on the link, is redirected to Twitter, and once logged in, it will redirect you to CALLBACK_URL in your application and tokens_received signal will be raised.

NOTE:
-----
Remember that your Twitter callback url must be the same as CALLBACK_URL

Dependencies
============
djano-twitter uses Django 1.3 and oauth2

References
==========
Some parts of Twython have been adapted to make possible this application. Thanks to Twython creator for share with us so amazing code.


Version 0.1.0
    + Initial release