https://github.com/justquick/django-activity-stream

Generate generic activity streams from the actions on your site. Users can follow any actors' activities for personalized streams.
https://github.com/justquick/django-activity-stream

Last synced: 4 days ago
JSON representation

Generate generic activity streams from the actions on your site. Users can follow any actors' activities for personalized streams.

• Host: GitHub
• URL: https://github.com/justquick/django-activity-stream
• Owner: justquick
• License: bsd-3-clause
• Created: 2010-02-24T21:16:51.000Z (almost 15 years ago)
• Default Branch: main
• Last Pushed: 2024-09-12T09:11:43.000Z (3 months ago)
• Last Synced: 2024-10-29T15:04:37.192Z (about 1 month ago)
• Language: Python
• Homepage: http://django-activity-stream.rtfd.io/en/latest/
• Size: 1.32 MB
• Stars: 2,382
• Watchers: 76
• Forks: 483
• Open Issues: 20
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Authors: AUTHORS.txt

Awesome Lists containing this project

• awesome-starts - justquick/django-activity-stream - Generate generic activity streams from the actions on your site. Users can follow any actors' activities for personalized streams. (Python)
• best-of-web-python - GitHub - 7% open · ⏱️ 04.10.2023): (Django Utilities)

README

        
Django Activity Stream

======================

.. image:: https://github.com/justquick/django-activity-stream/actions/workflows/workflow.yaml/badge.svg

    :target: https://github.com/justquick/django-activity-stream/actions/workflows/workflow.yaml

.. image:: https://badges.gitter.im/django-activity-stream/Lobby.svg

   :alt: Join the chat at https://gitter.im/django-activity-stream/Lobby

   :target: https://gitter.im/django-activity-stream/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

.. image:: https://coveralls.io/repos/github/justquick/django-activity-stream/badge.svg?branch=master

    :target: https://coveralls.io/github/justquick/django-activity-stream?branch=master

.. image:: https://scrutinizer-ci.com/g/justquick/django-activity-stream/badges/quality-score.png?b=master

    :target: https://scrutinizer-ci.com/g/justquick/django-activity-stream/

.. image:: https://img.shields.io/pypi/v/django-activity-stream.svg

    :target: https://pypi.python.org/pypi/django-activity-stream

What is Django Activity Stream?

===============================

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: ``_

For complete documentation see `Django Activity Stream Documentation `_

Contributors

------------

This project exists thanks to all the people who contribute!

.. image:: https://opencollective.com/django-activity-stream/contributors.svg?width=890&button=false