| Base module for providing alternative provider for iap apps
[jsonifier](jsonifier/) | 17.0.1.0.0 | | JSON-ify data for all models
+[mail_template_attachment_per_lang](mail_template_attachment_per_lang/) | 17.0.1.0.0 | | Set language specific attachments on mail templates.
[module_analysis](module_analysis/) | 17.0.1.0.3 | 
| Add analysis tools regarding installed modules to know which installed modules comes from Odoo Core, OCA, or are custom modules
[module_auto_update](module_auto_update/) | 17.0.1.0.0 | | Automatically update Odoo modules
[module_change_auto_install](module_change_auto_install/) | 17.0.1.0.2 | | Customize auto installables modules by configuration
diff --git a/mail_template_attachment_per_lang/README.rst b/mail_template_attachment_per_lang/README.rst
new file mode 100644
index 00000000000..4e95530b566
--- /dev/null
+++ b/mail_template_attachment_per_lang/README.rst
@@ -0,0 +1,122 @@
+.. image:: https://odoo-community.org/readme-banner-image
+ :target: https://odoo-community.org/get-involved?utm_source=readme
+ :alt: Odoo Community Association
+
+===========================================
+Mail Template Language Specific Attachments
+===========================================
+
+..
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ !! This file is generated by oca-gen-addon-readme !!
+ !! changes will be overwritten. !!
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+ !! source digest: sha256:a075fae834285057e4a0f26c055240e2bc3b4586363b66887e80386a793fd60f
+ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fserver--tools-lightgray.png?logo=github
+ :target: https://github.com/OCA/server-tools/tree/17.0/mail_template_attachment_per_lang
+ :alt: OCA/server-tools
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+ :target: https://translation.odoo-community.org/projects/server-tools-17-0/server-tools-17-0-mail_template_attachment_per_lang
+ :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/server-tools&target_branch=17.0
+ :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module extends the functionality of mail templates.
+
+It allows you to configure attachments based on the language of the
+partner or the language configured in the mail template (which is some
+times different from the partner's language).
+
+- The email template's language could be
+ ``{{ object.partner_id.lang }}`` or ``{{ object.user_id.lang }}``,
+ where in the first case we want to send the email in the partner's
+ language and in the second case we want to send the email in the
+ user's language.
+
+For example you can use it to localize your company's terms of
+agreements.
+
+**Table of contents**
+
+.. contents::
+ :local:
+
+Configuration
+=============
+
+To configure a language dependent attachment:
+
+1. Activate the developer mode;
+2. go to *Settings > Technical > Email > Templates*;
+3. go to the form view of the template you want to change;
+4. choose the *Language Attachment Method* you want to use;
+5. change the field *Language Dependent Attachments* to what you want.
+
+Usage
+=====
+
+When a template is selected in the mail composer, the attachments will
+be automatically added based on the recipients language. The language of
+the recipients can be configured on the Partner form view. When partners
+with different languages are selected all attachments of the partners
+languages will be added.
+
+To use the functionality:
+
+1. Configure a template (e.g. the sale order mail template)
+2. go to a sale order;
+3. click *Send by Email*;
+4. the attachments are added based on the email's language or the
+ customer's language (which might not be the same), depending on the
+ configuration of the template.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues 
This module extends the functionality of mail templates.
+It allows you to configure attachments based on the language of the +partner or the language configured in the mail template (which is some +times different from the partner’s language).
+For example you can use it to localize your company’s terms of +agreements.
+Table of contents
+To configure a language dependent attachment:
+When a template is selected in the mail composer, the attachments will +be automatically added based on the recipients language. The language of +the recipients can be configured on the Partner form view. When partners +with different languages are selected all attachments of the partners +languages will be added.
+To use the functionality:
+Bugs are tracked on GitHub 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.
+Do not contact contributors directly about support or help with technical issues.
+This module is maintained by the OCA.
+ +
+
+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/server-tools project on GitHub.
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
+Test body
", + "partner_to": "{{ object.id }}", + "lang": "{{ object.lang }}", + "ir_attachment_language_method": "template_lang", + "ir_attachment_language_ids": [ + ( + 0, + 0, + { + "lang": "fr_FR", + "attachment_id": cls.attachment_fr.id, + }, + ), + ( + 0, + 0, + { + "lang": "en_US", + "attachment_id": cls.attachment_en.id, + }, + ), + ], + } + ) + + def test_template_lang_method_french(self): + # Sending to a French partner should attach the French file + render_results = self.mail_template._generate_template( + [self.partner_fr.id], + [ + "attachment_ids", + "body_html", + "email_from", + "partner_to", + "report_template_ids", + "subject", + ], + ) + attachments = render_results[self.partner_fr.id].get("attachment_ids", []) + attachment_records = self.env["ir.attachment"].browse(attachments) + attachment_names = attachment_records.mapped("name") + self.assertIn("terms_fr.pdf", attachment_names) + self.assertNotIn("terms_en.pdf", attachment_names) + + def test_template_lang_method_english(self): + # Sending to an English partner should attach the English file + render_results = self.mail_template._generate_template( + [self.partner_en.id], + [ + "attachment_ids", + "body_html", + "email_from", + "partner_to", + "report_template_ids", + "subject", + ], + ) + attachments = render_results[self.partner_en.id].get("attachment_ids", []) + attachment_records = self.env["ir.attachment"].browse(attachments) + attachment_names = attachment_records.mapped("name") + self.assertIn("terms_en.pdf", attachment_names) + self.assertNotIn("terms_fr.pdf", attachment_names) + + def test_partner_lang_method(self): + # With partner_lang method, attachments match partner language + self.mail_template.ir_attachment_language_method = "partner_lang" + render_results = self.mail_template._generate_template( + [self.partner_fr.id], + [ + "attachment_ids", + "body_html", + "email_from", + "partner_to", + "report_template_ids", + "subject", + ], + ) + attachments = render_results[self.partner_fr.id].get("attachment_ids", []) + attachment_records = self.env["ir.attachment"].browse(attachments) + attachment_names = attachment_records.mapped("name") + self.assertIn("terms_fr.pdf", attachment_names) + self.assertNotIn("terms_en.pdf", attachment_names) + + def test_no_method_set(self): + # With no method set, no language-specific attachments are added + self.mail_template.ir_attachment_language_method = False + render_results = self.mail_template._generate_template( + [self.partner_fr.id], + [ + "attachment_ids", + "body_html", + "email_from", + "partner_to", + "report_template_ids", + "subject", + ], + ) + attachments = render_results[self.partner_fr.id].get("attachment_ids", []) + self.assertFalse(attachments) + + def test_batch_multiple_partners(self): + # Batch rendering attaches correct files per language + render_results = self.mail_template._generate_template( + [self.partner_fr.id, self.partner_en.id], + [ + "attachment_ids", + "body_html", + "email_from", + "partner_to", + "report_template_ids", + "subject", + ], + ) + fr_attachments = render_results[self.partner_fr.id].get("attachment_ids", []) + fr_attachment_records = self.env["ir.attachment"].browse(fr_attachments) + fr_names = fr_attachment_records.mapped("name") + en_attachments = render_results[self.partner_en.id].get("attachment_ids", []) + en_attachment_records = self.env["ir.attachment"].browse(en_attachments) + en_names = en_attachment_records.mapped("name") + self.assertIn("terms_fr.pdf", fr_names) + self.assertNotIn("terms_en.pdf", fr_names) + self.assertIn("terms_en.pdf", en_names) + self.assertNotIn("terms_fr.pdf", en_names) + + def test_send_mail_with_lang_attachments(self): + # Full send_mail flow includes language-specific attachments + with self.mock_mail_gateway(): + mail = self.mail_template.send_mail(self.partner_fr.id) + mail_record = self.env["mail.mail"].browse(mail) + attachment_names = mail_record.attachment_ids.mapped("name") + self.assertIn("terms_fr.pdf", attachment_names) + self.assertNotIn("terms_en.pdf", attachment_names) + + def test_partner_lang_with_fixed_template_lang(self): + # Test that even if the template body is forced to English, + # the attachments follow the recipient's language. + self.mail_template.write( + { + "lang": "en_US", + "partner_to": str(self.partner_en.id), + "ir_attachment_language_method": "partner_lang", + } + ) + # English recipient --> Should get English attachment + render_results = self.mail_template._generate_template( + [self.partner_en.id], + ["attachment_ids"], + ) + result = render_results[self.partner_en.id] + attachments = self.env["ir.attachment"].browse(result.get("attachment_ids", [])) + attachment_names = attachments.mapped("name") + self.assertIn("terms_en.pdf", attachment_names) + self.assertNotIn("terms_fr.pdf", attachment_names) + # Change recipient to French partner + # The body remains English (lang='en_US'), but attachments must switch to French + self.mail_template.write( + { + "partner_to": str(self.partner_fr.id), + } + ) + render_results = self.mail_template._generate_template( + [self.partner_fr.id], + ["attachment_ids"], + ) + result = render_results[self.partner_fr.id] + attachments = self.env["ir.attachment"].browse(result.get("attachment_ids", [])) + attachment_names = attachments.mapped("name") + # Verify that the logic correctly prioritized the recipient's language + self.assertIn("terms_fr.pdf", attachment_names) + self.assertNotIn("terms_en.pdf", attachment_names) diff --git a/mail_template_attachment_per_lang/views/mail_template_view.xml b/mail_template_attachment_per_lang/views/mail_template_view.xml new file mode 100644 index 00000000000..45a9207f2ce --- /dev/null +++ b/mail_template_attachment_per_lang/views/mail_template_view.xml @@ -0,0 +1,35 @@ + + +