You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

90 lines
2.5 KiB

  1. .. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
  2. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  3. :alt: License: AGPL-3
  4. =========================
  5. Mail digest notifications
  6. =========================
  7. Features
  8. --------
  9. This module allows users/partners to:
  10. * select "digest" mode in their notification settings
  11. * with digest mode on select a frequency: "daily" or "weekly"
  12. * configure specific rules per message subtype (enabled/disabled)
  13. to receive or to not receive any email notification for a given subtype.
  14. The preference tab on user's form will look like:
  15. .. image:: ./images/preview.png
  16. Behavior
  17. --------
  18. When a partner with digest mode on is notified with a message of type email or an email
  19. all the messages are collected inside a `mail.digest` container.
  20. A daily cron and a weekly cron will take care of creating a single email per each digest,
  21. which will be sent as a standard email.
  22. If the message has a specific subtype, all of this will work only
  23. if personal settings allow to receive notification for that specific subtype.
  24. Specifically:
  25. * no record for type: message passes
  26. * record disabled for type: message don't pass
  27. * record enabled for type: message pass
  28. NOTE: under the hood the digest notification logic excludes followers to be notified,
  29. since you really want to notify only mail.digest's partner.
  30. Known issues / Roadmap
  31. ======================
  32. * take full control of message and email template.
  33. Right now the notification message and the digest mail itself is wrapped inside Odoo mail template.
  34. We should be able to customize this easily.
  35. Bug Tracker
  36. ===========
  37. Bugs are tracked on `GitHub Issues
  38. <https://github.com/OCA/social/issues>`_. In case of trouble, please
  39. check there if your issue has already been reported. If you spotted it first,
  40. help us smashing it by providing a detailed and welcomed feedback.
  41. Credits
  42. =======
  43. Contributors
  44. ------------
  45. * Simone Orsi <simone.orsi@camptocamp.com>
  46. Funders
  47. -------
  48. The development of this module has been financially supported by: `Fluxdock.io <https://fluxdock.io>`_
  49. Maintainer
  50. ----------
  51. .. image:: https://odoo-community.org/logo.png
  52. :alt: Odoo Community Association
  53. :target: https://odoo-community.org
  54. This module is maintained by the OCA.
  55. OCA, or the Odoo Community Association, is a nonprofit organization whose
  56. mission is to support the collaborative development of Odoo features and
  57. promote its widespread use.
  58. To contribute to this module, please visit https://odoo-community.org.