CarlosRoca13 · Jun 14, 2016 · Sep 9, 2016 · Sep 9, 2016 · Sep 9, 2016 · Sep 29, 2016
diff --git a/mail_recipient_tracking/README.rst b/mail_recipient_tracking/README.rst
@@ -0,0 +1,222 @@
+.. 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:edb6846623fce419301b88a3366ab43093edff807b0e0c94c2972a8d57b97b5d
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/20.0/mail_recipient_tracking
+    :alt: OCA/mail
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/mail-20-0/mail-20-0-mail_recipient_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=20.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_recipient_tracking`` addon to wide
+load addons list (by default, only ``web`` addon), setting ``--load``
+option. For example, ``--load=web,mail,mail_tracking``
+
+The first update of the module after this index was added creates a
+partial index on ``mail_message``
+(``mail_message_mail_tracking_needs_action_index``). Later updates do
+not build it again: Odoo keeps it while its definition does not change.
+
+On a database with a very large ``mail_message`` table that first build
+blocks writes to the table while it runs (13 minutes on 122 million
+rows). To avoid the lock, create the index beforehand exactly as the ORM
+would, with the comment it stores on it; Odoo compares that comment with
+the index definition and keeps the index when they match:
+
+.. code:: sql
+
+   CREATE INDEX CONCURRENTLY mail_message_mail_tracking_needs_action_index
+       ON mail_message (id) WHERE mail_tracking_needs_action IS TRUE;
+   COMMENT ON INDEX mail_message_mail_tracking_needs_action_index
+       IS 'INDEX (id) WHERE mail_tracking_needs_action IS TRUE';
+
+Since Odoo 20.0 the core provides a ``mail_tracking`` module (technical
+tracking of field values), so this addon has been renamed to
+``mail_recipient_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. Partners added in Cc get
+their own email, so their status is shown next to the Cc icon. For Cc
+email addresses without their own email, the status can't be known, so
+only the Cc icon is shown.
+
+|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 appear on the
+'Failed' tab of the messaging menu. Any view with chatter can show the
+failed messages too.
+
+- Chatter
+
+  |image|
+
+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
+
+  |image1|
+
+.. |unknown| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/unknown.png
+.. |waiting| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/waiting.png
+.. |error| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/error.png
+.. |sent| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/sent.png
+.. |delivered| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/delivered.png
+.. |opened| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/opened.png
+.. |cc| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/cc.png
+.. |noemail| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/no_email.png
+.. |anonuser| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/src/img/anon_user.png
+.. |image| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_tracking/static/img/failed_message_widget.png
+.. |image1| image:: https://raw.githubusercontent.com/OCA/mail/20.0/mail_recipient_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_recipient_tracking%0Aversion:%2020.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/20.0/mail_recipient_tracking>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
diff --git a/mail_recipient_tracking/__init__.py b/mail_recipient_tracking/__init__.py
@@ -0,0 +1,2 @@
+from . import controllers
+from . import models
diff --git a/mail_recipient_tracking/__manifest__.py b/mail_recipient_tracking/__manifest__.py
@@ -0,0 +1,34 @@
+# 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": "20.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/ir.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_recipient_tracking/static/src/components/**/*",
+            "mail_recipient_tracking/static/src/core/**/*",
+        ],
+    },
+    "demo": ["demo/demo.xml"],
+}
diff --git a/mail_recipient_tracking/controllers/__init__.py b/mail_recipient_tracking/controllers/__init__.py
@@ -0,0 +1,2 @@
+from . import main
+from . import messaging_menu
diff --git a/mail_recipient_tracking/controllers/main.py b/mail_recipient_tracking/controllers/main.py
@@ -0,0 +1,78 @@
+# 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.router.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:  # noqa: BLE001
+                _logger.warning(e)
+
+        # Always return GIF blank image
+        response = werkzeug.wrappers.Response()
+        response.mimetype = "image/gif"
+        response.data = base64.b64decode(BLANK)
+        return response
diff --git a/mail_recipient_tracking/controllers/messaging_menu.py b/mail_recipient_tracking/controllers/messaging_menu.py
@@ -0,0 +1,13 @@
+# Copyright 2024 Tecnativa - David Vidal
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+from odoo.fields import Domain
+
+from odoo.addons.mail.controllers.messaging_menu import MessagingMenuController
+
+
+class MailTrackingMessagingMenuController(MessagingMenuController):
+    def _get_menu_tab_domain(self, tab_id):
+        """Failed messages of the current user, shown in the messaging menu"""
+        if tab_id == "failed":
+            return Domain("is_failed_message", "=", True)
+        return super()._get_menu_tab_domain(tab_id)
diff --git a/mail_recipient_tracking/data/tracking_data.xml b/mail_recipient_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
+        id="decimal_tracking_timestamp"
+        forcecreate="True"
+        model="decimal.precision"
+    >
+        <field name="name">MailTracking Timestamp</field>
+        <field name="digits">6</field>
+    </record>
+</odoo>
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		from . import controllers
		from . import models
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		from . import main
		from . import messaging_menu