<h1 class="title">Deferred Message Posting</h1> <p><a class="reference external image-reference" href="https://odoo-community.org/page/development-status"><img alt="Alpha" src="https://img.shields.io/badge/maturity-Alpha-red.png" /></a> <a class="reference external image-reference" href="http://www.gnu.org/licenses/lgpl-3.0-standalone.html"><img alt="License: LGPL-3" src="https://img.shields.io/badge/licence-LGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/social/tree/15.0/mail_post_defer"><img alt="OCA/social" src="https://img.shields.io/badge/github-OCA%2Fsocial-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/social-15-0/social-15-0-mail_post_defer"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/205/15.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This module enhances mail threads by using the mail queue by default.</p> <p>Without this module, Odoo attempts to notify recipients of your message immediately. If your mail server is slow or you have many followers, this can mean a lot of time. Install this module and make Odoo more snappy!</p> <p>All emails will be kept in the outgoing queue by at least 30 seconds, giving you some time to re-think what you wrote. During that time, you can still delete the message and start again.</p> <div class="admonition important"> <p class="first admonition-title">Important</p> <p class="last">This is an alpha version, the data model and design can change at any time without warning. Only for development or testing purpose, do not use in production. <a class="reference external" href="https://odoo-community.org/page/development-status">More details on development status</a></p> </div> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li> <li><a class="reference internal" href="#usage" id="id2">Usage</a></li> <li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li> <li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id5">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id6">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id8">Maintainers</a></li> </ul> </li> </ul> </div> <a name="configuration"></a> <h2><a class="toc-backref" href="#id1">Configuration</a></h2> <p>You need to do nothing. The module is configured appropriately out of the box.</p> <p>The mail queue processing is made by a cron job. This is normal Odoo behavior, not specific to this module. However, since you will start using that queue for every message posted by any user in any thread, this module configures that job to execute every minute by default.</p> <p>You can still change that cadence after installing the module (although it is not recommended). To do so:</p> <ol class="arabic simple"> <li>Log in with an administrator user.</li> <li>Activate developer mode.</li> <li>Go to <em>Settings &gt; Technical &gt; Automation &gt; Scheduled Actions</em>.</li> <li>Edit the action named &quot;Mail: Email Queue Manager&quot;.</li> <li>Lower down the frequency in the field <em>Execute Every</em>. Recommended: 1 minute.</li> </ol> <a name="usage"></a> <h2><a class="toc-backref" href="#id2">Usage</a></h2> <p>To use this module, you need to:</p> <ol class="arabic simple"> <li>Go to the form view of any record that has a mail thread. It can be a partner, for example.</li> <li>Post a message.</li> </ol> <p>The mail is now in the outgoing mail queue. It will be there for at least 30 seconds. It will be really sent the next time the &quot;Mail: Email Queue Manager&quot; cron job is executed.</p> <p>While the message has not been yet sent:</p> <ol class="arabic simple"> <li>Hover over the little envelope. You will see a paper airplane icon, indicating it is still outgoing.</li> <li>Hover over the message and click on the little trash icon to delete it. Mails will not be sent.</li> </ol> <a name="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2> <ul class="simple"> <li>Add minimal deferring time configuration if it ever becomes necessary. See <a class="reference external" href="https://github.com/OCA/social/pull/1001#issuecomment-1461581573">https://github.com/OCA/social/pull/1001#issuecomment-1461581573</a> for the rationale behind current hardcoded value of 30 seconds.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/social/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/OCA/social/issues/new?body=module:%20mail_post_defer%0Aversion:%2015.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id5">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id6">Authors</a></h3> <ul class="simple"> <li>Moduon</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id7">Contributors</a></h3> <ul class="simple"> <li>Jairo Llopis (<a class="reference external" href="https://www.moduon.team/">https://www.moduon.team/</a>)</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id8">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.</p> <p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p> <p><a class="reference external image-reference" href="https://github.com/Yajo"><img alt="Yajo" src="https://github.com/Yajo.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/social/tree/15.0/mail_post_defer">OCA/social</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>