Download the PHP package studioraz/magento2-simple-product-link-luma-theme without Composer

Magento 2 Simple Product Link Luma Theme

A standalone Magento 2 module that links independent products together and renders a variation switcher on Luma/Blank-based Product Detail Pages. Every linked item remains a standalone catalog product with its own PDP and native product-type behavior.

Designed for Luma/Blank-based storefronts — uses Magento layout XML, PHTML, native Swatches APIs, and module LESS. It does not depend on studioraz/magento2-simple-product-link.

This package is a standalone alternative to the Hyvä-oriented module, not a companion package. Do not enable both implementations in the same Magento installation because they intentionally use the same product attribute, admin route, event prefix, and database tables.

Table of Contents

• Features
• How It Works
• Requirements
• Installation
• Configuration
  • 1. Create a Link Rule
  • 2. Assign Products to a Group
• Frontend Behavior
  • Display Rules
  • Swatch Support
  • Out-of-Stock Handling
  • Sorting & Display Order
• Cache Invalidation
• License

Features

• Group independent products via a shared text attribute. Simple, virtual, downloadable, configurable, grouped, and bundle products are supported.
• Admin-managed Link Rules with variation attributes, catalog-rule conditions, and priority.
• Multiple variation attributes per rule (e.g., Color + Size) with drag-and-drop ordering.
• Color, image, and text swatches using Magento's native Swatches module.
• Out-of-stock indicators — diagonal strikethrough + tooltip, respects catalog display setting.
• Zero theme modifications — layout XML inserts the variant switcher after the product price.
• Group-aware cache invalidation — rule changes, product group changes, and stock updates automatically purge the correct FPC entries.

How It Works

1. Products are grouped by assigning the same value to the simple_product_group attribute.
2. An admin-defined Link Rule specifies which variation attributes to display and which products the rule applies to (via catalog-rule conditions).
3. On the storefront, the module's plugin appends a variant switcher block immediately after the price. Each variant is a clickable link to the sibling product's PDP.

For composite products, the switcher links whole parent products. It does not replace Magento's configurable, grouped, downloadable, or bundle option renderers and does not carry selected child options between PDPs.

Requirements

Installation

Via Composer (private repository)

Manual installation

1. Copy the module to app/code/SR/SimpleProductLinkLumaTheme/.
2. Run:

The data patch will automatically create the simple_product_group product attribute on first install.

Configuration

1. Create a Link Rule

Navigate to Admin → Studio Raz → Simple Product Link → Link Rules and click Add New Rule.

2. Assign Products to a Group

1. Open a product in Admin → Catalog → Products.
2. Set the Simple Product Group attribute to a shared group identifier (any arbitrary string, e.g., blue-widget-family).
3. Repeat for every sibling product in the group. Ensure each product has a different value for the variation attribute(s) defined in the matching rule.

Frontend Behavior

Display Rules

When conditions are met, the switcher renders after the price in product.info.main, with one row per variation attribute.

Swatch Support

Out-of-Stock Handling

Behavior depends on Stores → Configuration → Catalog → Inventory → Display Out of Stock Products:

• Yes — The option is visible but not clickable (rendered as <span>). It shows reduced opacity, a diagonal strikethrough line, and a tooltip reading "Option Label – Out of Stock".
• No — The option is completely hidden.

Sorting & Display Order

Cache Invalidation

The module implements a three-layer cache strategy:

1. Rule changes (create / update / delete) — Flushes the full-page cache entirely via observers on studioraz_simpleproductlink_rule_save_after and _delete_after.
2. Product group changes — When a product's simple_product_group value is modified, all sibling products in both the old and new groups are invalidated.
3. Composite stock changes — When a child product's stock changes, the resolver also includes its configurable, grouped, or bundle parents and invalidates the linked groups assigned to those parents.
4. Cache tag propagation — The switcher block exposes a group cache tag, so Varnish / FPC invalidation can purge related variant pages together.

Troubleshooting

License

MIT — © Studio Raz. All rights reserved.