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.

117 lines
4.1 KiB

  1. ==========================================================
  2. Customizable unsubscription process on mass mailing emails
  3. ==========================================================
  4. .. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  5. !! This file is generated by oca-gen-addon-readme !!
  6. !! changes will be overwritten. !!
  7. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  8. .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
  9. :target: https://odoo-community.org/page/development-status
  10. :alt: Beta
  11. .. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
  12. :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
  13. :alt: License: AGPL-3
  14. .. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fsocial-lightgray.png?logo=github
  15. :target: https://github.com/OCA/social/tree/12.0/mass_mailing_custom_unsubscribe
  16. :alt: OCA/social
  17. .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
  18. :target: https://translation.odoo-community.org/projects/social-12-0/social-12-0-mass_mailing_custom_unsubscribe
  19. :alt: Translate me on Weblate
  20. .. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
  21. :target: https://runbot.odoo-community.org/runbot/205/12.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. This addon extends the unsubscription form to let you:
  25. - Choose which mailing lists are not cross-unsubscriptable when unsubscribing
  26. from a different one.
  27. - Know why and when a contact has been subscribed or unsubscribed from a
  28. mass mailing.
  29. - Provide proof on why you are sending mass mailings to a given contact, as
  30. required by the GDPR in Europe.
  31. **Table of contents**
  32. .. contents::
  33. :local:
  34. Configuration
  35. =============
  36. You can customize what reasons will be displayed to your unsubscriptors when
  37. they are going to unsubscribe. To do it:
  38. #. Go to *Email Marketing > Configuration > Unsubscription Reasons*.
  39. #. Create / edit / remove / sort as usual.
  40. #. If *Details required* is enabled, they will have to fill a text area to
  41. continue.
  42. Usage
  43. =====
  44. Once configured:
  45. #. Go to *Email Marketing > Mailings > Create*.
  46. #. Edit your mass mailing at wish, but remember to add a snippet from
  47. *Footers*, so people have an *Unsubscribe* link.
  48. #. Send it.
  49. #. If somebody gets unsubscribed, you will see logs about that under
  50. *Email Marketing > Unsubscriptions*.
  51. Known issues / Roadmap
  52. ======================
  53. * This module replaces AJAX submission core implementation from the mailing
  54. list management form, because it is impossible to extend it. When this is
  55. fixed, this addon will need a refactoring (mostly removing
  56. duplicated functionality and depending on it instead of replacing it).
  57. Bug Tracker
  58. ===========
  59. Bugs are tracked on `GitHub Issues <https://github.com/OCA/social/issues>`_.
  60. In case of trouble, please check there if your issue has already been reported.
  61. If you spotted it first, help us smashing it by providing a detailed and welcomed
  62. `feedback <https://github.com/OCA/social/issues/new?body=module:%20mass_mailing_custom_unsubscribe%0Aversion:%2012.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  63. Do not contact contributors directly about support or help with technical issues.
  64. Credits
  65. =======
  66. Authors
  67. ~~~~~~~
  68. * Tecnativa
  69. Contributors
  70. ~~~~~~~~~~~~
  71. * `Tecnativa <https://www.tecnativa.com>`_:
  72. * Rafael Blasco
  73. * Antonio Espinosa
  74. * Jairo Llopis
  75. * David Vidal
  76. * Ernesto Tejeda
  77. Maintainers
  78. ~~~~~~~~~~~
  79. This module is maintained by the OCA.
  80. .. image:: https://odoo-community.org/logo.png
  81. :alt: Odoo Community Association
  82. :target: https://odoo-community.org
  83. OCA, or the Odoo Community Association, is a nonprofit organization whose
  84. mission is to support the collaborative development of Odoo features and
  85. promote its widespread use.
  86. This module is part of the `OCA/social <https://github.com/OCA/social/tree/12.0/mass_mailing_custom_unsubscribe>`_ project on GitHub.
  87. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.