faq.rst 3.42 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90
Frequently Asked Questions
==========================

Overall
-------

Why don't you implement support for ... ?
*****************************************

This app is just about authentication. Anything that is project
specific, such as making choices on what to display in a profile page,
or, what information is stored for a user (e.g. home address, or
favorite color?), is beyond scope and therefore not offered.

This information is nice and all, but... I need more!
*****************************************************

Here are a few third party resources to help you get started:

- https://speakerdeck.com/tedtieken/signing-up-and-signing-in-users-in-django-with-django-allauth
- https://stackoverflow.com/questions/tagged/django-allauth
- http://www.sarahhagstrom.com/2013/09/the-missing-django-allauth-tutorial/
- https://github.com/aellerton/demo-allauth-bootstrap

I think I found a security issue... now what?
*********************************************

Please report security issues only to django-allauth-security@googlegroups.com.
This is a private list only open to long-time, highly trusted django-allauth
developers, and its archives are not public.

You may also want to subscribe to django-allauth-announce@googlegroups.com to
get notified about security releases.


Troubleshooting
---------------

The /accounts/ URL is giving me a 404
*************************************

There is no such URL. Try ``/accounts/login/`` instead.

When I attempt to login I run into a 404 on /accounts/profile/
**************************************************************

When you end up here you have successfully logged in. However, you
will need to implement a view for this URL yourself, as whatever is to
be displayed here is project specific. You can also decide to redirect
elsewhere:

https://docs.djangoproject.com/en/dev/ref/settings/#login-redirect-url

When I sign up I run into connectivity errors (connection refused et al)
************************************************************************

You probably have not got an e-mail (SMTP) server running on the
machine you are developing on. Therefore, ``allauth`` is unable to send
verification mails.

You can work around this by adding the following line to
``settings.py``:

    EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'

This will avoid the need for an SMTP server as e-mails will be printed
to the console. For more information, please refer to:

https://docs.djangoproject.com/en/dev/ref/settings/#email-host


Why did you just close my issue?
********************************

Time is limited and I have to pick my battles. Please do not file the following
types of issues:

- **Support questions, installation instructions, "How do I...?":** please direct
  these questions elsewhere, for example here:
  https://stackoverflow.com/questions/tagged/django-allauth

- **Documentation related complaints:** while the documentation can most certainly be
  improved, I am adhering to the debatable principle that keeping open issues
  around with respect to documentation is not very helpful in improving things.
  Please step in and file a pull request if you feel there is something unclear.

- **Project specific integration trouble:** In cases where ``allauth`` is just
  one piece of the puzzle and for example a stack trace indicates another
  module crashing, please try to come up stripped version of the issue where it
  is clear that ``allauth`` is the one that is misbehaving.