django-friendship 0.8.0

django-friendship provides an easy extensible interface for following and friendship

django-friendship

Usage

Add friendship to INSTALLED_APPS and run syncdb.

To use django-friendship in your views:

from django.contrib.auth.models import User
from friendship.models import Friendship, Following

def my_view(request):
    # List of this user's friends
    all_friends = Friendship.objects.friends(request.user)

    # List all unread friendship requests
    requests = Friendship.objects.requests(user=request.user, unread=True)

    # List all rejected friendship requests
    rejects = Friendship.objects.requests(user=request.user, rejected=True)

    # List of this user's followers
    all_followers = Following.objects.followers(request.user)

    # List of who this user is following
    following = Following.objects.following(request.user)

    ### Managing friendship relationships
    other_user = User.objects.get(pk=1)
    new_relationship = Friendship.objects.add_friend(request.user, other_user)

    # Create request.user follows other_user relationship
    following_created = Following.objects.add_follower(request.user, other_user)

To use django-friendship in your templates:

{% load friendship %}

{% friends request.user %}
{% followers request.user %}
{% following request.user %}
{% friend_requests request.user %}

Signals

django-friendship emits the following signals:

• friendship_request_created

• friendship_request_rejected

• friendship_request_canceled

• friendship_request_accepted

• friendship_removed

• follower_created

• following_created

• follower_removed

• following_removed