Odoo Community Association

Website Snippet Product Category

Beta License: LGPL-3 OCA/e-commerce Translate me on Weblate Try me on Runboat

Adds a new snippet to show e-commerce categories.

A category is only displayed if it and all of its parent categories are explicitly enabled for the snippet, and can optionally be restricted to selected websites.

Table of contents

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 by setting the data-template attribute directly on the .js_product_category element, e.g. by inheriting the view where the snippet is placed:

<xpath expr="//div[hasclass('js_product_category')]" position="attributes">
    <attribute name="data-template">my_module.my_custom_template</attribute>
</xpath>

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. 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.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Tecnativa

Contributors

  • Tecnativa:
    • Alexandre D. Díaz
    • Pedro M. Baeza
    • Carlos Roca
    • Sergio Teruel
    • Pilar Vargas

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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.

Current maintainer:

Tardo

This module is part of the OCA/e-commerce project on GitHub.

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