Django-xauth application
========================

Django-xauth is django application which is all-in-one solution for registration
on the site via different 3rd part services like openid, oauth, etc. Xauth consists of
services. For now only openid and oauth is available. Each service enables your users to
use a number of popular websites. Openid service allows to use google, yandex, yahoo, etc.
Oauth allows to use twitter, vkontakte, etc.


Dependencies
============
* Django >= 1.3
* openid service depends on python-openid
* oauth service depends on python-oauth2


Installation (read carefully)
=============================

* Install django-xauth package using pip or easy_install (anyway for now it is better use recent version
  from the bitbucket)
* Install dependencies
* Put "xauth" into INSTALLED_APPS
* Put "xauth.backends.XauthBackend" into AUTHENTICATION_BACKENDS
* Put "from xauth.settings import *" to import default xauth settings
* Put "url(r'^auth/', include('xauth.urls'))" into urls.py
* Run syncdb
* Enable "django.contrib.messages"


Demo
====

Check out the "demo/" directory in the source code repo. It is the django project which demonstrates usage of django-xauth. Is shows particularly how to use own Profile Form and how to control profile fields which is requested via Sreg/AX Openid extensions.
