Metadata-Version: 2.1
Name: odoo-addon-website_snippet_product_category
Version: 18.0.1.1.0.3
Requires-Python: >=3.10
Requires-Dist: odoo==18.0.*
Summary: Adds a new snippet to show e-commerce categories
Home-page: https://github.com/OCA/e-commerce
License: LGPL-3
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
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 Snippet Product Category
================================

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

.. |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/18.0/website_snippet_product_category
    :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-18-0/e-commerce-18-0-website_snippet_product_category
    :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=18.0
    :alt: Try me on Runboat

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

Adds a new snippet to show e-commerce categories.

The snippet only displays categories explicitly enabled for it, and can
optionally restrict them to selected websites.

**Table of contents**

.. contents::
   :local:

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

You can select what categories can be shown by the snippet and an image
for the category:

1. Go to website > eCommerce > eCommerce Categories
2. Create or Edit one
3. You can see a new options "Published in product category snippet"
4. You can also set "Websites for category snippet" to restrict where
   the category is shown in the snippet. Leave it empty to show it on
   all websites.

Usage
=====

1. Go to website (frontend)
2. Press 'Edit' button
3. Drag the 'Product Category' snippet to the place of the website that
   you want
4. Save changes

Theming
-------

CSS Classes:

- ``.categ_container`` > The container per master category
- ``.categ_scroll_wrapper`` > The scrollable container wrapper
- ``.categ_scroll`` > The scrollable container
- ``.categ_tree_level`` > The category row (image + text)
- ``.main_tree_level`` > The first category row level displayed
- ``.categ_link`` > The link of the category row
- ``.categ_img`` > The container of the icon of the category row

You can use 'data-tree-level' attribute to select the category row of a
selected level (1-4 by design).

Also you can replace the entire template replacing the ``data-template``
attribute value in the ``s_product_category_options`` view. You only
need know that the name of the variable that have all the categories is
called ``object``.

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

- The snippet shows a maximum of 4 levels by design.
- Add a option to configure the initial level
- Add a option to select how many levels can be represented
- Handle large amounts of categories

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_snippet_product_category%0Aversion:%2018.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
-------

* Tecnativa

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

- `Tecnativa <https://www.tecnativa.com>`__:

  - Alexandre D. Díaz
  - Pedro M. Baeza
  - Carlos Roca
  - Sergio Teruel
  - Pilar Vargas

Other credits
-------------

static/img/boxes_32.png - https://www.iconninja.com/box-mario-icon-30561

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.

.. |maintainer-Tardo| image:: https://github.com/Tardo.png?size=40px
    :target: https://github.com/Tardo
    :alt: Tardo

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-Tardo| 

This module is part of the `OCA/e-commerce <https://github.com/OCA/e-commerce/tree/18.0/website_snippet_product_category>`_ project on GitHub.

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