Socialaccount: replaced context processor with template tag

Fixes #949.

allauth/app_settings.py

@@ -1,40 +1,7 @@
-import django
 from django.conf import settings
-from django.core.exceptions import ImproperlyConfigured
-from django import template
 
 SOCIALACCOUNT_ENABLED = 'allauth.socialaccount' in settings.INSTALLED_APPS
 
-
-def check_context_processors():
-    allauth_ctx = 'allauth.socialaccount.context_processors.socialaccount'
-    ctx_present = False
-
-    if django.VERSION < (1, 8,):
-        setting = "settings.TEMPLATE_CONTEXT_PROCESSORS"
-        if allauth_ctx in settings.TEMPLATE_CONTEXT_PROCESSORS:
-            ctx_present = True
-    else:
-        for name, engine in template.engines.templates.items():
-            if allauth_ctx in engine.get('OPTIONS', {})\
-                    .get('context_processors', []):
-                ctx_present = True
-            else:
-                setting = "settings.TEMPLATES['{}']['OPTIONS']['context_processors']"
-                setting = setting.format(name)
-
-    if not ctx_present:
-        excmsg = ("socialaccount context processor "
-                  "not found in {}. "
-                  "See settings.py instructions here: "
-                  "http://django-allauth.readthedocs.org/en/latest/installation.html")
-        raise ImproperlyConfigured(excmsg.format(setting))
-
-
-if SOCIALACCOUNT_ENABLED:
-    check_context_processors()
-
-
 LOGIN_REDIRECT_URL = getattr(settings, 'LOGIN_REDIRECT_URL', '/')
 
 USER_MODEL = getattr(settings, 'AUTH_USER_MODEL', 'auth.User')

allauth/socialaccount/templatetags/socialaccount.py

@@ -78,3 +78,16 @@ def get_social_accounts(user):
         providers = accounts.setdefault(account.provider, [])
         providers.append(account)
     return accounts
+
+
+@register.assignment_tag
+def get_providers():
+    """
+    Returns a list of social authentication providers.
+
+    Usage: `{% get_providers as socialaccount_providers %}`.
+
+    Then within the template context, `socialaccount_providers` will hold
+    a list of social providers configured for the current site.
+    """
+    return providers.registry.get_list()

allauth/templates/account/login.html

@@ -1,15 +1,17 @@
 {% extends "account/base.html" %}
 
 {% load i18n %}
-{% load account %}
+{% load account socialaccount %}
 
 {% block head_title %}{% trans "Sign In" %}{% endblock %}
 
 {% block content %}
 
 <h1>{% trans "Sign In" %}</h1>
 
-{% if socialaccount.providers %}
+{% get_providers as socialaccount_providers %}
+
+{% if socialaccount_providers %}
 <p>{% blocktrans with site.name as site_name %}Please sign in with one
 of your existing third party accounts. Or, <a href="{{ signup_url }}">sign up</a>
 for a {{ site_name }} account and sign in below:{% endblocktrans %}</p>

allauth/templates/socialaccount/snippets/provider_list.html

@@ -1,6 +1,8 @@
 {% load socialaccount %}
 
-{% for provider in socialaccount.providers %}
+{% get_providers as socialaccount_providers %}
+
+{% for provider in socialaccount_providers %}
 {% if provider.id == "openid" %}
 {% for brand in provider.get_brands %}
 <li>

docs/changelog.rst

@@ -4,6 +4,15 @@ Changelog
 This chapter contains notes on upgrading.
 
 
+From 0.21.0
+***********
+
+- Allauth doesn't enforce template context processors anymore. The context
+  processor for ``allauth.account`` was already empty, and the context
+  processor for ``allauth.socialaccount`` has been converted into the
+  :doc:`{% get_providers %} <templates>` template tag.
+
+
 From 0.20.0
 ***********
 

docs/installation.rst

@@ -16,9 +16,6 @@ settings.py::
         # Required by `allauth` template tags
         'django.core.context_processors.request',
         ...
-        # `allauth` specific context processors
-        'allauth.socialaccount.context_processors.socialaccount',
-        ...
     )
 
     # If you are running Django 1.8+, specify the context processors
@@ -34,9 +31,6 @@ settings.py::
 
                     # `allauth` needs this from django
                     'django.template.context_processors.request',
-
-                    # `allauth` specific context processors
-                    'allauth.socialaccount.context_processors.socialaccount',
                 ],
             },
         },

docs/templates.rst

@@ -70,3 +70,14 @@ Then::
     {{accounts.twitter}} -- a list of connected Twitter accounts
     {{accounts.twitter.0}} -- the first Twitter account
     {% if accounts %} -- if there is at least one social account
+
+
+Finally, social authentication providers configured for the current site
+can be retrieved via::
+
+    {% get_providers as socialaccount_providers %}
+
+Which will populate the ``socialaccount_providers`` variable in the
+template context with a list of configured social authentication
+providers. This supersedes the context processor used in version 0.21 and
+below.

example/example/settings.py

@@ -117,8 +117,6 @@
     "django.core.context_processors.static",
     "django.core.context_processors.request",
     "django.contrib.messages.context_processors.messages",
-
-    "allauth.socialaccount.context_processors.socialaccount",
 )
 
 TEMPLATE_DIRS = (

test_settings.py

@@ -31,7 +31,6 @@
                     'django.contrib.auth.context_processors.auth',
                     'django.contrib.messages.context_processors.messages',
                     'django.core.context_processors.request',
-                    'allauth.socialaccount.context_processors.socialaccount',
                 ],
             },
         },
@@ -45,8 +44,6 @@
         "django.core.context_processors.static",
         "django.core.context_processors.request",
         "django.contrib.messages.context_processors.messages",
-
-        "allauth.socialaccount.context_processors.socialaccount",
     )
 
 MIDDLEWARE_CLASSES = (