README

A powerful, centralised custom options manager for Magento 2. Create complex product options once, group them together, and instantly assign them to hundreds of products. Update a price or add a new dropdown to the group, and watch it sync across your entire catalogue automatically.

🛑 The Problem

Natively, Magento 2 forces you to recreate the exact same custom options (like "Gift Wrapping", "Custom Engraving", or "Extended Warranty") on every single product manually. If the price of your gift wrapping changes, you are forced to spend hours digging through individual product pages to update every single price modifier one by one.

🛠️ The Solution

This module introduces Shared Option Groups. You can now build out complex option sets in a dedicated Admin panel, complete with dropdowns, text fields, price modifiers, and image switchers. Once created, you simply edit any product and select the Shared Option Group from a clean, searchable multi-select field. The options instantly render on the storefront and inject perfectly into the cart and checkout.

✨ Features

Centralised Management: Build and manage options in one place. Update an option's price, and it instantly reflects on all assigned products across your catalogue.
Advanced UI Assignment: Easily assign option groups to products using a sleek, searchable multi-select UI component in the product edit form.
Price & Image Sync: Fully integrated frontend Knockout JS to handle dynamic price updates (shared-options-price.js) and gallery interactions (option-image-switcher.js) seamlessly.
Native Checkout Flow: Intercepts and hydrates shared options perfectly into standard quote and order items, ensuring no disruption to fulfilment.
Zero Core Overrides: Built using clean Magento 2 architecture (Plugins, ViewModels, and UI DataProviders) for maximum compatibility.

📦 Installation

1. Install via Composer

composer require blueprint3d/module-shared-product-options

2. Enable the module

php bin/magento module:enable BluePrint3D_SharedProductOptions

3. Run the database upgrade

php bin/magento setup:upgrade

4. Compile and flush cache

php bin/magento setup:di:compile
php bin/magento cache:flush

👨‍💻 Usage

Navigate to the new Shared Option Groups section in your Magento Admin.
Create a new Group (e.g., "Standard Add-ons") and add your desired custom options, values, and price modifiers.
Go to Catalog > Products and edit any product.
Expand the new BluePrint3D Shared Options fieldset.
Check the boxes for the option groups you want to assign and hit Save!

📜 License

This software is provided free of charge for personal or commercial use. However, the resale, redistribution, or sublicensing of this source code, modified or unmodified, for direct financial gain is strictly prohibited.

Please see the LICENSE.txt file for full terms and conditions.

Owned by: BluePrint3D Ltd (Company Registration Number: 13473806)
Email: support@blueprint3d.dev

blueprint3d / module-shared-product-options

Maintainers

Package info

Statistics

Security