Skip to main content
Help us improve Python packaging – donate today!

Django app that comes with a simple template tag to place a Facebook log-in button in your template

Project Description

fbauth
======

Requirements
============
* Django 1.6+

Installation
============
pip install django-fbauth-templatag

Testing
=======

You can try out fbauth using the installed demo included in the project. Just
run the `runserver` command to look at the demo.

Instructions
============
Load the `fbauth` template-tag library into your template, then call
`fbauth_css` inside your `head` tag and call the `fbauth_button` wherever you
want the Facebook button to be rendered.

E.g.

```django
{% load fbauth %}
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>My App</title>
{% fbauth_css %}
</head>
<body>
{% fbauth_button %}
</body>
</html>
```

Configure the `FBAUTH_FACEBOOK_APP_ID` variable in you `settings` module with
you Facebook app ID.

Configure the `FBAUTH_REDIRECT_URL` variable in your `settings` module with the
url that should be receiving the access token from facebook. Sometimes it's more
convinient to put it inside the `__init__` module of your app so that you can
take advantage of Django's `reverse` function.

There's also a `FBAUTH_FACEBOOK_LOCALEL` variable which you can use to specify
an ISO-15897 (also know as POSIX locale) locale for the Facebook API. Users of
your project will see the Facebook UI translated in the locale you specify. The
default locale is `en_US`.

E.g.

```python
# demo/__init__.py
from django.core.urlresolvers import reverse
from django.conf import settings

setattr(settings, 'FBAUTH_REDIRECT_URL',
reverse('demo:redirect') + '?access_token={0}')
```

Remember that your redirection URL should include the format token `{0}` to
indicate where Facebook's access token should be written.

Release history Release notifications

This version
History Node

0.2

History Node

0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
django-fbauth-templatetag-0.2.tar.gz (8.5 kB) Copy SHA256 hash SHA256 Source None Sep 10, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page