Metadata-Version: 2.1
Name: odoo-addon-mail_post_defer
Version: 18.0.1.0.2.1
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Faster and cancellable outgoing messages
Home-page: https://github.com/OCA/mail
License: LGPL-3
Author: Moduon, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

========================
Deferred Message Posting
========================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:8a627d0f62aebc47359106fa921c9a21a6a6e7b01536446192001c2823c60770
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
    :target: https://odoo-community.org/page/development-status
    :alt: Alpha
.. |badge2| image:: https://img.shields.io/badge/license-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fmail-lightgray.png?logo=github
    :target: https://github.com/OCA/mail/tree/18.0/mail_post_defer
    :alt: OCA/mail
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/mail-18-0/mail-18-0-mail_post_defer
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/mail&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module enhances mail threads by using the mail queue by default.

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!

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.

.. IMPORTANT::
   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.
   `More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
   :local:

Configuration
=============

You usually don't need to do anything. The module is configured
appropriately out of the box. Just make sure the following scheduled
actions are active:

- Mail: Email Queue Manager (mail.ir_cron_mail_scheduler_action)
- Notification: Send scheduled message notifications
  (mail.ir_cron_send_scheduled_message)

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.

You can still change that cadence after installing the module (although
it is not recommended). To do so:

1. Log in with an administrator user.
2. Activate developer mode.
3. Go to *Settings > Technical > Automation > Scheduled Actions*.
4. Edit the action named "Mail: Email Queue Manager".
5. Lower down the frequency in the field *Execute Every*. Recommended: 1
   minute.

Usage
=====

To use this module, you need to:

1. Go to the form view of any record that has a mail thread. It can be a
   partner, for example.
2. Post a message.

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 "Mail: Email
Queue Manager" cron job is executed.

While the message has not been yet sent:

1. Click the little envelope. You will see a paper airplane icon,
   indicating it is still outgoing.
2. Hover over the message and click on *⠇ > 🗑️ Delete*. Mails will not
   be sent.

Known issues / Roadmap
======================

- Add minimal deferring time configuration if it ever becomes necessary.
  See https://github.com/OCA/social/pull/1001#issuecomment-1461581573
  for the rationale behind current hardcoded value of 30 seconds.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/mail/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/mail/issues/new?body=module:%20mail_post_defer%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Moduon

Contributors
------------

- Jairo Llopis (https://www.moduon.team/)

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

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.

.. |maintainer-Yajo| image:: https://github.com/Yajo.png?size=40px
    :target: https://github.com/Yajo
    :alt: Yajo

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-Yajo| 

This module is part of the `OCA/mail <https://github.com/OCA/mail/tree/18.0/mail_post_defer>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
