Metadata-Version: 2.1
Name: odoo-addon-website_sale_cart_add_product_xlsx_csv
Version: 17.0.1.0.1.6
Requires-Python: >=3.10
Requires-Dist: odoo>=17.0a,<17.1dev
Requires-Dist: openpyxl
Summary: Adds button to import xlsx or csv in website cart
Home-page: https://github.com/OCA/e-commerce
License: AGPL-3
Author: Sygel, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
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 Cart Add Product Xlsx Csv
======================================

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

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

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

This module adds a button in the website cart that let users import a
xlsx or csv file with the products and quantities that he wants to add.

This button is only shown on empty carts, and the file must contain the
product's internal reference and the quantity to buy.

**Table of contents**

.. contents::
   :local:

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

To configure this module, you need to:

- To enable the cart import button, go to Website / Configuration /
  Settings. Then search the "Cart Import Button" and set its value.
- To edit the maximum file size, go to Website / Configuration /
  Settings. Then search the "Cart import button file size limit" and
  edit its value.

Usage
=====

To use this module, you need to:

1. Go to the "/shop/cart" path of your server website. Example:
   "http://localhost:8069/shop/cart"
2. You will see your cart. Empty it if it has products.
3. Click on "Download example file". Fill the xlsx file rows: 3.1. The
   "default_code" column is the internal reference of the product that
   you are going to add to your cart 3.2. The "product_uom_qty" is the
   qty of the product that you are going to add to your cart
4. Select the filled file, and click the "Import" button
5. You will see the cart with the imported products. If some error
   hapened or there are products that could not be imported, the system
   will show a message

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

- Despithe the fact that the cart button is enabled by default, some
  Odoo instances have the website configured to hide it if it is empty.
  If the shopping cart button is hidden without anything in it, the
  functionality cannot be used until something is added to the cart.

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_cart_add_product_xlsx_csv%0Aversion:%2017.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
-------

* Sygel

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

- `Sygel <https://www.sygel.es>`__:

  - Alberto Martínez
  - Valentin Vinagre
  - Harald Panten

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/17.0/website_sale_cart_add_product_xlsx_csv>`_ project on GitHub.

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