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](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [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

[1.0.0]: https://github.com/magdev/wc-composable-product/releases/tag/v1.0.0