diff --git a/report_qweb_decimal_place/README.rst b/report_qweb_decimal_place/README.rst new file mode 100644 index 0000000..a71f8fc --- /dev/null +++ b/report_qweb_decimal_place/README.rst @@ -0,0 +1,90 @@ +========================= +Report Qweb Decimal Place +========================= + +.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! 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-LGPL--3-blue.png + :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html + :alt: License: LGPL-3 +.. |badge3| image:: https://img.shields.io/badge/github-qrtl%2Ffal--custom-lightgray.png?logo=github + :target: https://github.com/qrtl/fal-custom/tree/16.0/report_qweb_decimal_place + :alt: qrtl/fal-custom + +|badge1| |badge2| |badge3| + +This module intends to provide the base function for currencies to adjust the number of decimal places +for the unit price in QWeb reports. +Installing this module alone does not affect the presentation of existing QWeb reports. +Individual adjustments need to be done in separate modules in a manner similar to the following: + +.. code-block:: xml + + + +Background: +~~~~~~~~~~~ + +Odoo default reports display price unit with the decimal accuracy of product price configuration. +However, globally applying the decimal accuracy setting is sometimes not appropriate under multi-currency settings +where how unit prices should be presented differs depending on the currency. + +For example, unit prices in JPY usually do not have decimals (with some exceptions depending on the industry), +while those in USD may require up to 2-4 decimals. If we configure the decimal accuracy based on USD, the unit price +presentation on PDF reports for JPY transactions may appear a bit unconventional. + +**Table of contents** + +.. contents:: + :local: + +Configuration +============= + +To apply price unit format: + +#. Go to Invoicing --> Configuration --> Currencies +#. Check apply_price_decimal_place field +#. Define decimal place in price_decimal_place field + +Inherit this module in your xxx_report_qweb_decimal_place module and format the price unit in reports. + +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 +~~~~~~~ + +* Quartile Limited + +Maintainers +~~~~~~~~~~~ + +This module is part of the `qrtl/fal-custom `_ project on GitHub. + +You are welcome to contribute. diff --git a/report_qweb_decimal_place/__init__.py b/report_qweb_decimal_place/__init__.py new file mode 100644 index 0000000..0650744 --- /dev/null +++ b/report_qweb_decimal_place/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/report_qweb_decimal_place/__manifest__.py b/report_qweb_decimal_place/__manifest__.py new file mode 100644 index 0000000..3c5627e --- /dev/null +++ b/report_qweb_decimal_place/__manifest__.py @@ -0,0 +1,16 @@ +# Copyright 2022 Quartile Limited +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). +{ + "name": "Report Qweb Decimal Place", + "category": "Reporting", + "version": "16.0.1.0.0", + "author": "Quartile Limited", + "website": "https://www.quartile.co", + "license": "LGPL-3", + "depends": ["base"], + "data": [ + "reports/price_unit_value_format.xml", + "views/res_currency_views.xml", + ], + "installable": True, +} diff --git a/report_qweb_decimal_place/models/__init__.py b/report_qweb_decimal_place/models/__init__.py new file mode 100644 index 0000000..ea5a680 --- /dev/null +++ b/report_qweb_decimal_place/models/__init__.py @@ -0,0 +1 @@ +from . import res_currency diff --git a/report_qweb_decimal_place/models/res_currency.py b/report_qweb_decimal_place/models/res_currency.py new file mode 100644 index 0000000..2441e89 --- /dev/null +++ b/report_qweb_decimal_place/models/res_currency.py @@ -0,0 +1,16 @@ +# Copyright 2022 Quartile Limited +# License LGPL-3.0 or later (https://www.gnu.org/licenses/lgpl). + +from odoo import fields, models + + +class ResCurrency(models.Model): + _inherit = "res.currency" + + apply_price_decimal_place = fields.Boolean( + help="Apply this decimal place to the unit price field of relevant PDF reports " + "where appropriate customization is done." + ) + price_decimal_places = fields.Integer( + help="Define decimal places for the unit price field of relevant PDF reports" + ) diff --git a/report_qweb_decimal_place/readme/CONFIGURE.rst b/report_qweb_decimal_place/readme/CONFIGURE.rst new file mode 100644 index 0000000..5cf0072 --- /dev/null +++ b/report_qweb_decimal_place/readme/CONFIGURE.rst @@ -0,0 +1,7 @@ +To apply price unit format: + +#. Go to Invoicing --> Configuration --> Currencies +#. Check apply_price_decimal_place field +#. Define decimal place in price_decimal_place field + +Inherit this module in your xxx_report_qweb_decimal_place module and format the price unit in reports. diff --git a/report_qweb_decimal_place/readme/DESCRIPTION.rst b/report_qweb_decimal_place/readme/DESCRIPTION.rst new file mode 100644 index 0000000..81cd0c0 --- /dev/null +++ b/report_qweb_decimal_place/readme/DESCRIPTION.rst @@ -0,0 +1,28 @@ +This module intends to provide the base function for currencies to adjust the number of decimal places +for the unit price in QWeb reports. +Installing this module alone does not affect the presentation of existing QWeb reports. +Individual adjustments need to be done in separate modules in a manner similar to the following: + +.. code-block:: xml + + + +Background: +~~~~~~~~~~~ + +Odoo default reports display price unit with the decimal accuracy of product price configuration. +However, globally applying the decimal accuracy setting is sometimes not appropriate under multi-currency settings +where how unit prices should be presented differs depending on the currency. + +For example, unit prices in JPY usually do not have decimals (with some exceptions depending on the industry), +while those in USD may require up to 2-4 decimals. If we configure the decimal accuracy based on USD, the unit price +presentation on PDF reports for JPY transactions may appear a bit unconventional. diff --git a/report_qweb_decimal_place/reports/price_unit_value_format.xml b/report_qweb_decimal_place/reports/price_unit_value_format.xml new file mode 100644 index 0000000..f6589d0 --- /dev/null +++ b/report_qweb_decimal_place/reports/price_unit_value_format.xml @@ -0,0 +1,15 @@ + + + + diff --git a/report_qweb_decimal_place/static/description/index.html b/report_qweb_decimal_place/static/description/index.html new file mode 100644 index 0000000..d4ef08e --- /dev/null +++ b/report_qweb_decimal_place/static/description/index.html @@ -0,0 +1,438 @@ + + + + + + +Report Qweb Decimal Place + + + +
+

Report Qweb Decimal Place

+ + +

Beta License: LGPL-3 qrtl/fal-custom

+

This module intends to provide the base function for currencies to adjust the number of decimal places +for the unit price in QWeb reports. +Installing this module alone does not affect the presentation of existing QWeb reports. +Individual adjustments need to be done in separate modules in a manner similar to the following:

+
+<template
+    id="report_saleorder_document_inherit"
+    inherit_id="sale.report_saleorder_document"
+>
+    <xpath expr="//td[@name='td_priceunit']/span" position="replace">
+            <t t-set="currency" t-value="doc.currency_id" />
+            <t t-set="price_unit" t-value="line.price_unit" />
+            <t t-call="report_qweb_decimal_place.price_unit_value_format" />
+    </xpath>
+</template>
+
+
+

Background:

+

Odoo default reports display price unit with the decimal accuracy of product price configuration. +However, globally applying the decimal accuracy setting is sometimes not appropriate under multi-currency settings +where how unit prices should be presented differs depending on the currency.

+

For example, unit prices in JPY usually do not have decimals (with some exceptions depending on the industry), +while those in USD may require up to 2-4 decimals. If we configure the decimal accuracy based on USD, the unit price +presentation on PDF reports for JPY transactions may appear a bit unconventional.

+

Table of contents

+ +
+

Configuration

+

To apply price unit format:

+
    +
  1. Go to Invoicing –> Configuration –> Currencies
    2. +
  2. Check apply_price_decimal_place field
    3. +
  3. Define decimal place in price_decimal_place field
    4. +
+

Inherit this module in your xxx_report_qweb_decimal_place module and format the price unit in reports.

+
+
+

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.

+
+ +
+
+

Authors

+
    +
  • Quartile Limited
    • +
+
+
+

Maintainers

+

This module is part of the qrtl/fal-custom project on GitHub.

+

You are welcome to contribute.

+
+
+ + diff --git a/report_qweb_decimal_place/views/res_currency_views.xml b/report_qweb_decimal_place/views/res_currency_views.xml new file mode 100644 index 0000000..cba49df --- /dev/null +++ b/report_qweb_decimal_place/views/res_currency_views.xml @@ -0,0 +1,17 @@ + + + + res.currency + res.currency + + + + + + + + + diff --git a/setup/report_qweb_decimal_place/odoo/addons/report_qweb_decimal_place b/setup/report_qweb_decimal_place/odoo/addons/report_qweb_decimal_place new file mode 120000 index 0000000..73d2a48 --- /dev/null +++ b/setup/report_qweb_decimal_place/odoo/addons/report_qweb_decimal_place @@ -0,0 +1 @@ +../../../../report_qweb_decimal_place \ No newline at end of file diff --git a/setup/report_qweb_decimal_place/setup.py b/setup/report_qweb_decimal_place/setup.py new file mode 100644 index 0000000..28c57bb --- /dev/null +++ b/setup/report_qweb_decimal_place/setup.py @@ -0,0 +1,6 @@ +import setuptools + +setuptools.setup( + setup_requires=['setuptools-odoo'], + odoo_addon=True, +)