Metadata-Version: 2.1
Name: odoo-addon-website_sale_variant_extra_fields
Version: 19.0.1.0.0.2
Requires-Dist: odoo==19.0.*
Summary: Show variant fields and more field types in the product page extra fields
Home-page: https://github.com/OCA/e-commerce
License: LGPL-3
Author: Camptocamp, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

================================
Website Sale Variant Extra Field
================================

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

.. |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/license-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-OCA%2Fe--commerce-lightgray.png?logo=github
    :target: https://github.com/OCA/e-commerce/tree/19.0/website_sale_variant_extra_fields
    :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-19-0/e-commerce-19-0-website_sale_variant_extra_fields
    :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=19.0
    :alt: Try me on Runboat

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

The standard *Product Page Extra Fields* configuration lets a website
manager pick product fields to display on the shop product page. It only
supports char and binary fields on the product template, and the
displayed value is read once when the page loads, so it never updates
when the customer switches variants.

This module removes both limitations:

- product variant fields can be selected, in addition to product
  template fields;
- more field types are supported: numbers, dates, datetimes, dropdown
  (selection) values and linked records, in addition to char and binary
  fields;
- when a variant field is selected, its value refreshes live on the
  product page as soon as the customer picks a different combination of
  attributes.

  - decimal numbers are displayed with the number of decimals configured
    for the selected field.

**Table of contents**

.. contents::
   :local:

Usage
=====

1. Go to *Website > Configuration > Settings* and open the *Product Page
   Extra Fields* configuration of the website.
2. Add a line and pick any field of a product or of a product variant.
   Text, file, number, date, date and time, dropdown, and linked record
   fields are available.
3. Go to the shop and open a product page. The label and the value of
   each selected field are displayed below the product details (if the
   field has a value on the displayed product or variant).
4. Select another variant attribute on that page. The values coming from
   a product.variant field are updated immediately, while the values
   coming from a product.template field stay unchanged.

A variant field with no value on the displayed variant is simply hidden,
and appears again as soon as the customer selects a variant that has a
value.

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

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

* Camptocamp

Contributors
------------

- `Camptocamp <https://www.camptocamp.com/>`__:

  - Ricardoalso <ricardo.almeidasoares@camptocamp.com>

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/e-commerce <https://github.com/OCA/e-commerce/tree/19.0/website_sale_variant_extra_fields>`_ project on GitHub.

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