About the Plugin
Sync Display Variations adds a "Sync Displays" admin tool to WooCommerce that automatically matches "display" products with their corresponding "clicker" products, then populates each display variation's description and regular price from the clicker variations that belong in it.
Key Features
- 😊 Three Display Types: Handles single-clicker displays, combo displays whose
pa_ends values bundle several shape products, and simple-product bundle displays - each filled with one of every size.
- ✅ Curated Sources: Auto-detection proposes the source products; tick or untick them per display to add or remove items. Your selection is saved per display.
- 🛂 Confidence Flags: Low-confidence matches are flagged for review before applying any changes.
- 🛈 Price Calculation: Prices are computed as the sum of the regular prices of every included variation.
- 🗓 Description Generation: A detailed "1x ..." includes list, ordered by size, showing exactly which items go into each display.
- 📦 Component Stock Sync: Selling a display decrements each managed source variation by one per unit; unmanaged sources (e.g. titanium) are left untouched, and stock is restored on cancel/refund.
- ⏳ Live Out-of-Stock Notes: When a source size sells out, the display description auto-updates to flag that line as “will ship later”.
- 🔍 Diagnostics View: A read-only panel lists every display and source product the tool can find, and explains why any is skipped.
- 😂 Safe Preview: Review all changes before applying - nothing is written until you click Apply.
- 🗣 Never Zero: A display that matches zero items is always skipped, never zeroed.
- 🗸 Configurable: Customize the display keyword, size attribute, combo attribute, and item line formatting.
Perfect For
- Body Jewelry Stores: Managing displays (gauge + colour combinations) and individual clickers (with multiple sizes).
- Any WooCommerce Store: With variable products that contain sub-sets of other products.
🎯 How It Works
On WooCommerce → Sync Displays, the plugin shows a preview of every display product and the source products it matched to. Under each display, tick or untick the source products to curate exactly what it includes (saved per display). Each display lists its variations with the calculated new description (the includes list) and price. Review, tick the displays you want to update, and click "Apply checked displays". The plugin recomputes everything from scratch and writes only the checked displays.
Installation Instructions
- Download the Plugin: Click the download button to get the latest version.
- Upload to WordPress: Go to Plugins → Add New → Upload Plugin, then select the downloaded zip file.
- Activate the Plugin: Click “Activate Plugin” after the upload completes.
- Run a Sync: Navigate to WooCommerce → Sync Displays and review the preview.
- Apply Changes: Tick the displays you want to update and click “Apply checked displays”.
Configuration
Edit the constants near the top of plugin.php to customize:
- CLKDS_DISPLAY_KEYWORD: The word that identifies a display in the title (default:
display).
- CLKDS_SIZE_ATTR: The size attribute the clicker has but the display doesn't (default:
pa_size).
- CLKDS_ONLY_IN_STOCK: Count only in-stock clicker variations (default:
false).
- clkds_overrides(): Force a display-to-clicker pairing when auto-match gets it wrong.
- clkds_format_item_line(): Change the wording or order of each includes line.
⚠️ Requirements
WordPress: 5.0 or higher
WooCommerce: 3.0 or higher
PHP: 7.4 or higher
License: GPLv2 or later