diff --git a/report_qr/README.rst b/report_qr/README.rst new file mode 100644 index 000000000..31226efeb --- /dev/null +++ b/report_qr/README.rst @@ -0,0 +1,111 @@ +============== +Web QR Manager +============== + +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! 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%2Freporting--engine-lightgray.png?logo=github + :target: https://github.com/OCA/reporting-engine/tree/14.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-14-0/reporting-engine-14-0-report_qr + :alt: Translate me on Weblate +.. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png + :target: https://runbot.odoo-community.org/runbot/143/14.0 + :alt: Try me on Runbot + +|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/14.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/14.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 smashing 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 000000000..91c5580fe --- /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 000000000..6866fbfa0 --- /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": "15.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 000000000..da6b5392e --- /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 000000000..f5760deb3 --- /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/report_qr.pot b/report_qr/i18n/report_qr.pot new file mode 100644 index 000000000..d721c9148 --- /dev/null +++ b/report_qr/i18n/report_qr.pot @@ -0,0 +1,34 @@ +# Translation of Odoo Server. +# This file contains the translation of the following modules: +# * report_qr +# +msgid "" +msgstr "" +"Project-Id-Version: Odoo Server 14.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.fields,field_description:report_qr.field_ir_actions_report__display_name +msgid "Display Name" +msgstr "" + +#. module: report_qr +#: model:ir.model.fields,field_description:report_qr.field_ir_actions_report__id +msgid "ID" +msgstr "" + +#. module: report_qr +#: model:ir.model.fields,field_description:report_qr.field_ir_actions_report____last_update +msgid "Last Modified on" +msgstr "" + +#. 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 000000000..a248cf216 --- /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 000000000..ccad9b58c --- /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 000000000..ba55fe73f --- /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 000000000..e4e45291b --- /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 000000000..365558ad6 --- /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 000000000..3a0328b51 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 000000000..7d96dca42 --- /dev/null +++ b/report_qr/static/description/index.html @@ -0,0 +1,450 @@ + + + + + + +Web QR Manager + + + +
+

Web QR Manager

+ + +

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

+

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 smashing 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 000000000..6b4848f12 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 000000000..73958fa99 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 000000000..c7c57bc29 --- /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 000000000..56ddf27fc --- /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/report_qr/odoo/addons/report_qr b/setup/report_qr/odoo/addons/report_qr new file mode 120000 index 000000000..aed55d06a --- /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 000000000..28c57bb64 --- /dev/null +++ b/setup/report_qr/setup.py @@ -0,0 +1,6 @@ +import setuptools + +setuptools.setup( + setup_requires=['setuptools-odoo'], + odoo_addon=True, +)