diff --git a/setup/website_sale_order_cancel/odoo/addons/website_sale_order_cancel b/setup/website_sale_order_cancel/odoo/addons/website_sale_order_cancel new file mode 120000 index 0000000000..39e22a39a1 --- /dev/null +++ b/setup/website_sale_order_cancel/odoo/addons/website_sale_order_cancel @@ -0,0 +1 @@ +../../../../website_sale_order_cancel \ No newline at end of file diff --git a/setup/website_sale_order_cancel/setup.py b/setup/website_sale_order_cancel/setup.py new file mode 100644 index 0000000000..28c57bb640 --- /dev/null +++ b/setup/website_sale_order_cancel/setup.py @@ -0,0 +1,6 @@ +import setuptools + +setuptools.setup( + setup_requires=['setuptools-odoo'], + odoo_addon=True, +) diff --git a/website_sale_order_cancel/README.rst b/website_sale_order_cancel/README.rst new file mode 100644 index 0000000000..f7ca5c5f6d --- /dev/null +++ b/website_sale_order_cancel/README.rst @@ -0,0 +1,95 @@ +========================= +Website Sale Order Cancel +========================= + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:7988891481fa43dd69fc8c859e10df9ba5d4dd6ad6ac63043e7ab114a6fe0a2b + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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/15.0/website_sale_order_cancel + :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-15-0/e-commerce-15-0-website_sale_order_cancel + :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=15.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module allows customers to cancel confirmed sales orders directly from the Odoo portal using a simple confirmation modal. The sale order cannot be cancelled if it has any validated related stock pickings. + +**Table of contents** + +.. contents:: + :local: + +Usage +===== + +1. In the Website app, navigate to My Account > Sales Orders. +2. Open the sales order you wish to cancel. +3. Click the **Cancel** button to open the confirmation modal. +4. Confirm the cancellation by clicking the **Submit** button. + +The sales order cannot be cancelled if it has any validated related stock pickings. + +Bug Tracker +=========== + +Bugs are tracked on `GitHub 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 `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +~~~~~~~ + +* APSL-Nagarro + +Contributors +~~~~~~~~~~~~ + +- [APSL-Nagarro](https://www.apsl.tech): + - Patryk Pyczko \<\> + +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. + +.. |maintainer-ppyczko| image:: https://github.com/ppyczko.png?size=40px + :target: https://github.com/ppyczko + :alt: ppyczko + +Current `maintainer `__: + +|maintainer-ppyczko| + +This module is part of the `OCA/e-commerce `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/website_sale_order_cancel/__init__.py b/website_sale_order_cancel/__init__.py new file mode 100644 index 0000000000..9613a24bd3 --- /dev/null +++ b/website_sale_order_cancel/__init__.py @@ -0,0 +1,3 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import controllers diff --git a/website_sale_order_cancel/__manifest__.py b/website_sale_order_cancel/__manifest__.py new file mode 100644 index 0000000000..7cfd8c1499 --- /dev/null +++ b/website_sale_order_cancel/__manifest__.py @@ -0,0 +1,25 @@ +# Copyright 2024 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Website Sale Order Cancel", + "version": "15.0.1.0.0", + "summary": "Allow customers to cancel their website sale orders", + "category": "Website", + "website": "https://github.com/OCA/e-commerce", + "author": "APSL-Nagarro, Odoo Community Association (OCA)", + "maintainers": ["ppyczko"], + "license": "AGPL-3", + "application": False, + "installable": True, + "depends": ["website_sale", "sale_management", "stock"], + "data": ["views/templates.xml"], + "assets": { + "web.assets_frontend": [ + "website_sale_order_cancel/static/src/js/website_sale_order_cancel.js" + ], + "web.assets_tests": [ + "website_sale_order_cancel/static/tests/tours/cancel_order_tour.js", + ], + }, +} diff --git a/website_sale_order_cancel/controllers/__init__.py b/website_sale_order_cancel/controllers/__init__.py new file mode 100644 index 0000000000..f43232f012 --- /dev/null +++ b/website_sale_order_cancel/controllers/__init__.py @@ -0,0 +1,3 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import main diff --git a/website_sale_order_cancel/controllers/main.py b/website_sale_order_cancel/controllers/main.py new file mode 100644 index 0000000000..69f0884306 --- /dev/null +++ b/website_sale_order_cancel/controllers/main.py @@ -0,0 +1,29 @@ +# Copyright 2024 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import http +from odoo.http import request + + +class SaleOrderCancel(http.Controller): + @http.route( + "/cancel/confirm", + type="json", + auth="public", + website=False, + csrf=False, + methods=["GET", "POST"], + ) + def confirm_cancel_sale_order(self): + """Cancel the sale order after confirmation.""" + sale_order_id = request.jsonrequest.get("sale_order_id") + + if not sale_order_id: + return {"success": False} + + sale_order = request.env["sale.order"].sudo().browse(int(sale_order_id)) + sale_order.with_context(disable_cancel_warning=True).action_cancel() + + return { + "success": True, + } diff --git a/website_sale_order_cancel/readme/CONTRIBUTORS.rst b/website_sale_order_cancel/readme/CONTRIBUTORS.rst new file mode 100644 index 0000000000..134de2bbe2 --- /dev/null +++ b/website_sale_order_cancel/readme/CONTRIBUTORS.rst @@ -0,0 +1,2 @@ +- [APSL-Nagarro](https://www.apsl.tech): + - Patryk Pyczko \<\> diff --git a/website_sale_order_cancel/readme/DESCRIPTION.rst b/website_sale_order_cancel/readme/DESCRIPTION.rst new file mode 100644 index 0000000000..9736e52e51 --- /dev/null +++ b/website_sale_order_cancel/readme/DESCRIPTION.rst @@ -0,0 +1 @@ +This module allows customers to cancel confirmed sales orders directly from the Odoo portal using a simple confirmation modal. The sale order cannot be cancelled if it has any validated related stock pickings. diff --git a/website_sale_order_cancel/readme/USAGE.rst b/website_sale_order_cancel/readme/USAGE.rst new file mode 100644 index 0000000000..c18f90d1b1 --- /dev/null +++ b/website_sale_order_cancel/readme/USAGE.rst @@ -0,0 +1,6 @@ +1. In the Website app, navigate to My Account > Sales Orders. +2. Open the sales order you wish to cancel. +3. Click the **Cancel** button to open the confirmation modal. +4. Confirm the cancellation by clicking the **Submit** button. + +The sales order cannot be cancelled if it has any validated related stock pickings. diff --git a/website_sale_order_cancel/static/description/icon.png b/website_sale_order_cancel/static/description/icon.png new file mode 100644 index 0000000000..3a0328b516 Binary files /dev/null and b/website_sale_order_cancel/static/description/icon.png differ diff --git a/website_sale_order_cancel/static/description/index.html b/website_sale_order_cancel/static/description/index.html new file mode 100644 index 0000000000..c0c1d3af6c --- /dev/null +++ b/website_sale_order_cancel/static/description/index.html @@ -0,0 +1,437 @@ + + + + + +Website Sale Order Cancel + + + +
+

Website Sale Order Cancel

+ + +

Beta License: AGPL-3 OCA/e-commerce Translate me on Weblate Try me on Runboat

+

This module allows customers to cancel confirmed sales orders directly from the Odoo portal using a simple confirmation modal. The sale order cannot be cancelled if it has any validated related stock pickings.

+

Table of contents

+ +
+

Usage

+
    +
  1. In the Website app, navigate to My Account > Sales Orders.
    2. +
  2. Open the sales order you wish to cancel.
    3. +
  3. Click the Cancel button to open the confirmation modal.
    4. +
  4. Confirm the cancellation by clicking the Submit button.
    5. +
+

The sales order cannot be cancelled if it has any validated related stock pickings.

+
+
+

Bug Tracker

+

Bugs are tracked on GitHub 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.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • APSL-Nagarro
    • +
+
+
+

Contributors

+ +
+
+

Maintainers

+

This module is maintained by the OCA.

+ +Odoo Community Association + +

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.

+

Current maintainer:

+

ppyczko

+

This module is part of the OCA/e-commerce project on GitHub.

+

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

+
+
+
+ + diff --git a/website_sale_order_cancel/static/src/js/website_sale_order_cancel.js b/website_sale_order_cancel/static/src/js/website_sale_order_cancel.js new file mode 100644 index 0000000000..74d6f8977d --- /dev/null +++ b/website_sale_order_cancel/static/src/js/website_sale_order_cancel.js @@ -0,0 +1,48 @@ +/* Copyright 2024 Patryk Pyczko (APSL-Nagarro) + * License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). */ + +odoo.define("website_sale_order_cancel_widget", function (require) { + "use strict"; + + const publicWidget = require("web.public.widget"); + const Dialog = require("web.Dialog"); + + var WebsiteSaleOrderCancelWidget = publicWidget.Widget.extend({ + selector: ".cancelOrderForm", + events: { + "click #submit_cancel_button": "_onSubmit", + }, + + _onSubmit: function (e) { + e.preventDefault(); + var sale_order_id = this.$("#sale_order_id").val(); + + fetch("/cancel/confirm", { + method: "POST", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify({sale_order_id: sale_order_id}), + }) + .then((response) => response.json()) + .then((data) => { + if (data.result.success) { + location.reload(); + } else { + this._showDialog("Error", "Unable to cancel the order."); + } + }) + .catch(() => + this._showDialog("Error", "An unexpected error occurred.") + ); + }, + + _showDialog(title, message) { + Dialog.alert(this, message, {title}); + }, + }); + + publicWidget.registry.WebsiteSaleOrderCancel = WebsiteSaleOrderCancelWidget; + + return WebsiteSaleOrderCancelWidget; +}); diff --git a/website_sale_order_cancel/static/tests/tours/cancel_order_tour.js b/website_sale_order_cancel/static/tests/tours/cancel_order_tour.js new file mode 100644 index 0000000000..3555ab4ac8 --- /dev/null +++ b/website_sale_order_cancel/static/tests/tours/cancel_order_tour.js @@ -0,0 +1,33 @@ +/* Copyright 2024 Patryk Pyczko (APSL-Nagarro) + * License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). */ + +odoo.define("website_sale_order_cancel.cancel_order_tour", function (require) { + "use strict"; + + var tour = require("web_tour.tour"); + + tour.register( + "sale_order_cancel_tour", + { + url: "/my/orders/8", + test: true, + }, + [ + // Step 1: Locate and click the Cancel button to initiate the cancellation process + { + trigger: "#cancelOrderButton", + content: + "Click on the Cancel button to start the cancellation process.", + run: "click", + }, + + // Step 2: Locate the 'Submit' button in the cancellation modal and confirm the cancellation + { + trigger: "#submit_cancel_button", + content: + "Submit the cancellation form to confirm the order cancellation.", + run: "click", + }, + ] + ); +}); diff --git a/website_sale_order_cancel/tests/__init__.py b/website_sale_order_cancel/tests/__init__.py new file mode 100644 index 0000000000..fafda1346e --- /dev/null +++ b/website_sale_order_cancel/tests/__init__.py @@ -0,0 +1,3 @@ +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from . import test_sale_order_cancel_tour diff --git a/website_sale_order_cancel/tests/test_sale_order_cancel_tour.py b/website_sale_order_cancel/tests/test_sale_order_cancel_tour.py new file mode 100644 index 0000000000..d0fa29fbfb --- /dev/null +++ b/website_sale_order_cancel/tests/test_sale_order_cancel_tour.py @@ -0,0 +1,31 @@ +# Copyright 2024 Patryk Pyczko (APSL-Nagarro) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo.tests import HttpCase, tagged + + +@tagged("post_install", "-at_install") +class TestSaleOrderCancelTour(HttpCase): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.sale_order = cls.env.ref("sale.sale_order_8") + + def test_tour(self): + self.assertNotEqual( + self.sale_order.state, + "cancel", + "Sale order shouldn't be cancelled.", + ) + + self.start_tour( + "/my/orders/8", + "sale_order_cancel_tour", + login="demo", + ) + + self.assertEqual( + self.sale_order.state, + "cancel", + "Sale order should be cancelled.", + ) diff --git a/website_sale_order_cancel/views/templates.xml b/website_sale_order_cancel/views/templates.xml new file mode 100644 index 0000000000..98df2d7155 --- /dev/null +++ b/website_sale_order_cancel/views/templates.xml @@ -0,0 +1,65 @@ + + + +