.. 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:
* select "digest" mode in their notification settings
* with digest mode on select a frequency: "daily" or "weekly"
* configure specific rules per message subtype (enabled/disabled)
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
Behavior
--------
When a partner 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.
If the message has a specific subtype, all of this will work only
if personal settings allow to receive notification for that specific subtype.
Specifically:
* no record for type: message passes
* record disabled for type: message don't pass
* record enabled for type: message pass
NOTE: under the hood the digest notification logic excludes followers to be notified,
since you really want to notify only mail.digest's partner.
NOTE 2: Odoo's mail machinery has an option `force_send`
to send the email immediately without waiting for the mail queue to be processed.
When this option is used the email is sent right away
and the message record is deleted right after.
A typical use case is the reset password mail.
We assume that if you use that option you really want the email to go out "now"
so when `force_send` is used, digest machinery is completely bypassed.
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.
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.
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 smashing 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": "odoo10-addon-mail-digest",
"maintainer": "",
"docs_url": null,
"requires_python": "~=2.7",
"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* select \"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\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\nBehavior\n--------\n\nWhen a partner 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 of creating a single email per each digest,\nwhich will be sent as a standard email.\n\nIf the message has a specific subtype, all of this will work only\nif personal settings allow to receive notification for that specific subtype.\nSpecifically:\n\n* no record for type: message passes\n* record disabled for type: message don't pass\n* record enabled for type: message pass\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\nNOTE 2: Odoo's mail machinery has an option `force_send`\nto send the email immediately without waiting for the mail queue to be processed.\nWhen this option is used the email is sent right away\nand the message record is deleted right after.\n\nA typical use case is the reset password mail.\nWe assume that if you use that option you really want the email to go out \"now\"\nso when `force_send` is used, digest machinery is completely bypassed.\n\n\nGlobal settings\n---------------\n\nBy default digest functionality is enabled for 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\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\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 smashing 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": "10.0.1.0.2",
"project_urls": {
"Homepage": "https://github.com/OCA/social"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "aa0ce462c0e24adfbe7d114f90f737ccbd919693d6567235cf1cfe698460868e",
"md5": "66215864d3b9543bd308fb3dd739dd06",
"sha256": "86561a8c83288c0ff86efa2de322ce8b0984e9f09b8bd022f8673fa08d3f2574"
},
"downloads": -1,
"filename": "odoo10_addon_mail_digest-10.0.1.0.2-py2-none-any.whl",
"has_sig": false,
"md5_digest": "66215864d3b9543bd308fb3dd739dd06",
"packagetype": "bdist_wheel",
"python_version": "py2",
"requires_python": "~=2.7",
"size": 157798,
"upload_time": "2018-04-07T04:30:09",
"upload_time_iso_8601": "2018-04-07T04:30:09.708212Z",
"url": "https://files.pythonhosted.org/packages/aa/0c/e462c0e24adfbe7d114f90f737ccbd919693d6567235cf1cfe698460868e/odoo10_addon_mail_digest-10.0.1.0.2-py2-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2018-04-07 04:30:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "social",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "extract_msg",
"specs": []
},
{
"name": "premailer",
"specs": []
}
],
"lcname": "odoo10-addon-mail-digest"
}
JSON
