[19.0][MIG] mail_tracking: Migration to 19.0

mail_tracking/README.rst

@@ -0,0 +1,203 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+==============
+Email tracking
+==============
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:db328da6c6862a0a974ae2259d6ec0106efc220892bb703f7429abf16f8f7851
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/19.0/mail_tracking
+    :alt: OCA/mail
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/mail-19-0/mail-19-0-mail_tracking
+    :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=19.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module shows email notification tracking status for any messages in
+mail thread (chatter). Each notified partner will have an intuitive icon
+just right to his name.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Installation
+============
+
+If you're using a multi-database installation (with or without dbfilter
+option) where /web/databse/selector returns a list of more than one
+database, then you need to add ``mail_tracking`` addon to wide load
+addons list (by default, only ``web`` addon), setting ``--load`` option.
+For example, ``--load=web,mail,mail_tracking``
+
+Configuration
+=============
+
+As there can be scenarios where sending a tracking img in the email body
+is not desired, there is a global system parameter
+"mail_tracking.tracking_img_disabled" that can be set to True to remove
+the tracking img from all outgoing emails. Note that the **Opened**
+status will not be available in this case.
+
+Usage
+=====
+
+When user sends a message in mail_thread (chatter), for instance in
+partner form, then an email tracking is created for each email
+notification. Then a status icon will appear just right to name of
+notified partner.
+
+These are all available status icons:
+
+|unknown| **Unknown**: No email tracking info available. Maybe this
+notified partner has 'Receive Inbox Notifications by Email' == 'Never'
+
+|waiting| **Waiting**: Waiting to be sent
+
+|error| **Error**: Error while sending
+
+|sent| **Sent**: Sent to SMTP server configured
+
+|delivered| **Delivered**: Delivered to final MX server
+
+|opened| **Opened**: Opened by partner
+
+|cc| **Cc**: It's a Carbon-Copy recipient. Can't know the status so is
+'Unknown'
+
+|noemail| **No Email**: The partner doesn't have a defined email
+
+|anonuser| **No Partner**: The recipient doesn't have a defined partner
+
+If you want to see all tracking emails and events you can go to
+
+- Settings > Technical > Email > Tracking emails
+- Settings > Technical > Email > Tracking events
+
+When the message generates an 'error' status, it will apear on discuss
+'Failed' channel. Any view with chatter can show the failed messages
+too.
+
+- Discuss
+
+  |image|
+
+- Chatter
+
+  |image1|
+
+You can use "Failed sent messages" filter present in all views to show
+records with messages in failed status and that needs an user action.
+
+- Filter
+
+  |image2|
+
+.. |unknown| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/unknown.png
+.. |waiting| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/waiting.png
+.. |error| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/error.png
+.. |sent| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/sent.png
+.. |delivered| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/delivered.png
+.. |opened| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/opened.png
+.. |cc| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/cc.png
+.. |noemail| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/no_email.png
+.. |anonuser| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/src/img/anon_user.png
+.. |image| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/img/failed_message_discuss.png
+.. |image1| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/img/failed_message_widget.png
+.. |image2| image:: https://raw.githubusercontent.com/OCA/mail/19.0/mail_tracking/static/img/failed_message_filter.png
+
+Known issues / Roadmap
+======================
+
+- Integrate with the core ``mail.notification`` model as it overlaps
+  with what the ``mail.tracking`` model does. We could add the existing
+  features on top of that model and save lots of code lines.
+
+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_tracking%0Aversion:%2019.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
+-------
+
+* Tecnativa
+
+Contributors
+------------
+
+- `Tecnativa <https://www.tecnativa.com>`__:
+
+  - Pedro M. Baeza
+  - Antonio Espinosa
+  - David Vidal
+  - Ernesto Tejeda
+  - Rafael Blasco
+  - Alexandre Díaz
+
+- `Eezee-IT <https://www.eezee-it.com>`__:
+
+  - Asma Elferkhsi
+
+- `Vauxoo <https://www.vauxoo.com>`__:
+
+  - Agustín Payen Sandoval
+
+- `Trobz <https://www.trobz.com>`__:
+
+  - Tris Doan
+
+- `Komit <https://komit-consulting.com>`__:
+
+  - Quoc Pham Ngoc
+
+Other credits
+-------------
+
+The migration of this module from 17.0 to 18.0 was financially supported
+by Camptocamp.
+
+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/19.0/mail_tracking>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

mail_tracking/__init__.py

@@ -0,0 +1,2 @@
+from . import controllers
+from . import models

mail_tracking/__manifest__.py

@@ -0,0 +1,40 @@
+# Copyright 2016 Tecnativa - Antonio Espinosa
+# Copyright 2018 Tecnativa - David Vidal
+# Copyright 2018 Tecnativa - Ernesto Tejeda
+# Copyright 2019 Tecnativa - Pedro M. Baeza
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+{
+    "name": "Email tracking",
+    "summary": "Email tracking system for all mails sent",
+    "version": "19.0.1.0.0",
+    "category": "Social Network",
+    "website": "https://github.com/OCA/mail",
+    "author": ("Tecnativa, Odoo Community Association (OCA)"),
+    "license": "AGPL-3",
+    "application": False,
+    "installable": True,
+    "depends": ["mail"],
+    "data": [
+        "data/tracking_data.xml",
+        "security/mail_tracking_email_security.xml",
+        "security/ir.model.access.csv",
+        "views/mail_tracking_email_view.xml",
+        "views/mail_tracking_event_view.xml",
+        "views/mail_message_view.xml",
+        "views/res_partner_view.xml",
+        "views/res_config_settings.xml",
+    ],
+    "assets": {
+        "web.assets_backend": [
+            "mail_tracking/static/src/core/chatter/*",
+            "mail_tracking/static/src/core/message/*",
+            "mail_tracking/static/src/core/discuss/*",
+            "mail_tracking/static/src/services/*",
+            "mail_tracking/static/src/components/message_tracking/*",
+            "mail_tracking/static/src/components/failed_message/*",
+            "mail_tracking/static/src/components/failed_message_review/*",
+        ],
+    },
+    "demo": ["demo/demo.xml"],
+}

mail_tracking/controllers/__init__.py

@@ -0,0 +1,2 @@
+from . import main
+from . import mailbox

mail_tracking/controllers/mailbox.py

@@ -0,0 +1,28 @@
+# Copyright 2024 Tecnativa - David Vidal
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+from odoo.http import request, route
+
+from odoo.addons.mail.controllers.mailbox import MailboxController
+from odoo.addons.mail.tools.discuss import Store
+
+
+class MailTrackingMailBoxController(MailboxController):
+    @route("/mail/failed/messages", methods=["POST"], type="jsonrpc", auth="user")
+    def discuss_failed_messages(
+        self, search_term=None, before=None, after=None, limit=30, around=None
+    ):
+        """Fetch failed messages for discuss"""
+        res = request.env["mail.message"]._message_fetch(
+            [("is_failed_message", "=", True)],
+            search_term=search_term,
+            before=before,
+            after=after,
+            around=around,
+            limit=limit,
+        )
+        messages = res.pop("messages")
+        return {
+            **res,
+            "data": Store().add(messages).get_result(),
+            "messages": messages.ids,
+        }

mail_tracking/controllers/main.py

@@ -0,0 +1,76 @@
+# Copyright 2016 Antonio Espinosa - <antonio.espinosa@tecnativa.com>
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+import base64
+import logging
+from contextlib import contextmanager
+
+import werkzeug
+
+import odoo
+from odoo import SUPERUSER_ID, api, http
+
+from odoo.addons.mail.controllers.mail import MailController
+
+_logger = logging.getLogger(__name__)
+
+BLANK = "R0lGODlhAQABAIAAANvf7wAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw=="
+
+
+@contextmanager
+def db_env(dbname):
+    if not http.db_filter([dbname]):
+        raise werkzeug.exceptions.BadRequest()
+    cr = None
+    if dbname == http.request.db:
+        cr = http.request.env.cr
+    if not cr:
+        cr = odoo.sql_db.db_connect(dbname).cursor()
+    yield api.Environment(cr, SUPERUSER_ID, {})
+
+
+class MailTrackingController(MailController):
+    def _request_metadata(self):
+        """Prepare remote info metadata"""
+        request = http.request.httprequest
+        return {
+            "ip": request.remote_addr or False,
+            "user_agent": request.user_agent or False,
+            "os_family": request.user_agent.platform or False,
+            "ua_family": request.user_agent.browser or False,
+        }
+
+    @http.route(
+        [
+            "/mail/tracking/open/<string:db>/<int:tracking_email_id>/blank.gif",
+            "/mail/tracking/open/<string:db>"
+            "/<int:tracking_email_id>/<string:token>/blank.gif",
+        ],
+        type="http",
+        auth="none",
+        methods=["GET"],
+    )
+    def mail_tracking_open(self, db, tracking_email_id, token=False, **kw):
+        """Route used to track mail openned (With & Without Token)"""
+        metadata = self._request_metadata()
+        with db_env(db) as env:
+            try:
+                tracking_email = (
+                    env["mail.tracking.email"]
+                    .sudo()
+                    .search([("id", "=", tracking_email_id), ("token", "=", token)])
+                )
+                if not tracking_email:
+                    _logger.warning(
+                        "MailTracking email '%s' not found", tracking_email_id
+                    )
+                elif tracking_email.state in ("sent", "delivered"):
+                    tracking_email.event_create("open", metadata)
+            except Exception as e:
+                _logger.warning(e)
+
+        # Always return GIF blank image
+        response = werkzeug.wrappers.Response()
+        response.mimetype = "image/gif"
+        response.data = base64.b64decode(BLANK)
+        return response

mail_tracking/data/tracking_data.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- Copyright 2016 Antonio Espinosa - <antonio.espinosa@tecnativa.com>
+     License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html). -->
+<odoo>
+    <record
+        forcecreate="True"
+        id="decimal_tracking_timestamp"
+        model="decimal.precision"
+    >
+        <field name="name">MailTracking Timestamp</field>
+        <field name="digits">6</field>
+    </record>
+</odoo>