Metadata-Version: 2.1
Name: odoo-addon-base_search_mail_content
Version: 18.0.1.0.2
Requires-Python: >=3.10
Requires-Dist: odoo-addon-base_search_fuzzy==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Base Search Mail Content
Home-page: https://github.com/OCA/mail
License: AGPL-3
Author: ForgeFlow, SerpentCS, Tecnativa, 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 Affero General Public License v3
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

========================
Base Search Mail Content
========================

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

.. |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/license-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-OCA%2Fmail-lightgray.png?logo=github
    :target: https://github.com/OCA/mail/tree/18.0/base_search_mail_content
    :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-base_search_mail_content
    :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 adds the capability to find on any object (e.g. project
issues or helpdesk ticket) based on the conversation threads associated
to them.

This will be useful in models that make intense use of messages, like
project issues or helpdesk tickets.

A project issue or helpdesk ticket can contain tens of mails or notes
associated, based on the feedback that the person responsible for the
ticket maintains, including conversations with the person that raised
the issue.

A user may often want to find issues or tickets, based on the past
conversations that were recorded, as much as he or she needs to search
in their mail for past conversations.

This module will add dynamically a field 'message_content' to the search
view of any model that inherits from the mail.thread.

The current search capabilities include searching into the subject,
body, email from, reply to and record name.

**Table of contents**

.. contents::
   :local:

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

This module creates the GIN (trigram) indexes for these fields of
mail.message: subject, body, record_name, email_from, reply_to.

Usage
=====

Go to any model that contains a chatter (e.g. Contacts, ...). Search for
content in field 'Message Content'.

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

- This module restricts the message_content search functionality to
  internal users only, addressing the issue faced by project
  collaborators (portal users) as described in
  https://github.com/OCA/social/issues/1204. Consequently, portal users
  no longer have the ability to search within mail content.
- This module's usability is severely limited for languages that don't
  separate words with spaces (e.g., Chinese, Japanese, Korean, Thai,
  etc.), because ``pg_trgm`` needs three-character tokens and a
  similarity score above the default cutoff

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:%20base_search_mail_content%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
-------

* ForgeFlow
* SerpentCS
* Tecnativa

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

- Jordi Ballester Alomar <jordi.ballester@forgeflow.com>
- Serpent Consulting Services Pvt. Ltd. <support@serpentcs.com>
- Lois Rilo Antelo <lois.rilo@forgeflow.com>
- Aaron Henriquez <ahenriquez@forgeflow.com>
- `Tecnativa <https://www.tecnativa.com>`__:

  - Vicent Cubells
  - Ernesto Tejeda
  - David Bañón

- Nguyen Minh Chien <chien@trobz.com>
- Joel Estrada (`Moduon <https://moduon.es>`__)

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.

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

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