Additional Product Fields and Options – Attributes without Combinations (Custom Fields)

Combinations Require Stock Levels

In PrestaShop, each attribute combination requires a separate stock level. For options such as "gift wrapping" or "extended warranty", this makes no business sense.

Solution: Module variants operate independently of stock – define an option once and assign it to any number of products.

Virtual Products Do Not Support Attributes

Virtual products (e-books, licences, courses) in PrestaShop have limited support for combinations. Adding price variants requires workarounds or code modifications.

Solution: The module works with every product type – physical, virtual, and downloadable.

Discounts Apply to Service Surcharges

With a 20% product discount, the gift wrapping surcharge is also reduced. This generates losses on additional services.

Solution: Variant surcharges are calculated after discounts are applied – promotions only affect the base product price.

Quick Options Require Multiple Clicks

A customer wishing to add a warranty or insurance often has to navigate through separate pages or complex forms.

Solution: Variants are displayed directly on the product page – one click and the option is added to the basket.

No Validation for Required Options

Standard customisation fields do not block adding to basket. The customer can skip a mandatory selection.

Solution: Variants marked as required block the "Add to basket" button until a selection is made.

Additional Services

• Gift wrapping
• Personalisation (engraving, printing)
• Assembly or installation
• Express processing

Warranty and Support

• Extended warranty (12/24/36 months)
• Shipping insurance
• Priority technical support
• Service package

Virtual Products

• Software licences (Basic/Pro/Enterprise)
• Online courses (30/90/365 days access)
• E-books with extras
• Subscriptions with varying scope

Delivery Options

• Standard / express delivery
• Weekend delivery
• Timed delivery
• Click and collect with assembly

1. Variant Management

Central list of all variants with drag & drop sorting.

• 4 display types: dropdown, radio, checkbox, images/colours.
• HTML descriptions: each variant can have a rich description with formatting, displayed as a tooltip on the front end.
• Multilingual: variant names and descriptions translated per shop language.
• Multistore: variants assigned per shop.

2. Variant Values

Each variant can have any number of values to choose from.

• HTML descriptions: each variant value has its own description field with HTML formatting support.
• Visualisation: HEX colour or image for the "image" type.
• Multilingual: value names and descriptions translated per shop language.
• Positioning: value order set via drag & drop.

3. Per-Product Configuration

A panel in the product tab allows you to assign variants and set prices.

• Price impact: net and gross prices with automatic conversion.
• Negative prices: ability to grant a discount for a selected option.
• Required flag: "Required" checkbox blocks adding to basket without selection.

4. Order View

Selected variants visible in order details.

• Data snapshot: name and price saved at the time of order.
• Per order line: variants assigned to a specific product.
• History: changing the variant name does not affect historical orders.

5. Display Configuration

The configuration panel allows you to specify the position and behaviour of the module on the front end.

• Position selection (hook): displayProductActions (inside form, after quantity), displayProductAdditionalInfo (inside form, after add to basket button).
• Custom hook: displayPPVariants – option for developers to manually place in any template location.
• Enable/disable descriptions: separate toggles for variant tooltips and value tooltips – you can disable tooltips for the entire shop or enable only one type.

1. Product Page Display

Variants rendered in the selected hook – inside the add-to-basket form.

• Dynamic pricing: changing selected options updates the price in real time.
• Variant tooltips: (?) icon next to the variant name displays the HTML description defined in the Back Office.
• Value tooltips: (?) icon next to each value shows its individual HTML description.
• Responsiveness: image swatches and checkboxes adapted for mobile.

2. Required Variant Validation

Variants marked as required block the form until a selection is made.

• Asterisk (*): visual indication of required fields.
• Modal message: notification about missing selection.
• No page reload: JavaScript validation without form submission.

3. Basket Integration

Selected variants visible in every basket presentation.

• Product line: variant displayed below the product name.
• Basket modal: visible after adding a product.
• Summary: full list of options at checkout.

4. Customer Order Details

The "My orders" section displays selected variants with prices.

• Format: Variant name: Selected value (+£XX.XX).
• Historical data: data from the time the order was placed.

Increased Basket Value

Additional services such as warranty, wrapping, or express delivery increase average order value. Options visible directly on the product page have a higher conversion rate than separate pages.

Margin Protection

Variant surcharges are not subject to discounts. With a "-30% on everything" promotion, the gift wrapping cost remains fixed – you do not lose on additional services.

Catalogue Simplification

Instead of creating separate products for each warranty version (product + 12m warranty, product + 24m warranty), you handle everything with one product and variants.

SEO Structure

One product URL instead of multiple variants. No content duplication, SEO power consolidated on the main product page. No issues with combination indexing.

Module Architecture

• ObjectModel: PPVariant, PPVariantValue, PPProductVariant classes compliant with PrestaShop standards.
• Multilang/Multishop: full support for multiple languages and shops via native PS mechanisms.

Template Integration

• Custom hook:

  {hook h='displayPPVariants' product=$product}

  – place anywhere in the product template.
• Ready-to-use hooks: the module works with displayProductActions and displayProductAdditionalInfo without template modification.
• CSS classes: all elements use pp-variant-* and pp-* prefixes – no conflicts with theme styles.

Extensibility

• Customization API: variants use the native PS customisation system – compatibility with other modules.
• Price hooks: actionProduct... – surcharges added after discounts.
• No hard dependencies: the module does not require other modules or external JS/CSS libraries.

Database

• 8 tables: variants, values, product assignments, basket, orders + _lang and _shop tables.
• Indexes: query optimisation via keys on id_product, id_shop, id_pp.
• Order snapshots: names and prices saved at order time – independent of subsequent changes.