Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
An extension app for django-social-auth or django-allauth that fetches your friends from different social-networks.
Python
branch: master
Failed to load latest commit information.
examples socialauth example is fixed for django 1.5
social_friends_finder
.gitignore gitignore extended
CHANGES.txt
LICENSE.txt setup files are added
MANIFEST.in
README.md Readme update: Google is added as providers
requirements.txt
setup.py GoogleFriendsProvider implemented

README.md

django-social-friends-finder

An extension app for django-social-auth or django-allauth that fetches your friends from different social-networks. It displays matched friends so you can suggest your users to add them as friend or follow them.

Dependencies

To use it with django-social-auth

To use it with django-allauth

Back-end dependencies

Available BackEnds

  • Facebook
  • Twitter
  • Vkontakte
  • Google

Installation

There are 3 ways to install this app

pip install django-social-friends-finder

or build from the source.

python setup.py install

or add social_friends_finder to your path

Usage and Configuration

Add social_friends_finder to your APPS list in your settings file

INSTALLED_APPS = (
    ...
    "social_friends_finder",
)

Add urls to your url config

urlpatterns = patterns('',
    ...
    url(r'^find-friends/', include('social_friends_finder.urls')),
)

Have a look at following settings:

SOCIAL_FRIENDS_USING_ALLAUTH: True if you use `django-allauth`. Default is False
SF_REDIRECT_IF_NO_SOCIAL_ACCOUNT_FOUND: True if no social account found. Default is True
REDIRECT_URL: The url to redirect if above setting is used. Default is "/"

Go to /find-friends/list/ on your browser.

Contributions

Currently there are facebook and twitter backends are available. Please help to implement new backends.

Implementing backend classes are easy. Just create a class inherits from BaseFriendsProvider and implement two of its methods. See backends module for example implementations

The software design for back-ends needs to be tweaked a little. Encapsulating the allauth and social-auth behaviors in different subclasses would help. Also a common interface for backends to load them silently is crucial. Now if there is a missing backend, we raise an error. Factory class that loads them is also very ugly.

I needed to implement this app for a real-world project with an impossible deadline, and now no time to refactor it. So if you can spend some time on the above issues, that'd be awesome.

Contributors

  • lizrice
  • vden
  • mike-grayhat

Change Log

See CHANGES.txt file for history

Bitdeli Badge

Something went wrong with that request. Please try again.