==============
Web Widget UoM
==============

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:38dfa2cf8bbebca8a11c8b661e1ea517e57629a7a8171ae82f049f2eec42c941
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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%2Fweb-lightgray.png?logo=github
    :target: https://github.com/OCA/web/tree/14.0/web_widget_uom
    :alt: OCA/web
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/web-14-0/web-14-0-web_widget_uom
    :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/web&target_branch=14.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module allows the user to decide maximum
how many decimal places should be displayed in the Odoo User
Interface for each Unit of Measure.

If "Show only inputed decimals" is enabled on the UoM,
the widget will show inputed decimals up to Decimal Places.

**Table of contents**

.. contents::
   :local:

Usage
=====

In the UoM form view specify the number of decimal places that
should be displayed for each unit of Measure:

.. image:: https://raw.githubusercontent.com/OCA/web/14.0/web_widget_uom/static/description/UoMDecimalPlaces.png
   :alt: Decimal Places in UoM form view

In the view declaration, put widget='uom' attribute in the field tag::

    ...
    <field name="arch" type="xml">
        <tree string="View name">
            ...
            <field name="product_qty" widget="uom"/>
            ...
        </tree>
    </field>
    ...
    <field name="arch" type="xml">
        <form string="View name">
            ...
            <field name="product_qty" widget="uom"/>
            ...
        </form>
    </field>
    ...

Widget Options::

    ...
    <field name="arch" type="xml">
        <tree string="View name">
            ...
            <field name="product_qty" widget="uom" options="{'uom_field': 'product_uom'}"/>
            ...
        </tree>
    </field>
    ...

If the UoM field in the model is not declared under the name uom_id, the
option uom_field must be specified with the appropriate field name.

Known issues / Roadmap
======================

TODO

1. Add caching by uom.id

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/web/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/web/issues/new?body=module:%20web_widget_uom%0Aversion:%2014.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
~~~~~~~

* Giovanni Serra

Contributors
~~~~~~~~~~~~

* Adria Gil Sorribes <adria.gil@eficent.com>
* Giovanni Serra <giovanni@gslab.it>

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/web <https://github.com/OCA/web/tree/14.0/web_widget_uom>`_ project on GitHub.

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