dfbundlevisual — Frequently Bought Together

Overview

dfbundlevisual displays an Amazon-style Frequently Bought Together block on the product page: checkable product cards separated by plus signs, a live-updating total price and a single button to add the selection to the cart. A bundle discount (percentage or fixed amount tax incl.) is applied automatically when the full bundle is in the cart. When no manual bundle exists, the module can suggest the products genuinely purchased together based on your order history.

Installation

1. In the back office, open Modules > Module Manager > Upload a module.
2. Upload the dfbundlevisual.zip file and click Install.
3. The module creates its tables, its Catalog > Visual bundles tab and registers the required hooks.

Configuration

Open the module configuration page (Modules > Module Manager > dfbundlevisual > Configure):

• Enable module: global switch for the front-office block.
• Display hook: displayFooterProduct (product footer, recommended) or displayProductAdditionalInfo (below the buy button, depending on the theme).
• Block title: customizable per language. Defaults to “Frequently bought together” in English.
• Enable automatic suggestions: shows co-purchase suggestions when no manual bundle exists for the viewed product.
• Max automatic suggestions: number of complementary products displayed (2 by default).
• Minimum co-purchases: minimum number of orders containing both products for a suggestion to appear (2 by default).
• Order history window (days): period analysed for co-occurrence (365 by default).

Creating a bundle

1. Open Catalog > Visual bundles and click Add.
2. Bundle name: internal name, also used as the discount label in the cart.
3. Main product: search by name, reference or ID. The block will be displayed on this product’s page.
4. Bundled products: add one or more complementary products using the autocomplete search.
5. Discount type and value: no discount, percentage (max 100) or fixed amount tax incl.
6. Activate the bundle and save.

How the discount works

The discount is applied through a dynamic cart rule created on the fly for each cart (code DFBV-{bundle_id}-{cart_id}) and restricted to the bundle products only:

• It is only created when the full bundle is present in the cart — checked server-side.
• A percentage discount applies only to the bundle products, never to the rest of the cart.
• If the customer removes a bundle product, the discount is deleted automatically.
• On order validation, the rule is deactivated so it cannot be reused.
• On module uninstall, all generated rules are purged.

Automatic suggestions

When no active manual bundle exists for the viewed product and the option is enabled, the module analyses product co-occurrence in your valid orders over the configured window, then displays the most frequent combinations that meet the co-purchase threshold. Out-of-stock products are excluded. The result is cached to preserve performance. No discount is applied on automatic suggestions: discounts are reserved for manual bundles.

Statistics

The Catalog > Visual bundles list shows, for each bundle, its views (block displays) and conversions (full additions to the cart). Automatic suggestions are counted globally. Use these figures to fine-tune compositions and discounts.

Troubleshooting

• The block does not appear: check the module is enabled, an active bundle exists for the product (or automatic suggestions are enabled with enough history), and the chosen hook is present in your theme.
• The discount does not show: it is only created when all bundle products are in the cart. Also check the discount type is not “No discount”.
• No automatic suggestions: lower the minimum co-purchase threshold or widen the history window; valid orders containing the products together are required.
• Products with combinations: the default combination is used when adding to the cart, with stock checks.