Skip to main content

django app for adding/removing/listing facebook realtime subscriptions and retrieving facebook realtime updates

Project description

https://secure.travis-ci.org/rmaceissoft/django-facebook-realtime.png?branch=master

A reusable app to interact with facebook real-time updates (https://developers.facebook.com/docs/reference/api/realtime/)

Features

  • add/remove a subscription to changes in data in facebook
  • list all subscriptions
  • receive facebook real-time updates

Requirements

python, django, requests

Installation

  1. pip install git+git://github.com/rmaceissoft/django-facebook-realtime.git

  2. Add "dj_facebook_realtime" to your INSTALLED_APPS setting

  3. Add FACEBOOK_APP_ID, FACEBOOK_API_SECRET and FACEBOOK_REALTIME_VERIFY_TOKEN settings

  4. Wire up the views by adding a line to your URLconf:

    url(r'facebook/subscriptions/', include('dj_facebook_realtime.urls')),
    
  5. Make sure that current Site has a right domain value due to it’s used to build callback url used to verify subscriptions

Example of use

Adding a subscription

adding a subscription for changes on user’s friends and feed connections

python manage.py realtime_subscriptions_add --object_type=user --fields=friends,feed

Removing subscriptions

removing all existent subscriptions only for users

python manage.py realtime_subscriptions_delete --object_type=user

Listing all subscriptions

python manage.py realtime_subscriptions_list

Retrieving updates with facebook data changes

Below a snippet of code to handling realtime_update signal provided by django-facebook-realtime to keep posted of facebook changes through facebook realtime service:

from django.dispatch import receiver
from dj_facebook_realtime.signals import realtime_update


@receiver(realtime_update)
def handler_new_facebook_change(sender, object_type, uid, changed_fields, time, **kwargs):
    """
    handle facebook changes detected through facebook's real-time update service
    """
    if object_type == 'user':
        # make some action for changes related to facebook users
    elif object_type == 'page':
        # make some action for changes related to facebook pages

Project details


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-realtime-0.1.1-20130208.zip (13.4 kB) Copy SHA256 hash SHA256 Source None Feb 8, 2013

Supported by

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