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.

121 lines
3.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 configuration with server_environment
  6. ==========================================
  7. This module allows to configure the incoming and outgoing mail servers
  8. using the `server_environment` mechanism: you can then have different
  9. mail servers for the production and the test environment.
  10. Installation
  11. ============
  12. To install this module, you need to have the server_environment module
  13. installed and properly configured.
  14. Configuration
  15. =============
  16. With this module installed, the incoming and outgoing mail servers are
  17. configured in the `server_environment_files` module (which is a module
  18. you should provide, see the documentation of `server_environment` for
  19. more information).
  20. In the configuration file of each environment, you may first use the
  21. sections `[outgoing_mail]` and `[incoming_mail]` to configure the
  22. default values respectively for SMTP servers and the IMAP/POP servers.
  23. Then for each server, you can define additional values or override the
  24. default values with a section named `[outgoing_mail.resource_name]` or
  25. `[incoming_mail.resource_name]` where "resource_name" is the name of
  26. the server.
  27. Exemple of config file :
  28. [outgoing_mail]
  29. smtp_host = smtp.myserver.com
  30. smtp_port = 587
  31. smtp_user =
  32. smtp_pass =
  33. smtp_encryption = ssl
  34. [outgoing_mail.odoo_smtp_server1]
  35. smtp_user = odoo
  36. smtp_pass = odoo
  37. [incoming_mail.odoo_pop_mail1]
  38. server = mail.myserver.com
  39. port = 110
  40. type = pop
  41. is_ssl = 0
  42. attach = 0
  43. original = 0
  44. user = odoo@myserver.com
  45. password = uas1ohV0
  46. You will need to create 2 records in the database, one outgoing mail
  47. server with the field `name` set to "odoo_smtp_server1" and one
  48. incoming mail server with the field `name` set to "odoo_pop_mail1".
  49. Usage
  50. =====
  51. Once configured, Odoo will read the mail servers values from the
  52. configuration file related to each environment defined in the main
  53. Odoo file.
  54. Known issues / Roadmap
  55. ======================
  56. * Due to the special nature of this addon, you cannot test it on the OCA
  57. runbot.
  58. Bug Tracker
  59. ===========
  60. Bugs are tracked on `GitHub Issues
  61. <https://github.com/OCA/server-tools/issues>`_. In case of trouble, please
  62. check there if your issue has already been reported. If you spotted it first,
  63. help us smashing it by providing a detailed and welcomed `feedback
  64. <https://github.com/OCA/
  65. server-tools/issues/new?body=module:%20
  66. mail_environment%0Aversion:%20
  67. 9.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
  68. Credits
  69. =======
  70. Images
  71. ------
  72. * Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.
  73. Contributors
  74. ------------
  75. * Nicolas Bessi <nicolas.bessi@camptocamp.com>
  76. * Yannick Vaucher <yannick.vaucher@camptocamp.com>
  77. * Guewen Baconnier <guewen.baconnier@camptocamp.com>
  78. * Joël Grand-Guillaume <joel.grandguillaume@camptocamp.com>
  79. * Holger Brunn <hbrunn@therp.nl>
  80. * Alexandre Fayolle <alexandre.fayolle@camptocamp.com>
  81. Maintainer
  82. ----------
  83. .. image:: https://odoo-community.org/logo.png
  84. :alt: Odoo Community Association
  85. :target: https://odoo-community.org
  86. This module is maintained by the OCA.
  87. OCA, or the Odoo Community Association, is a nonprofit organization whose
  88. mission is to support the collaborative development of Odoo features and
  89. promote its widespread use.
  90. To contribute to this module, please visit https://odoo-community.org.