Skip to main content

Basic digest mail handling.

Project description

License: AGPL-3

Mail digest notifications

Features

This module allows users/partners to:

  • enable “digest mode” in their notification settings

  • with digest mode on select a frequency: “daily” or “weekly”

  • configure specific rules per message subtype (enabled/disabled)

  • globally enable/disable digest based on message’s type

to receive or to not receive any email notification for a given subtype.

The preference tab on user’s form will look like:

./images/preview.png

Global settings

By default digest functionality is enabled for every message type (‘email’, ‘comment’, ‘notification’). You change this with the config param mail_digest.enabled_message_types whereas you can specify message types separated by comma.

Behavior

When a user with digest mode on is notified with a message or an email all the messages are collected inside a mail.digest container.

A daily cron and a weekly cron will take care of creating a single email per each digest, which will be sent as a standard email.

Rules

Given that the user has Notification management = Handle by Emails

a message with subtype assigned will be sent via digest if:

  • global: mail_digest_enabled_message_types param enables the message type

  • user: digest mode is ON for the recipient

  • user: recipient’s user has no specific setting for the subtype

  • user: recipient’s user has no specific disabling setting for the subtype

a message with subtype assigned will NOT be sent via digest if:

  • global: mail_digest_enabled_message_types param disables the message type

  • user: digest mode is OFF for the recipient

  • user: recipient’s user has disabled the subtype in her/his settings

NOTE: under the hood the digest notification logic excludes followers to be notified, since you really want to notify only mail.digest’s partner.

Known issues / Roadmap

  • take full control of message and email template.

Right now the notification message and the digest mail itself is wrapped inside Odoo mail template. We should be able to customize this easily.

Migrating to v11

Notification settings, in Odoo core, have been moved to user model <https://github.com/odoo/odoo/commit/2950ffaa86ef38263e9a4a59a30d0768f82a61fa#diff-0c15808786b030dc6c62b0b88196afff>, and the logic changed a bit.

At the moment there’s no staight upgrade provided by this module. If you need to migrate, keep in mind that:

  • mail.digest is now tied to user (partner_id -> user_id)

  • notify_email has been removed so to enable digest mode you have to turn on the new flag digest_mode

  • notify_frequency has been moved to user model and is now called digest_frequency

  • partner.notification.conf became user.notification.conf

  • notify_conf_ids now links the new model user.notification.conf and moved to user model

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smash it by providing a detailed and welcomed feedback.

Credits

Contributors

Funders

The development of this module has been financially supported by: Fluxdock.io

Maintainer

Odoo Community Association

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

To contribute to this module, please visit https://odoo-community.org.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

odoo11_addon_mail_digest-11.0.1.0.2-py2.py3-none-any.whl (163.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file odoo11_addon_mail_digest-11.0.1.0.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for odoo11_addon_mail_digest-11.0.1.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 43b308038ff7acab5f37bc6d7d4f4beb2df4a7cc4035732614238c8b78ea68e5
MD5 4f4b6494284d4e6d25daaa76bee6d7bc
BLAKE2b-256 c6878711324f38a33449b28fbf56c8244c71738fe8dc57e2296a7538e4deca8e

See more details on using hashes here.

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