+ {{ object.name }}
+ {{ object.company_id.name }}
+ {{ object.email or '' }}
+
+ {{ object.name }}
+ {{ object.company_id.name }}
+ {{ object.email or '' }}
+
This module lets administrators update users email signatures in bulk.
+Administrators define one HTML signature template on a mass edit record, +select a company, and confirm the operation. The template is rendered +for each matching internal user.
+Table of contents
+Give the user the Signature Mass Edit access right in Email +Marketing.
+Go to Email Marketing > Configuration > Signature Mass Edits.
+Administrators can also access the same records from Settings > +Users & Companies > Signature Mass Edits.
+Create a new record.
+Select the company whose internal users must be updated.
+Optionally select one or more groups to restrict the update to users +belonging to those groups. Only internal users are updated.
+Enter the HTML signature template in the Source tab. Use the +Preview tab to check the rendered signature.
+Click Confirm.
+The signature template is rendered on the res.users model. For +example:
++<p> + <strong>{{ object.name }}</strong><br/> + {{ object.company_id.name }}<br/> + {{ object.email or '' }} +</p> ++
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.
+Current maintainer:
+
This module is part of the OCA/mail project on GitHub.
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
+{{ object.name }} - {{ object.company_id.name }}
", + } + ) + self.assertEqual( + mass_edit.display_name, + "Signature Mass Edit - Signature Company", + ) + self.assertEqual(mass_edit.user_count, 1) + + mass_edit.action_confirm() + + self.assertEqual(mass_edit.state, "done") + self.assertEqual(mass_edit.processed_user_count, 1) + self.assertEqual( + self.user.signature, + "Signature User - Signature Company
", + ) + self.assertNotEqual( + self.other_user.signature, + "Other Signature User - Other Signature Company
", + ) + + def test_confirm_only_updates_internal_users(self): + mass_edit = self.env["signature.mass.edit"].create( + { + "company_id": self.company.id, + "signature": "{{ object.name }}
", + } + ) + + mass_edit.action_confirm() + + self.assertEqual(mass_edit.processed_user_count, 1) + self.assertEqual(self.user.signature, "Signature User
") + self.assertNotEqual(self.portal_user.signature, "Portal Signature User
") + + def test_confirm_only_updates_users_in_selected_groups(self): + mass_edit = self.env["signature.mass.edit"].create( + { + "company_id": self.company.id, + "group_ids": [(6, 0, self.group_settings.ids)], + "signature": "{{ object.name }}
", + } + ) + + mass_edit.action_confirm() + + self.assertEqual(mass_edit.processed_user_count, 0) + self.assertNotEqual(self.user.signature, "Signature User
") + + action = mass_edit.action_reset_to_draft() + self.assertTrue(action) + self.assertEqual(mass_edit.state, "draft") + + def test_only_draft_records_can_be_confirmed(self): + mass_edit = self.env["signature.mass.edit"].create( + { + "company_id": self.company.id, + "signature": "{{ object.name }}
", + } + ) + mass_edit.action_confirm() + + with self.assertRaisesRegex(UserError, "Only draft signature mass edits"): + mass_edit.action_confirm() + + def test_action_view_users(self): + mass_edit = self.env["signature.mass.edit"].create( + { + "company_id": self.company.id, + "signature": "{{ object.name }}
", + } + ) + + action = mass_edit.action_view_users() + + self.assertEqual(action["type"], "ir.actions.act_window") + self.assertEqual(action["res_model"], "res.users") + self.assertEqual(action["view_mode"], "list,form") + self.assertEqual( + action["views"], + [(False, "list"), (self.env.ref("base.view_users_form").id, "form")], + ) + self.assertEqual(action["domain"], mass_edit._get_target_users_domain()) + + def test_signature_mass_edit_group_can_confirm_without_user_admin_rights(self): + marketing_user = new_test_user( + self.env, + login="signature_marketing_user", + groups="mail_user_signature_mass_edit.group_signature_mass_edit", + context={"no_reset_password": True}, + name="Signature Marketing User", + company_id=self.company.id, + company_ids=[(6, 0, self.company.ids)], + email="signature_marketing_user@example.com", + ) + mass_edit = ( + self.env["signature.mass.edit"] + .with_user(marketing_user) + .create( + { + "company_id": self.company.id, + "group_ids": [(6, 0, self.group_signature_mass_edit.ids)], + "signature": "{{ object.name }}
", + } + ) + ) + + mass_edit.with_user(marketing_user).action_confirm() + + self.assertFalse(marketing_user.has_group("base.group_system")) + self.assertEqual(mass_edit.state, "done") + self.assertEqual(mass_edit.processed_user_count, 1) + self.assertEqual(marketing_user.signature, "Signature Marketing User
") diff --git a/mail_user_signature_mass_edit/views/signature_mass_edit_views.xml b/mail_user_signature_mass_edit/views/signature_mass_edit_views.xml new file mode 100644 index 000000000..29073621c --- /dev/null +++ b/mail_user_signature_mass_edit/views/signature_mass_edit_views.xml @@ -0,0 +1,148 @@ + + +
This module lets signature mass edit operations run through queue jobs.
+A new Run in Queue Job option is added to signature mass edits. When +enabled, confirming a mass edit moves it to In Progress, creates one +queue job per matching user.
+Table of contents
+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.
+Current maintainer:
+
This module is part of the OCA/mail project on GitHub.
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
+{{ object.name }}
", + } + ) + + with trap_jobs() as trap: + mass_edit.action_confirm() + + self.assertEqual(mass_edit.state, "in_progress") + trap.assert_jobs_count(3) + for user in self.user | self.other_user: + trap.assert_enqueued_job( + mass_edit._queued_process_user_signature, + args=(user.id,), + properties={ + "description": f"User signature mass edit - {user.display_name}" + }, + ) + trap.assert_enqueued_job( + mass_edit._queued_mark_signature_mass_edit_done, + args=(2,), + properties={ + "description": ( + f"Mark user signature mass edit done - {mass_edit.display_name}" + ) + }, + ) + jobs_by_call = list(zip(trap.calls, trap.enqueued_jobs, strict=True)) + user_jobs = { + job + for call, job in jobs_by_call + if call.method.__func__ == mass_edit._queued_process_user_signature.__func__ + } + done_jobs = [ + job + for call, job in jobs_by_call + if call.method.__func__ + == mass_edit._queued_mark_signature_mass_edit_done.__func__ + ] + self.assertEqual(len(user_jobs), 2) + self.assertEqual(len(done_jobs), 1) + done_job = done_jobs[0] + self.assertEqual(done_job.depends_on, user_jobs) + self.assertTrue(done_job.graph_uuid) + self.assertTrue(all(job.graph_uuid == done_job.graph_uuid for job in user_jobs)) + self.assertTrue(all(done_job in job.reverse_depends_on for job in user_jobs)) + + def test_user_jobs_process_signature_mass_edit(self): + mass_edit = self.env["signature.mass.edit"].create( + { + "company_id": self.company.id, + "run_in_queue_job": True, + "signature": "{{ object.name }}
", + } + ) + + with trap_jobs() as trap: + mass_edit.action_confirm() + trap.perform_enqueued_jobs() + + self.assertEqual(mass_edit.state, "done") + self.assertEqual(mass_edit.processed_user_count, 2) + self.assertEqual(self.user.signature, "Queued Signature User
") + self.assertEqual( + self.other_user.signature, + "Other Queued Signature User
", + ) + + def test_confirm_processes_synchronously_by_default(self): + mass_edit = self.env["signature.mass.edit"].create( + { + "company_id": self.company.id, + "signature": "{{ object.name }}
", + } + ) + + with trap_jobs() as trap: + mass_edit.action_confirm() + + trap.assert_jobs_count(0) + self.assertFalse(mass_edit.run_in_queue_job) + self.assertEqual(mass_edit.state, "done") + self.assertEqual(mass_edit.processed_user_count, 2) + self.assertEqual(self.user.signature, "Queued Signature User
") diff --git a/mail_user_signature_mass_edit_queued/views/signature_mass_edit_views.xml b/mail_user_signature_mass_edit_queued/views/signature_mass_edit_views.xml new file mode 100644 index 000000000..0da600bdd --- /dev/null +++ b/mail_user_signature_mass_edit_queued/views/signature_mass_edit_views.xml @@ -0,0 +1,34 @@ + + +