Category Tree

The Category Tree widget allows you to display a structured list of your store’s product categories in a customizable tree format. You can control layout, sorting, submenu behavior, and styling options to match your theme and improve navigation across both desktop and mobile views.

Content tab

Configure the category source, layout, and mobile behavior for the category tree.

Category Tree widget Content tab - Options

Category Tree Source & Behavior

Skin

Choose the overall appearance: 'Classic' (customizable within the widget) or 'Theme' (inherits styling from your active PrestaShop theme).

Note: When 'Theme' skin is selected, most layout and styling options in the 'Layout (Classic Skin)' Content tab and the Style tab will be handled by your theme.
Category Root

Choose the starting point for the category tree: Home Category, Current Category, Parent Category, Current/Parent Category, or a specific Custom Category.

Select Category (Custom Root)

Select the specific category to use as the root when 'Category Root' is set to 'Custom Category'.

Maximum Depth

Set the maximum number of category levels to display in the tree (0 for unlimited).

Sort

Choose how to sort the categories within the tree: By Position (default) or By Name.

Sort Order

Choose the sorting direction: Ascending (A-Z or lowest position first) or Descending.

Category Tree widget Content tab - Layout

These options apply only when 'Skin' is 'Classic'.

Navigation Layout

Category Menu Thumbnails

Enable to display thumbnail images next to category links within the tree (if thumbnails exist).

Layout

Set the orientation of the main category items: Horizontal, Vertical, or Dropdown (defaults to Dropdown).

Align

Align the main category items horizontally: Left, Center, Right, or Stretch (to fill available space).

Pointer

Select the visual indicator (e.g., Underline, Framed, Background) used for hover and active menu items (defaults to Background).

Animation (Pointer)

Choose the animation effect based on the selected pointer type.

Submenu Indicator

Select an icon to indicate that a category item has subcategories.

Submenu Align

Align the submenu dropdown either to the left or right relative to its parent category item.

Show Submenu

Choose whether submenus appear on hover or require a click.

Mobile Dropdown

Settings for the menu on smaller screens when main 'Layout' is not 'Dropdown'.

Breakpoint

Choose the screen width (Tablet or Mobile) below which the menu will collapse into a mobile dropdown.

Align

Align the text within the opened mobile dropdown menu: Aside (usually left) or Center.

Animation

Select the animation style for expanding submenus within the mobile dropdown: Toggle (simple show/hide) or Accordion (closes other open items).

Toggle Button

Choose whether to display a Hamburger icon or no button (default) to trigger the mobile dropdown.

Toggle Align

Align the mobile toggle button horizontally: Left, Center, or Right.

Full Width

Enable to make the opened mobile dropdown menu stretch to the full width of the viewport.

Style tab

Customize the appearance of the category tree menu, dropdowns, and mobile toggle button when using the 'Classic' skin.

Category Tree widget Style tab - Nav Menu

Applies to the main menu when 'Skin' is 'Classic' and Layout is Horizontal or Vertical (not Dropdown).

Main Menu Items

Typography

Control the font settings for the main category items.

Text Color (Normal, Hover & Active)

Set the text color for main category items in their default, hover, and active states.

Pointer Color (Hover & Active)

Set the color of the pointer effect for hover and active states (not applicable for 'None' or 'Text' pointers).

Horizontal Padding

Adjust the horizontal space inside each main category item.

Vertical Padding

Adjust the vertical space inside each main category item.

Space Between

Control the space between the main category items.

Border Radius (Pointer: Background)

Adjust the roundness of the corners for the background pointer effect.

Pointer Width (Pointer: Line/Framed)

Control the thickness of the line or frame used for the pointer effect.

Category Tree widget Style tab - Dropdown

When 'Skin' is 'Classic': On desktop, styles apply to submenus. On mobile (below breakpoint) or when Layout is 'Dropdown', styles apply to the entire menu.

Dropdown Menu

Typography

Control the font settings for the text within the dropdown/mobile menu.

Text Color (Normal, Hover & Active)

Set the text color for items within the dropdown/mobile menu in their default, hover, and active states.

Background Color (Normal, Hover & Active)

Set the background color for items within the dropdown/mobile menu in their default, hover, and active states.

Border

Define the border type, width, and color for the dropdown container.

Border Radius

Adjust the roundness of the corners for the dropdown container.

Box Shadow

Apply a shadow effect to the dropdown container.

Horizontal Padding

Adjust the horizontal space inside each dropdown item.

Vertical Padding

Adjust the vertical space inside each dropdown item.

Divider

Border Type

Choose the style for the divider line between dropdown items (e.g., solid, dashed).

Color

Set the color of the divider line.

Border Width

Control the thickness of the divider line.

Distance

Adjust the vertical distance between the main menu item and its submenu dropdown.

Category Tree widget Style tab - Toggle Button

Styles apply when 'Skin' is 'Classic' and 'Toggle Button' in the Content tab is 'Hamburger'.

Toggle Button

Color (Normal & Hover)

Set the color of the toggle button icon in its default and hover states.

Background Color (Normal & Hover)

Set the background color of the toggle button in its default and hover states.

Size

Adjust the size of the toggle button icon.

Border Width

Control the thickness of the border around the toggle button.

Border Radius

Adjust the roundness of the corners for the toggle button.

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