django-oneall 0.1.3

settings.py

Add django_oneall to INSTALLED_APPS, make sure you have django.contrib.auth enabled:

INSTALLED_APPS = (
    'django.contrib.auth',
    # . . .
    'django_oneall',
)

Add the authentication backend:

AUTHENTICATION_BACKENDS = ('django_oneall.auth.OneAllAuthBackend',)

Configure OneAll connection:

ONEALL_SITE_NAME = 'NAME OF YOUR ONEALL SITE'
ONEALL_PRIVATE_KEY = 'PRIVATE KEY OF YOUR SITE'
ONEALL_PUBLIC_KEY = 'PUBLIC KEY OF YOUR SITE'

Configure behavior (these are good to go as they are here, so you can just copy-paste):

# This setting lets you decide which identity data you want stored in the User model.
# The keys stand for the fields in the User model, while the values are the expressions that will be evaluated
# as attributes of the identity object as received from OneAll. There can be more than one identity expression,
# in case different authentication providers have different data structures.
# Note that the usernames will default to the user_token, which is a UUID. You can override it with any other
# unique identity information
ONEALL_CACHE_FIELDS = {
    'username': ('user_token',),
    'email': ('emails[0].value',),
    'first_name': ('name.givenName',),
    'last_name': ('name.familyName',),
}

# User identity is always cached on first authentication. However, if you want to spare an API call for users
# who are already known to your Django app, you can disable the refresh of cache for the second time they
# connect and onward.
ONEALL_REFRESH_CACHE_ON_AUTH = True

# The OneAll cache table in the DB, where cached identities are stored
ONEALL_CACHE_TABLE = 'oneall_cache'

urls.py

Add the following URL pattern to your urlpatterns tuple:

url(r'^oneall/', include('django_oneall.urls'))

This should enable you to use the callback view at /oneall/auth/

Template

When embedding the body of the OneAll plugin inside your login template, set the callback_uri attribute to the URL of the OneAll callback view like so: http://example.com{% url oneall_auth %}. The template might look like:

<script type="text/javascript">
    oneall.api.plugins.social_login.build("social_login_container", {
        'providers' :  ['facebook', 'google', 'linkedin', 'twitter', 'yahoo'],
        'css_theme_uri': 'https://oneallcdn.com/css/api/socialize/themes/buildin/connect/large-v1.css',
        'grid_size_x': '1',
        'callback_uri': 'http://example.com{% url oneall_auth %}'
    });
</script>