README.rst
November 8, 2024 ยท View on GitHub
.. --restructuredtext--
.. image:: https://github.com/ubernostrum/django-registration/workflows/CI/badge.svg :alt: CI status image :target: https://github.com/ubernostrum/django-registration/actions?query=workflow%3ACI
This is a user-registration application for Django <https://www.djangoproject.com/>_ sites.
It has built-in support for:
-
User registration with the default Django user model
-
User registration with many custom user models
-
Two-step (email an activation link) registration
-
One-step (register and be immediately logged in) registration
And is designed to be extensible to support use cases beyond what's built in.
For example, to enable one-step registration, you'd add
"django_registration" to your Django INSTALLED_APPS setting,
then add the following to your site's root URLconfig:
.. code-block:: python
from django.urls import include, path
urlpatterns = [ # Other URL patterns ... path("accounts/", include("django_registration.backends.one_step.urls")), path("accounts/", include("django.contrib.auth.urls")), # More URL patterns ... ]
And create a few templates (see the quick start guide <https://django-registration.readthedocs.io/en/stable/quickstart.html>_
for details).
For more, check out the full documentation <https://django-registration.readthedocs.io/>_.