.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: 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:
.. image:: ./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
<https://github.com/OCA/social/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
------------
* Simone Orsi <simone.orsi@camptocamp.com>
Funders
-------
The development of this module has been financially supported by: `Fluxdock.io <https://fluxdock.io>`_
Maintainer
----------
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
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.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/social",
"name": "odoo11-addon-mail-digest",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*",
"maintainer_email": "",
"keywords": "",
"author": "Camptocamp, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": "",
"platform": "",
"description": ".. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n\n=========================\nMail digest notifications\n=========================\n\nFeatures\n--------\n\nThis module allows users/partners to:\n\n* enable \"digest mode\" in their notification settings\n* with digest mode on select a frequency: \"daily\" or \"weekly\"\n* configure specific rules per message subtype (enabled/disabled)\n* globally enable/disable digest based on message's type\n\nto receive or to not receive any email notification for a given subtype.\n\nThe preference tab on user's form will look like:\n\n.. image:: ./images/preview.png\n\n\nGlobal settings\n---------------\n\nBy default digest functionality is enabled\nfor every message type ('email', 'comment', 'notification').\nYou change this with the config param `mail_digest.enabled_message_types`\nwhereas you can specify message types separated by comma.\n\n\nBehavior\n--------\n\nWhen a user with digest mode on is notified with a message or an email\nall the messages are collected inside a `mail.digest` container.\n\nA daily cron and a weekly cron will take care\nof creating a single email per each digest,\nwhich will be sent as a standard email.\n\n**Rules**\n\nGiven that the user has `Notification management = Handle by Emails`...\n\na message with subtype assigned **will be sent** via digest if:\n\n * global: `mail_digest_enabled_message_types` param enables the message type\n * user: digest mode is ON for the recipient\n * user: recipient's user has no specific setting for the subtype\n * user: recipient's user has no specific disabling setting for the subtype\n\n\na message with subtype assigned **will NOT be sent** via digest if:\n\n * global: `mail_digest_enabled_message_types` param disables the message type\n * user: digest mode is OFF for the recipient\n * user: recipient's user has disabled the subtype in her/his settings\n\n\nNOTE: under the hood the digest notification logic excludes followers to be notified,\nsince you really want to notify only mail.digest's partner.\n\n\nKnown issues / Roadmap\n======================\n\n* take full control of message and email template.\n\nRight now the notification message and the digest mail itself is wrapped inside Odoo mail template.\nWe should be able to customize this easily.\n\nMigrating to v11\n----------------\n\nNotification settings, in Odoo core,\n`have been moved to user model <https://github.com/odoo/odoo/commit/2950ffaa86ef38263e9a4a59a30d0768f82a61fa#diff-0c15808786b030dc6c62b0b88196afff>`,\nand the logic changed a bit.\n\nAt the moment there's no staight upgrade provided by this module.\nIf you need to migrate, keep in mind that:\n\n* `mail.digest` is now tied to user (partner_id -> user_id)\n* `notify_email` has been removed so to enable digest mode you have to turn on the new flag `digest_mode`\n* `notify_frequency` has been moved to user model and is now called `digest_frequency`\n* `partner.notification.conf` became `user.notification.conf`\n* `notify_conf_ids` now links the new model `user.notification.conf` and moved to user model\n\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues\n<https://github.com/OCA/social/issues>`_. In case of trouble, please\ncheck there if your issue has already been reported. If you spotted it first,\nhelp us smash it by providing a detailed and welcomed feedback.\n\nCredits\n=======\n\nContributors\n------------\n\n* Simone Orsi <simone.orsi@camptocamp.com>\n\n\nFunders\n-------\n\nThe development of this module has been financially supported by: `Fluxdock.io <https://fluxdock.io>`_\n\n\nMaintainer\n----------\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nThis module is maintained by the OCA.\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\nTo contribute to this module, please visit https://odoo-community.org.\n\n\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Basic digest mail handling.",
"version": "11.0.1.0.2",
"project_urls": {
"Homepage": "https://github.com/OCA/social"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c6878711324f38a33449b28fbf56c8244c71738fe8dc57e2296a7538e4deca8e",
"md5": "4f4b6494284d4e6d25daaa76bee6d7bc",
"sha256": "43b308038ff7acab5f37bc6d7d4f4beb2df4a7cc4035732614238c8b78ea68e5"
},
"downloads": -1,
"filename": "odoo11_addon_mail_digest-11.0.1.0.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "4f4b6494284d4e6d25daaa76bee6d7bc",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*",
"size": 163297,
"upload_time": "2018-04-05T04:30:11",
"upload_time_iso_8601": "2018-04-05T04:30:11.382456Z",
"url": "https://files.pythonhosted.org/packages/c6/87/8711324f38a33449b28fbf56c8244c71738fe8dc57e2296a7538e4deca8e/odoo11_addon_mail_digest-11.0.1.0.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2018-04-05 04:30:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "social",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "odoo11-addon-mail-digest"
}
JSON
