Skip to main content

Facebook open graph API client in python. Enables django applications to register users using facebook. Fixes issues with the official but unsupported Facebook python-sdk. Enables mobile facebook authentication. Canvas page authentication for facebook applications. FQL access via the server side api.

Project description

https://secure.travis-ci.org/tschellenbach/Django-facebook.png?branch=master https://pypip.in/d/django-facebook/badge.png

Status

Django and Facebook are both rapidly changing at the moment. Meanwhile, I’m caught up in a startup and don’t have much spare time. The library needs a good round of testing against the latest python, django and facebook graph API. Contributions are strongly appreciated. Seriously, give github a try, fork and get started :)

News

  • django-facebook is now python 3 compatible! With this change, django-facebook will be dropping support for django 1.4 and the mininum required django version will be 1.5.

Demo & About

Django Facebook enables your users to easily register using the Facebook API. It converts the Facebook user data and creates regular User and Profile objects. This makes it easy to integrate with your existing Django application.

I’ve built it for my startup Fashiolista.com and it’s currently used in production with thousands of signups per day. For a demo of the signup flow have a look at Fashiolista’s landing page (fashiolista.com)

After registration Django Facebook gives you access to user’s graph. Allowing for applications such as:

  • Open graph/ Timeline functionality
  • Seamless personalization
  • Inviting friends
  • Finding friends
  • Posting to a users profile

Updates and tutorials can be found on my blog mellowmorning

Features

  • Access the Facebook API, from:
    • Your website (Using javascript OAuth)
    • Facebook canvas pages (For building facebook applications)
    • Mobile (Or any other flow giving you a valid access token)
  • Django User Registration (Convert Facebook user data into a user model)
  • Store likes, friends and user data locally.
  • Facebook FQL access
  • OAuth 2.0 compliant
  • Automated reauthentication (For expired tokens)
  • Includes Open Facebook (stable and tested Python client to the graph API)

Contributing and Running tests

Tests are run from within the example project. You can run them yourself as follows:

install from git

facebook_example/manage.py test django_facebook

Vagrant

A vagrant development setup is included in the GIT repo. Assuming you have vagrant installed, simply type the following in your shell:

# First get a fresh Django-Facebook checkout
git clone git@github.com:tschellenbach/Django-facebook.git django-facebook

# Go to the directory:
cd django-facebook

# Time to start Vagrant (grab a cup of coffee after this command, it'll take a while) :)
vagrant up; vagrant provision

# Finally done?
vagrant ssh
python manage.py runserver 0:8000

To have a working Django Facebook example up and running at 192.168.50.42:8000/facebook/example/. For the facebook login to work simply map that ip to vagrant.mellowmorning.com (Since Facebook checks the domain)

You can run the test suite by typing:

python manage.py test django_facebook

Django Jobs

Do you also see the beauty in clean code? Are you experienced with high scalability web apps? Currently we’re looking for additional talent over at our Amsterdam office. Feel free to drop me a line at my personal email for more information: thierryschellenbach[at]gmail.com

Project details


Release history Release notifications

This version
History Node

6.0.3

History Node

6.0.2

History Node

6.0.1

History Node

6.0.0

History Node

5.3.1

History Node

5.3.0

History Node

5.2.10

History Node

5.2.9

History Node

5.2.8

History Node

5.2.7

History Node

5.2.6

History Node

5.2.5

History Node

5.2.4

History Node

5.2.3

History Node

5.2.2

History Node

5.2.1

History Node

5.2.0

History Node

5.1.10

History Node

5.1.9

History Node

5.1.8

History Node

5.1.7

History Node

5.1.6

History Node

5.1.5

History Node

5.1.2

History Node

5.1.1

History Node

5.1.0

History Node

5.0.13

History Node

5.0.12

History Node

5.0.11beta

History Node

5.0.10beta

History Node

5.0.9beta

History Node

5.0.8beta

History Node

5.0.7beta

History Node

5.0.6beta

History Node

5.0.5alpha

History Node

4.3.4

History Node

4.3.3

History Node

4.3.1

History Node

4.3.0

History Node

4.2.11

History Node

4.2.10

History Node

4.2.9

History Node

4.2.8

History Node

4.2.7

History Node

4.2.5

History Node

4.2.4

History Node

4.2.3

History Node

4.2.2

History Node

4.2.1

History Node

4.2.0

History Node

4.1.7

History Node

4.1.6

History Node

4.1.5

History Node

4.1.4

History Node

4.1.3

History Node

4.1.2

History Node

4.1.1

History Node

4.1.0

History Node

4.0.11

History Node

4.0.10

History Node

4.0.9

History Node

4.0.8

History Node

4.0.7

History Node

4.0.6

History Node

4.0.5

History Node

4.0.4

History Node

4.0.3

History Node

4.0.2

History Node

4.0.1

History Node

3.6.7

History Node

3.6.6

History Node

3.6.5

History Node

3.6.4

History Node

3.6.3

History Node

3.6.2

History Node

3.6.1

History Node

3.6.0

History Node

3.5.93

History Node

3.5.92

History Node

3.5.9

History Node

3.5.8

History Node

3.5.7

History Node

3.5.6

History Node

3.5.5

History Node

3.5.4

History Node

3.5.3

History Node

3.5.0

History Node

3.4.4

History Node

3.3.0

History Node

3.2.7

History Node

3.2.5

History Node

3.2.4

History Node

3.2.3

History Node

3.2.2

History Node

3.2.1

History Node

3.2.0

History Node

3.1.9

History Node

3.1.8

History Node

3.1.7

History Node

3.1.6

History Node

3.1.5

History Node

3.1.2

History Node

3.1.1

History Node

3.1.0

History Node

3.0.8

History Node

3.0.5

History Node

3.0.4

History Node

2.3.3

History Node

2.3.2

History Node

2.3.1

History Node

2.3.0

History Node

2.2.15

History Node

2.2.14

History Node

2.2.13

History Node

2.2.12

History Node

2.2.10

History Node

2.2.9

History Node

2.2.8

History Node

2.2.7

History Node

2.2.6

History Node

2.2.5

History Node

2.2.4

History Node

2.2.3

History Node

2.2.2

History Node

2.2.1

History Node

2.2.0

History Node

2.1.5

History Node

2.1.3

History Node

2.1.2

History Node

2.1.1

History Node

2.1

History Node

2.0.18

History Node

2.0.16

History Node

2.0.15

History Node

2.0.14

History Node

2.0.13

History Node

2.0.12

History Node

2.0.11

History Node

2.0.10

History Node

2.0.8

History Node

2.0.7

History Node

2.0.6

History Node

2.0.5

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0

History Node

1.0

History Node

5.0.2prealpha

History Node

5.0.1prealpha

History Node

5.0.0prealpha

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-facebook-6.0.3.tar.gz (96.5 kB) Copy SHA256 hash SHA256 Source None May 26, 2015

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