wc-composable-product/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.12] - 2025-12-31

Fixed

• CRITICAL: Variable product variations still not appearing in product selector after v1.1.11 release
• Changed variation retrieval method from get_available_variations() to get_children() for more reliable variation ID retrieval
• get_available_variations() returns complex data arrays which may not work in all contexts
• get_children() returns simple array of variation IDs directly, ensuring consistent results

Technical

• Modified file: includes/Product_Type.php (lines 171-184)
• Changed from $product->get_available_variations() to $product->get_children()
• More direct and reliable method for retrieving variation IDs
• Each variation ID passed to wc_get_product() for full product object
• Maintains all stock and purchasability checks from v1.1.11

Notes

• This is a patch release fixing the variable product support introduced in v1.1.11
• User reported "nope, still no product selectable" after v1.1.11
• Root cause: get_available_variations() returns variation data arrays instead of clean IDs
• get_children() is the standard WooCommerce method for retrieving variation IDs
• All translation files remain at 100% completion (57/57 strings - no changes needed)

[1.1.11] - 2025-12-31

Added

• FEATURE: Variable product support - composable products can now include variable products and their variations
• Variable products automatically expand to show all available variations as selectable items
• Each variation displays with full attribute information (e.g., "Product - Color: Red, Size: Large")

Fixed

• Products not showing in selector when all available products were variable products
• Variable products were being filtered out because parent products aren't directly purchasable

Changed

• Modified get_available_products() to detect and handle variable products
• Variable products now expand into their individual variations
• Each variation checked individually for stock status and purchasability
• Simple products continue to work exactly as before

Technical

• Modified file: includes/Product_Type.php (lines 160-188)
• Added logic to detect is_type('variable') products
• Uses get_available_variations() to retrieve all variations
• Each variation validated with is_in_stock() and is_purchasable()
• Maintains backward compatibility with simple products

Notes

• This is a feature enhancement release, not a bug fix
• Resolves the issue where categories containing only variable products showed no selections
• Variations display with their parent product name plus selected attributes
• Stock management works correctly for both simple products and variations
• All translation files remain at 100% completion (57/57 strings - no new strings added)

[1.1.10] - 2025-12-31

Fixed

• CRITICAL: Admin panel - Both General and Composable tabs visible simultaneously on initial page load
• CRITICAL: Frontend - No products showing in product selector, only cart button and pricing visible
• Empty product grid now shows helpful message instead of blank space

Changed

• Added explicit display: none to #composable_product_data panel for proper initial hiding
• Panel now only shows when body.product-type-composable class is present
• Added empty state message in product selector template when no products are configured
• Cleared Twig cache to ensure template changes take effect

Added

• Empty state message: "No products available for selection. Please configure the product criteria in the admin panel."
• Translations for empty state message in all 6 supported locales (de_DE, de_DE_informal, de_CH, de_CH_informal, fr_CH, it_CH)
• Recompiled .mo translation files

Technical

• Modified files: assets/css/admin.css (lines 7-16), templates/product-selector.twig (lines 12-15)
• Root cause (admin): Panel lacked explicit CSS hiding rule, relied only on hidden class
• Root cause (frontend): No feedback when products array is empty
• Solution: CSS specificity + empty state conditional in Twig template

Notes

• This release fixes two critical bugs discovered immediately after v1.1.9
• Admin interface now correctly hides composable panel until product type is selected
• Frontend provides clear user feedback when product selection is unavailable
• All translation files now 100% complete (57/57 strings)

[1.1.9] - 2025-12-31

Fixed

• CRITICAL: Admin rendering completely broken - tabs disappeared and fields appeared out of context after v1.1.8 release
• CSS selectors were too broad, hiding tab navigation along with field groups
• Removed !important flags that caused overly aggressive hiding

Changed

• Made CSS selectors more specific: .options_group.show_if_composable for field groups only
• Added separate rule for tab links: .product_data_tabs li.composable_options
• Tab navigation now works correctly without hiding itself

Technical

• Modified files: assets/css/admin.css (lines 22-40)
• Root cause: .show_if_composable class used by WooCommerce for both tab links AND field groups
• Solution: Separate selectors for each use case to prevent unintended hiding

Notes

• This release fixes critical regression introduced in v1.1.8
• Admin interface now renders correctly with visible tabs and properly positioned fields
• No !important flags needed with specific selectors

[1.1.8] - 2025-12-31

Fixed

• CRITICAL: Admin rendering bug where both General and Composable Options tabs showed simultaneously on initial page load
• CRITICAL: Frontend product selector not appearing on product pages - WooCommerce's default add-to-cart button now hidden for composable products
• CRITICAL: Price formatting not localized - prices now display with proper currency symbols, decimal separators, and thousand separators for all locales

Added

• wc_price() Twig function for proper price formatting in templates
• formatPrice() JavaScript method with full WooCommerce locale support
• Price format localization data passed to frontend JavaScript (decimal/thousand separators, currency position, number of decimals)
• hide_default_add_to_cart() method to prevent WooCommerce's default purchase UI for composable products

Changed

• Enhanced CSS specificity with !important flags for proper tab visibility control
• Template now uses {{ fixed_price_html|raw }} instead of raw currency concatenation
• Product selector passes pre-formatted price HTML from wc_price() function
• Frontend JavaScript updates prices dynamically using WooCommerce format settings

Technical

• Modified files: assets/css/admin.css (+24 lines), includes/Cart_Handler.php (+14 lines), includes/Plugin.php (+7 lines), includes/Product_Selector.php (+2 lines), templates/product-selector.twig, assets/js/frontend.js (+28 lines)
• All PHP files pass syntax validation
• Supports Swiss format (CHF 50.-), European format (50,00 €), US format ($50.00), and all other WooCommerce locales
• Thousand separator support: comma (1,000), dot (1.000), apostrophe (1'000), space (1 000)

Notes

• This release fixes all three critical UI bugs reported in CLAUDE.md
• Admin tabs now display correctly on initial page load without JavaScript flicker
• Frontend product selector is now the only purchase interface (no WooCommerce default button)
• All prices maintain proper locale formatting during dynamic updates

[1.1.7] - 2025-12-31

Added

• Compiled .mo translation files for all 6 supported locales (de_DE, de_DE_informal, de_CH, de_CH_informal, fr_CH, it_CH)
• WordPress can now load translations in admin and frontend areas

Fixed

• CRITICAL: Missing translations in WordPress admin when using non-English locales
• Settings page ("Composable Products", "Default Selection Limit", etc.) now properly translated
• Product settings ("Composable Options", "Selection Criteria", etc.) now properly translated

Technical

• Compiled .mo files from .po sources using msgfmt
• All 6 locales now have complete translation coverage (56/56 strings translated and compiled)
• .mo files required for WordPress i18n system to display translations

Notes

• Previous versions included .po translation files but WordPress requires compiled .mo files
• This release makes all existing translations actually visible to users

[1.1.6] - 2025-12-31

Added

• Complete translations for all admin area strings across all 6 supported locales
• "Fixed Price" field label and description translations

Changed

• Updated translation template (.pot) to version 1.1.6
• Simplified "How to calculate the price" description text

Technical

• All .po files now include translations for v1.1.4 admin strings
• 100% translation coverage maintained across all locales (56/56 strings)
• German formal/informal variants properly differentiated (Sie vs. du)

[1.1.5] - 2025-12-31

Fixed

• CRITICAL: Fixed Twig template error "Unknown 'esc_attr' filter" when rendering product selector
• Template compatibility issue when other plugins (e.g., WooCommerce Tier and Package Prices) use Twig
• WordPress escaping functions now properly registered as both Twig functions AND filters

Technical

• Added TwigFilter registrations for esc_html, esc_attr, and esc_url in Plugin::init_twig()
• Template can now use both syntax styles: {{ value|esc_attr }} (filter) and {{ esc_attr(value) }} (function)
• Prevents conflicts when multiple plugins bundle their own Twig installations

Notes

• Previous versions only registered escaping functions as Twig functions, not filters
• Template used filter syntax (|esc_attr) which failed when parsed by external Twig instances
• Fix ensures compatibility regardless of which Twig instance processes the template

[1.1.4] - 2025-12-31

Added

• Fixed price field in Composable Options tab for easier price configuration
• JavaScript toggle to show/hide fixed price field based on selected pricing mode

Changed

• Simplified pricing mode description text in admin interface
• Fixed price field now appears dynamically when "Fixed" pricing mode is selected

Technical

• Added _regular_price field with composable_fixed_price_field CSS class in Product_Data.php
• Implemented toggleFixedPriceField() JavaScript function in assets/js/admin.js
• Progressive disclosure pattern improves admin UX by showing relevant fields only

[1.1.3] - 2024-12-31

Added

• WooCommerce HPOS (High-Performance Order Storage) compatibility declaration
• Prevents duplicate price calculations to avoid conflicts with other pricing plugins

Fixed

• WooCommerce compatibility warnings with Analytics and other WooCommerce extensions
• Price calculation conflicts with third-party pricing plugins

Technical

• Added before_woocommerce_init hook to declare HPOS compatibility
• Implemented static flag in Cart_Handler::calculate_cart_item_price() to prevent multiple executions
• Added composable_price_calculated flag to cart items to prevent re-calculation by other plugins
• Ensures composable products work with WooCommerce's modern order storage system

[1.1.2] - 2024-12-31

Fixed

• CRITICAL: Fixed persistent "Class WC_Settings_Page not found" error that continued in v1.1.1
• Root cause: Settings.php was being included too early (during plugin init) before WC_Settings_Page was loaded
• Solution: Delayed Settings.php inclusion until woocommerce_get_settings_pages filter when class is guaranteed to exist

Technical

• Removed require_once Settings.php from Plugin::includes() (line 93)
• Added require_once Settings.php to Plugin::add_settings_page() (line 196)
• Settings file now loads on-demand when WooCommerce requests settings pages
• Previous hook change (woocommerce_init) was insufficient - class loading order was the real issue

Notes

• v1.1.1 attempted to fix this with hook change but the error persisted
• This version addresses the actual root cause: premature class extension

[1.1.1] - 2024-12-31

Fixed

• Settings page initialization timing issue causing "Class WC_Settings_Page not found" error
• Changed hook from woocommerce_loaded to woocommerce_init to ensure WC_Settings_Page class is available
• Plugin now initializes after all WooCommerce core classes are loaded

Technical

• Hook changed from woocommerce_loaded to woocommerce_init in wc-composable-product.php:65
• woocommerce_init fires after WooCommerce has finished loading all its core classes including settings

[1.1.0] - 2024-12-31

Added

• Stock Management Integration: Complete inventory tracking system for composable products
  • Stock validation during product selection and add-to-cart
  • Automatic stock deduction when orders are completed/processed
  • Automatic stock restoration on order cancellation/refund
  • Stock status indicators in product selector (In stock, Low stock, Out of stock)
  • Visual feedback for out-of-stock items (disabled checkboxes, reduced opacity)
  • Low stock warnings when 5 or fewer items remain
  • Prevention of out-of-stock item selection
  • Order notes documenting stock changes

Technical

• New Stock_Manager class handling all stock operations
• Integration with WooCommerce order status hooks
• Stock information passed to frontend via Twig template
• Enhanced CSS styling for stock status badges
• Stock data stored in order item meta for accurate tracking
• Backorder support detection and handling

Translation

• Added 8 new translatable strings for stock messages
• Updated Italian (Switzerland) translation with stock-related terms
• Updated translation template (.pot file)

[1.0.1] - 2024-12-31

Fixed

• Fatal error "Class WC_Settings_Page not found" during plugin activation
• Changed initialization hook from plugins_loaded to woocommerce_loaded to ensure WooCommerce classes are available before plugin initialization
• Settings page now correctly integrates as a tab in WooCommerce > Settings

Technical

• Plugin now waits for woocommerce_loaded action before initializing
• Prevents race condition where WooCommerce classes weren't loaded yet
• Settings tab appears correctly in WooCommerce settings interface

1.0.0 - 2024-12-31

Added

• Initial release
• Composable product type for WooCommerce
• Product selection by category, tag, or SKU
• Configurable selection limits (global and per-product)
• Two pricing modes: fixed price or sum of selected products
• Admin settings page
• Frontend product selector with grid layout
• AJAX add-to-cart functionality
• Twig template engine integration
• Full internationalization support
• Responsive design
• WooCommerce cart integration
• Product data validation

Features

• Select products from predefined categories, tags, or SKUs
• Limit number of items customers can select
• Visual product selector with images and prices
• Real-time price calculation
• Clean, modern UI
• Mobile responsive
• Translation ready