Metadata-Version: 2.1
Name: odoo-addon-mail_block_user_assigned_message
Version: 18.0.1.0.0
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Block assignation notifications depending on model
Home-page: https://github.com/sygel-technology/sy-social
License: AGPL-3
Author: Sygel
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

================================
Mail Block User Assigned Message
================================

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

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-sygel--technology%2Fsy--social-lightgray.png?logo=github
    :target: https://github.com/sygel-technology/sy-social/tree/18.0/mail_block_user_assigned_message
    :alt: sygel-technology/sy-social

|badge1| |badge2| |badge3|

This module allows to select multiple models in each user so they don't
receive a notification from the documents related to those models when
the users are assigned to them. This module works for both Odoo and
email notifications.

**Table of contents**

.. contents::
   :local:

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

To configure this module, you need to:

1. Go to the "Preferences" tab in an internal user.
2. Activate the "Block Assigned Message" option.
3. Select the models for which assignation notifications don't have to
   be generated.

It is important to keep in mind that automatic assignment notifications
are only created when a model meets the following requirements:

-  The model is subclass of the abstract class mail.thread.
-  The model has a user_id field.
-  The tracking parameter of the user_id field is different to False.

This module will not work with models that do not meet all those three
requirements. Also, notification methods can be overriden, so the module
would not work in those cases either.

A particular example of a model that does not work is the project.task
model. It does not have a user_id field, but a Many2many user_ids field.
Assignment notifications are created using a specific custom method for
this model, so are not blocked using this module.

Usage
=====

To use this module, you need to:

1. Go to a model that has assign notifications. For example: res.partner
   (install the contacts module if you do not have the menu)
2. Login with a user that has permissions in that model with another
   browser or incognito mode. Create that user before if it does not
   exist
3. With the second user, assign a record to the first user selecting him
   on the user_id field. In our res.partner example, we will assign the
   first user as 'Salesperson'.
4. The first user will not receive the assignation notification if you
   have configured them to be blocked in that model. You can also review
   if the notifications are correcly received without this block.

Note: Notifications are, by default, handled by emails. You can change
them, to be handled in odoo, in your preferences.

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

Bugs are tracked on `GitHub Issues <https://github.com/sygel-technology/sy-social/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/sygel-technology/sy-social/issues/new?body=module:%20mail_block_user_assigned_message%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
-------

* Sygel

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

-  `Sygel <https://www.sygel.es>`__:

   -  Manuel Regidor
   -  Alberto Martínez
   -  Valentin Vinagre
   -  Harald Panten

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

This module is part of the `sygel-technology/sy-social <https://github.com/sygel-technology/sy-social/tree/18.0/mail_block_user_assigned_message>`_ project on GitHub.

You are welcome to contribute.
