[19.0][MIG] mail_notify_employee_leave: Migration to 19.0

mail_notify_employee_leave/README.rst

@@ -0,0 +1,104 @@
+.. image:: https://odoo-community.org/readme-banner-image
+   :target: https://odoo-community.org/get-involved?utm_source=readme
+   :alt: Odoo Community Association
+
+==========================
+Mail Notify Employee Leave
+==========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:d842cebb8364c632fefac6bb11811aceb16efe2d3aa4910c51a56368df2e9bba
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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_notify_employee_leave
+    :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_notify_employee_leave
+    :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 automatically notifies users when they mention or assign a
+colleague who is out of office. The notification includes the expected
+return date of the absent user and is sent only once per day per user.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+To trigger the out-of-office notification:
+
+1. An employee must have an approved leave covering today's date. This
+   sets the employee's **Is Absent** field automatically.
+2. The employee must be linked to an Odoo user.
+3. Send any message that includes employee's partner in the recipients,
+   for example, by mentioning them with ``@name``.
+
+When these conditions are met, the sender receives an internal note with
+the expected return date of the absent employee, calculated as the first
+working day after the leave ends based on the employee's working
+schedule and public holidays.
+
+The notification is sent at most once per user per day per employee.
+Sending further messages to the same absent employee on the same day
+will not produce additional notifications.
+
+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_notify_employee_leave%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
+-------
+
+* ForgeFlow
+
+Contributors
+------------
+
+- `ForgeFlow <https://www.forgeflow.com>`__:
+
+  - Guillermo Navas <guillermo.navas@forgeflow.com>
+
+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_notify_employee_leave>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

mail_notify_employee_leave/__init__.py

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

mail_notify_employee_leave/__manifest__.py

@@ -0,0 +1,14 @@
+# Copyright 2026 ForgeFlow S.L.
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+{
+    "name": "Mail Notify Employee Leave",
+    "summary": """
+        Notifies users when they mention or assign someone who is out of office.
+    """,
+    "version": "19.0.1.0.0",
+    "license": "AGPL-3",
+    "author": "ForgeFlow, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/mail",
+    "depends": ["mail", "hr_holidays"],
+}

mail_notify_employee_leave/i18n/es.po

@@ -0,0 +1,66 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# 	* mail_notify_employee_leave
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 17.0+e\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2026-03-05 10:44+0000\n"
+"PO-Revision-Date: 2026-03-05 10:44+0000\n"
+"Last-Translator: \n"
+"Language-Team: \n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "%(name)s is out of office, expected back on %(date)s."
+msgstr "%(name)s estará fuera de la oficina hasta el %(date)s."
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of Last Absence Notification"
+msgstr "Fecha de la última notificación"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of the last notification record"
+msgstr "Fecha del último registro de notificaciones"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_mail_thread
+msgid "Email Thread"
+msgstr "Hilo de correo electrónico"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_employee
+msgid "Employee"
+msgstr "Empleado"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_leave
+msgid "Time Off"
+msgstr "Ausencias"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "User out of office"
+msgstr "Usuario fuera de la oficina"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users Notified Today"
+msgstr "Usuarios notificados hoy"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users who have already been notified today about this absence"
+msgstr "Usuarios que ya fueron notificados hoy sobre esta ausencia"

mail_notify_employee_leave/i18n/it.po

@@ -0,0 +1,66 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# 	* mail_notify_employee_leave
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 17.0\n"
+"Report-Msgid-Bugs-To: \n"
+"PO-Revision-Date: 2026-05-11 17:45+0000\n"
+"Last-Translator: mymage <stefano.consolaro@mymage.it>\n"
+"Language-Team: none\n"
+"Language: it\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"
+"X-Generator: Weblate 5.15.2\n"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "%(name)s is out of office, expected back on %(date)s."
+msgstr "%(name)s è fuori dall'ufficio, previsto rientro il %(date)s."
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of Last Absence Notification"
+msgstr "Data ultima notifica assenza"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of the last notification record"
+msgstr "Data dell'ultimo record di notifica"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_mail_thread
+msgid "Email Thread"
+msgstr "Discussione e-mail"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_employee
+msgid "Employee"
+msgstr "Dipendente"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_leave
+msgid "Time Off"
+msgstr "Ferie"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "User out of office"
+msgstr "Utente fuori ufficio"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users Notified Today"
+msgstr "Utente avvisato oggi"
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users who have already been notified today about this absence"
+msgstr "Utenti che sono già stati informati oggi di questa assenza"

mail_notify_employee_leave/i18n/mail_notify_employee_leave.pot

@@ -0,0 +1,63 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# 	* mail_notify_employee_leave
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 17.0\n"
+"Report-Msgid-Bugs-To: \n"
+"Last-Translator: \n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "%(name)s is out of office, expected back on %(date)s."
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of Last Absence Notification"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_date
+msgid "Date of the last notification record"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_mail_thread
+msgid "Email Thread"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_employee
+msgid "Employee"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model,name:mail_notify_employee_leave.model_hr_leave
+msgid "Time Off"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#. odoo-python
+#: code:addons/mail_notify_employee_leave/models/mail_thread.py:0
+#, python-format
+msgid "User out of office"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,field_description:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users Notified Today"
+msgstr ""
+
+#. module: mail_notify_employee_leave
+#: model:ir.model.fields,help:mail_notify_employee_leave.field_hr_employee__absence_notified_user_ids
+msgid "Users who have already been notified today about this absence"
+msgstr ""

mail_notify_employee_leave/models/__init__.py

@@ -0,0 +1,3 @@
+from . import mail_thread
+from . import hr_leave
+from . import hr_employee

mail_notify_employee_leave/models/hr_employee.py

@@ -0,0 +1,19 @@
+from odoo import fields, models
+
+
+class HrEmployee(models.Model):
+    _inherit = "hr.employee"
+
+    absence_notified_user_ids = fields.Many2many(
+        "res.users",
+        string="Users Notified Today",
+        readonly=True,
+        copy=False,
+        help="Users who have already been notified today about this absence",
+    )
+    absence_notified_date = fields.Date(
+        string="Date of Last Absence Notification",
+        readonly=True,
+        copy=False,
+        help="Date of the last notification record",
+    )

mail_notify_employee_leave/models/hr_leave.py

@@ -0,0 +1,15 @@
+from odoo import models
+
+
+class HrLeave(models.Model):
+    _inherit = "hr.leave"
+
+    def _validate_leave_request(self):
+        """
+        Override _validate_leave_request to skip absence notifications when
+        approving leaves. The context flag 'skip_absence_notification' prevents
+        _notify_thread from sending messages,
+        """
+        return super(
+            HrLeave, self.with_context(skip_absence_notification=True)
+        )._validate_leave_request()