[ADD] web_form_banner

Author: yostashiro

setup/web_form_banner/odoo/addons/web_form_banner

@@ -0,0 +1 @@
+../../../../web_form_banner

setup/web_form_banner/setup.py

@@ -0,0 +1,6 @@
+import setuptools
+
+setuptools.setup(
+    setup_requires=['setuptools-odoo'],
+    odoo_addon=True,
+)

web_form_banner/README.rst

@@ -0,0 +1,221 @@
+===============
+Web Form Banner
+===============
+
+.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fweb-lightgray.png?logo=github
+    :target: https://github.com/OCA/web/tree/12.0/web_form_banner
+    :alt: OCA/web
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/web-12-0/web-12-0-web_form_banner
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
+    :target: https://runbot.odoo-community.org/runbot/162/12.0
+    :alt: Try me on Runbot
+
+|badge1| |badge2| |badge3| |badge4| |badge5| 
+
+The module adds configurable banners for backend **form** views. Define rules per model
+(and optionally per view) to show context-aware alerts with a chosen severity (info/warning/danger).
+
+Messages can be plain text with ${placeholders} or fully custom HTML; visibility,
+severity, and values are computed server-side via a safe Python expression.
+
+Banners are injected just before or after a target node (default: //sheet) and refresh
+on form load/save/reload.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Usage
+=====
+
+#. Go to *Settings > Tachnical > User Interface > Form Banner Rules* and create a rule.
+#. Choose Model, (optionally) restrict Form Views, set Default Severity, Target XPath
+   (insertion point), Position, and configure the message.
+#. Save. Open any matching form record—the banner will appear and auto-refresh after
+   load/save/reload.
+
+Usage of message fields:
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+* **Message** (message): Text shown in the banner. Supports `${placeholders}` filled
+  from values returned by message_value_code. Ignored if message_value_code returns an
+  `html` value.
+* **HTML** (message_is_html): If enabled, the message string is rendered as HTML;
+  otherwise it's treated as plain text.
+* **Message Value Code** (message_value_code): Safe Python expression evaluated per
+  record. Return a dict such as `{"visible": True, "severity": "warning", "values": {"name": record.name}}`.
+  Use either message or `html` (from this code), not both. Several evaluation context
+  variables are available.
+
+Evaluation context variables available in Message Value Code:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* `env`: Odoo environment for ORM access.
+* `user`: Current user (`env.user`).
+* `ctx`: Copy of the current context (`dict(env.context)`).
+* `record`: Current record (the form's record).
+* `model`: Shortcut to the current model (`env[record._name]`).
+* `url_for(obj)`: Helper that returns a backend form URL for `obj`.
+* `context_today(ts=None)`: User-timezone “today” (date) for reliable date comparisons.
+* `time`, `datetime`: Standard Python time/datetime modules.
+* `dateutil`: `{ "parser": dateutil.parser, "relativedelta": dateutil.relativedelta }`
+* `timezone`: `pytz.timezone` for TZ handling.
+* `float_compare`, `float_is_zero`, `float_round`: Odoo float utils for precision-safe
+  comparisons/rounding.
+
+All of the above are injected by the module to the safe_eval locals.
+
+Message setting examples:
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+**A) Missing email on contact (warning)**
+
+* Model: `res.partner`
+* Message: `This contact has no email.`
+* Message Value Code:
+
+.. code-block:: python
+
+  {"visible": not bool(record.email)}
+
+**B) Show partner comment if available**
+
+* Model: `purchase.order`
+* Message: `Vendor Comments: ${comment}`
+* Message Value Code (single expression):
+
+.. code-block:: python
+
+  {
+    "visible": bool(record.partner_id.comment),
+    values: {"comment": record.partner_id.comment},
+  }
+
+It is also possible to use "convenience placeholders" without an explicit `values` key:
+
+.. code-block:: python
+
+  {
+    "visible": bool(record.partner_id.comment),
+    "comment": record.partner_id.comment,
+  }
+
+**C) High-value sale order (dynamic severity)**
+
+* Model: `sale.order`
+* Message: `High-value order: ${amount_total}`
+* Message Value Code:
+
+.. code-block:: python
+
+  {
+    "visible": record.amount_total > 30000,
+    "severity": "danger" if record.amount_total >= 100000 else "warning",
+    "values": {"amount_total": record.amount_total},
+  }
+
+**D) Quotation past validity date**
+
+* Model: `sale.order`
+* Message: `This quotation is past its validity date (${validity_date}).`
+* Message Value Code:
+
+.. code-block:: python
+
+  {
+    "visible": bool(record.validity_date and context_today() > record.validity_date and record.state in ["draft", "sent"]),
+    "values": {"validity_date": record.validity_date},
+  }
+
+**E) Pending activities on a task (uses env)**
+
+* Model: `project.task`
+* Message: `There are ${cnt} pending activities.`
+* Message Value Code (multi-line with `result`):
+
+.. code-block:: python
+
+  cnt = env["mail.activity"].search_count([("res_model","=",record._name),("res_id","=",record.id)])
+  result = {"visible": cnt > 0, "values": {"cnt": cnt}}
+
+**F) HTML banner linking to the customer's last sales order**
+
+* Model: `sale.order`
+* Message: (leave blank; `html` provided by Message Value Code)
+* Message Value Code (multi-line with `result`):
+
+.. code-block:: python
+
+  last = model.search(
+    [("partner_id", "=", record.partner_id.id), ("id", "<", record.id)],
+    order="date_order desc, id desc",
+    limit=1,
+  )
+  if last:
+    html = "<strong>Previous order:</strong> <a href='%s'>%s</a>" % (url_for(last), last.name)
+    result = {"visible": True, "html": html}
+  else:
+    result = {"visible": False}
+
+Known issues / Roadmap
+======================
+
+Placing a full-width inline banner inside `<group>` is currently not supported. The
+banner will be limited to 50% of the group's width, and its label/value ratio will be
+forced to 1:1.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us smashing it by providing a detailed and welcomed
+`feedback <https://github.com/OCA/web/issues/new?body=module:%20web_form_banner%0Aversion:%2012.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
+~~~~~~~
+
+* Quartile
+
+Contributors
+~~~~~~~~~~~~
+
+* `Quartile <https://www.quartile.co>`_:
+
+  * Yoshi Tashiro
+
+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/web <https://github.com/OCA/web/tree/12.0/web_form_banner>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

web_form_banner/__init__.py

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

web_form_banner/__manifest__.py

@@ -0,0 +1,18 @@
+# Copyright 2025 Quartile (https://www.quartile.co)
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+{
+    "name": "Web Form Banner",
+    "version": "12.0.1.0.0",
+    "category": "Web",
+    "author": "Quartile, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/web",
+    "license": "AGPL-3",
+    "depends": ["web"],
+    "data": [
+        "security/ir.model.access.csv",
+        "views/assets.xml",
+        "views/web_form_banner_rule_views.xml",
+    ],
+    "demo": ["demo/web_form_banner_rule_demo.xml"],
+    'installable': True,
+}

web_form_banner/demo/web_form_banner_rule_demo.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo noupdate="1">
+    <record id="demo_rule_partner_name_length" model="web.form.banner.rule">
+        <field name="name">Partner name length notice</field>
+        <field name="model_id" ref="base.model_res_partner"/>
+        <field name="severity">warning</field>
+        <field name="target_xpath">//sheet</field>
+        <field name="position">before</field>
+        <field name="message_value_code"><![CDATA[
+name = (record.name or "").strip()
+n = len(name)
+if n > 20:
+    result = {
+        "visible": True,
+        "severity": "danger",
+        "html": "<strong>This partner's name is very long!</strong> (length: %d)" % n,
+    }
+elif n > 10:
+    result = {
+        "visible": True,
+        "severity": "warning",
+        "html": "This partner's name is a bit long. (length: %d)" % n,
+    }
+else:
+    result = {"visible": False}
+     ]]></field>
+    </record>
+</odoo>

web_form_banner/models/__init__.py

@@ -0,0 +1,2 @@
+from . import ir_model
+from . import web_form_banner_rule

web_form_banner/models/ir_model.py

@@ -0,0 +1,63 @@
+# Copyright 2025 Quartile (https://www.quartile.co)
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from lxml import etree
+
+from odoo import api, models
+
+
+class Base(models.AbstractModel):
+    _inherit = "base"
+
+    @api.model
+    def fields_view_get(
+        self, view_id=None, view_type="form", toolbar=False, submenu=False
+    ):
+        res = super().fields_view_get(
+            view_id=view_id, view_type=view_type, toolbar=toolbar, submenu=submenu
+        )
+        if view_type != "form" or not res.get("arch"):
+            return res
+        current_view_id = view_id or res.get("view_id")
+        if not current_view_id:
+            return res
+        rules = self.env["web.form.banner.rule"].sudo().search(
+            [
+                ("model_name", "=", self._name),
+                "|",
+                ("view_ids", "in", current_view_id),
+                ("view_ids", "=", False),
+            ]
+        )
+        if not rules:
+            return res
+        try:
+            root = etree.fromstring(res["arch"])
+        except Exception:
+            return res
+        for rule in rules:
+            target = root.xpath(rule.target_xpath or "//sheet")
+            if not target:
+                continue
+            # Lightweight placeholder; JS will fill and toggle visibility
+            css = "o_form_banner alert alert-%s" % (rule.severity or "danger")
+            node = etree.Element(
+                "div",
+                {
+                    "class": css,
+                    "role": "alert",
+                    "data-rule-id": str(rule.id),
+                    "data-model": self._name,
+                    "data-default-severity": (rule.severity or "danger"),
+                    "style": "display:none;",
+                },
+            )
+            parent = target[0].getparent()
+            if parent is None:
+                continue
+            if rule.position == "before":
+                parent.insert(parent.index(target[0]), node)
+            else:
+                target[0].addnext(node)
+        res["arch"] = etree.tostring(root, encoding="unicode")
+        return res