Product boxes
Last updated
Last updated
-
For the listing you can define for each viewport how many products should be displayed in one row.
[≡] Different settings per category In each category you can make a different setting in the Custom fields > Products per row.
You can adjust different settings for layouts with active sidebar, because the available width is smaller by the width of the sidebar.
[≡] Different settings per category In each category you can make a different setting in the Custom fields > Products per row.
You can set the number of products per line for product sliders in the Settings (1) of aeach product slider element itself (in the shopping experiences). The value for the Minimal width (2) specifies the minimum width of the product box - Javascript is then used to calculate how many elements fit in one row.
If the width of the content is e.g. 1340px
, 4 product tiles can be displayed in a row because 1340px / 4 = 335px
. With 5 tiles per line, the maximum possible width of a product tile would be 1340px / 5 = 268px
and therefore too small.
The short description in the listing depends on the layout type of the shopping experience listing element.
With the Border (1) setting the entire product box gets a border in the specified color. Shadow (2) and shadow:hover (3) highlights the product box with a drop shadow in the selected color.
Spacer (4) defines a distance between each product box in the listing grid.
Meta description as product description (5) lets you replace the product description that is displayed in the Standard
layout type with the meta description of the product. If there is no meta description, the product description is used as a fallback.
The option Discount in % (6) displays the percentage savings in the badge on discount items.
Attention animation (7) moves the product box up a few pixels on mouseover.
Example:
With Mouseover Image change (1) you specify whether an alternative article image is displayed when hovering the mouse over it. The theme automatically selects the next closest assigned article image to the cover image from the configuration of the article.
The checkbox background (2) offers the possibility to use the background color configured under General > Product images > Product image background. This way you can control more specifically when the background color should be applied. In the detail page area, there is also such a checkbox for the gallery.
In addition to the product box itself, the product image can also have a border (3) in the defined border color (4).
Layout type big image - max height (5) gives you the possibility to change the height of the image of this product layout. Unlike the other product box layouts, the Big image
product layout is not based on our aspect ratio feature of the images and uses the display of fitted item images with a fixed height.
Example:
For displaying the optimal product image thumbnails in the product boxes for the different devices and screen sizes many factors play a role. These include, for example, the adjustable number of products per line, the adjustable maximum layout width as well as the distance between the product boxes. Settings which affect the size of the boxes and thus also the displayed images.
Basically, the theme automatically calculates the image size to be loaded for the various thumbnails in the listing based on the various parameters. Manual adjustment of fixed image sizes is only recommended in exceptional cases.
Background knowledge:
The product image sizes setting defines fixed image sizes of the product images for the different display sizes / viewport widths. The img-srcset
decides which image should be loaded based on the conditions stored in the sizes
attribute. Each constraint consists of an optional media query that describes the viewport width and the width of the image.
Once the setting Activate custom srcset-sizes (1) has been enabled, the specified image sizes for each viewport in the settings panels below will take effect.
Choose between different positions of the rating stars with the Rating position (1) configuration and set et whether grayed out stars should be displayed as placeholders if a product does not yet have any reviews.
Example:
In addition to the general settings for color and typography, the number of lines of the product name in the listing can be changed using the Lines (8) option. This can be useful for particularly short or particularly long product names, as the length of the product names is limited by the number of lines displayed to ensure a uniform appearance in the listing.
The product description is only available with the Standard
product layout. The Layout type (1) can be set in each category and shopping experience listing element.
Display the product number in the product listing. By disabling the display of the article number, you can reduce the height of the product boxes, because no space is reserved for this information.
By disabling the display of variant features, you can reduce the height of the product box display, as no space is reserved for this information.
By disabling the display of the cheapest variant price, you can reduce the height of the display of the product boxes, as no space is reserved for this information.
By deactivating the display of the basic price, you can reduce the height of the display of the product boxes, as no space is reserved for this information.
Please check the display of mandatory information beforehand!
"Whoever offers products according to length, volume, weight or area is obliged to state a basic price." Source: Shopware Blog on the subject of price quotations
If you are obliged to display a basic price, do not switch it off - if you only sell e.g. clothing, you can possibly save the unnecessary empty space of the basic price calculation.
-
Activate the Delivery information (1) in listings to display delivery information in the product card in a minimal Appearance (2) or default mode. Adjust the text align to fit to the alignment of the other elements.
Examples:
A product can have actions such as adding the item to the shopping cart, the details button for variants and much more.
More information about the buy button:
Appearance (1): Product actions can overlay the product image on mouseover, push up the product information or overlay the product price. By default, the actions are always visible below the price.
Appearance (mobile) (2): If product actions are only visible on mouseover, mobile devices interpret the first touch gesture as mouseover event. The first "click" is therefore used to display the product actions - opening the product is therefore only possible with the second "click". You can therefore make a different setting for mobile devices.
Wishlist (3): Activates the wishlist product action, if wishlist is globally activated in the shopware core configuration.
Quantity field (4): In addition to the shopping cart button, a quantity field will be displayed.
Display product action button (5): If active, the product action button is displayed in listings, if extended prices or variants do not allow the display of this buy button.
Product action for variants - main product (6): Product action of the variant shown as the main product in the storefront presentation. Details button
| Select options button
Quickview must be active for 'Select options button'.
Product action for variants - single product (7): Product action of the variant as expanded by property values or as single product with preselected variant in the storefront presentation. Details button
| Select options button
| Buy button
Since it is clear for individual products which variant ends up in the shopping cart, a shopping cart button can also be displayed here.
Quickview must be active for 'Select options button'.
Product action for product with advanced prices (8): Product action of product with advanced prices. Details button
| Select options button
Since the cheapest price is usually shown in the listing for advanced prices, there can be no shopping cart button here. (No legal advice)
Quickview must be active for 'Select options button'.
Example: