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.3.2] - 2026-03-01

Added

• Custom page template for composable products — replaces the standard WooCommerce two-column layout (large image gallery + summary) with a compact product info header and full-width product selector grid
• New Twig template single-product-composable.html.twig with PHP loader for WooCommerce template override
• Body class single-product-composable for CSS scoping on composable product pages

Changed

• Renamed Twig templates from *.twig to *.html.twig (proper Twig naming convention)
• Refreshed translation catalog (.pot) with accurate file references and line numbers
• Updated all .po/.mo translation files via msgmerge

[1.3.1] - 2026-03-01

Added

• PHPUnit test suite: 57 unit tests covering all 6 core classes (ProductType, StockManager, CartHandler, Plugin, Admin/ProductData, Admin/Settings)
• Brain Monkey + Mockery for WordPress/WooCommerce function mocking without a full WP installation
• WooCommerce class stubs in tests/stubs/ for classes extended by the plugin (WC_Product, WC_Settings_Page, etc.)
• PHPCS with WordPress-Extra and PHPCompatibilityWP coding standards (phpcs.xml.dist)
• PHPCS job in release workflow — coding standards must pass before release is built
• PHP lint job in release workflow — syntax-checks all PHP files before testing
• Test job in release workflow — tests must pass before release package is built
• Testing and linting sections in README and CLAUDE.md

Changed

• PSR-4 refactored: Renamed files to PascalCase (Product_Type → ProductType, etc.) and changed namespace from WC_Composable_Product to Magdev\WcComposableProduct
• Updated all cross-references in PHP files, main plugin file, composer.json, CSS/JS doc comments, and translation file source comments
• PHPUnit upgraded from 9.6 to 10 (Brain Monkey 2.7 supports both)
• WPCS formatting applied to all source files (tabs, Yoda conditions, strict in_array, wp_json_encode, long array syntax)
• Release workflow now has four stages: lint + phpcs (parallel) → test → build-release
• Composer platform pinned to PHP 8.3 to prevent incompatible dependency locks

[1.3.0] - 2026-03-01

Added

• Include Non-Public Products: New option to include draft and private products in composable product selections
  • Global setting under WooCommerce > Settings > Composable Products
  • Per-product override in the Composable Options tab (Use global default / Yes / No)
  • Useful when products should only be sold as part of a composition, not individually
• Translations for the new setting in all 6 locales (de_DE, de_CH, fr_CH, it_CH + informal variants)

[1.2.1] - 2026-03-01

Changed

• Consolidated documentation: merged INSTALL.md into README.md, merged IMPLEMENTATION.md into CLAUDE.md
• Condensed CLAUDE.md from ~1960 lines to ~160 lines, keeping only essential architecture and lessons learned
• README.md now includes full installation guide, usage tutorial, and troubleshooting section
• Cleaned up .gitignore

Removed

• INSTALL.md (content merged into README.md)
• IMPLEMENTATION.md (content merged into CLAUDE.md)

[1.2.0] - 2026-03-01

Fixed

• CRITICAL: Product selection always empty regardless of configuration (categories, tags, or SKUs)
  • Root cause: Product query used a meta_query checking _product_type in wp_postmeta, but WooCommerce stores product types in the product_type taxonomy — the != comparison with a non-existent meta key caused an INNER JOIN returning zero results
  • Fix: Replaced broken meta_query with correct tax_query using product_type taxonomy to exclude composable products
• CRITICAL: Cart price always 0.00 despite correct frontend price calculation
  • Root cause: composable_price_calculated flag was persisted to the cart session, preventing price recalculation on subsequent page loads — but set_price() only modifies the in-memory product object and is lost between requests
  • Fix: Removed per-item session flag; the existing static $already_calculated flag already prevents duplicate calculation within a single request
• Admin tab rendering: Both General and Composable Options panels visible on initial page load
  • Root cause: JavaScript manually showed #composable_product_data via .show() without hiding the General panel
  • Fix: Trigger WooCommerce's native tab click instead, so the tab system handles panel visibility correctly

Added

• Gitea CI/CD release workflow (.gitea/workflows/release.yml)
  • Triggered on v* tags
  • Installs PHP 8.3 with production Composer dependencies
  • Compiles .po → .mo translations
  • Verifies plugin version matches tag
  • Builds release ZIP with proper WordPress directory structure
  • Generates SHA-256 checksums
  • Verifies package contains main plugin file and vendor directory
  • Extracts changelog for release notes
  • Creates Gitea release with attachments via API

Removed

• Debug logging from v1.1.14 (no longer needed after root cause identified)

Technical

• Modified files: includes/Product_Type.php, includes/Cart_Handler.php, assets/js/admin.js
• New file: .gitea/workflows/release.yml
• Product query now correctly uses tax_query with product_type taxonomy (NOT IN operator)
• Cart price recalculated on every request via woocommerce_before_calculate_totals hook
• Admin JS uses $('ul.product_data_tabs li.composable_options a').trigger('click') for native WooCommerce tab handling

[1.1.14] - 2025-12-31

Added

• DEBUG: Comprehensive debug logging to troubleshoot product retrieval issues
• Error log output shows selection criteria, query arguments, and results
• Logs each product/variation being added to help identify filtering issues
• Enable by setting WP_DEBUG to true in wp-config.php

Technical

• Modified file: includes/Product_Type.php (added error_log statements throughout get_available_products())
• Logs criteria array (categories, tags, SKUs)
• Logs WP_Query arguments before execution
• Logs number of posts found by query
• Logs each variable product's variation count
• Logs each variation/simple product being added with name
• Logs total products available at end
• All logging wrapped in WP_DEBUG checks (no performance impact in production)

Notes

• This is a debug release to help diagnose why products aren't showing
• No functional changes from v1.1.13
• User should enable WP_DEBUG and check debug.log or error.log
• Log output will show exactly where products are being filtered out
• All translation files remain at 100% completion (57/57 strings)

[1.1.13] - 2025-12-31

Fixed

• CRITICAL: "No products available for selection" message showing even when products are configured
• Removed overly strict is_in_stock() requirement that was filtering out all products
• Products now show regardless of stock status (out-of-stock items are displayed but disabled)
• Added 'relation' => 'AND' to meta_query for proper handling of multiple meta conditions

Changed

• Product retrieval now shows all purchasable products, not just in-stock ones
• Stock status still displayed on frontend with appropriate styling
• Out-of-stock items shown but disabled via checkbox and visual indicators
• Frontend stock management from v1.1.0 still fully functional

Technical

• Modified file: includes/Product_Type.php (lines 117-124, 177, 181)
• Changed from $variation->is_in_stock() && $variation->is_purchasable() to just $variation->is_purchasable()
• Changed from $product->is_in_stock() && $product->is_purchasable() to just $product->is_purchasable()
• Added 'relation' => 'AND' to meta_query array for WordPress query compatibility

Notes

• This fixes the issue where NO products were showing in the selector
• Stock validation still occurs at add-to-cart time (Stock_Manager class)
• Frontend still displays stock badges (in stock, low stock, out of stock)
• Out-of-stock items remain non-selectable via disabled checkboxes
• All translation files remain at 100% completion (57/57 strings)

[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