MaxtDesign

Installation

Requirements

  • WordPress 6.0 or higher
  • WooCommerce 8.0 or higher (required — plugin will not initialise 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 currently distributed through GitHub.

    From the GitHub release

  • 1.Go to [github.com/maxtdesign/maxtdesign-companion-products](https://github.com/maxtdesign/maxtdesign-companion-products)
  • 2.Click Code → Download ZIP (or grab a tagged release from the Releases page)
  • 3.In WordPress admin, go to Plugins → Add New → Upload Plugin
  • 4.Choose the ZIP file and click Install Now
  • 5.Activate the plugin
  • 6.WooCommerce must be active first — the plugin shows a dismissible admin notice and does not initialise until WooCommerce is present

    • From the cloned repo (developer install)

    cd wp-content/plugins
git clone https://github.com/maxtdesign/maxtdesign-companion-products.git

    Then activate from Plugins → Installed Plugins in WordPress admin.

    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 1.0.0)
  • 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

    • Step 3 (optional): add add-ons

  • 1.Tick Enable add-on products for this product
  • 2.Add companions to the add-on list
  • 3.Set a Conflict Group Key on add-ons that are mutually exclusive (e.g. voltage, size). Two add-ons sharing the same key cannot both be selected.

    • Step 4: 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 checkboxes drive automatic quantity matching with the parent

    • 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