django-dans-notifications 1.1.16

A Django app to different handle notification types.

Django Dans Notifications

Description

A Django app to handle notifications.

Support for basic notifications, push notifications and email notifications.

Quick start

1. Install the package via pip:

pip install django-dans-notifications

2. Add "django_dans_notifications" to your INSTALLED_APPS setting like this:

INSTALLED_APPS = [
	...
	'django_dans_notifications',
]

3. Include the notifications URLconf in your project urls.py for the REST API endpoints like this:

path("api/notifications/", include("django_dans_notifications.urls")),

4. Run python manage.py migrate to update your database schema.

5. Create notifications via the API endpoints, in code or your Django admin portal.

Requirements

• Python 3.0 or higher
• Django 3.0 or higher
• Django Rest Framework
  • NOTE: not only must you have this installed, you must have set DEFAULT_AUTHENTICATION_CLASSES and DEFAULT_PAGINATION_CLASS in your settings.py to work with the APIs properly. An example config would be:

REST_FRAMEWORK = {
    "DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
    "PAGE_SIZE": 20,
    "DEFAULT_AUTHENTICATION_CLASSES": (
        "rest_framework.authentication.TokenAuthentication",
    ),
}

Available Settings

Currently all available settings are optional:

• TEAM_NAME - Default team name to use for emails, can be added to message context manually as well still.
• IN_TEST - Whether running in tests or not. Used to determine whether to actually send email.

Usage

The main way to interact with this app is to create and use the appropriate models and their managers' methods as needed.

Also included is the NotificationManager a class to expose some common functionality and maintain object permissions.

Some of its methods currently are:

• get_notifications_push/email/basic/all
  • Enforce object ownership and notification 'direction'
• mark_notification_basic_read

You can also interact directly, so for example to send an email notification:

from django_dans_notifications.models import EmailNotification

email_notification = EmailNotification.objects.send_email(...)

Docs

Model docs.

API docs.

Email Template docs.

---

https://danielnazarian.com

Copyright 2024 © Daniel Nazarian.