Metadata-Version: 2.1
Name: odoo-addon-product_multi_image
Version: 15.0.1.0.0.8
Summary: Multiple Images in Products
Home-page: https://github.com/OCA/product-attribute
Author: Antiun Ingeniería, Tecnativa, LasLabs, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 15.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Requires-Python: >=3.8
Requires-Dist: odoo-addon-base-multi-image<15.1dev,>=15.0dev
Requires-Dist: odoo<15.1dev,>=15.0a

===========================
Multiple Images in Products
===========================

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

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

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

This module implements the possibility to have multiple images for a product
template, a.k.a. an image gallery.

**Table of contents**

.. contents::
   :local:

Installation
============

To install this module, you need to:

* Install ``base_multi_image`` from
  `OCA/server-tools <https://github.com/OCA/server-tools>`_.

Configuration
=============

You can manage your images at Product template level:

#. Go to *Sales > Products > Products* and choose a product template.
#. Go to the *Images* tab.
#. Add a new image or edit the existing ones.
#. You can select for which variants you want to make available the image.
   Keep it empty for making visible in all.
#. Refresh the page.
#. The first image in the collection is the main image for the product
   template.

Going to product variants form, you can manage also your images, but take
into account this behaviour:

#. Go to *Sales > Products > Product Variants* and choose a product variant.
#. If you add an image here, the image is actually added to the product
   template, and restricted to this variant.
#. When editing an existing image, the image is changed generally for all
   the variants where is enabled, not only for this variant.
#. When removing an image from this form, if the image is only in this variant,
   the image is removed. Otherwise, the image gets restricted to the rest of
   the variants where is available.

.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
   :alt: Try me on Runbot
   :target: https://runbot.odoo-community.org/runbot/135/9.0

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

* When you change the image on the product variant, the preview image of the
  *Images* tab doesn't get refreshed until you refresh the browser, or if you
  go to its template, but the image has been actually saved!
* The field "Available in these variants" appears when opening the image
  from the product variant.
* Add logic for handling to add images with the same name that another variant
  of the same template, renaming the new image to a unique name.
* Add logic for handling to add the same image in several variants to a
  already in another variant for not duplicating bytes.
* Provide proper migration scripts from module product_images from 7.0.
* Migrate to v8 api when https://github.com/odoo/odoo/issues/10799 gets fixed.
* If you try to sort images before saving the product variant or template, you
  will get an error similar to ``DataError: invalid input syntax for integer:
  "one2many_v_id_62"``. This bug has not been fixed yet, but a workaround is to
  save and edit again to sort images.

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

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

* Antiun Ingeniería
* Tecnativa
* LasLabs

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

* Pedro M. Baeza <pedro.baeza@serviciosbaeza.com>
* Rafael Blasco <rafabn@antiun.com>
* Jairo Llopis <yajo.sk8@gmail.com>
* Dave Lasley <dave@laslabs.com>
* Shepilov Vladislav <shepilov.v@protonmail.com>
* Marc Poch Mallandrich <mpoch@planetatic.com>
* Hai Lang <hailn@trobz.com>
* `Greenice <https://www.greenice.com>`_:

  * Fernando La Chica <fernandolachica@gmail.com>

Other credits
~~~~~~~~~~~~~

* The migration of this module from 12.0 to 14.0 was financially supported by
  Camptocamp.

Original implementation
-----------------------
* This module is inspired in previous module *product_images* from OpenLabs
  and Akretion.

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/product-attribute <https://github.com/OCA/product-attribute/tree/15.0/product_multi_image>`_ project on GitHub.

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