Activity Stream Documentation
|Authors:||Justin Quick <firstname.lastname@example.org>, Aaron Williamson, Jordan Reiter, Manuel Aristaran|
Django Activity Stream is a way of creating activities generated by the actions on your site. Action events are categorized by three main components.
Actor. The object that performed the action.
Verb. The verb phrase of the action performed.
Target. (Optional) The object that the verb is enacted on.
GenericForeignKeys to any arbitrary Django object. An action is a description of an action that was performed (
Verb) at some instant in time by some
Acor, with some optional
Nomenclature of this specification is based on the Atom Activity Extension
Download the most recent sourcecode and start up the development server. Make sure you have the most recent version of django:
git clone git://github.com/justquick/django-activity-stream.git cd django-activity-stream python setup.py install # sudo this pip install django # and this cd example_project python manage.py runserver
If all goes well it will be available at http://127.0.0.1:8000/. Use the demo login (demo:demo) and try tinkering with the site and following users/groups. Some sample data is provided.
To test the activity-stream app, stop the server and run this:
python manage.py test actstream
actstream to your
INSTALLED_APPS = ( ... 'actstream', ... )
Add the activity urls:
urlpatterns = patterns('', ... ('^activity/', include('actstream.urls')), ... )
Generating actions is probably best done in a separate signal:
from django.db.models.signals import pre_save from actstream import action from myapp.models import MyModel def my_handler(sender, **kwargs): action.save(sender, verb='was saved') pre_save.connect(my_handler, sender=MyModel)
To generate an action anywhere in your code, simply import the action signal and send it with your actor, verb, and target:
from actstream import action action.send(request.user, verb='reached level 10') action.send(request.user, verb='joined', target=group)
Generating the link between a
User and any particular
Actor is as easy as calling a function:
from actstream.models import follow, unfollow follow(request.user, group)
You can also just make a
GET request to the
Then the current logged in user will follow the actor defined by
next parameter is URL to redirect to.
There is also a function
actstream.unfollow which removes the link and takes the same arguments as
Listings of actions are available for several points of view. All return a
Action items sorted by
from actstream.models import actor_stream, user_stream, model_stream
Actions by a given actor:
Actions by any given Django
Actions from actors that a particular user is folowing: