Django Activity Stream Documentation

Django Activity Stream is a way of creating activities generated by the actions on your site.

It is designed for generating and displaying streams of interesting actions and can handle following and unfollowing of different activity sources. For example, it could be used to emulate the Github dashboard in which a user sees changes to projects they are watching and the actions of users they are following.

Action events are categorized by four main components.

• Actor. The object that performed the activity.
• Verb. The verb phrase that identifies the action of the activity.
• Action Object. (Optional) The object linked to the action itself.
• Target. (Optional) The object to which the activity was performed.

Actor, Action Object and Target are GenericForeignKeys to any arbitrary Django object and so can represent any Django model in your project. An action is a description of an action that was performed (Verb) at some instant in time by some Actor on some optional Target that results in an Action Object getting created/updated/deleted.

For example: justquick (actor) closed (verb) issue 2 (object) on django-activity-stream (target) 12 hours ago

Nomenclature of this specification is based on the Activity Streams Spec: http://activitystrea.ms/

Contents:

• Installation
  • Get the code
  • Basic app configuration
  • 3rd Party Extras
  • Supported Environments
• Configuration
  • Model Registration
  • Settings
• Generating Actions
• Adding Custom Data to your Actions
• Following/Unfollowing Objects
• Action Streams
  • Using Builtin Streams
  • Writing Custom Streams
• Templatetags
  • Displaying Streams
  • Follow/Unfollow
• Feeds
  • Builtin Feed URLs
  • Custom JSON Feed URLs
  • Output
• Changelog
  • 0.5.1
  • 0.5.0
  • 0.4.5
  • 0.4.4
  • 0.4.3
  • 0.4.2
  • 0.4.1
  • 0.4.0
• API
  • Action Manager
  • Follow Manager
  • Views
  • Feeds
  • Actions
  • Decorators
  • Templatetags

Indices and tables

• Index
• Module Index
• Search Page