[16.0][ADD] sale_campaign_seasonality

sale_campaign_seasonality/README.rst

@@ -0,0 +1,83 @@
+============================
+Product Campaign Seasonality
+============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:0197ed616e759f09f528ac68441e01331fdce3e348f268341435cebc9dd91fa7
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/licence-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%2Fsale--workflow-lightgray.png?logo=github
+    :target: https://github.com/OCA/sale-workflow/tree/16.0/sale_campaign_seasonality
+    :alt: OCA/sale-workflow
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/sale-workflow-16-0/sale-workflow-16-0-sale_campaign_seasonality
+    :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/sale-workflow&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module modifies campaigns to allow for tracking seasonality and
+campaigns of products.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+Create seasonalities and assign them to campaigns
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/sale-workflow/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/sale-workflow/issues/new?body=module:%20sale_campaign_seasonality%0Aversion:%2016.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
+-------
+
+* Akretion
+
+Contributors
+------------
+
+-  Kevin Khao [email protected]
+-  David Beal [email protected]
+
+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/sale-workflow <https://github.com/OCA/sale-workflow/tree/16.0/sale_campaign_seasonality>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

sale_campaign_seasonality/__init__.py

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

sale_campaign_seasonality/__manifest__.py

@@ -0,0 +1,20 @@
+# Copyright 2024 Akretion
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Product Campaign Seasonality",
+    "summary": """
+        Product campaign seasonality""",
+    "version": "16.0.1.0.0",
+    "license": "AGPL-3",
+    "author": "Akretion,Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/sale-workflow",
+    "depends": ["utm", "product", "sale"],
+    "data": [
+        "views/product_packaging.xml",
+        "views/product_product.xml",
+        "views/utm_campaign.xml",
+        "security/campaign_seasonality.xml",
+        "views/campaign_seasonality.xml",
+    ],
+}

sale_campaign_seasonality/models/__init__.py

@@ -0,0 +1,4 @@
+from . import campaign_seasonality
+from . import utm_campaign
+from . import product_product
+from . import product_packaging

sale_campaign_seasonality/models/campaign_seasonality.py

@@ -0,0 +1,17 @@
+# Copyright 2024 Akretion
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import fields, models
+
+
+class CampaignSeasonality(models.Model):
+    _name = "campaign.seasonality"
+    _description = "Campaign Seasonality"
+
+    name = fields.Char(required=True)
+    company_id = fields.Many2one(
+        "res.company", required=True, default=lambda self: self.env.company
+    )
+    granularity = fields.Selection(
+        [("date", "Date"), ("month", "Month"), ("year", "Year")], required=True
+    )

sale_campaign_seasonality/models/product_packaging.py

@@ -0,0 +1,15 @@
+# Copyright 2024 Akretion
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import fields, models
+
+
+class ProductPackaging(models.Model):
+    _inherit = "product.packaging"
+
+    seasonality_id = fields.Many2one(
+        "campaign.seasonality",
+        string="Seasonality",
+        related="product_id.seasonality_id",
+        store=True,
+    )

sale_campaign_seasonality/models/product_product.py

@@ -0,0 +1,22 @@
+# Copyright 2024 Akretion
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import fields, models
+
+
+class ProductProduct(models.Model):
+    _inherit = "product.product"
+
+    seasonality_id = fields.Many2one("campaign.seasonality", string="Seasonality")
+    campaign_ids = fields.Many2many(
+        "utm.campaign", string="Campaigns", compute="_compute_campaign_ids"
+    )
+
+    def _compute_campaign_ids(self):
+        for rec in self:
+            sale_orders = (
+                self.env["sale.order.line"]
+                .search([("product_id", "=", rec.id)])
+                .order_id
+            )
+            rec.campaign_ids = sale_orders.campaign_id

sale_campaign_seasonality/models/utm_campaign.py

@@ -0,0 +1,42 @@
+# Copyright 2024 Akretion
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import api, fields, models
+
+
+class UtmCampaign(models.Model):
+    _inherit = "utm.campaign"
+
+    seasonality_id = fields.Many2one("campaign.seasonality", string="Seasonality")
+    display_name = fields.Char(compute="_compute_display_name")
+    start_date = fields.Date(required=True)
+    end_date = fields.Date()
+    start_date_year = fields.Integer(compute="_compute_start_date_year", store=True)
+    display_seasonality_name = fields.Char(
+        compute="_compute_display_seasonality", store=True
+    )
+
+    @api.depends("start_date")
+    def _compute_start_date_year(self):
+        for rec in self:
+            if not rec.start_date:
+                rec.start_date_year = False
+            else:
+                rec.start_date_year = rec.start_date.year
+
+    @api.depends("seasonality_id.name", "start_date_year")
+    def _compute_display_seasonality(self):
+        for rec in self:
+            if rec.seasonality_id.granularity == "year" and rec.start_date_year:
+                rec.display_seasonality_name = (
+                    rec.seasonality_id.name + f" {rec.start_date_year}"
+                )
+            else:
+                rec.display_seasonality_name = rec.seasonality_id.name
+
+    def _compute_display_name(self):
+        for rec in self:
+            if rec.seasonality_id:
+                rec.display_name = f"[{rec.display_seasonality_name}] {rec.name}"
+            else:
+                rec.display_name = rec.name

sale_campaign_seasonality/readme/CONFIGURE.md

@@ -0,0 +1 @@
+Create seasonalities and assign them to campaigns

sale_campaign_seasonality/readme/CONTRIBUTORS.md

@@ -0,0 +1,2 @@
+- Kevin Khao <[email protected]>
+- David Beal <[email protected]>

sale_campaign_seasonality/readme/DESCRIPTION.md

@@ -0,0 +1 @@
+This module modifies campaigns to allow for tracking seasonality and campaigns of products.

sale_campaign_seasonality/security/campaign_seasonality.xml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<!-- Copyright 2024 Akretion
+     License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). -->
+<odoo>
+
+    <record model="ir.model.access" id="campaign_seasonality_access_name">
+        <field name="name">campaign.seasonality sale user</field>
+        <field name="model_id" ref="model_campaign_seasonality" />
+        <field name="group_id" ref="sales_team.group_sale_salesman" />
+        <field name="perm_read" eval="1" />
+        <field name="perm_create" eval="1" />
+        <field name="perm_write" eval="1" />
+        <field name="perm_unlink" eval="1" />
+    </record>
+
+</odoo>