Skip to main content

A pluggable notification system written for the Django framework.

Project description

https://travis-ci.org/benjaoming/django-nyt.png?branch=master Documentation Status https://badge.fury.io/py/django-nyt.svg http://codecov.io/github/benjaoming/django-nyt/coverage.svg?branch=master

Concept

django-nyt is a notification framework for Django, it does this:

from django_nyt.utils import notify

EVENT_KEY = "my_key"
notify(_("OMG! Something happened"), EVENT_KEY)

All users subscribing to "my_key" will have a notification created in their stack when notify() is called.

If you have emails enabled, subscribers receive a summary of notifications at an interval of their choice.

Data can be accessed easily from Django models or from the included JSON views.

Channels (django-channels)

Starting from django-nyt 1.0, support for the upcoming channels has been added together with Django 1.9 and 1.10 support.

In order to install the prerelease, use an extra flag for pip:

pip install django-nyt --pre

Docs

http://django-nyt.readthedocs.io/en/latest/

Why should you do this?

Users need a cleverly sifted stream of events that’s highly customizable as well. By using django-nyt, your users can subscribe to global events or specific events pertaining specific objects.

Instead of inventing your own notification system, use this and you won’t have to design your own models, and you will have a nice guide that goes through the various steps of implementing notifications for your project.

Let’s try to summarize the reasons you want to be using django-nyt:

  • Simple API: call notify() where-ever you want.

  • CLI for sending emails (as cron job, daemon or Celery task)

  • Support for django-channels and Web Sockets (optional, fallback for JSON-based polling)

  • Basic JavaScript / HTML example code

  • Multi-lingual

  • Individual subscription settings for each type of event, for instance: - Event type A spawns instant email notifications, but Event B only gets emailed weekly.

  • Customizable intervals for which users can receive notifications

  • Optional URL for action target for each notification

  • Avoid clutter: Notifications don’t get repeated, instead a counter is incremented.

This project exists with django.contrib.messages in mind, to serve a simple, best-practice, scalable solution for notifications. There are loads of other notification apps for Django, some focus on integration of specific communication protocols

What do you need to do?

django-nyt does everything it can to meet as many needs as possible and have sane defaults.

But you need to do a lot! Firstly, you need to write some JavaScript that will fetch the latest notifications and display them in some area of the screen. Upon clicking that icon, the latest notifications are displayed, and clicking an individual notification will redirect the user through a page that marks the notification as read.

Something like this:

Javascript drop-down

JavaScript drop-down: Some examples are provided in the docs, but there is no real easy way to place this nifty little thing at the top of your site, you’re going to have to work it out on your own.

Other items for your TODO list:

  • Provide your users with options to customize their subscriptions and notification preferences. Create your own Form inheriting from django_nyt.forms.SettingsForm.

  • Customize contents of notification emails by overwriting templates in django_nyt/emails/notification_email_message.txt and django_nyt/emails/notification_email_subject.txt.

  • Make the mail notification daemon script run either constantly python manage.py notifymail --daemon or with some interval by invoking python manage.py notifymail --cron as a cronjob. You can also call it from a Celery task or similar with call_command('notifymail', cron=True).

Development / demo project

In your Git fork, run pip install -r requirements.txt to install the requirements.

Install pre-commit hooks to verify your commits:

pip install pre-commit
pre-commit install

The folder test-project/ contains a pre-configured django project and an SQlite database. Login for django admin is admin:admin:

cd test-project
python manage.py runserver

After this, navigate to http://localhost:8000

Community

Please visit #django-wiki on irc.freenode.net as many django-wiki users are also familiar with django-nyt which previously lived inside django-wiki.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-nyt-1.0b5.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

django_nyt-1.0b5-py2.py3-none-any.whl (24.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-nyt-1.0b5.tar.gz.

File metadata

  • Download URL: django-nyt-1.0b5.tar.gz
  • Upload date:
  • Size: 20.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for django-nyt-1.0b5.tar.gz
Algorithm Hash digest
SHA256 24337e185bfddf37d96fe0eb5da0c1f3ec756fbb39d064ebd60fea2647a40cd4
MD5 1ca4ab08ea33f925afbf3edac0d397b7
BLAKE2b-256 a8d82ae6c48cc9fb2d878b0e5d1940aee1ee80a80c84d12624766c46e8446d64

See more details on using hashes here.

Provenance

File details

Details for the file django_nyt-1.0b5-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_nyt-1.0b5-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 93e798bf8a896e5bd242a139acab35d417e942607bce2caf1936820ec0cbb553
MD5 da39a85c3f9b0d73097999c2c99a9fbd
BLAKE2b-256 14ae4b921d5cd7e079471ec9d3326acade5f4c7638e6f47b44ee5f98576249bd

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page