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.

113 lines
4.0 KiB

  1. ===================================
  2. Default Thread For Unbounded 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/11.0/fetchmail_thread_default
  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-11-0/social-11-0-fetchmail_thread_default
  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/11.0
  22. :alt: Try me on Runbot
  23. |badge1| |badge2| |badge3| |badge4| |badge5|
  24. This module extends the functionality of mail fetching to support choosing a
  25. mail thread that acts as a mail sink and gathers all mail messages that Odoo
  26. does not know where to put.
  27. Dangling emails are really a problem because if you do not care about them,
  28. SPAM can enter your inbox and keep increasing fetchmail process network quota
  29. because Odoo would gather them every time it runs the fetchmail process.
  30. Before this, your only choice was to create a new record for those unbounded
  31. emails. That could be useful under some circumstances, like creating a
  32. ``crm.lead`` for them, but what happens if you do not want to have lots of
  33. spammy leads? Or if you do not need Odoo's CRM at all?
  34. Here we come to the rescue. This simple addons adds almost none dependencies
  35. and allows you to direct those mails somewhere you can handle or ignore at
  36. wish.
  37. **Table of contents**
  38. .. contents::
  39. :local:
  40. Configuration
  41. =============
  42. To configure this module, you need to:
  43. #. Go to *Settings > General Settings > Configure the incoming email gateway*.
  44. #. Create or edit a record.
  45. #. Configure properly.
  46. #. Under *Default mail thread*, choose a model and record.
  47. Tip: if you do not know what to choose, we suggest you to use a mail
  48. channel.
  49. Usage
  50. =====
  51. To use this module, you need to:
  52. #. Subscribe to the thread you chose as the *Default mail thread*.
  53. #. You will be notified when a new unbound email lands in that thread.
  54. #. Do what you want with it.
  55. Bug Tracker
  56. ===========
  57. Bugs are tracked on `GitHub Issues <https://github.com/OCA/social/issues>`_.
  58. In case of trouble, please check there if your issue has already been reported.
  59. If you spotted it first, help us smashing it by providing a detailed and welcomed
  60. `feedback <https://github.com/OCA/social/issues/new?body=module:%20fetchmail_thread_default%0Aversion:%2011.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  61. Do not contact contributors directly about support or help with technical issues.
  62. Credits
  63. =======
  64. Authors
  65. ~~~~~~~
  66. * Tecnativa
  67. Contributors
  68. ~~~~~~~~~~~~
  69. * `Tecnativa <https://www.tecnativa.com>`_:
  70. * Jairo Llopis
  71. * David Vidal
  72. Maintainers
  73. ~~~~~~~~~~~
  74. This module is maintained by the OCA.
  75. .. image:: https://odoo-community.org/logo.png
  76. :alt: Odoo Community Association
  77. :target: https://odoo-community.org
  78. OCA, or the Odoo Community Association, is a nonprofit organization whose
  79. mission is to support the collaborative development of Odoo features and
  80. promote its widespread use.
  81. This module is part of the `OCA/social <https://github.com/OCA/social/tree/11.0/fetchmail_thread_default>`_ project on GitHub.
  82. You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.