diff --git a/content/applications/sales/sales/products_prices/products/variants.rst b/content/applications/sales/sales/products_prices/products/variants.rst index 162edd9471..e4ae6d31ef 100644 --- a/content/applications/sales/sales/products_prices/products/variants.rst +++ b/content/applications/sales/sales/products_prices/products/variants.rst @@ -28,12 +28,12 @@ within the Odoo *Sales* application. other similar records in Odoo. .. seealso:: - :ref:`ecommerce/products/product-variants` + :ref:`Product variants in the eCommerce shop ` Configuration ============= -To use product variants, the *Variants* setting **must** be activated in the Odoo *Sales* +To use product variants, the :guilabel:`Variants` setting **must** be activated in the Odoo *Sales* application. To do that, go to :menuselection:`Sales app --> Configuration --> Settings`, and locate the @@ -47,6 +47,8 @@ In that section, check the box to enable the :guilabel:`Variants` feature. Then, click :guilabel:`Save` at the top of the :guilabel:`Settings` page. +.. _products/variants/attributes: + Attributes ========== @@ -61,7 +63,6 @@ To create a new attribute from the :guilabel:`Attributes` page, click :guilabel: reveals a blank attributes form that can be customized and configured in a number of ways. .. image:: variants/attribute-creation.png - :align: center :alt: A blank attribute creation form in the Odoo Sales application. First, create an :guilabel:`Attribute Name`, such as `Color` or `Size`. @@ -70,71 +71,73 @@ Next, select one of the options from the :guilabel:`Display Type` field. The :gu Type` determines how this product is shown on the online store, *Point of Sale* dashboard, and *Product Configurator*. -The :guilabel:`Display Type` options are: +The following :guilabel:`Display Type` options are available. -- :guilabel:`Pills`: options appear as selectable buttons on the product page of the online store. -- :guilabel:`Color`: options appear as small, colored squares, which reflect any HTML color codes -- :guilabel:`Radio`: options appear in a bullet-style list on the product page of the online store. -- :guilabel:`Select`: options appear in a drop-down menu on the product page of the online store. - set, on the product page of the online store. -- :guilabel:`Multi-checkbox (option)`: options appear as selectable checkboxes on the product page - of the online store. This allows customers to choose options for themselves and is good choice for - highly customizable products. +.. tabs:: -.. image:: variants/display-types.png - :align: center - :alt: Display Types on Product Configurator on the online store in Odoo. + .. tab:: :guilabel:`Pills` + + Options appear as selectable buttons. + + .. image:: variants/pills-display-type.png + :alt: Pills display type + + .. tab:: :guilabel:`Color` + + Options appear as small, colored circles, which reflect any HTML color codes. + + .. image:: variants/color-display-type.png + :alt: Pills display type + + .. tab:: :guilabel:`Radio` + + Options appear in a bullet-style list. + + .. image:: variants/radio-display-type.png + :alt: Pills display type + + .. tab:: :guilabel:`Select` + + Options appear in a drop-down menu. + + .. image:: variants/select-display-type.png + :alt: Pills display type + + .. tab:: :guilabel:`Image` -The :guilabel:`Variant Creation Mode` field informs Odoo when to automatically create a new variant + Options appear as images. + + .. image:: variants/image-display-type.png + :alt: Pills display type + + .. tab:: :guilabel:`Multi-checkbox` + + Options appear as selectable checkboxes. This allows customers to choose options for + themselves and is good choice for highly customizable products + + .. image:: variants/multi-checkbox-display-type.png + :alt: Pills display type + +The :guilabel:`Variant Creation` field informs Odoo when to automatically create a new variant once an attribute is added to a product. .. note:: - The :guilabel:`Variant Creation Mode` field **must** be set to :guilabel:`Never (option)` in - order for the :guilabel:`Multi-checkbox (option)` to work properly as the :guilabel:`Display + The :guilabel:`Variant Creation` field **must** be set to :guilabel:`Never` in + order for the :guilabel:`Multi-checkbox` to work properly as the :guilabel:`Display Type`. - :guilabel:`Instantly`: creates all possible variants as soon as attributes and values are added to a product template. - :guilabel:`Dynamically`: creates variants **only** when corresponding attributes and values are added to a sales order. -- :guilabel:`Never (option)`: never automatically creates variants. +- :guilabel:`Never`: never automatically creates variants. .. warning:: - Once added to a product, an attribute's :guilabel:`Variants Creation Mode` cannot be edited. - -The :guilabel:`eCommerce Filter Visibility` field determines whether or not these attribute options -are visible to the customer on the front-end, as they shop on the online store. - -- :guilabel:`Visible`: the attribute values are visible to customers on the front-end. -- :guilabel:`Hidden`: the attribute values are hidden from customers on the front-end. - -Lastly, in the optional :guilabel:`eCommerce Category` field, select a category from a drop-down -menu to group similar attributes under the same section for added specificity and organization. - -.. note:: - To view the details related to the attribute category selected, click the internal link - :icon:`fa-arrow-right` :guilabel:`(right arrow)` icon to the far-right of the - :guilabel:`eCommerce Category` field, once an option has been selected. Doing so reveals that - attribute category's detail form. - - .. image:: variants/attribute-category-internal-link.png - :align: center - :alt: A standard attribute category detail page accessible via its internal link arrow icon. - - Here, the :guilabel:`Category Name` and :guilabel:`Sequence` is displayed at the top. Followed by - :guilabel:`Related Attributes` associated with the category. These attributes can be - dragged-and-dropped into a desirable order of priority. - - Attributes can be directly added to the category, as well, by clicking :guilabel:`Add a line`. + Once added to a product, an attribute's :guilabel:`Variants Creation` mode cannot be edited. .. tip:: - To create an attribute category directly from this field, start typing the name of the new - category, then select either :guilabel:`Create` or :guilabel:`Create and edit...` from the - drop-down menu that appears. - - Clicking :guilabel:`Create` creates the category, which can be modified later. Clicking - :guilabel:`Create and edit...` creates the category and reveals a :guilabel:`Create Category` - pop-up window, in which the new attribute category can be configured and customized. + Configure some :ref:`ecommerce-specific ` + settings for attributes. Attribute values ---------------- @@ -170,12 +173,12 @@ Or, choose a specific color by clicking the *dropper* icon, and selecting a desi currently clickable on the screen. Businesses can attach images to product variant attribute values for customers to view on an -eCommerce webite. To do so, click the :icon:`fa-camera` :guilabel:`(camera)` icon, then click the +eCommerce website. To do so, click the :icon:`fa-camera` :guilabel:`(camera)` icon, then click the :icon:`fa-pencil` :guilabel:`(pencil)` icon and select an image from your local drive. This image -will appear as a color option on the ecommerce product page. +will appear as a color option for the relevant product. -.. image:: variants/ecommerce-pattern-option.png - :alt: Pattern as color option on the ecommerce page. +.. image:: variants/pattern-display.png + :alt: Pattern as color option. .. tip:: Attributes can also be created directly from the product template by adding a new line and typing @@ -258,6 +261,8 @@ In the :guilabel:`Exclude for` field, different :guilabel:`Product Templates` an :guilabel:`Attribute Values` can be added. When added, this specific attribute value will be excluded from those specific products. +.. _products/variants/variants-smart-button: + Variants smart button --------------------- diff --git a/content/applications/sales/sales/products_prices/products/variants/attribute-creation.png b/content/applications/sales/sales/products_prices/products/variants/attribute-creation.png index 6995f3c3c3..39539fe881 100644 Binary files a/content/applications/sales/sales/products_prices/products/variants/attribute-creation.png and b/content/applications/sales/sales/products_prices/products/variants/attribute-creation.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/color-display-type.png b/content/applications/sales/sales/products_prices/products/variants/color-display-type.png new file mode 100644 index 0000000000..6e5dc25e6f Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/color-display-type.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/display-types.png b/content/applications/sales/sales/products_prices/products/variants/display-types.png deleted file mode 100644 index 0eeb30d6ef..0000000000 Binary files a/content/applications/sales/sales/products_prices/products/variants/display-types.png and /dev/null differ diff --git a/content/applications/sales/sales/products_prices/products/variants/image-display-type.png b/content/applications/sales/sales/products_prices/products/variants/image-display-type.png new file mode 100644 index 0000000000..c5dd035072 Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/image-display-type.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/multi-checkbox-display-type.png b/content/applications/sales/sales/products_prices/products/variants/multi-checkbox-display-type.png new file mode 100644 index 0000000000..aefd34b2e1 Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/multi-checkbox-display-type.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/pattern-display.png b/content/applications/sales/sales/products_prices/products/variants/pattern-display.png new file mode 100644 index 0000000000..cc805c11f9 Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/pattern-display.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/pills-display-type.png b/content/applications/sales/sales/products_prices/products/variants/pills-display-type.png new file mode 100644 index 0000000000..1aec3631fd Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/pills-display-type.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/radio-display-type.png b/content/applications/sales/sales/products_prices/products/variants/radio-display-type.png new file mode 100644 index 0000000000..f37bbc8f07 Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/radio-display-type.png differ diff --git a/content/applications/sales/sales/products_prices/products/variants/select-display-type.png b/content/applications/sales/sales/products_prices/products/variants/select-display-type.png new file mode 100644 index 0000000000..d6411993da Binary files /dev/null and b/content/applications/sales/sales/products_prices/products/variants/select-display-type.png differ diff --git a/content/applications/websites/ecommerce/google_merchant_center.rst b/content/applications/websites/ecommerce/google_merchant_center.rst index 00bd02f4df..7350488ecb 100644 --- a/content/applications/websites/ecommerce/google_merchant_center.rst +++ b/content/applications/websites/ecommerce/google_merchant_center.rst @@ -70,7 +70,7 @@ Linking Odoo to GMC #. Click :guilabel:`Manage feeds`. #. In the :guilabel:`Product Feeds` pop-up window, select a :ref:`pricelist `, a :ref:`language ` and :ref:`categories - `, and :guilabel:`Save`. + `, and :guilabel:`Save`. .. note:: You must first enable the corresponding :doc:`language ` diff --git a/content/applications/websites/ecommerce/products.rst b/content/applications/websites/ecommerce/products.rst index 5e00388163..b6c89def3c 100644 --- a/content/applications/websites/ecommerce/products.rst +++ b/content/applications/websites/ecommerce/products.rst @@ -6,9 +6,8 @@ Products **Odoo eCommerce** allows you to :ref:`add products ` and manage your :ref:`product pages ` directly from the Website app. It also -allows you to add :ref:`product variants ` and -:ref:`digital files `, :ref:`translating -` the product page content, and :ref:`managing stock +allows you to add :ref:`digital files `, :ref:`translate +` the product page content, and :ref:`manage the stock `. .. _ecommerce/products/add-products: @@ -74,9 +73,11 @@ Product information To add general information about a product, navigate to :menuselection:`Website --> eCommerce --> Products` and select the product. You can configure the product page from the form -by adding :ref:`variants `, :ref:`digital documents +by adding :ref:`variants `, :ref:`digital documents `, or :ref:`translating ` content. +.. _ecommerce/products/description: + You can also add an ecommerce-specific product description to be displayed below the product name on the product's page. To do so, go to the :guilabel:`Sales` tab, scroll down to the :guilabel:`Ecommerce description` section, and add a description. Use Odoo's @@ -124,7 +125,7 @@ Use the :guilabel:`Customize` tab to modify the page layout or add features: :ref:`VAT included or excluded `. - :guilabel:`Variants`: Show all possible product :ref:`variants - ` vertically as a :guilabel:`Products List` + ` vertically as a :guilabel:`Products List` or horizontally as selectable :guilabel:`Options` to compose the variant yourself. - :guilabel:`Product Tags`: Toggle the switch to display the :guilabel:`Product Template Tags` on @@ -143,7 +144,7 @@ Use the :guilabel:`Customize` tab to modify the page layout or add features: - :guilabel:`Specification`: Select :guilabel:`Bottom of Page` to display a detailed list of the attributes and their values available for the product. This option only works for products with - :ref:`variants ` if the + :ref:`variants ` if the :ref:`Product comparison tool ` is enabled in the Website :guilabel:`Settings`. @@ -185,64 +186,6 @@ and select the relevant media. In the :guilabel:`Customize` tab, use the followi .. note:: Images must be in PNG or JPG format and with a minimum size of 1024x1024 to trigger the zoom. -.. _ecommerce/products/products-block: - -Products block -============== - -The :guilabel:`Products` :doc:`building block <../website/web_design/building_blocks>` is used to -display a selection of products sold on your website. - -.. image:: products/products-block.png - :alt: Example of a products block - -By default, the block displays the :guilabel:`Newest Products`. To change which products are shown, -go to the :guilabel:`Customize` tab's :guilabel:`Products` section and set the :guilabel:`Filter` -field to :guilabel:`Recently Sold Products` or :guilabel:`Recently Viewed Products`. - -In addition, it is possible to display products from a specific category only using the -:guilabel:`Category` field. - -You can also filter products by :guilabel:`Tags`, include :guilabel:`Variants`, and adjust the -display by selecting a different :guilabel:`Template`. - -.. _ecommerce/products/product-variants: - -Product variants -================ - -:doc:`Product variants <../../sales/sales/products_prices/products/variants>` are different versions -of the same product, such as various colors or materials, with potential differences in price and -availability. - -To configure product variants for a product: - -#. Go to :menuselection:`Website --> Configuration --> Settings`. -#. Scroll down to the :guilabel:`Shop - Products` section and enable the - :guilabel:`Product Variants` feature. -#. Access the :ref:`product forms ` and go to the - :guilabel:`Attributes & Variants` tab, where you can add attributes and values, allowing - customers to configure and select product variants on the product page. For multiple attributes, - you can combine them to create specific variants. - -To display or hide an attribute on the :guilabel:`Shop` page and allow visitors to filter them, -go to :menuselection:`Website --> eCommerce --> Attributes`, click on the attribute, and select -:guilabel:`Visible` or :guilabel:`Hidden` in the :guilabel:`eCommerce Filter Visibility` field. - -.. tip:: - - To display the product attributes in the :doc:`product catalog `, - set the :guilabel:`Attributes` feature to :guilabel:`Left` using the website editor. - - To group attributes under the same section when - :ref:`comparing products `, go to - the :guilabel:`eCommerce Category` field and either select an :doc:`existing category or create - a new one <../../websites/ecommerce/products>`. - -.. note:: - Two attribute values are needed to make the filter visible. - -.. seealso:: - :doc:`Product variants <../../sales/sales/products_prices/products/variants>` - .. _ecommerce/products/digital-files: Digital files @@ -315,8 +258,12 @@ To set the product's website availability, navigate to the :ref:`product form available on. Leave the field blank to make the product available on *all* websites. .. note:: - You can make a product available on either *one* website or *all* websites, but selecting only - *some* websites is not possible. + - You can make a product available on either *one* website or *all* websites, but selecting only + *some* websites is not possible. To use it on *several* specific websites, but not all of your + websites, you must duplicate the product for each website on which you want to sell it, and + assign the relevant website to each duplicate. + - Enable the :guilabel:`Is Published` toggle to make sure the product is available for website + visitors. .. _ecommerce/products/stock-management: @@ -351,3 +298,4 @@ In the :guilabel:`Inventory Defaults` sub-section, fill in those fields: products/prices products/cross_upselling products/additional_features + products/categories_variants diff --git a/content/applications/websites/ecommerce/products/additional_features.rst b/content/applications/websites/ecommerce/products/additional_features.rst index 3e95443462..b6580d2324 100644 --- a/content/applications/websites/ecommerce/products/additional_features.rst +++ b/content/applications/websites/ecommerce/products/additional_features.rst @@ -13,7 +13,7 @@ Product comparison ================== The :icon:`fa-exchange` (:guilabel:`Add to compare`) button allows website visitors to compare -products based on their :ref:`attributes `. Customers can +products based on their :ref:`attributes `. Customers can click this button to select the products they wish to compare, then click :guilabel:`Compare` in the pop-up window at the bottom of the page to see the comparison summary. @@ -139,7 +139,7 @@ the ecommerce products. :alt: Create a new ribbon in the website editor - It is also possible to add ribbons for specific :ref:`product variants - `. To do so, go to :menuselection:`Website --> + `. To do so, go to :menuselection:`Website --> eCommerce --> Products` and select a product. Click the :guilabel:`Variants` smart button, choose a variant, and add a ribbon in the :guilabel:`Variant Ribbon` field of the :guilabel:`Sales` section. diff --git a/content/applications/websites/ecommerce/products/catalog.rst b/content/applications/websites/ecommerce/products/catalog.rst index 61aa0c7cce..cf8ec04202 100644 --- a/content/applications/websites/ecommerce/products/catalog.rst +++ b/content/applications/websites/ecommerce/products/catalog.rst @@ -1,203 +1,238 @@ -======= -Catalog -======= +=============== +Product catalog +=============== The eCommerce catalog displays products for customers to browse. It is organized using product -categories, available options, sorting, and navigation paths. Essentially, the eCommerce catalog -is the shop page of your website. +categories, available product variants, sorting options, and navigation paths. Essentially, the +eCommerce catalog is the shop page of your website. The product catalog includes a :ref:`top bar `, a :ref:`side panel `, and a :ref:`product listing area -`. With Odoo, you can :ref:`customize the layout -`, and filter by :ref:`categories and attributes -`. +`. Additionally, the :ref:`layout +` can be customized per shop and category, and you can add +:ref:`building blocks `. -You can customize the shop page using the website editor. To access it, go to the shop page, -click :guilabel:`Edit` in the upper-right corner, and navigate to the :guilabel:`Customize` tab. +To customize it, go to the shop page, click :guilabel:`Edit` in the upper-right corner, select the +section you want to change, and navigate to the :guilabel:`Style` tab. .. _ecommerce/catalog/top-bar: Top bar ======= -The top bar can include a search bar, a currency selector, -:ref:`sort-by and display options `, and -:ref:`category quick access `. - -.. _ecommerce/catalog/sort-by-and-display-option: - -Sort-by search and display options ----------------------------------- - -You can toggle the :guilabel:`Search Bar`, display :ref:`categories ` -and/or :ref:`attributes `, and enable or disable the -:guilabel:`Sort-By` as well as the :ref:`Layout ` buttons in -the :guilabel:`Top Bar`. +It possible to display a search bar or sort-by options in the top bar of the shop page by toggling +the :guilabel:`Sort By` and/or :guilabel:`Search` buttons next to the :guilabel:`Toolbar` label. +Enable the :guilabel:`Floating` switch to make those options follow you when scrolling, and select +a :guilabel:`Default Sort` option: -The :guilabel:`Sort-by` button is toggled by default, and customers can choose between the -following :guilabel:`Default Sort` options: - -- :guilabel:`None` - :guilabel:`Featured` - :guilabel:`Newest Arrivals` - :guilabel:`Name (A-Z)` - :guilabel:`Price - Low to High` - :guilabel:`Price - High to Low` -The default sort applies to *all* :ref:`categories `. +To create a :ref:`category ` quick access in the top bar, +click the :guilabel:`Top` button next to :guilabel:`Categories`, and choose a :guilabel:`Style` +for them. .. tip:: - If you don't want to display a top bar or :ref:`side panel `, - you can disable all related options in the website editor. + - The default sort applies to *all* :ref:`categories `. + - If you do not want to display a top bar or :ref:`side panel `, + disable all related options in the website editor, and make sure to only assign one pricelist + to the website. .. _ecommerce/catalog/side-panel: Side panel ========== -The side panel provides advanced filtering tools to organize your product categories. -To further :ref:`categorize ` the shop page, you can activate -various filters, such as the :ref:`attribute ` filter. +The side panel provides advanced filtering tools to organize the catalog. -You can also add a :guilabel:`Datepicker` option to display a date range calendar to check -the availability of rental products over a specific period. The :doc:`Rental app -<../../../sales/rental>` must be installed to use this feature. +Enable :guilabel:`Filters` in the :guilabel:`Sidebar`, or set the :guilabel:`Filters` option to +:guilabel:`Off-screen menu` to add a :icon:`fa-sliders` :guilabel:`Filters` button that displays a +filters bar when clicked. You can also :guilabel:`Hide` it entirely. -It is also possible to toggle the :guilabel:`Collapsible sidebar` switch to make the side panel -manually collapsible. +By default, there are two :guilabel:`Filters` enabled: -.. tip:: - To use a price range or tags filter, you have to enable :ref:`attributes - ` first. + - :guilabel:`Price`: Use the switch to display a :guilabel:`Price Range` bar, which + allows customers to filter products according to a specific price range by dragging adjustable + handles. + - :guilabel:`Tags`: Toggle the switch to display product :guilabel:`Tags` on the shop page, and + allow customers to filter products using those tags by going to the + :guilabel:`Tags` section in the side panel. -.. _ecommerce/catalog/categories: + .. tip:: + To create product tags on your e-commerce, go to :menuselection:`eCommerce --> Product Tags`, + and click :guilabel:`New`. Add a :guilabel:`Tag` name, toggle the :guilabel:`Visible to + customers` switch, and choose a :guilabel:`Color`. Optionally, add an image. -Product categorization in catalog -================================= +You can also add a :guilabel:`Rental Date` option to display a date range calendar to check +the availability of rental products over a specific period. The :doc:`Rental app +<../../../sales/rental>` must be installed to use this feature. -eCommerce categories are used to organize products into groups, making it easier for customers -to browse the online store. +To display :ref:`categories ` in the side panel, enable +the :guilabel:`Sidebar` option next to :guilabel:`Categories`. When selected, the option +:guilabel:`Collapse Category Recursive` appears, allowing you to collapse the category in the side +panel. -To create eCommerce categories, go to :menuselection:`Website --> eCommerce --> -eCommerce Categories`, and click :guilabel:`New`. On the category form, add a -:guilabel:`Name`, optionally enter a :guilabel:`Parent Category`, and write a :guilabel:`Category -Description`, if needed. +.. note:: + The category filters located in the sidebar work autonomously, and are not affected by the + :guilabel:`Filters` setting. -To use eCommerce categories, go to :menuselection:`Website --> eCommerce --> Products`, select -the product you wish to modify, go to the :guilabel:`Sales` tab, navigate to the -:guilabel:`Ecommerce shop` section, and select the :guilabel:`Categories` it belongs to. +Attributes +---------- -.. note:: - A single product can belong to multiple eCommerce categories. +When you offer :ref:`product variants ` with +different :ref:`attributes `, those options appear +in the side panel when the :guilabel:`Filters` setting is enabled. The side panel automatically +adapts to the number of attribute sections: -Once the categories are configured and assigned to the relevant products, go to the main shop page -and open the website editor. In the :guilabel:`Categories` option, you can either enable -a menu on the :guilabel:`Left`, i.e., in the :ref:`side panel `, -or on the :guilabel:`Top`, i.e., in the :ref:`top bar `, or both. -If you select the :guilabel:`Left` category, the option :guilabel:`Collapsible Category Recursive` -appears, allowing you to collapse the category in the side panel. +- **Up to 4 attributes**: all the attribute values are displayed. +- **More than 4 attributes**: the sections are automatically collapsed. -.. image:: catalog/catalog-panel-categories.png - :alt: Categories options for your eCommerce website +For :guilabel:`Radio` and :guilabel:`Select` :ref:`display types `, +a :guilabel:`View More` button appears when there are more than **8** values, and a search field +when the number of values exceeds **20**. + +.. note:: + - At least two attribute values are required for the filter to be visible. + - The attribute filters located in the sidebar do not work autonomously, and are affected by the + :guilabel:`Filters` setting. .. seealso:: - :doc:`../products` + - :doc:`../../../sales/sales/products_prices/products/variants` + - :doc:`categories_variants` -.. _ecommerce/catalog/attributes: +.. _ecommerce/catalog/product-listing: -Attributes ----------- +Product listing area +==================== -Attributes refer to characteristics of a product, such as the color or material, whereas -variants are the different combinations of attributes. To configure attributes and variants, go to -:menuselection:`Website --> eCommerce --> Products`, select a product, and click the -:guilabel:`Attributes & Variants` tab. Add as many attributes as desired. +.. _ecommerce/catalog/layout: -.. seealso:: - :doc:`../../../sales/sales/products_prices/products/variants` +Define the number of products to display on your shop pages by configuring the :guilabel:`Size` +displayed per page and line, and specify the number of columns for :guilabel:`Mobile` devices. -.. image:: catalog/catalog-attributes.png - :alt: Attributes and variants of your product +.. tip:: + Be aware that displaying too many products may affect performance and page loading speed. -To enable attribute filtering, go to your main shop page, then open the website editor, and set -the :guilabel:`Attributes` field to :guilabel:`Left` (:ref:`side panel -`) and/or :guilabel:`Top` (:ref:`top bar -`). +In addition, you can manually change a product’s position on the shop page. To do so, click a +specific product, change its :guilabel:`Size`, and :guilabel:`Re-order` it using the arrows +in the :guilabel:`Product` section of the :guilabel:`Style` tab. The :icon:`fa-angle-double-left` +(:guilabel:`double left arrow`) and :icon:`fa-angle-double-right` (:guilabel:`double right arrow`) +buttons allow you to move the product to the extreme left or right, and the :icon:`fa-angle-left` +(:guilabel:`single left arrow`) and :icon:`fa-angle-right` (:guilabel:`single left arrow`) buttons +allow you to move it one row to the left or right. You can also choose or create a :ref:`ribbon or +badge ` to highlight a specific product. .. tip:: - When attribute filtering is enabled in the top bar, customers must click the :icon:`fa-sliders` - (:guilabel:`dropdown toggle`) button to access it. + It is also possible to change the products' positions on the shop page by going to + :menuselection:`Website --> eCommerce --> Products`, switching to the list view, and + dragging and dropping the products within the list. -When enabling :guilabel:`Attributes`, more options become available: +Products design +--------------- - - :guilabel:`Price Filter`: Toggle the switch to display a :guilabel:`Price Range` bar, which - allows customers to filter products according to a specific price range by dragging adjustable - handles. - - :guilabel:`Product Tags Filter`: Toggle the switch to display the :guilabel:`Product Tags` on - the shop page, and allow customers to filter products using those tags by going to the - :guilabel:`Tags` section in the :ref:`side panel `. +Choose a :guilabel:`Products Design`, customize it by clicking the :icon:`fa-paint-brush` +:guilabel:`(paint brush)` icon next to it, and choose a :guilabel:`Preset` layout. You can adapt +the :guilabel:`General` design, customize the :guilabel:`Text & content`, add :ref:`images +`, and enable some :guilabel:`Actions` for the product cards. -.. tip:: - - If you want to use tags on your e-commerce, go to :menuselection:`eCommerce --> Product Tags` - and click :guilabel:`New`. In the :guilabel:`Product Templates` tab of the product tags form, - add the products to link to the given tag. You can also add product variants in the - :guilabel:`Product Variants` tab and view a summary of all selected products in - the :guilabel:`All Products` tab. - - Price filtering works independently from attributes and, therefore, can be enabled on its own, - if desired. +.. _ecommerce/catalog/product-card: -.. _ecommerce/catalog/product-listing: +Product card +~~~~~~~~~~~~ -Product listing area -==================== +In the :guilabel:`General` section, add a :guilabel:`Hover Effect` when hovering over the product, +define the :guilabel:`Gap` between the products, the :guilabel:`Roundness` of the cards, and the +:guilabel:`Colors`, if applicable. -You can customize the layout of the entire shop page, as well as that of :ref:`individual category -pages `. +In the :guilabel:`Text & content` section, configure the text :guilabel:`Alignment`, and the +:guilabel:`Title Style`, and define whether you want to show the :guilabel:`Description`, and +:guilabel:`Ratings`. -.. tip:: - It is also possible to customize individual :ref:`product pages `. +In the :guilabel:`Actions` section, add additional buttons like :icon:`fa-shopping-cart` +:ref:`Add to cart `, :icon:`fa-exchange` :ref:`Compare +`, or :icon:`fa-heart-o` :ref:`Add to +wishlist `. Define how they should be display, +i.e.: :guilabel:`Inline`, :guilabel:`On Hover`, :guilabel:`Fixed` or :guilabel:`Fixed - On Hover`. +Lastly, define a style for the buttons: :guilabel:`Subtle`, :guilabel:`Promote` +:icon:`fa-shopping-cart`, or :guilabel:`Theme colors`. -.. _ecommerce/catalog/layout: +Variants and attributes +*********************** -In the website editor, choose the :ref:`layout `, and -set the default layout to either :guilabel:`Grid` or :guilabel:`List` view. +Configure :ref:`attributes ` to make them +:guilabel:`Visible` on the product card on the shop page. -Use the following options to further adjust the layout: +You can also add a variant picture on the product card. To do so, go to the product form, click +the :icon:`fa-sitemap` :guilabel:`Variants` :ref:`smart button +`, select a variant, and click the +:icon:`fa-pencil` :guilabel:`(Edit)` icon to add a picture for each variant. Make sure that the +:ref:`Show Thumbnails ` is enabled on the +attribute form. - - :guilabel:`Size`: Set the number of products displayed per page and line. - - :guilabel:`Gap`: Define the gap between the products. - - :guilabel:`Style`: Select :guilabel:`Default`, :guilabel:`Cards`, :guilabel:`Thumbnails`, or - :guilabel:`Grid`. - - :guilabel:`Image Size`: Choose the aspect ratio for the product images: - :guilabel:`Landscape (4/3)`, :guilabel:`Default (1/1)`, :guilabel:`Portrait (4/5)`, or - :guilabel:`Vertical (2/3)`. You can also adjust the display by changing the :guilabel:`Fill` - options to fit your design preferences best. +.. image:: catalog/catalog-show-thumbnails.png + :alt: Variant thumbnails on product card. -Toggle the :guilabel:`Prod. Desc.` switch to display the product description below the product's -name. +.. _ecommerce/catalog/images: -.. tip:: - You can choose the size of the grid, but be aware that displaying too many products may affect - performance and page loading speed. +Images +~~~~~~ + +Click the :icon:`fa-paint-brush` :guilabel:`(paint brush)` icon next to :guilabel:`Products Design`, +navigate to the :guilabel:`Images` section, and customize the image layout: -In addition, you can manually change a product’s position on the shop page. To do so, go to the -main shop page, click the product, and open the website editor. In the :guilabel:`Product` section, -you can reorder the products by using the arrows. The `<<` `>>` buttons allow to move the product to -the extreme left or right, and `<` `>` allow to move it one row to the left or right. +- :guilabel:`Image Ratio`: Define the ratio of images on the shop page. +- :guilabel:`Auto-crop`: Cut or trim images automatically to make them fit the page. +- :guilabel:`Hover Effect`: Define the zoom when hovering over the image. +- :guilabel:`Secondary Image`: Show a second image when hovering over the product image. .. tip:: - It is also possible to change the products' positions on the shop page by going to - :menuselection:`Website --> eCommerce --> Products`, switching to the list view, and - dragging and dropping the products within the list. + :guilabel:`Replace` a media directly from the shop page using the :guilabel:`Image` + section of the :guilabel:`Style` tab. .. _ecommerce/catalog/customize-layout: -Shop and category page design ------------------------------ +Layout customization +==================== + +Customize the layout of the entire shop page by choosing the :guilabel:`Regular` or +:guilabel:`Full` :guilabel:`Content Width`. + +.. tip:: + It is also possible to customize individual :ref:`product pages + `. + +You can also define different headers for the shop and each category. + +.. tabs:: + + .. tab:: Shop + + Define the :guilabel:`Shop Header` by changing the title, and toggling the + :guilabel:`Show Title` and/or the :guilabel:`Center Content` switches. + + .. tab:: Category + + Define the :guilabel:`(Category) Header` by changing the title, and toggling the + :guilabel:`Show Title`. Toggle the :guilabel:`Show Description` switch to show the + :ref:`category description ` defined on the + category form, and/or the :guilabel:`Center Content` switch. + +.. _ecommerce/catalog/building-blocks: + +Building blocks +--------------- Use :doc:`building blocks <../../website/web_design/building_blocks>` to add content on the shop and/or category page. +.. _ecommerce/catalog/customize-page-design: + +Shop and category page design +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + You can customize the top and/or bottom section of the catalog, either for the entire shop page or for a specific category. In the latter case, the block appears *only* when filtering by that category. To do so, move the block to the far top or bottom section to display it on the general @@ -215,6 +250,39 @@ display it only when filtering by that specific category. - eCommerce categories can also be added as :ref:`mega menu items ` for quick access. -.. seealso:: - - :doc:`Products <../products>` - - :doc:`additional_features` +Catalog blocks +~~~~~~~~~~~~~~ + +The :guilabel:`Catalog` :doc:`building blocks +` are used to create quick access to +your e-commerce shop. You can showcase your categories, a specific product selection, or a banner +with general information or promotions. + +Depending on the selected layout, you can customize the blocks in the :guilabel:`Style` tab. + +.. example:: + Add a building block to display a selection of products sold on your website. + + .. image:: catalog/catalog-product-block.png + :alt: Example of a catalog block for specific products + + By default, the block displays the :guilabel:`Newest Products`. To change which products are + shown, go to the :guilabel:`Style` tab's :guilabel:`Products` section and set the + :guilabel:`Filter` field to :guilabel:`Recently Sold Products` or :guilabel:`Recently Viewed + Products (per user)`. In addition, it is possible to display products from a specific category + only using the :guilabel:`Category` field. + + You can also filter products by :guilabel:`Tags`, :guilabel:`Show variants`, and adjust the + display by selecting a different :guilabel:`Cards Design`. + +Footer block +~~~~~~~~~~~~ + +There is a :guilabel:`eCommerce` footer block that features all the available payment methods in the +footer. +Click the footer and select the :guilabel:`eCommerce` template in the :guilabel:`Template` field. +Click the payment method section, and choose a :guilabel:`Limit` and the :guilabel:`Height` in the +:guilabel:`Supported Payment Methods` section. + +.. note:: + It is not possible to create a customized footer per category. diff --git a/content/applications/websites/ecommerce/products/catalog/catalog-panel-categories.png b/content/applications/websites/ecommerce/products/catalog/catalog-panel-categories.png deleted file mode 100644 index dc5ed35f8c..0000000000 Binary files a/content/applications/websites/ecommerce/products/catalog/catalog-panel-categories.png and /dev/null differ diff --git a/content/applications/websites/ecommerce/products/catalog/catalog-product-block.png b/content/applications/websites/ecommerce/products/catalog/catalog-product-block.png new file mode 100644 index 0000000000..ccbcefe78e Binary files /dev/null and b/content/applications/websites/ecommerce/products/catalog/catalog-product-block.png differ diff --git a/content/applications/websites/ecommerce/products/catalog/catalog-show-thumbnails.png b/content/applications/websites/ecommerce/products/catalog/catalog-show-thumbnails.png new file mode 100644 index 0000000000..399f332cef Binary files /dev/null and b/content/applications/websites/ecommerce/products/catalog/catalog-show-thumbnails.png differ diff --git a/content/applications/websites/ecommerce/products/categories_variants.rst b/content/applications/websites/ecommerce/products/categories_variants.rst new file mode 100644 index 0000000000..906e9e52ea --- /dev/null +++ b/content/applications/websites/ecommerce/products/categories_variants.rst @@ -0,0 +1,108 @@ +======================= +Categories and variants +======================= + +Odoo's product configurator offers many possibilities to define product variants or to organize +products by category. + +.. _ecommerce/categories_variants/product-variants: + +Product variants +================ + +:doc:`Product variants ` are different +versions of the same product, such as those with varying colors or materials, which may have +potential differences in price and availability. + +To configure product variants for a product: + +#. Go to :menuselection:`Website --> Configuration --> Settings`. +#. Scroll down to the :guilabel:`eCommerce` section and enable the + :guilabel:`Product Variants` feature. +#. Access the :ref:`product form `, and go to the + :guilabel:`Attributes & Variants` tab, where you can add attributes and values, enabling + customers to configure and select product variants on the product page. You can combine multiple + attributes to create specific variants. + +.. _ecommerce/categories_variants/attributes: + +Attributes +---------- + +Attributes refer to the characteristics of a product, such as its color or material, whereas +variants are the different combinations of attributes. Each attribute includes a set of values. + +.. image:: catalog/catalog-attributes.png + :alt: Attributes and variants of your product + +Once your attributes are :ref:`created `, make sure to display them +on the shop page. To do so, configure the following settings on the attribute form: + +- :guilabel:`eCommerce Filter`: Choose between :guilabel:`Visible` and :guilabel:`Hidden` to + make it available on the shop filters section. +- :guilabel:`On Product Cards`: Choose between :guilabel:`Visible`, :guilabel:`Hidden`, and + :guilabel:`Hover` to display attributes on the product image on the shop page when dealing with + :guilabel:`Instantly` created variants. + +When the :guilabel:`On Product cards` field is set to :guilabel:`Visible`, the :guilabel:`Show +Thumbnails` option can be toggled to show a product variant image instead of the attribute values. + +.. _ecommerce/categories_variants/attribute-categories: + +Attribute categories +~~~~~~~~~~~~~~~~~~~~ + +In the optional :guilabel:`eCommerce Category` field of the attribute form, select a category from +a drop-down menu to group similar attributes under the same section for added specificity and +organization, when :ref:`comparing products +`. + +.. note:: + To view the details related to the selected attribute category, click the internal link + :icon:`fa-arrow-right` :guilabel:`(right arrow)` icon to the far right of the + :guilabel:`eCommerce Category` field, once an option has been selected. Doing so reveals that + attribute category's detail form. + + .. image:: categories_variants/internal-link-attribute-category.png + :alt: A standard attribute category detail page accessible via its internal link arrow icon. + + Here, the :guilabel:`Category Name` and :guilabel:`Sequence` are displayed at the top. Followed + by :guilabel:`Related Attributes` associated with the category. These attributes can be + rearranged and reordered to a desirable priority. + + Attributes can be directly added to the category by clicking :guilabel:`Add a line`. + +.. tip:: + To create an attribute category directly from this field, start typing the name of the new + category, then select either :guilabel:`Create` or :guilabel:`Create and edit...` from the + drop-down menu that appears. + + Clicking :guilabel:`Create` creates the category, which can be modified later. Clicking + :guilabel:`Create and edit...` creates the category and display a :guilabel:`Create eCommerce + Category` pop-up window, in which the new attribute category can be configured and customized. + +.. _ecommerce/categories_variants/categories: + +Product categorization in catalog +================================= + +eCommerce categories are used to organize products into groups, making it easier for customers +to browse the online store. + +To create eCommerce categories, go to :menuselection:`Website --> eCommerce --> +eCommerce Categories`, and click :guilabel:`New`. On the category form, add a +:guilabel:`Name`, optionally enter a :guilabel:`Parent` category, restrict it to a specific +:guilabel:`Website`, and write a :guilabel:`Description`, if needed. You can also add a +:guilabel:`Cover Image` for the category. + +To use :guilabel:`eCommerce categories`, go to :menuselection:`Website --> eCommerce --> Products`, +select the product you wish to modify, go to the :guilabel:`Sales` tab, navigate to the +:guilabel:`Ecommerce shop` section, and select the :guilabel:`Categories` it belongs to. + +.. note:: + - A single product can belong to multiple eCommerce categories. + - Define how to :doc:`display categories ` on the shop page. + - Categories that do not contain any products are not visible on the shop page. + +.. seealso:: + :doc:`../products` diff --git a/content/applications/websites/ecommerce/products/categories_variants/internal-link-attribute-category.png b/content/applications/websites/ecommerce/products/categories_variants/internal-link-attribute-category.png new file mode 100644 index 0000000000..e0ab39c8e5 Binary files /dev/null and b/content/applications/websites/ecommerce/products/categories_variants/internal-link-attribute-category.png differ diff --git a/content/applications/websites/ecommerce/products/products-block.png b/content/applications/websites/ecommerce/products/products-block.png deleted file mode 100644 index e000ec5a1f..0000000000 Binary files a/content/applications/websites/ecommerce/products/products-block.png and /dev/null differ diff --git a/content/developer/tutorials/website_theme/05_dynamic_templates.rst b/content/developer/tutorials/website_theme/05_dynamic_templates.rst index e652587dca..ef49a124fd 100644 --- a/content/developer/tutorials/website_theme/05_dynamic_templates.rst +++ b/content/developer/tutorials/website_theme/05_dynamic_templates.rst @@ -37,7 +37,7 @@ using `XPath`. Following the Airproof design, let's begin by modifying the shop - To enable attribute/variant filtering, activate the :doc:`/applications/sales/sales/products_prices/products/variants` option in the website backend settings and :ref:`configure attributes and variants - ` for the products. + ` for the products. .. spoiler:: Solutions