Maintainers
+This module is maintained by Vortex Dimensión Digital.
+Contact the maintainer through their official support channels in case you find +any issues with this module.
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/hr_employee_vcard/static/src/scss/hr_employee_vcard.scss b/hr_employee_vcard/static/src/scss/hr_employee_vcard.scss
new file mode 100644
index 00000000000..193bf896827
--- /dev/null
+++ b/hr_employee_vcard/static/src/scss/hr_employee_vcard.scss
@@ -0,0 +1,181 @@
+$o-vcard-width: 8.5cm;
+$o-vcard-height: 5.4cm;
+$o-vcard-radius: 0.25cm;
+
+$o-vcard-primary: #714b67;
+$o-vcard-dark: #1f2b3a;
+$o-vcard-text: #212529;
+$o-vcard-muted: #8a8a8a;
+$o-vcard-border: #e0e0e0;
+
+.o_hr_employee_vcard {
+ text-align: center;
+
+ .o_hr_employee_vcard_face {
+ width: $o-vcard-width;
+ height: $o-vcard-height;
+ margin: 0 auto 0.4cm auto;
+ -webkit-box-sizing: border-box;
+ box-sizing: border-box;
+ position: relative;
+ overflow: hidden;
+ border-radius: $o-vcard-radius;
+ background-color: #ffffff;
+ background-repeat: no-repeat;
+ background-position: center center;
+ background-size: cover;
+ display: table;
+ }
+
+ .o_hr_employee_vcard_content {
+ display: table-cell;
+ vertical-align: middle;
+ text-align: center;
+ padding: 0.45cm;
+ }
+
+ .o_hr_employee_vcard_line {
+ margin: 0 0 0.1cm 0;
+ line-height: 1.2;
+ word-wrap: break-word;
+ }
+
+ .o_hr_employee_vcard_img {
+ display: block;
+ margin: 0 auto;
+ }
+
+ .o_hr_employee_vcard_logo {
+ max-width: 3.4cm;
+ max-height: 1.3cm;
+ margin-bottom: 0.15cm;
+ }
+
+ .o_hr_employee_vcard_line_name {
+ font-size: 15px;
+ font-weight: bold;
+ }
+
+ .o_hr_employee_vcard_line_job_title {
+ font-size: 10px;
+ text-transform: uppercase;
+ letter-spacing: 0.05cm;
+ color: $o-vcard-muted;
+ }
+
+ .o_hr_employee_vcard_line_company_name {
+ font-size: 13px;
+ font-weight: bold;
+ }
+
+ .o_hr_employee_vcard_line_work_email,
+ .o_hr_employee_vcard_line_work_phone,
+ .o_hr_employee_vcard_line_website {
+ font-size: 10px;
+ }
+
+ .o_hr_employee_vcard_icon {
+ display: inline-block;
+ width: 0.5cm;
+ height: 0.5cm;
+ line-height: 0.5cm;
+ margin-right: 0.15cm;
+ border-radius: 50%;
+ background-color: $o-vcard-primary;
+ color: #ffffff;
+ font-size: 8px;
+ text-align: center;
+ vertical-align: middle;
+ }
+
+ .o_hr_employee_vcard_value {
+ vertical-align: middle;
+ }
+
+ .o_hr_employee_vcard_back .o_hr_employee_vcard_content {
+ text-align: left;
+ padding-right: 2.2cm;
+ }
+
+ .o_hr_employee_vcard_back .o_hr_employee_vcard_line_qr {
+ position: absolute;
+ top: 50%;
+ right: 0.5cm;
+ width: 1.7cm;
+ margin: -0.85cm 0 0 0;
+ }
+
+ .o_hr_employee_vcard_qr {
+ max-width: 1.7cm;
+ max-height: 1.7cm;
+ }
+}
+
+.o_hr_employee_vcard_modern {
+ .o_hr_employee_vcard_face {
+ background-color: $o-vcard-dark;
+ color: #ffffff;
+ }
+
+ .o_hr_employee_vcard_line_company_name {
+ color: #ffffff;
+ }
+
+ .o_hr_employee_vcard_line_job_title {
+ color: $o-vcard-primary;
+ }
+
+ .o_hr_employee_vcard_line_name {
+ display: inline-block;
+ padding-bottom: 0.08cm;
+ border-bottom: 0.05cm solid $o-vcard-primary;
+ }
+
+ .o_hr_employee_vcard_qr {
+ background-color: #ffffff;
+ padding: 0.1cm;
+ border-radius: 0.1cm;
+ }
+}
+
+.o_hr_employee_vcard_minimal {
+ .o_hr_employee_vcard_face {
+ border: 1px solid $o-vcard-border;
+ }
+
+ .o_hr_employee_vcard_line_name {
+ font-weight: normal;
+ letter-spacing: 0.03cm;
+ }
+
+ .o_hr_employee_vcard_line_company_name {
+ font-weight: normal;
+ color: $o-vcard-muted;
+ }
+
+ .o_hr_employee_vcard_icon {
+ width: auto;
+ height: auto;
+ line-height: 1;
+ margin-right: 0.12cm;
+ background-color: transparent;
+ color: $o-vcard-primary;
+ font-size: 10px;
+ }
+}
+
+.o_hr_employee_vcard_classic {
+ .o_hr_employee_vcard_face {
+ border: 1px solid $o-vcard-border;
+ border-left: 0.25cm solid $o-vcard-primary;
+ }
+
+ .o_hr_employee_vcard_line_company_name {
+ color: $o-vcard-primary;
+ }
+
+ .o_hr_employee_vcard_back .o_hr_employee_vcard_line_name {
+ padding-bottom: 0.1cm;
+ border-bottom: 1px solid $o-vcard-border;
+ }
+}
diff --git a/hr_employee_vcard/tests/__init__.py b/hr_employee_vcard/tests/__init__.py
new file mode 100644
index 00000000000..10e9817b184
--- /dev/null
+++ b/hr_employee_vcard/tests/__init__.py
@@ -0,0 +1 @@
+from . import test_hr_employee_vcard
diff --git a/hr_employee_vcard/tests/test_hr_employee_vcard.py b/hr_employee_vcard/tests/test_hr_employee_vcard.py
new file mode 100644
index 00000000000..22ad51eb4bd
--- /dev/null
+++ b/hr_employee_vcard/tests/test_hr_employee_vcard.py
@@ -0,0 +1,189 @@
+import base64
+
+from odoo.tests import Form, TransactionCase
+
+
+class TestHrEmployeeVcard(TransactionCase):
+ @classmethod
+ def setUpClass(cls):
+ super().setUpClass()
+ cls.Report = cls.env["ir.actions.report"]
+ cls.company = cls.env.company
+ cls.layout_modern = cls.env.ref(
+ "hr_employee_vcard.hr_employee_vcard_layout_modern"
+ )
+ cls.layout_minimal = cls.env.ref(
+ "hr_employee_vcard.hr_employee_vcard_layout_minimal"
+ )
+ cls.field_website = cls.env.ref(
+ "hr_employee_vcard.hr_employee_vcard_field_website"
+ )
+ # A valid PNG to use as an uploaded image.
+ cls.png = base64.b64encode(cls.Report.barcode("QR", "sample"))
+ # Put the company in a known configuration.
+ cls.company.write(
+ {
+ "vcard_layout_id": cls.layout_modern.id,
+ "vcard_layout_background": "blank",
+ "vcard_layout_font": "lato",
+ "vcard_layout_field_ids": [
+ (6, 0, cls.env["hr.employee.vcard.field"].search([]).ids)
+ ],
+ }
+ )
+ cls.employee = cls.env["hr.employee"].create(
+ {
+ "name": "Test Employee",
+ "job_title": "Tester",
+ "work_email": "test@example.com",
+ "work_phone": "+1 000 000",
+ "company_id": cls.company.id,
+ }
+ )
+
+ # ------------------------------------------------------------------
+ # Company / defaults
+ # ------------------------------------------------------------------
+ def test_new_company_defaults(self):
+ company = self.env["res.company"].create({"name": "vCard Test Co"})
+ self.assertEqual(company.vcard_layout_id, self.layout_modern)
+ self.assertTrue(company.vcard_layout_field_ids)
+ self.assertEqual(company.vcard_layout_background, "blank")
+ self.assertEqual(company.vcard_layout_font, "lato")
+
+ # ------------------------------------------------------------------
+ # Line building (mixin)
+ # ------------------------------------------------------------------
+ def test_build_lines_front_back_split(self):
+ values = self.company._get_vcard_preview_values()
+ front, back = self.company._build_vcard_lines(values)
+ front_types = [line["type"] for line in front]
+ back_types = [line["type"] for line in back]
+ self.assertIn("company_name", front_types)
+ self.assertIn("name", back_types)
+ self.assertNotIn("name", front_types)
+ self.assertNotIn("company_name", back_types)
+
+ def test_lines_adapt_to_selected_fields(self):
+ self.company.vcard_layout_field_ids -= self.field_website
+ values = self.company._get_vcard_preview_values()
+ _front, back = self.company._build_vcard_lines(values)
+ self.assertNotIn("website", [line["type"] for line in back])
+
+ def test_lines_skip_empty_values(self):
+ values = self.company._get_vcard_preview_values()
+ values["work_email"] = False
+ _front, back = self.company._build_vcard_lines(values)
+ self.assertNotIn("work_email", [line["type"] for line in back])
+
+ def test_contact_line_has_icon(self):
+ values = self.company._get_vcard_preview_values()
+ _front, back = self.company._build_vcard_lines(values)
+ email = next(line for line in back if line["type"] == "work_email")
+ self.assertEqual(email["kind"], "text")
+ self.assertTrue(email["icon"])
+
+ def test_image_line_is_data_uri(self):
+ values = self.company._get_vcard_preview_values()
+ _front, back = self.company._build_vcard_lines(values)
+ qr = next(line for line in back if line["type"] == "qr")
+ self.assertEqual(qr["kind"], "image")
+ self.assertTrue(qr["value"].startswith("data:image/"))
+
+ # ------------------------------------------------------------------
+ # Card data (font / background)
+ # ------------------------------------------------------------------
+ def test_card_data_font_family(self):
+ self.company.vcard_layout_font = "roboto"
+ data = self.company._get_vcard_card_data(
+ self.company._get_vcard_preview_values()
+ )
+ self.assertIn("Roboto", data["font_family"])
+
+ def test_background_blank_is_empty(self):
+ self.company.vcard_layout_background = "blank"
+ self.assertEqual(self.company._get_vcard_background_style(), "")
+
+ def test_background_custom_overlay(self):
+ self.company.write(
+ {
+ "vcard_layout_background": "custom",
+ "vcard_layout_background_image": self.png,
+ }
+ )
+ style = self.company._get_vcard_background_style()
+ self.assertIn("background-image", style)
+ self.assertIn("linear-gradient", style)
+
+ # ------------------------------------------------------------------
+ # Employee: vCard content + QR + actions
+ # ------------------------------------------------------------------
+ def test_vcard_content(self):
+ content = self.employee._get_vcard_content()
+ self.assertTrue(content.startswith("BEGIN:VCARD"))
+ self.assertTrue(content.strip().endswith("END:VCARD"))
+ self.assertIn("FN:Test Employee", content)
+ self.assertIn("EMAIL:test@example.com", content)
+
+ def test_get_vcard_qr_is_png(self):
+ qr = self.employee._get_vcard_qr()
+ self.assertEqual(base64.b64decode(qr)[:4], b"\x89PNG")
+
+ def test_action_generate_vcard(self):
+ self.employee.vcard_qr = False
+ action = self.employee.action_generate_vcard()
+ self.assertTrue(self.employee.vcard_qr)
+ self.assertEqual(action["type"], "ir.actions.report")
+ self.assertEqual(action["report_name"], "hr_employee_vcard.report_vcard")
+
+ def test_action_print_vcard(self):
+ action = self.employee.action_print_vcard()
+ self.assertEqual(action["report_name"], "hr_employee_vcard.report_vcard")
+
+ # ------------------------------------------------------------------
+ # Wizard
+ # ------------------------------------------------------------------
+ def test_wizard_onchange_sets_default_layout(self):
+ self.company.vcard_layout_id = False
+ wizard = self.env["hr.employee.vcard.wizard"].new(
+ {"company_id": self.company.id}
+ )
+ wizard._onchange_company_id()
+ self.assertTrue(wizard.vcard_layout_id)
+
+ def test_wizard_preview_reacts_to_fields(self):
+ form = Form(self.env["hr.employee.vcard.wizard"])
+ self.assertIn("o_hr_employee_vcard_line_website", form.vcard_layout_preview)
+ form.vcard_layout_field_ids.remove(id=self.field_website.id)
+ self.assertNotIn("o_hr_employee_vcard_line_website", form.vcard_layout_preview)
+
+ def test_wizard_preview_reacts_to_layout(self):
+ form = Form(self.env["hr.employee.vcard.wizard"])
+ form.vcard_layout_id = self.layout_minimal
+ self.assertIn("o_hr_employee_vcard_minimal", form.vcard_layout_preview)
+
+ # ------------------------------------------------------------------
+ # Settings preview action
+ # ------------------------------------------------------------------
+ def test_settings_preview_action(self):
+ settings = self.env["res.config.settings"].create({})
+ action = settings.action_preview_vcard()
+ self.assertEqual(
+ action["report_name"], "hr_employee_vcard.report_vcard_preview"
+ )
+
+ # ------------------------------------------------------------------
+ # Reports render (HTML, no wkhtmltopdf)
+ # ------------------------------------------------------------------
+ def test_report_vcard_html(self):
+ html = self.Report._render_qweb_html(
+ "hr_employee_vcard.report_vcard", self.employee.ids
+ )[0]
+ self.assertIn(b"o_hr_employee_vcard", html)
+ self.assertIn(b'class="article"', html)
+
+ def test_report_vcard_preview_html(self):
+ html = self.Report._render_qweb_html(
+ "hr_employee_vcard.report_vcard_preview", self.company.ids
+ )[0]
+ self.assertIn(b"o_hr_employee_vcard", html)
diff --git a/hr_employee_vcard/views/hr_employee_vcard_templates.xml b/hr_employee_vcard/views/hr_employee_vcard_templates.xml
new file mode 100644
index 00000000000..a69732bb960
--- /dev/null
+++ b/hr_employee_vcard/views/hr_employee_vcard_templates.xml
@@ -0,0 +1,75 @@
+
+HR Employee vCard
+ + +
This module lets you design and print business cards (vCards) for your +employees.
+A company-wide card design is configured once (layout, font, background +and which fields to show) and can be printed for any employee as a +two-sided PDF: the front holds the branding (logo, company name) and the +back the contact details (name, job position, email, phone, website). +Each card includes a QR code with the employee’s contact information, so +it can be scanned straight into a phone’s address book.
+The card adapts to the data available: only the selected fields that +actually have a value are shown.
+Table of contents
+
+
+-
+
- Configuration +
- Usage +
- Credits + +
+
+Configuration
+To configure the vCard design:
+-
+
- Go to Employees > Configuration > Settings. +
- In the Employee vCard section, click Configure vCard Layout. +
- Choose the layout (Modern, Minimal or Classic), the font, the +background (blank, company logo or a custom image) and the fields to +display on the card. A live preview is shown as you change the +options. +
- Click Save. +
The design is stored per company, so each company can have its own card.
+Use Preview vCard to download a sample PDF with the current design.
+
+
+Usage
+To print an employee’s vCard:
+-
+
- Open the employee form (Employees > Employees). +
- In the Actions menu, choose Generate vCard. +
The QR code is (re)generated from the employee’s contact details and a +two-sided card PDF is downloaded, ready to print.
+
+
+Credits
+
+
+Authors
+-
+
- Vortex Dimensión Digital +
+
+Contributors
+-
+
- Vortex Dimensión Digital:
-
+
- Jorge Rosado Julián <jorge.rosado@dimensionvortex.com> +
+
+
+
+ ![]()
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+