django-allauth-ens/example
2018-06-19 19:15:25 +02:00
..
app Eww, hard to sum up… 2018-01-16 16:57:18 +01:00
.gitignore minor fix on demo project 2017-08-03 12:55:30 +02:00
adapter.py Small fix to example site 2018-06-19 19:15:25 +02:00
manage.py Add example project 2017-08-03 12:41:30 +02:00
README.rst Eww, hard to sum up… 2018-01-16 16:57:18 +01:00
requirements.txt Update example site... 2017-09-16 02:41:30 +02:00
settings.py typo 2018-03-28 13:07:36 +02:00
urls.py Eww, hard to sum up… 2018-01-16 16:57:18 +01:00
wsgi.py Add example project 2017-08-03 12:41:30 +02:00

*****
Setup
*****

Clone the repository and go to the directory containing this file.

If it is the first time you start the example website, run these commands::

  # Create a virtual env.
  $ virtualenv -p python3 venv
  $ . venv/bin/activate

  # Install dependencies (django-allauth-ens is installed from local copy).
  $ pip install -r requirements.txt

  # Initialize the database (sqlite).
  $ ./manage.py migrate

Start the server with::

  $ ./manage.py runserver

Then, open your browser at `<http://localhost:8000/>`_.


*****
Usage
*****

Pre-existing users
==================

You can try to login using one of the existing users:

* a "normal" user (username: 'user', password: 'user')

* a superuser (username: 'root', password: 'root')

Auth Providers
==============

Facebook and Google are activated but they won't work unless you provide valid
API credentials in the Django Admin at
`<http://localhost:8060/admin/socialaccount/socialapp/>`_.

Clipper is available (which requires valid credentials). For auto-signup, the
new user is populated with the clipper identifier as username (plus a suffix if
not available) and ``<clipper id>@clipper.ens.fr`` as email.

Adapters
========

``ACCOUNT_ADAPTER`` and ``SOCIALACCOUNT_ADAPTER`` can be customized in
``adapter.py``.