.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3

===============
Message forward
===============

This module was written to extend the functionality of mails to support
forwarding them to another contact or database object.

* **To another object of the database:**
  * All its followers are notified according to their settings.
* **To other contacts:**
  * They recieve the forwarded message according to the usual notification
    rules of Odoo.

Installation
============

When installed, this module allows forwarding to the following database
objects:

* ``crm.lead``
* ``crm.meeting``
* ``crm.phonecall``
* ``mail.group``
* ``note.note``
* ``product.product``
* ``project.project``
* ``project.task``
* ``res.partner``
* ``sale.order``

Of course, if some of those are not available in your database, they will be
hidden until you install the module that adds them.

Usage
=====

To use this module, you need to:

* Go to any view that has a message thread.
* Press *Forward* (the button with a curved arrow pointing to the right).
* Modify the subject if you wish.
* If you want to forward the message to an *object*, choose it from the
  selector.
* If you want to forward the message to some partner(s), add them in the
  selector.
* Modify the message if you want.
* Add attachments if you want.
* If the message contains attachments, you can turn on the *Move attachments*
  option, and those will get attached to the new object.

  You will need to install the *document* module and have at least *User*
  permissions for *Knowledge* to see the effect.

.. info::
    Technical note: Internally, forwarded messages are modified copies of
    original ones, but attachments are references to the exact originals to
    avoid duplicating disk space. Keep that in mind when managing permissions.

.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
   :alt: Try me on Runbot
   :target: https://runbot.odoo-community.org/runbot/205/8.0

For further information, please visit:

* https://www.odoo.com/forum/help-1

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/social/issues>`_. 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
feedback `here
<https://github.com/OCA/social/issues/new?body=module:%20mail_forward%0Aversion:%208.0.6.0.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.


Credits
=======

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

* Jairo Llopis <j.llopis@grupoesoc.es>

Maintainer
----------

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

This module is maintained by the OCA.

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.

To contribute to this module, please visit http://odoo-community.org.