From 7b896a0d5f5d6ab279ad018f1eb0adee12fe3b49 Mon Sep 17 00:00:00 2001
From: stenex <stefano.nana@nextev.it>
Date: Mon, 8 May 2023 17:27:06 +0200
Subject: [PATCH] [IMP] Add INVOICEMONTHNAME marker to line description

---
 contract/models/contract_line.py     | 23 +++++++++++++++++++++++
 contract/readme/USAGE.rst            |  4 ++--
 contract/tests/test_contract.py      |  6 +++++-
 contract/views/contract.xml          |  7 +++++++
 contract/views/contract_template.xml |  2 ++
 5 files changed, 39 insertions(+), 3 deletions(-)

diff --git a/contract/models/contract_line.py b/contract/models/contract_line.py
index 5f3a496c1..a5bf57414 100644
--- a/contract/models/contract_line.py
+++ b/contract/models/contract_line.py
@@ -616,6 +616,23 @@ class ContractLine(models.Model):
         )
         return first_date_invoiced, last_date_invoiced, recurring_next_date
 
+    def _translate_marker_month_name(self, month_name):
+        months = {
+            "January": _("January"),
+            "February": _("February"),
+            "March": _("March"),
+            "April": _("April"),
+            "May": _("May"),
+            "June": _("June"),
+            "July": _("July"),
+            "August": _("August"),
+            "September": _("September"),
+            "October": _("October"),
+            "November": _("November"),
+            "December": _("December"),
+        }
+        return months[month_name]
+
     def _insert_markers(self, first_date_invoiced, last_date_invoiced):
         self.ensure_one()
         lang_obj = self.env["res.lang"]
@@ -624,6 +641,12 @@ class ContractLine(models.Model):
         name = self.name
         name = name.replace("#START#", first_date_invoiced.strftime(date_format))
         name = name.replace("#END#", last_date_invoiced.strftime(date_format))
+        name = name.replace(
+            "#INVOICEMONTHNAME#",
+            self.with_context(lang=lang.code)._translate_marker_month_name(
+                first_date_invoiced.strftime("%B")
+            ),
+        )
         return name
 
     def _update_recurring_next_date(self):
diff --git a/contract/readme/USAGE.rst b/contract/readme/USAGE.rst
index 7257cf153..072e87e68 100644
--- a/contract/readme/USAGE.rst
+++ b/contract/readme/USAGE.rst
@@ -10,8 +10,8 @@
    * the recurrence parameters: interval (days, weeks, months, months last day or years),
      start date, date of next invoice (automatically computed, can be modified) and end date (optional)
    * auto-price, for having a price automatically obtained from the price list
-   * #START# or #END# in the description field to display the start/end date of
-     the invoiced period in the invoice line description
+   * #START# - #END# or #INVOICEMONTHNAME# in the description field to display
+     the start/end date or the start month of the invoiced period in the invoice line description
    * pre-paid (invoice at period start) or post-paid (invoice at start of next period)
 
 #. The "Generate Recurring Invoices from Contracts" cron runs daily to generate the invoices.
diff --git a/contract/tests/test_contract.py b/contract/tests/test_contract.py
index 9f26c53aa..e1a645f72 100644
--- a/contract/tests/test_contract.py
+++ b/contract/tests/test_contract.py
@@ -150,7 +150,7 @@ class TestContractBase(common.SavepointCase):
                         0,
                         {
                             "product_id": False,
-                            "name": "Header for Services",
+                            "name": "Header for #INVOICEMONTHNAME# Services",
                             "display_type": "line_section",
                         },
                     ),
@@ -2453,3 +2453,7 @@ class TestContract(TestContractBase):
         self.acct_line.uom_id = uom_day.id
         self.acct_line.refresh()
         self.assertEqual(self.acct_line.price_unit, 30.75 * 8)
+
+    def test_check_month_name_marker(self):
+        invoice_id = self.contract3.recurring_create_invoice()
+        self.assertEqual(invoice_id.invoice_line_ids[0].name, "Header for May Services")
diff --git a/contract/views/contract.xml b/contract/views/contract.xml
index c98aa616d..9cc2209f8 100644
--- a/contract/views/contract.xml
+++ b/contract/views/contract.xml
@@ -466,6 +466,13 @@
                                     the
                                     invoiced period
                                 </p>
+                                <p colspan="2">
+                                    <strong>#INVOICEMONTHNAME#</strong>
+                                    : Invoice month name
+                                    of
+                                    the
+                                    invoiced period
+                                </p>
                             </group>
                         </page>
                     </notebook>
diff --git a/contract/views/contract_template.xml b/contract/views/contract_template.xml
index da79db55d..c4f57f46d 100644
--- a/contract/views/contract_template.xml
+++ b/contract/views/contract_template.xml
@@ -68,6 +68,8 @@
                 >
                     <p> <strong>#START#</strong>: Start date of the invoiced period</p>
                     <p> <strong>#END#</strong>: End date of the invoiced period</p>
+                    <p> <strong
+                        >#INVOICEMONTHNAME#</strong>: Invoice month name of the invoiced period</p>
                 </group>
             </form>
         </field>