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.
======
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 | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-fbauth-templatetag-0.2.tar.gz.
File metadata
- Download URL: django-fbauth-templatetag-0.2.tar.gz
- Upload date:
- Size: 8.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
819a9da02409d88abb6b141d80adbffe029d1badefb5220fc769cd21f4209993
|
|
| MD5 |
aa6f7223aa2764aa341312433bea87f0
|
|
| BLAKE2b-256 |
4764fab7ef87ed77e8a2dee07815b784d62f05fb81460511ce829c0a56e1242f
|
