OCA · OCA-git-bot · Oct 16, 2025 · Oct 26, 2015 · Dec 23, 2016 · Sep 6, 2017
diff --git a/website_sale_require_legal/README.rst b/website_sale_require_legal/README.rst
@@ -0,0 +1,152 @@
+=========================================
+Require accepting legal terms to checkout
+=========================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:110fc2437cf0a83c09c41f0e87bf5281edfcc18d1471243bd25fc01b38162e13
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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%2Fe--commerce-lightgray.png?logo=github
+    :target: https://github.com/OCA/e-commerce/tree/18.0/website_sale_require_legal
+    :alt: OCA/e-commerce
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/e-commerce-18-0/e-commerce-18-0-website_sale_require_legal
+    :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/e-commerce&target_branch=18.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module extends your e-commerce legal compliance options:
+
+1. Require accepting legal terms before submitting a new address.
+2. Log a note in the partner when such terms are accepted.
+3. Log a note in the sale order when terms are accepted before payment
+   (done for every online payment, it is an upstream feature).
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Use Cases / Context
+===================
+
+This module adds the functionality to require the user to check the
+checkbox to accept the legal terms in the address form. Additionally, it
+provides a metadata record for both the user when legal terms are
+accepted through the address form and for the sales order when legal
+terms are accepted during the payment process.
+
+It's worth noting that this module can be useful even if the acceptance
+of legal terms in the address form is not activated, as it stores a
+metadata record when the terms and conditions are accepted during the
+payment process, even if a new address has not been created.
+
+Configuration
+=============
+
+To configure this module, you need to:
+
+1. Install it.
+
+2. Set up `your legal pages </legal>`__.
+
+3. Go to your e-commerce and make a sample checkout.
+
+4. Visit `/shop/address </shop/address>`__ and enable in the web editor
+   *Customize > Require Legal Terms Acceptance*.
+
+   |image1|
+
+   This will require acceptance before recording a new address, and log
+   visitor's acceptance.
+
+5. Visit `/shop/payment </shop/payment>`__ and enable in the web editor
+   *Customize > Accept Terms & Conditions* (upstream Odoo feature).
+
+   |image2|
+
+   This will require acceptance before paying the sale order, and log
+   visitor's acceptance.
+
+.. |image1| image:: https://raw.githubusercontent.com/OCA/e-commerce/18.0/website_sale_require_legal/static/description/address-enable.png
+.. |image2| image:: https://raw.githubusercontent.com/OCA/e-commerce/18.0/website_sale_require_legal/static/description/payment-enable.png
+
+Usage
+=====
+
+To use this module, you need to:
+
+- Buy something from your website.
+
+Known issues / Roadmap
+======================
+
+- Shopping terms and conditions are accepted only on user registration
+  or address edition. So if those terms change after the user signed up,
+  a notification should be made. An implicit acceptance could be printed
+  in the payment screen to solve this. Maybe that could be a work to
+  develop in another module.
+- If you enable both acceptance views as explained in the configuration
+  section, first-time buyers will have to accept the legal terms between
+  2 and 3 times to buy.
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/e-commerce/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/e-commerce/issues/new?body=module:%20website_sale_require_legal%0Aversion:%2018.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
+-------
+
+* Tecnativa
+
+Contributors
+------------
+
+- `Tecnativa <https://www.tecnativa.com>`__:
+
+     - Rafael Blasco
+     - Jairo Llopis
+     - Vicent Cubells
+     - David Vidal
+     - Ernesto Tejeda
+     - Cristina Martin R.
+     - Pilar Vargas
+
+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/e-commerce <https://github.com/OCA/e-commerce/tree/18.0/website_sale_require_legal>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
diff --git a/website_sale_require_legal/__init__.py b/website_sale_require_legal/__init__.py
@@ -0,0 +1,2 @@
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from . import controllers
diff --git a/website_sale_require_legal/__manifest__.py b/website_sale_require_legal/__manifest__.py
@@ -0,0 +1,25 @@
+# Copyright 2015, 2017, 2021 Tecnativa - Jairo Llopis
+# Copyright 2016 Tecnativa - Vicent Cubells
+# Copyright 2019 Tecnativa - Cristina Martin R.
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+{
+    "name": "Require accepting legal terms to checkout",
+    "summary": "Force the user to accept legal tems to buy in the web shop",
+    "version": "18.0.1.0.0",
+    "category": "Website",
+    "website": "https://github.com/OCA/e-commerce",
+    "author": "Tecnativa, Odoo Community Association (OCA)",
+    "license": "AGPL-3",
+    "application": False,
+    "installable": True,
+    "depends": ["website_sale"],
+    "data": ["templates/website_sale.xml"],
+    "assets": {
+        "web.assets_frontend": [
+            "/website_sale_require_legal/static/src/scss/website_sale_require_legal.scss",
+        ],
+        "web.assets_tests": [
+            "/website_sale_require_legal/static/tests/tours/tour.esm.js",
+        ],
+    },
+}
diff --git a/website_sale_require_legal/controllers/__init__.py b/website_sale_require_legal/controllers/__init__.py
@@ -0,0 +1,2 @@
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+from . import main
diff --git a/website_sale_require_legal/controllers/main.py b/website_sale_require_legal/controllers/main.py
@@ -0,0 +1,120 @@
+# Copyright 2015-2017 Tecnativa - Jairo Llopis
+# Copyright 2016 Tecnativa - Vicent Cubells
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+from markupsafe import Markup
+
+from odoo import http
+from odoo.http import request, route
+
+from odoo.addons.payment.controllers import portal
+from odoo.addons.website_sale.controllers import main
+
+
+class WebsiteSale(main.WebsiteSale):
+    def _validate_address_values(
+        self,
+        address_values,
+        partner_sudo,
+        address_type,
+        use_delivery_as_billing,
+        required_fields,
+        is_main_address,
+        **_kwargs,
+    ):
+        invalid_fields, missing_fields, error_messages = (
+            super()._validate_address_values(
+                address_values,
+                partner_sudo,
+                address_type,
+                use_delivery_as_billing,
+                required_fields,
+                is_main_address,
+                **_kwargs,
+            )
+        )
+        if not _kwargs.get("accepted_legal_terms"):
+            error_messages.append(
+                request.env._("You must accept the terms & conditions to continue.")
+            )
+
+        return invalid_fields, missing_fields, error_messages
+
+    @route(
+        "/shop/address/submit",
+        type="http",
+        methods=["POST"],
+        auth="public",
+        website=True,
+        sitemap=False,
+    )
+    def shop_address_submit(
+        self,
+        partner_id=None,
+        address_type="billing",
+        use_delivery_as_billing=None,
+        callback=None,
+        required_fields=None,
+        **form_data,
+    ):
+        res = super().shop_address_submit(
+            partner_id=partner_id,
+            address_type=address_type,
+            use_delivery_as_billing=use_delivery_as_billing,
+            callback=callback,
+            required_fields=required_fields,
+            **form_data,
+        )
+        if partner_id:
+            partner = request.env["res.partner"].browse(int(partner_id))
+            if form_data.get("accepted_legal_terms"):
+                self._log_acceptance_metadata(partner)
+        return res
+
+    def _log_acceptance_metadata(self, record):
+        """Log legal terms acceptance metadata."""
+        environ = request.httprequest.headers.environ
+        metadata = "<br/>".join(
+            f"{val}: {environ.get(val)}"
+            for val in (
+                "REMOTE_ADDR",
+                "HTTP_USER_AGENT",
+                "HTTP_ACCEPT_LANGUAGE",
+            )
+        )
+        message = Markup(
+            request.env._("Website legal terms acceptance metadata: %s") % metadata
+        )
+        record.sudo().message_post(
+            body=message, message_type="notification", subtype_xmlid="mail.mt_comment"
+        )
+
+
+class PaymentPortal(portal.PaymentPortal):
+    @http.route()
+    def shop_payment_transaction(self, order_id, access_token, **kwargs):
+        """Record sale order payment legal terms acceptance.
+
+        If the "Accept Terms & Conditions" upstream view is enabled in the
+        website, to get here, user must have accepted legal terms.
+        """
+        result = super().shop_payment_transaction(order_id, access_token, **kwargs)
+        # If the "Accept Terms & Conditions" view is disabled, we log nothing
+        if not request.website.viewref(
+            "website_sale.accept_terms_and_conditions"
+        ).active:
+            return result
+        # Retrieve the sale order
+        if order_id:
+            sale_obj = request.env["sale.order"]
+            domain = [("id", "=", order_id)]
+            if access_token:
+                sale_obj = sale_obj.sudo()
+                domain.append(("access_token", "=", access_token))
+            order = sale_obj.search(domain, limit=1)
+        else:
+            order = request.website.sale_get_order()
+        # Log metadata in the sale order
+        if order:
+            WebsiteSale._log_acceptance_metadata(self, order)
+        return result
diff --git a/website_sale_require_legal/i18n/de.po b/website_sale_require_legal/i18n/de.po
@@ -0,0 +1,43 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# * website_sale_require_legal
+#
+# Translators:
+# Rudolf Schnapka <rs@techno-flex.de>, 2017
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 9.0c\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2017-05-20 01:42+0000\n"
+"PO-Revision-Date: 2017-05-20 01:42+0000\n"
+"Last-Translator: Rudolf Schnapka <rs@techno-flex.de>, 2017\n"
+"Language-Team: German (https://www.transifex.com/oca/teams/23907/de/)\n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. module: website_sale_require_legal
+#: model_terms:ir.ui.view,arch_db:website_sale_require_legal.accept_input
+msgid "I agree to the"
+msgstr ""
+
+#. module: website_sale_require_legal
+#. odoo-python
+#: code:addons/website_sale_require_legal/controllers/main.py:0
+#, python-format
+msgid "Website legal terms acceptance metadata: %s"
+msgstr ""
+
+#. module: website_sale_require_legal
+#: model_terms:ir.ui.view,arch_db:website_sale_require_legal.accept_input
+msgid "terms &amp; conditions"
+msgstr ""
+
+#~ msgid ""
+#~ "Confirm\n"
+#~ "            <span class=\"fa fa-long-arrow-right\"/>"
+#~ msgstr ""
+#~ "Bestätigen\n"
+#~ "            <span class=\"fa fa-long-arrow-right\"/>"
diff --git a/website_sale_require_legal/i18n/es.po b/website_sale_require_legal/i18n/es.po
@@ -0,0 +1,37 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+# * website_sale_require_legal
+#
+# Translators:
+# Pedro M. Baeza <pedro.baeza@gmail.com>, 2017
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 9.0c\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2017-01-07 02:00+0000\n"
+"PO-Revision-Date: 2023-07-05 14:08+0000\n"
+"Last-Translator: Ivorra78 <informatica@totmaterial.es>\n"
+"Language-Team: Spanish (https://www.transifex.com/oca/teams/23907/es/)\n"
+"Language: es\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"
+"X-Generator: Weblate 4.17\n"
+
+#. module: website_sale_require_legal
+#: model_terms:ir.ui.view,arch_db:website_sale_require_legal.accept_input
+msgid "I agree to the"
+msgstr "Estoy de acuerdo con el/la"
+
+#. module: website_sale_require_legal
+#. odoo-python
+#: code:addons/website_sale_require_legal/controllers/main.py:0
+#, python-format
+msgid "Website legal terms acceptance metadata: %s"
+msgstr "Metadatos de aceptación de los términos legales del sitio web: %s"
+
+#. module: website_sale_require_legal
+#: model_terms:ir.ui.view,arch_db:website_sale_require_legal.accept_input
+msgid "terms &amp; conditions"
+msgstr "términos y plazos; condiciones"
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
		from . import controllers
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
		from . import main