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.

332 lines
11 KiB

  1. <section class="oe_container">
  2. <div class="oe_row oe_spaced">
  3. <div class="oe_span12">
  4. <h2 class="oe_slogan" style="color:#875A7B;">Mailgun</h2>
  5. <h3 class="oe_slogan">Easy to setup the outgoing and incoming mail flow</h3>
  6. </div>
  7. </div>
  8. </section>
  9. <section class="oe_container">
  10. <div class="oe_row oe_spaced">
  11. <div class="oe_span12">
  12. <p class="oe_mt32">
  13. <div class="alert alert-success" style="padding:0.3em 0.6em; font-size: 150%;">
  14. The module provides Odoo and Mailgun integration to be able to easily configure <em>Outgoing</em> and <em>Incoming</em> mail flow.
  15. <div style="margin-top:2%;">
  16. From Mailgun side you get:
  17. <ul style="padding-left: 1.6em;">
  18. <li style="margin-top: 0.3em;">
  19. Powerful Sending Infrastructure
  20. </li>
  21. <li>
  22. Intelligent Inbound Routing &amp; Storage
  23. </li>
  24. <li>
  25. Tracking and Analytics
  26. </li>
  27. <li>
  28. Email Validation
  29. </li>
  30. </ul>
  31. </div>
  32. </div>
  33. </p>
  34. </div>
  35. </div>
  36. </section>
  37. <section class="oe_container oe_dark">
  38. <div class="oe_row oe_spaced">
  39. <h3 class="oe_slogan">Mailgun Configuration</h3>
  40. <h4 class="oe_slogan"><b>Manage Domains</b></h4>
  41. <div class="oe_span12">
  42. <p class="oe_mt32">
  43. <font style="font-size: 120%;">
  44. <ul style="padding-left: 1.4em;">
  45. <li>
  46. Create account on <a href="https://mailgun.com" target="_blank">Mailgun</a> service
  47. </li>
  48. <li>
  49. Add domain in <b>Domains</b> menu
  50. </li>
  51. </ul>
  52. Note that the state of your domain should be <b>Active</b> to be able to use it from Odoo side. To verify it follow the instruction <a href="https://help.mailgun.com/hc/en-us/articles/202052074-How-do-I-verify-my-domain-" target="_blank">How do I verify my domain</a>
  53. </font>
  54. </p>
  55. </div>
  56. <div class="oe_screenshot" align="center">
  57. <img style="max-width: 80%" src="mailgun_add_domain.png"/>
  58. </div>
  59. </div>
  60. </section>
  61. <section class="oe_container">
  62. <div class="oe_row oe_spaced">
  63. <div class="oe_span12 text-center">
  64. <p class="oe_mt32">
  65. <font style="font-size: 120%;">
  66. Click on added domain name and see all the information needed to configure your <em>Incoming</em> and <em>Outgoing</em> mail feature.
  67. </font>
  68. </p>
  69. </div>
  70. <div class="oe_screenshot" align="center">
  71. <img style="max-width: 80%" src="mailgun_domain_details.png"/>
  72. </div>
  73. </div>
  74. </section>
  75. <section class="oe_container oe_dark">
  76. <div class="oe_row oe_spaced">
  77. <div class="oe_span12 text-center">
  78. <p class="oe_mt32">
  79. <font style="font-size: 120%;">
  80. If you use sandbox domain, add <b>Authorized Recipient</b> first (sandbox domains are restricted to <a href="https://help.mailgun.com/hc/en-us/articles/217531258" target="_blank">authorized recipients</a>)
  81. </font>
  82. </p>
  83. </div>
  84. <div class="oe_screenshot" align="center">
  85. <img style="max-width: 80%" src="mailgun_auth_recipients.png"/>
  86. </div>
  87. <br/>
  88. <div class="oe_screenshot" align="center">
  89. <img style="max-width: 80%" src="mailgun_auth_recipients_form.png"/>
  90. </div>
  91. </div>
  92. </section>
  93. <section class="oe_container">
  94. <div class="oe_row oe_spaced" style="margin-top: 5em;">
  95. <h4 class="oe_slogan"><b>Routes</b></h4>
  96. <div class="oe_span12 text-center">
  97. <p class="oe_mt32">
  98. <font style="font-size: 120%;">
  99. Navigate to <b>Routes</b> menu and create a new route
  100. </font>
  101. </p>
  102. </div>
  103. <div class="oe_screenshot" align="center">
  104. <img style="max-width: 80%" src="mailgun_route.png"/>
  105. </div>
  106. </div>
  107. </section>
  108. <section class="oe_container oe_dark">
  109. <div class="oe_row oe_spaced">
  110. <div class="oe_span12">
  111. <p class="oe_mt32">
  112. <font style="font-size: 120%;">
  113. Set the following fields and values:
  114. <ul>
  115. <li>
  116. <b>Expression Type</b>: Custom
  117. </li>
  118. <li>
  119. <b>Raw Expression</b>: match_recipient('.*@your_mail_domain')
  120. </li>
  121. <li>
  122. <b>Actions</b>:
  123. <ul>
  124. <li>
  125. Check the box <em>Store and notify</em>
  126. </li>
  127. <li>
  128. Put there http://your_odoo_domain/mailgun/notify
  129. </li>
  130. </li>
  131. </ul>
  132. </font>
  133. </p>
  134. </div>
  135. <div class="oe_screenshot" align="center">
  136. <img style="max-width: 80%" src="mailgun_route_form.png"/>
  137. </div>
  138. <div class="oe_span12 text-center">
  139. <p class="oe_mt32">
  140. <font style="font-size: 120%;">
  141. <b>Now everything is ready to move to Odoo configuration.</b>
  142. </font>
  143. </p>
  144. </div>
  145. </div>
  146. </section>
  147. <section class="oe_container">
  148. <div class="oe_row oe_spaced" style="margin-top: 6em;">
  149. <h3 class="oe_slogan">Odoo Configuration</h3>
  150. <h4 class="oe_slogan"><b>Outgoing Mail Feature</b></h4>
  151. <div class="oe_span12">
  152. <p class="oe_mt32">
  153. <font style="font-size: 120%;">
  154. At first, activate <a href="https://odoo-development.readthedocs.io/en/latest/odoo/usage/debug-mode.html" target="_blank">the developer mode</a>. Then go to <em>Settings &rarr; Technical &rarr; Email &rarr; Outgoing Mail Servers</em> menu and populate the following fields:
  155. <ul>
  156. <li>
  157. <b>Description</b> - e.g. Mailgun
  158. </li>
  159. <li>
  160. <b>SMTP Server</b> - smtp.mailgun.org
  161. </li>
  162. <li>
  163. <b>Connection Security</b> - SSL/TLS
  164. </li>
  165. <li>
  166. <b>Username</b> - use <em>Default SMTP Login</em> from mailgun
  167. </li>
  168. <li>
  169. <b>Password</b> - use <em>Default Password</em> from mailgun
  170. </li>
  171. </ul>
  172. Once the fields are populated, click <b>Test Connection</b> button to check the connection to smtp server. If everything is ok, you can see popup message <em>Connection Test Succeeded! Everything seems properly set up!</em> and you are able to send messages now.
  173. </font>
  174. </p>
  175. </div>
  176. <div class="oe_screenshot" align="center">
  177. <img style="max-width: 80%" src="mailgun_odoo_outgoing.png"/>
  178. </div>
  179. </div>
  180. </section>
  181. <section class="oe_container oe_dark">
  182. <div class="oe_row oe_spaced">
  183. <h4 class="oe_slogan"><b>Incoming Mail Feature</b></h4>
  184. <div class="oe_span12">
  185. <p class="oe_mt32">
  186. <font style="font-size: 120%;">
  187. Note that to setup incoming mailing, it is not required to setup <em>Incoming Mail Server</em>.
  188. <br/>
  189. Open <em>Settings &rarr; General Settings</em> menu:
  190. <ul>
  191. <li>
  192. Check the box <b>External Email Servers</b>
  193. </li>
  194. <li>
  195. Set as <b>Alias Domain</b> the domain name from Mailgun
  196. </li>
  197. </ul>
  198. Save the changes.
  199. </font>
  200. </p>
  201. </div>
  202. <div class="oe_screenshot" align="center">
  203. <img style="max-width: 80%" src="mailgun_odoo_general.png"/>
  204. </div>
  205. </div>
  206. </section>
  207. <section class="oe_container">
  208. <div class="oe_row oe_spaced">
  209. <div class="oe_span12">
  210. <p class="oe_mt32">
  211. <font style="font-size: 120%;">
  212. Setup mailgun API credentials in <em>Settings &rarr; Parameters &rarr; System Parameters</em> menu. Create new parameter:
  213. <ul>
  214. <li>
  215. <b>Key</b> - mailgun.apikey
  216. </li>
  217. <li>
  218. <b>Value</b> - key-12345...
  219. </li>
  220. </ul>
  221. </font>
  222. </p>
  223. </div>
  224. <div class="oe_screenshot" align="center">
  225. <img style="max-width: 80%" src="mailgun_odoo_sys_param.png"/>
  226. </div>
  227. </div>
  228. </section>
  229. <section class="oe_container oe_dark">
  230. <div class="oe_row oe_spaced">
  231. <div class="oe_span12 text-center">
  232. <p class="oe_mt32">
  233. <font style="font-size: 120%;">
  234. Now you can configure mail aliases for users. Go to <em>Settings &rarr; Users</em> menu and open user form (e.g. for Administrator). Then switch to <em>Preferences</em> tab and select an existing alias or create new one in the <b>Alias</b> field.
  235. </font>
  236. </p>
  237. </div>
  238. <div class="oe_screenshot" align="center">
  239. <img style="max-width: 80%" src="mailgun_odoo_mail_alias.png"/>
  240. </div>
  241. </div>
  242. </section>
  243. <section class="oe_container">
  244. <div class="oe_row oe_spaced">
  245. <div class="oe_span12 text-center">
  246. <p class="oe_mt32">
  247. <font style="font-size: 120%;">
  248. Open the user's related partner and set <b>Email</b> - the email is used for replying on user messages
  249. </font>
  250. </p>
  251. </div>
  252. <div class="oe_screenshot" align="center">
  253. <img style="max-width: 80%" src="mailgun_odoo_partner_email.png"/>
  254. </div>
  255. </div>
  256. </section>
  257. <section class="oe_container oe_dark">
  258. <div class="oe_row oe_spaced">
  259. <div class="oe_span12 text-center">
  260. <p class="oe_mt32">
  261. <font style="font-size: 120%;">
  262. <b>
  263. Everything is done! It's time to send/receive email messages now!
  264. </b>
  265. </font>
  266. </p>
  267. </div>
  268. </div>
  269. </section>
  270. <section class="oe_container">
  271. <div class="oe_row oe_spaced">
  272. <div class="oe_span8">
  273. <h2>Need our service?</h2>
  274. <p class="oe_mt32">Contact us by <a href="mailto:apps@it-projects.info">email</a> or fill out <a href="https://www.it-projects.info/page/website.contactus " target="_blank">request form</a></p>
  275. <ul>
  276. <li><a href="mailto:apps@it-projects.info">apps@it-projects.info <i class="fa fa-envelope-o"></i></a></li>
  277. <li><a href="https://www.it-projects.info/page/website.contactus " target="_blank">https://www.it-projects.info/page/website.contactus <i class="fa fa-list-alt"></i></a></li>
  278. </ul>
  279. </div>
  280. <div class="oe_span4">
  281. <div class="stamp" style="width:200px;">
  282. <div style="margin-top: 15px;
  283. position: relative;
  284. font-family:'Vollkorn', serif;
  285. font-size: 16px;
  286. line-height: 25px;
  287. text-transform: uppercase;
  288. font-weight: bold;
  289. color: #75526b;
  290. border: 3px dashed #75526b;
  291. float: left;
  292. padding: 4px 12px;
  293. -webkit-transform: rotate(6deg);
  294. -o-transform: rotate(6deg);
  295. -moz-transform: rotate(6deg);
  296. -ms-transform: rotate(6deg);">
  297. Tested on Odoo<br/>11.0 community
  298. </div>
  299. <div style="margin-top: 15px;
  300. position: relative;
  301. font-family:'Vollkorn', serif;
  302. font-size: 16px;
  303. line-height: 25px;
  304. text-transform: uppercase;
  305. font-weight: bold;
  306. color: #75526b;
  307. border: 3px dashed #75526b;
  308. float: left;
  309. padding: 4px 12px;
  310. -webkit-transform: rotate(-7deg);
  311. -o-transform: rotate(-7deg);
  312. -moz-transform: rotate(-7deg);
  313. -ms-transform: rotate(-7deg);">
  314. Tested on Odoo<br/>11.0 enterprise
  315. </div>
  316. </div>
  317. </div>
  318. </div>
  319. </section>