README.rst
1==========================
2Welcome to django-allauth!
3==========================
4
5.. image:: https://travis-ci.org/pennersr/django-allauth.svg
6 :target: http://travis-ci.org/pennersr/django-allauth
7
8.. image:: https://img.shields.io/pypi/v/django-allauth.svg
9 :target: https://pypi.python.org/pypi/django-allauth
10
11.. image:: https://coveralls.io/repos/pennersr/django-allauth/badge.svg?branch=master
12 :alt: Coverage Status
13 :target: https://coveralls.io/r/pennersr/django-allauth
14
15.. image:: https://pennersr.github.io/img/bitcoin-badge.svg
16 :target: https://blockchain.info/address/1AJXuBMPHkaDCNX2rwAy34bGgs7hmrePEr
17
18.. image:: https://img.shields.io/badge/code%20style-pep8-green.svg
19 :target: https://www.python.org/dev/peps/pep-0008/
20
21.. image:: https://img.shields.io/badge/code_style-standard-brightgreen.svg
22 :target: http://standardjs.com
23
24.. image:: https://pennersr.github.io/img/emacs-badge.svg
25 :target: https://www.gnu.org/software/emacs/
26
27Integrated set of Django applications addressing authentication,
28registration, account management as well as 3rd party (social) account
29authentication.
30
31Home page
32 http://www.intenct.nl/projects/django-allauth/
33
34Source code
35 http://github.com/pennersr/django-allauth
36
37Mailinglist
38 http://groups.google.com/group/django-allauth
39
40Documentation
41 https://django-allauth.readthedocs.io/en/latest/
42
43Stack Overflow
44 http://stackoverflow.com/questions/tagged/django-allauth
45
46Rationale
47=========
48
49Most existing Django apps that address the problem of social
50authentication focus on just that. You typically need to integrate
51another app in order to support authentication via a local
52account.
53
54This approach separates the worlds of local and social
55authentication. However, there are common scenarios to be dealt with
56in both worlds. For example, an e-mail address passed along by an
57OpenID provider is not guaranteed to be verified. So, before hooking
58an OpenID account up to a local account the e-mail address must be
59verified. So, e-mail verification needs to be present in both worlds.
60
61Integrating both worlds is quite a tedious process. It is definitely
62not a matter of simply adding one social authentication app, and one
63local account registration app to your ``INSTALLED_APPS`` list.
64
65This is the reason this project got started -- to offer a fully
66integrated authentication app that allows for both local and social
67authentication, with flows that just work.
68
69
70Commercial Support
71==================
72
73This project is sponsored by IntenCT_. If you require assistance on
74your project(s), please contact us: info@intenct.nl.
75
76.. _IntenCT: http://www.intenct.info
77
78
79Cross-Selling
80=============
81
82If you like this, you may also like:
83
84- django-trackstats: https://github.com/pennersr/django-trackstats
85- netwell: https://github.com/pennersr/netwell
86
