MaxtDesign

Installation

Requirements

  • WordPress 6.1 or higher
  • WooCommerce 8.0 or higher (required, the plugin will not initialize without it)
  • PHP 7.4 or higher

    • Recommended:

  • WooCommerce 10.0+, PHP 8.1+
  • Object caching (Redis or Memcached) for the requirements lookup

    • Installation

    Companion Products is in private beta ahead of its public release. Request access through the [contact page](/contact) and we will send you the plugin ZIP.

    Install the ZIP

  • 1.In WordPress admin, go to Plugins → Add New → Upload Plugin
  • 2.Choose the ZIP file and click Install Now
  • 3.Activate the plugin
  • 4.WooCommerce must be active first — the plugin shows a dismissible admin notice and does not initialize until WooCommerce is present

    • First Configuration (5 minutes)

    Step 1: open a simple product

  • 1.Go to Products → All Products
  • 2.Edit a simple product (variable products are not supported in this release)
  • 3.Scroll to the Companion Products meta box below the standard product data panel

    • Step 2: turn on required selection

  • 1.Tick Enable required product selection for this product
  • 2.Set the Selection Label customers will see (max 100 characters)
  • 3.Use Search for products... to add one or more companions to the required list
  • 4.Pick a Display Style: Radio Buttons (all visible) or Dropdown (compact, better for long lists)
  • 5.Choose Out-of-stock behavior per companion: block purchase, allow backorders, or hide
  • 6.Give any companion a "Display as" label if its product name is too long for the widget (the real name still shows in cart and orders)

    • Step 3 (optional): add add-on sections

  • 1.Tick Enable add-on products for this product
  • 2.Create one or more sections (for example "Mounting Hardware"), drag to reorder, and set each to checkbox mode (pick any) or radio mode (pick at most one)
  • 3.Add companions to each section

    • Step 4 (optional): set incompatibility rules

  • 1.On any companion row, open "Incompatible with" and tick the add-ons that conflict with it
  • 2.On the product page, selecting an item dims everything incompatible with it and explains why
  • 3.Rules are enforced again server side when the cart is submitted

    • Step 5: save and test

  • 1.Save the product
  • 2.Open the product page on the frontend
  • 3.Confirm the required selection blocks add-to-cart until a choice is made
  • 4.Confirm add-on sections, the live running total, and incompatibility dimming all behave as configured

    • Global Settings

    The plugin adds a Companion Products tab at WooCommerce → Settings → Companion Products. See the Configuration section for what lives there.

    Translations

    The plugin is translation-ready. The text domain is maxtdesign-companion-products with the languages folder at /languages. A .pot template ships with the release.

    Configuration