diff --git a/README.md b/README.md index fd9c438fc6..eadde17765 100644 --- a/README.md +++ b/README.md @@ -32,6 +32,7 @@ addon | version | maintainers | summary [report_label](report_label/) | 16.0.1.0.1 | [![ivantodorovich](https://github.com/ivantodorovich.png?size=30px)](https://github.com/ivantodorovich) | Print configurable self-adhesive labels reports [report_py3o](report_py3o/) | 16.0.1.0.1 | | Reporting engine based on Libreoffice (ODT -> ODT, ODT -> PDF, ODT -> DOC, ODT -> DOCX, ODS -> ODS, etc.) [report_py3o_fusion_server](report_py3o_fusion_server/) | 16.0.1.0.0 | | Let the fusion server handle format conversion. +[report_qr](report_qr/) | 16.0.1.0.0 | | Web QR Manager [report_qweb_decimal_place](report_qweb_decimal_place/) | 16.0.1.0.0 | | Report Qweb Decimal Place [report_qweb_element_page_visibility](report_qweb_element_page_visibility/) | 16.0.1.0.0 | | Report Qweb Element Page Visibility [report_qweb_encrypt](report_qweb_encrypt/) | 16.0.1.0.2 | [![kittiu](https://github.com/kittiu.png?size=30px)](https://github.com/kittiu) | Allow to encrypt qweb pdfs diff --git a/report_qr/README.rst b/report_qr/README.rst new file mode 100644 index 0000000000..ed7843d1f3 --- /dev/null +++ b/report_qr/README.rst @@ -0,0 +1,114 @@ +============== +Web QR Manager +============== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:3254874204b0eb4c8d9092211d5d8fb50ed53af74053aaf64e7c5713dcc21a3c + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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%2Freporting--engine-lightgray.png?logo=github + :target: https://github.com/OCA/reporting-engine/tree/16.0/report_qr + :alt: OCA/reporting-engine +.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png + :target: https://translation.odoo-community.org/projects/reporting-engine-16-0/reporting-engine-16-0-report_qr + :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/reporting-engine&target_branch=16.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +This module allows to print QR in better structure than the standard odoo. + +The original image looks like the following + +.. figure:: https://raw.githubusercontent.com/OCA/reporting-engine/16.0/report_qr/static/description/old_qr.png + :alt: Original QR + :width: 100 px + +With the new generator, it looks like: + +.. figure:: https://raw.githubusercontent.com/OCA/reporting-engine/16.0/report_qr/static/description/new_qr.png + :alt: New QR + :width: 100 px + +**Table of contents** + +.. contents:: + :local: + +Usage +===== + +When creating new reports, you should use a path like the following:: + + + + +The **error_correction** parameter controls the error correction used for the QR Code. The following four constants are made available: + +* **error_correction** = 1: About 7% or less errors can be corrected. +* **error_correction** = 0: About 15% or less errors can be corrected. +* **error_correction** = 3: About 25% or less errors can be corrected. +* **error_correction** = 2: About 30% or less errors can be corrected. + +The **box_size** parameter controls how many pixels each "box" of the QR code is. The default is 3. +The **border** parameter controls how many boxes thick the border should be (the default is 4, which is the minimum according to the specs). + +The **version** parameter is an integer from 1 to 40 that controls the size of the QR Code (the smallest, version 1, is a 21x21 matrix). Set to None and use the fit parameter when making the code to determine this automatically. + +**fill_color** and **back_color** can change the background and the painting color of the QR, when using the default image factory. + +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 +~~~~~~~ + +* Creu Blanca + +Contributors +~~~~~~~~~~~~ + +* Enric Tobella + +* `Tecnativa `_: + + * David Vidal + +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/reporting-engine `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/report_qr/__init__.py b/report_qr/__init__.py new file mode 100644 index 0000000000..91c5580fed --- /dev/null +++ b/report_qr/__init__.py @@ -0,0 +1,2 @@ +from . import controllers +from . import models diff --git a/report_qr/__manifest__.py b/report_qr/__manifest__.py new file mode 100644 index 0000000000..f17e034605 --- /dev/null +++ b/report_qr/__manifest__.py @@ -0,0 +1,14 @@ +# Copyright 2019 Creu Blanca +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +{ + "name": "Web QR Manager", + "version": "16.0.1.0.0", + "author": "Creu Blanca, Odoo Community Association (OCA)", + "category": "Reporting", + "website": "https://github.com/OCA/reporting-engine", + "license": "AGPL-3", + "depends": ["web"], + "data": [], + "installable": True, +} diff --git a/report_qr/controllers/__init__.py b/report_qr/controllers/__init__.py new file mode 100644 index 0000000000..da6b5392e6 --- /dev/null +++ b/report_qr/controllers/__init__.py @@ -0,0 +1 @@ +from . import qr diff --git a/report_qr/controllers/qr.py b/report_qr/controllers/qr.py new file mode 100644 index 0000000000..f5760deb36 --- /dev/null +++ b/report_qr/controllers/qr.py @@ -0,0 +1,22 @@ +import werkzeug + +from odoo import http +from odoo.http import request + + +class Home(http.Controller): + @http.route("/report/qr", type="http", auth="public") + def report_qr(self, value, box_size=3, border=3, factory="png", **kwargs): + try: + barcode = request.env["ir.actions.report"].qr_generate( + value, box_size=box_size, border=border, factory=factory, **kwargs + ) + except (ValueError, AttributeError) as e: + raise werkzeug.exceptions.HTTPException( + description="Cannot convert into barcode." + ) from e + if factory != "png": + return request.make_response( + barcode, headers=[("Content-Type", "image/svg+xml")] + ) + return request.make_response(barcode, headers=[("Content-Type", "image/png")]) diff --git a/report_qr/i18n/ca.po b/report_qr/i18n/ca.po new file mode 100644 index 0000000000..576628a328 --- /dev/null +++ b/report_qr/i18n/ca.po @@ -0,0 +1,22 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * report_qr +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 15.0\n" +"Report-Msgid-Bugs-To: \n" +"PO-Revision-Date: 2022-06-15 18:05+0000\n" +"Last-Translator: jabelchi \n" +"Language-Team: none\n" +"Language: ca\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.3.2\n" + +#. module: report_qr +#: model:ir.model,name:report_qr.model_ir_actions_report +msgid "Report Action" +msgstr "Acció informe" diff --git a/report_qr/i18n/it.po b/report_qr/i18n/it.po new file mode 100644 index 0000000000..e8985a2a23 --- /dev/null +++ b/report_qr/i18n/it.po @@ -0,0 +1,20 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * report_qr +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 16.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: Automatically generated\n" +"Language-Team: none\n" +"Language: it\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: report_qr +#: model:ir.model,name:report_qr.model_ir_actions_report +msgid "Report Action" +msgstr "" diff --git a/report_qr/i18n/report_qr.pot b/report_qr/i18n/report_qr.pot new file mode 100644 index 0000000000..ba19ed79bd --- /dev/null +++ b/report_qr/i18n/report_qr.pot @@ -0,0 +1,19 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * report_qr +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 16.0\n" +"Report-Msgid-Bugs-To: \n" +"Last-Translator: \n" +"Language-Team: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: \n" +"Plural-Forms: \n" + +#. module: report_qr +#: model:ir.model,name:report_qr.model_ir_actions_report +msgid "Report Action" +msgstr "" diff --git a/report_qr/models/__init__.py b/report_qr/models/__init__.py new file mode 100644 index 0000000000..a248cf2162 --- /dev/null +++ b/report_qr/models/__init__.py @@ -0,0 +1 @@ +from . import ir_actions_report diff --git a/report_qr/models/ir_actions_report.py b/report_qr/models/ir_actions_report.py new file mode 100644 index 0000000000..ccad9b58ca --- /dev/null +++ b/report_qr/models/ir_actions_report.py @@ -0,0 +1,35 @@ +import io + +import qrcode +from qrcode.image import pil, svg + +from odoo import api, models + + +class IrActionsReport(models.Model): + _inherit = "ir.actions.report" + + @api.model + def qr_generate(self, value, box_size=3, border=5, factory="png", **kwargs): + factories = { + "png": pil.PilImage, + "svg": svg.SvgImage, + "svg-fragment": svg.SvgFragmentImage, + "svg-path": svg.SvgPathImage, + } + back_color = kwargs.pop("back_color", "white") + fill_color = kwargs.pop("fill_color", "black") + try: + # Defaults to png if the argument is unknown + image_factory = factories.get(factory, pil.PilImage) + qr = qrcode.QRCode( + box_size=box_size, border=border, image_factory=image_factory, **kwargs + ) + qr.add_data(value) + qr.make() + img = qr.make_image(fill_color=fill_color, back_color=back_color) + arr = io.BytesIO() + img.save(arr) + return arr.getvalue() + except Exception as e: + raise ValueError("Cannot convert into barcode.") from e diff --git a/report_qr/readme/CONTRIBUTORS.rst b/report_qr/readme/CONTRIBUTORS.rst new file mode 100644 index 0000000000..ba55fe73fc --- /dev/null +++ b/report_qr/readme/CONTRIBUTORS.rst @@ -0,0 +1,5 @@ +* Enric Tobella + +* `Tecnativa `_: + + * David Vidal diff --git a/report_qr/readme/DESCRIPTION.rst b/report_qr/readme/DESCRIPTION.rst new file mode 100644 index 0000000000..e4e45291b1 --- /dev/null +++ b/report_qr/readme/DESCRIPTION.rst @@ -0,0 +1,13 @@ +This module allows to print QR in better structure than the standard odoo. + +The original image looks like the following + +.. figure:: static/description/old_qr.png + :alt: Original QR + :width: 100 px + +With the new generator, it looks like: + +.. figure:: static/description/new_qr.png + :alt: New QR + :width: 100 px diff --git a/report_qr/readme/USAGE.rst b/report_qr/readme/USAGE.rst new file mode 100644 index 0000000000..365558ad65 --- /dev/null +++ b/report_qr/readme/USAGE.rst @@ -0,0 +1,18 @@ +When creating new reports, you should use a path like the following:: + + + + +The **error_correction** parameter controls the error correction used for the QR Code. The following four constants are made available: + +* **error_correction** = 1: About 7% or less errors can be corrected. +* **error_correction** = 0: About 15% or less errors can be corrected. +* **error_correction** = 3: About 25% or less errors can be corrected. +* **error_correction** = 2: About 30% or less errors can be corrected. + +The **box_size** parameter controls how many pixels each "box" of the QR code is. The default is 3. +The **border** parameter controls how many boxes thick the border should be (the default is 4, which is the minimum according to the specs). + +The **version** parameter is an integer from 1 to 40 that controls the size of the QR Code (the smallest, version 1, is a 21x21 matrix). Set to None and use the fit parameter when making the code to determine this automatically. + +**fill_color** and **back_color** can change the background and the painting color of the QR, when using the default image factory. diff --git a/report_qr/static/description/icon.png b/report_qr/static/description/icon.png new file mode 100644 index 0000000000..3a0328b516 Binary files /dev/null and b/report_qr/static/description/icon.png differ diff --git a/report_qr/static/description/index.html b/report_qr/static/description/index.html new file mode 100644 index 0000000000..d42a50c02d --- /dev/null +++ b/report_qr/static/description/index.html @@ -0,0 +1,451 @@ + + + + + +Web QR Manager + + + +
+

Web QR Manager

+ + +

Beta License: AGPL-3 OCA/reporting-engine Translate me on Weblate Try me on Runboat

+

This module allows to print QR in better structure than the standard odoo.

+

The original image looks like the following

+
+Original QR +
+

With the new generator, it looks like:

+
+New QR +
+

Table of contents

+ +
+

Usage

+

When creating new reports, you should use a path like the following:

+
+<img t-att-src="'/report/qr/?value=%s&amp;error_correction=%s' % ('HELLO WORLD!', 3)" style="width:100;height:100"/>
+
+

The error_correction parameter controls the error correction used for the QR Code. The following four constants are made available:

+
    +
  • error_correction = 1: About 7% or less errors can be corrected.
    • +
  • error_correction = 0: About 15% or less errors can be corrected.
    • +
  • error_correction = 3: About 25% or less errors can be corrected.
    • +
  • error_correction = 2: About 30% or less errors can be corrected.
    • +
+

The box_size parameter controls how many pixels each “box” of the QR code is. The default is 3. +The border parameter controls how many boxes thick the border should be (the default is 4, which is the minimum according to the specs).

+

The version parameter is an integer from 1 to 40 that controls the size of the QR Code (the smallest, version 1, is a 21x21 matrix). Set to None and use the fit parameter when making the code to determine this automatically.

+

fill_color and back_color can change the background and the painting color of the QR, when using the default image factory.

+
+
+

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

+
    +
  • Creu Blanca
    • +
+
+
+

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.

+

This module is part of the OCA/reporting-engine project on GitHub.

+

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

+
+
+
+ + diff --git a/report_qr/static/description/new_qr.png b/report_qr/static/description/new_qr.png new file mode 100644 index 0000000000..6b4848f12f Binary files /dev/null and b/report_qr/static/description/new_qr.png differ diff --git a/report_qr/static/description/old_qr.png b/report_qr/static/description/old_qr.png new file mode 100644 index 0000000000..73958fa995 Binary files /dev/null and b/report_qr/static/description/old_qr.png differ diff --git a/report_qr/tests/__init__.py b/report_qr/tests/__init__.py new file mode 100644 index 0000000000..c7c57bc296 --- /dev/null +++ b/report_qr/tests/__init__.py @@ -0,0 +1 @@ +from . import test_report_qr diff --git a/report_qr/tests/test_report_qr.py b/report_qr/tests/test_report_qr.py new file mode 100644 index 0000000000..56ddf27fc0 --- /dev/null +++ b/report_qr/tests/test_report_qr.py @@ -0,0 +1,18 @@ +# Copyright 2019 Creu Blanca +# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl). + +from odoo.tests.common import HttpCase + + +class TestReportQr(HttpCase): + def test_qr_generation(self): + data = "TEST" + image = self.url_open("/report/qr?value=%s" % data) + self.assertEqual(image.headers["Content-type"], "image/png") + + def test_qr_overflow(self): + """There is a QR limitation for 4296 characters, we will test that an + Exception is raised""" + new_data = "".join(["TEST"] * 1500) + with self.assertRaises(ValueError): + self.env["ir.actions.report"].qr_generate(new_data) diff --git a/setup/_metapackage/VERSION.txt b/setup/_metapackage/VERSION.txt index 255c93bfc6..cff785750e 100644 --- a/setup/_metapackage/VERSION.txt +++ b/setup/_metapackage/VERSION.txt @@ -1 +1 @@ -16.0.20231208.0 \ No newline at end of file +16.0.20240305.0 \ No newline at end of file diff --git a/setup/_metapackage/setup.py b/setup/_metapackage/setup.py index fd65b99ada..536d1286e9 100644 --- a/setup/_metapackage/setup.py +++ b/setup/_metapackage/setup.py @@ -19,6 +19,7 @@ 'odoo-addon-report_label>=16.0dev,<16.1dev', 'odoo-addon-report_py3o>=16.0dev,<16.1dev', 'odoo-addon-report_py3o_fusion_server>=16.0dev,<16.1dev', + 'odoo-addon-report_qr>=16.0dev,<16.1dev', 'odoo-addon-report_qweb_decimal_place>=16.0dev,<16.1dev', 'odoo-addon-report_qweb_element_page_visibility>=16.0dev,<16.1dev', 'odoo-addon-report_qweb_encrypt>=16.0dev,<16.1dev', diff --git a/setup/report_qr/odoo/addons/report_qr b/setup/report_qr/odoo/addons/report_qr new file mode 120000 index 0000000000..aed55d06a4 --- /dev/null +++ b/setup/report_qr/odoo/addons/report_qr @@ -0,0 +1 @@ +../../../../report_qr \ No newline at end of file diff --git a/setup/report_qr/setup.py b/setup/report_qr/setup.py new file mode 100644 index 0000000000..28c57bb640 --- /dev/null +++ b/setup/report_qr/setup.py @@ -0,0 +1,6 @@ +import setuptools + +setuptools.setup( + setup_requires=['setuptools-odoo'], + odoo_addon=True, +)