Product Box

The Product Box widget lets you showcase a single product by selecting it from your catalog and choosing a display style. You can either use a pre-designed layout (miniature) from your theme or build a custom arrangement of product elements like image, title, price, and buttons.

Content tab

Configure the product selection, layout style, and elements for the custom miniature.

Product Box widget Content tab - Product Box

Product Box

Miniature

Select a predefined product miniature style from your theme, or choose 'Custom' to build your own layout.

Product

Search and select the specific product you want to display in this box.

Product Box widget Content tab - Custom Content

These controls define which elements appear and their basic settings when 'Miniature' is set to 'Custom'. Styling is done in the Style tab.

Content Elements

Image Size

Select the predefined image size to use for the product image on different devices.

Second Image

Enable to show the second product image (if available) when hovering over the main image.

Category

Toggle the visibility of the product's category name.

Description

Toggle the visibility of the product's short description.

Max. Length (Description)

Set the maximum number of characters to display for the short description.

Regular price

Toggle the visibility of the regular (non-discounted) price when a product is on sale.

Add to Cart

Toggle the visibility of the Add to Cart button (element visibility only).

Quick View

Toggle the visibility of the Quick View button (element visibility only).

Product Name

Display

Adjust the predefined size display for the product name (Small, Medium, Large, etc.).

HTML Tag

Select the appropriate HTML tag (H1-H6, div, span, p) for the product name.

Badges

Badges

Select which product flags (Sale, New, Pack, Out-of-Stock, Online only) should be displayed.

Sale Text

Customize the text displayed for the 'Sale' badge (leave empty for default).

New Text

Customize the text displayed for the 'New' badge (leave empty for default).

Pack Text

Customize the text displayed for the 'Pack' badge (leave empty for default).

Out-of-Stock Text

Customize the text displayed for the 'Out-of-Stock' badge (leave empty for default).

Online only Text

Customize the text displayed for the 'Online only' badge (leave empty for default).

Product Box widget Content tab - Custom Add to Cart

Configure the Add to Cart button when 'Miniature' is set to 'Custom' and 'Add to Cart' visibility is enabled.

Add to Cart Button

Type

Select a predefined style theme (Default, Primary, Secondary) for the Add to Cart button.

Text

Set the text displayed on the Add to Cart button.

Alignment

Align the Add to Cart button horizontally (Left, Center, Right, Justified).

Size

Adjust the size of the Add to Cart button (XS to XL).

Icon

Choose an icon to display within the Add to Cart button.

Icon Position

Set the icon's placement (Before or After) relative to the Add to Cart button text.

Icon Spacing

Define the spacing between the icon and text within the Add to Cart button.

Product Box widget Content tab - Custom Quick View

Configure the Quick View button when 'Miniature' is set to 'Custom' and 'Quick View' visibility is enabled.

Quick View Button

Text

Set the text displayed on the Quick View button/link.

Icon

Choose an icon to display within the Quick View button.

Icon Position

Set the icon's placement (Before or After) relative to the Quick View button text.

Icon Spacing

Define the spacing between the icon and text within the Quick View button.

Style tab

Customize the appearance and design of the product box and its custom elements.

Product Box widget Style tab - Product Box

Product Box Container

Alignment

Set the horizontal alignment (Left, Center, Right, Justified) for the content within the product box.

Padding

Define the inner spacing around the content within the product box container.

Border Width

Control the thickness of the border around the product box.

Border Radius

Adjust the roundness of the corners for the product box.

Border Color (Normal & Hover)

Set the border color for the product box in its default and hovered states.

Background Color (Normal & Hover)

Define the background color for the product box in its default and hovered states (applies to 'Custom' miniature).

Box Shadow (Normal & Hover)

Apply a shadow effect to the product box in its default and hovered states.

Product Box widget Style tab - Custom Image

Styles apply to the Image element when 'Miniature' is set to 'Custom'.

Image

Width

Set the width of the product image using pixels or percentage.

Border

Define the border type, width, and color for the product image.

Border Radius

Adjust the roundness of the product image corners.

Hover Animation

Apply an animation effect to the product image when the user hovers over it.

Product Box widget Style tab - Custom Content

Styles apply to the text elements below the image when 'Miniature' is set to 'Custom'.

Content Area

Alignment

Set the horizontal alignment (Left, Center, Right) for all text content below the image.

Padding

Control the inner spacing around the content area below the image.

Min Height

Set a minimum height for the content area below the image.

Name

Spacing

Adjust the space above the product name.

Allow Multiline

Permit the product name to wrap onto multiple lines if needed.

Color

Set the text color for the product name.

Typography

Define the font settings for the product name.

Category

Spacing

Adjust the space above the category name.

Allow Multiline

Permit the category name to wrap onto multiple lines if needed.

Color

Set the text color for the category name.

Typography

Define the font settings for the category name.

Description

Spacing

Adjust the space above the product description.

Max Lines

Limit the description to a maximum number of lines using CSS line clamping.

Color

Set the text color for the product description.

Typography

Define the font settings for the product description.

Price

Spacing

Adjust the space above the price area.

Color

Set the text color for the current product price.

Typography

Define the font settings for the price text (both current and regular).

Regular Price
Color

Set the text color for the regular (strikethrough) price when a product is on sale.

Size

Adjust the font size specifically for the regular price text.

Product Box widget Style tab - Custom Add to Cart

Styles apply to the Add to Cart button when 'Miniature' is set to 'Custom'.

Add to Cart Button

Spacing

Adjust the space above the Add to Cart button.

Typography

Define the font settings for the Add to Cart button text.

Text Color (Normal, Hover & Disabled)

Set the text color for the Add to Cart button in its normal, hover, and disabled states.

Background Color (Normal, Hover & Disabled)

Set the background color for the Add to Cart button in its normal, hover, and disabled states.

Border Color (Normal, Hover & Disabled)

Set the border color for the Add to Cart button in its normal, hover, and disabled states.

Cursor (Disabled)

Choose the mouse cursor style (default or not-allowed) when hovering over a disabled Add to Cart button.

Border Width

Control the thickness of the Add to Cart button's border.

Border Radius

Adjust the roundness of the Add to Cart button's corners.

Product Box widget Style tab - Custom Quick View

Styles apply to the Quick View button when 'Miniature' is set to 'Custom'.

Quick View Button

Typography

Define the font settings for the Quick View button text.

Text Color (Normal & Hover)

Set the text color for the Quick View button in its normal and hover states.

Background Color (Normal & Hover)

Set the background color for the Quick View button in its normal and hover states.

Border Color (Normal & Hover)

Set the border color for the Quick View button in its normal and hover states.

Border Width

Control the thickness of the Quick View button's border.

Border Radius

Adjust the roundness of the Quick View button's corners.

Product Box widget Style tab - Custom Badges

Styles apply to the product badges (flags) when 'Miniature' is set to 'Custom'.

Badges General

Top Distance

Adjust the vertical offset of the badges from the top edge.

Left Distance

Adjust the horizontal offset for badges positioned on the left.

Right Distance

Adjust the horizontal offset for badges positioned on the right.

Spacing

Control the vertical space between multiple badges displayed in the same corner.

Min Width

Set a minimum width for the badges.

Padding

Define the inner spacing within each badge.

Border Radius

Adjust the roundness of the corners for the badges.

Typography

Define the font settings for the text within the badges.

Individual Badges

Sale Badge
Position

Choose whether the Sale badge appears on the left or right side.

Text Color

Set the text color specifically for the Sale badge.

Background Color

Set the background color specifically for the Sale badge.

New Badge
Position

Choose whether the New badge appears on the left or right side.

Text Color

Set the text color specifically for the New badge.

Background Color

Set the background color specifically for the New badge.

Pack Badge
Position

Choose whether the Pack badge appears on the left or right side.

Text Color

Set the text color specifically for the Pack badge.

Background Color

Set the background color specifically for the Pack badge.

Out-of-Stock Badge
Position

Choose whether the Out-of-Stock badge appears on the left or right side.

Text Color

Set the text color specifically for the Out-of-Stock badge.

Background Color

Set the background color specifically for the Out-of-Stock badge.

Online only Badge
Position

Choose whether the Online only badge appears on the left or right side.

Text Color

Set the text color specifically for the Online only badge.

Background Color

Set the background color specifically for the Online only badge.

Advanced tab

Access advanced layout, motion, and custom CSS options.

Advanced Tab Layout
Margin

Define the external space around the widget for separation from adjacent elements.

Padding

Set the internal spacing within the widget to control the arrangement of its content.

Width

Specify the widget's width behavior: Full Width, Inline, Custom, or Calculate.

Full width
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Inline
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Custom
  • Custom Width: Set the width in pixels, percentage, or viewport width (vw).
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Calculate
  • Calc: Use calculations like 100% - 20px to dynamically define the width.
  • Min Width: Set a minimum width in pixels, percentage, or viewport width (vw).
  • Vertical align: Set the vertical alignment to start, center, end, or stretch.
  • Size: Define the size as none, grow, or custom to determine widget dimensions.
Order

Control the widget's order using start, end, or custom values.

Position

Choose default, absolute or fixed positioning for the widget.

Absolute
  • Horizontal Orientation: Determines the element's horizontal alignment within its nearest positioned ancestor.
  • Offset: Specifies the distance between the element and the left or right edge of its containing block.
  • Vertical Orientation: Sets the element's vertical alignment within its nearest positioned ancestor.
  • Offset: Defines the space between the element and the top or bottom edge of its containing block.
Fixed
  • Horizontal Orientation: Controls the element's horizontal alignment relative to the browser window.
  • Offset: Adjusts the distance between the element and the left or right edge of the viewport.
  • Vertical Orientation: Manages the element's vertical alignment relative to the browser window.
  • Offset: Defines the space between the element and the top or bottom edge of the viewport.
Z-index

Set the stacking order of the widget relative to other elements.

CSS ID

Assign a unique CSS ID for custom styling or interaction.

CSS Classes

Add custom CSS classes for targeted styling via external stylesheets.

Element Cache

Improves loading times by storing a static version of this element.

Advanced Tab Motion Effects
Scrolling Effects

Enhance elements with various dynamic effects triggered by the user's scrolling behavior.

  • Vertical Scroll: Configure the scroll direction, speed, and viewport range for vertical scrolling effects.
  • Horizontal Scroll: Set the scroll direction, speed, and viewport range for horizontal scrolling effects.
  • Transparency: Adjust the transparency based on the direction, level, and viewport range.
  • Blur: Apply a blur effect with customizable direction, level, and viewport range.
  • Rotate: Rotate the element using direction, speed, and viewport settings.
  • Scale: Scale the element with direction, speed, and viewport controls.
  • Apply Effects on: Choose whether to apply scrolling effects on desktop, tablet, or mobile devices.
  • Effects Relative to: Define whether the effects are relative to the default container, the viewport, or the entire page.
Mouse Effects

Enable mouse based effects for added interactivity.

  • Mouse Track: Adjust the direction and speed of the effect as the user moves the mouse across the page.
  • 3D Tilt: Enable 3D tilt effects with controllable direction and speed for a more immersive experience.
Sticky Effects

Fix elements at the top or bottom of the viewport as the user scrolls for persistent visibility.

  • Sticky on: Apply sticky effects on desktop, tablet, or mobile devices.
  • Offset: Set the offset in pixels to trigger the sticky effect after scrolling.
  • Dynamic Offset: Use a CSS selector to dynamically set the offset based on other elements on the page.
  • Effects Offset: Configure the pixel offset to control when additional effects apply.
  • Stay in Column: Choose whether the sticky element remains within its column during scrolling (yes or no).
  • Hide on Scroll: Set the offset and transition duration for hiding the sticky element when scrolling down.
Entrance Animation

Apply predefined animations to elements when they appear on screen.

  • Fading: Elements gradually fade in or out of view.
  • Revealing: Create smooth reveal effects as elements come into view.
  • Sliding & Revealing: Combine sliding motion with reveal effects.
  • Scaling & Revealing: Adjust the size of elements as they are revealed.
  • Zooming: Apply zoom in or out effects during element appearance.
  • Bouncing: Elements enter with a bouncing motion for attention-grabbing effects.
  • Sliding: Elements slide into view from different directions.
  • Rotating: Apply rotation effects as elements enter or leave the viewport.
  • Attention Seekers: Highlight elements with exaggerated, noticeable animations.
  • Specials: Unique animations for elements that require special effects.
Advanced Tab Transform
Opacity

Adjust the transparency level of the element to create fade effects during normal or hover states.

Rotate

Rotate the element along the X, Y, or Z axes for dynamic visual effects. Use deg (degrees) values or apply 3D rotation.

Offset

Shift the position of the element horizontally (X-axis) or vertically (Y-axis) to control its exact placement within the layout.

Scale

Resize the element, with the option to keep proportions (yes or no) and adjust the scale factor to enlarge or shrink the element.

Skew

Skew the element along the X and Y axes to tilt its appearance.

Flip Horizontal/Vertical

Flip the element horizontally or vertically by selecting the anchor points (X: left, center, right; Y: top, center, bottom) for precise control over the flip transformation.

Trigger by (On hover)

Choose whether the hover transformation is triggered by interaction with the widget, column, or section.

Transition Duration (On hover)

Set the time duration in milliseconds that the hover transition effect takes to complete.

Transition Delay (On hover)

Specify a delay in milliseconds before the hover transition effect begins.

Advanced Tab Background
Background Type

Select the background type: None, Classic, or Gradient.

Classic
Color
Set a solid background color to provide a consistent base for your design.
Image
Upload an image to use as the background. Additional settings include:
  • Loading: Choose whether to load the background image lazily or immediately.
  • Position: Define the image's position within the background (e.g., center, top-left).
  • Attachment: Set the background image to scroll with the page or remain fixed.
  • Repeat: Determine if the image repeats or stays single across the background area.
  • Size: Control the size of the background image, such as cover, contain, or custom dimensions.
Backdrop Filters
Apply visual filters to the background, such as blur, brightness, or contrast, enhancing its appearance.
Transition Duration (On hover)
Set the time duration in milliseconds that the hover transition effect takes to complete.
Gradient
Color
Select the primary color for the gradient background.
Location
Define the starting position of the primary color in the gradient effect.
Second Color
Select the secondary color to blend into the gradient.
Location
Set the starting point of the secondary color within the gradient.
Angle
Adjust the angle at which the gradient flows (e.g., horizontal, vertical, diagonal).
Backdrop Filters
Apply visual filters to the gradient background for added depth and effects.
Transition Duration (On hover)
Set the time duration in milliseconds that the hover transition effect takes to complete.

Advanced Tab Border
Border Type

Define the border style of the element.

Border Width

Set the thickness of the element's border.

Border Color

Define the color of the element's border.

Border Radius

Adjust the corner roundness of the element.

Box Shadow

Apply shadow effects to add depth to the element.

Advanced Tab Visibility
Responsive Visibility

Control the display of elements across different devices by selectively hiding them on desktop, tablet, or mobile.

Scheduled Visibility

Set the section's visibility based on specific schedules.

Customer Group Visibility

Control section visibility based on customer groups.

Advanced Tab Custom CSS
Custom CSS

Apply custom CSS to style the widget beyond the default settings.

Note: This requires CSS knowledge—use carefully, as incorrect syntax can impact other areas of the site.

/* For main element */
selector { 
  color: red; 
}

/* For child element */
selector .child-element { 
  margin: 10px; 
}

/* Or use any custom selector */
.my-class { 
  text-align: center; 
}

If you want to learn the basics of CSS, W3Schools is a great resource for that.

© WebshopWorks - Professional PrestaShop Addons