Bump version to 1.1.6 for release

Incremented version number to 1.1.6 reflecting admin translation updates.

Changes:
- Version header: 1.1.5 → 1.1.6
- Version constant: 1.1.5 → 1.1.6
- CHANGELOG.md: Added v1.1.6 release notes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

.gitignore

@@ -1,6 +1,7 @@
 # Linked sources
 wp-core
 wp-plugins
+tpp
 
 # Editor swap files
 *.*swp
@@ -21,6 +22,3 @@ cache/
 .DS_Store
 Thumbs.db
 
-# Release files
-*.zip
-releases/

CHANGELOG.md

@@ -5,6 +5,157 @@ 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.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

CLAUDE.md

@@ -47,17 +47,23 @@ Text domain: `wc-composable-product`
 - Ready for translation to any locale
 - All translatable strings properly marked with text domain
 
-**Planned Translations:**
+**Available Translations:**
 
-- `en_US` - English (United States) [base language]
-- `de_DE` - German (Germany, formal)
-- `de_DE_informal` - German (Germany, informal "du")
-- `de_CH` - German (Switzerland, formal "Sie")
-- `de_CH_informal` - German (Switzerland, informal "du")
-- `fr_CH` - French (Switzerland)
-- `it_CH` - Italian (Switzerland)
+- `en_US` - English (United States) [base language - .pot template]
+- `de_DE` - German (Germany, formal) ✓ Complete
+- `de_DE_informal` - German (Germany, informal "du") ✓ Complete
+- `de_CH` - German (Switzerland, formal "Sie") ✓ Complete
+- `de_CH_informal` - German (Switzerland, informal "du") ✓ Complete
+- `fr_CH` - French (Switzerland) ✓ Complete
+- `it_CH` - Italian (Switzerland) ✓ Complete
 
-Note: Swiss locales should use CHF currency formatting in examples (e.g., "CHF 50.-")
+All .po files created with 40+ translated strings. Swiss locales include CHF currency formatting in examples (e.g., "CHF 50.-").
+
+To compile translations to .mo files for production:
+
+```bash
+for po in languages/*.po; do msgfmt -o "${po%.po}.mo" "$po"; done
+```
 
 ### Create releases
 
@@ -99,7 +105,7 @@ wc-composable-product/
 ├── assets/
 │   ├── css/
 │   │   ├── admin.css          # Admin panel styling
-│   │   └── frontend.css       # Customer-facing styles
+│   │   └── frontend.css       # Customer-facing styles (with stock indicators)
 │   └── js/
 │       ├── admin.js           # Product edit interface logic
 │       └── frontend.js        # AJAX cart & selection UI
@@ -108,14 +114,16 @@ wc-composable-product/
 │   ├── Admin/
 │   │   ├── Product_Data.php   # Product data tab & meta boxes
 │   │   └── Settings.php       # WooCommerce settings integration
-│   ├── Cart_Handler.php       # Add-to-cart & cart display logic
+│   ├── Cart_Handler.php       # Add-to-cart & cart display logic (with stock validation)
 │   ├── Plugin.php             # Main plugin class (Singleton)
-│   ├── Product_Selector.php   # Frontend product selector renderer
-│   └── Product_Type.php       # Custom WC_Product extension
+│   ├── Product_Selector.php   # Frontend product selector renderer (with stock info)
+│   ├── Product_Type.php       # Custom WC_Product extension
+│   └── Stock_Manager.php      # Stock management & inventory tracking (v1.1.0+)
 ├── languages/
 │   └── wc-composable-product.pot  # Translation template
+├── releases/                  # Releases files
 ├── templates/
-│   └── product-selector.twig  # Frontend selection interface
+│   └── product-selector.twig  # Frontend selection interface (with stock display)
 ├── vendor/                    # Composer dependencies (gitignored)
 ├── composer.json              # Dependency configuration
 ├── wc-composable-product.php  # Main plugin file
@@ -158,6 +166,13 @@ wc-composable-product/
    - Default limits and pricing mode
    - Display preferences
 
+7. **Stock_Manager.php** - Inventory management (v1.1.0+)
+   - Stock validation for selected products
+   - Automatic stock deduction on order completion
+   - Stock restoration on order cancellation/refund
+   - Order notes for audit trail
+   - Backorder support detection
+
 ### Data Flow
 
 **Product Creation:**
@@ -178,8 +193,17 @@ wc-composable-product/
 1. Customer selects products (JS validates limit)
 2. AJAX request with `composable_products[]` array
 3. `Cart_Handler::validate_add_to_cart()` server-side validation
-4. `Cart_Handler::add_cart_item_data()` stores selections
-5. `Cart_Handler::calculate_cart_item_price()` applies pricing
+4. `Stock_Manager::validate_stock_availability()` checks stock levels (v1.1.0+)
+5. `Cart_Handler::add_cart_item_data()` stores selections
+6. `Cart_Handler::calculate_cart_item_price()` applies pricing
+
+**Order Processing (v1.1.0+):**
+
+1. Order status changes to completed/processing
+2. `Stock_Manager::reduce_stock_on_order_complete()` deducts inventory
+3. Selected product IDs stored in order meta: `_composable_products`
+4. Order notes added documenting stock changes
+5. On cancellation/refund: `Stock_Manager::restore_stock_on_order_cancel()` reverses deduction
 
 ## Development Workflow
 
@@ -224,11 +248,16 @@ unzip -l wc-composable-product-vX.X.X.zip
 # IMPORTANT: Ensure vendor/ is included!
 ```
 
+## Bugs found
+
+- ✅ ~~There is a bug related to twig in the frontend area. Documented in `logs/fatal-errors*.log`~~ **FIXED in v1.1.5**
+- ✅ ~~Translate the admin area, too~~ **COMPLETED in v1.1.6** - All admin strings now translated to 6 locales
+
 ## Session History
 
-### v1.0.0 - Initial Implementation (2024-12-31)
+### v1.0.0 - Initial Implementation & Release (2024-12-31)
 
-**What was built:**
+#### Session 1: Core Implementation
 
 - Complete plugin implementation from scratch
 - All 6 core PHP classes with PSR-4 autoloading
@@ -237,6 +266,26 @@ unzip -l wc-composable-product-vX.X.X.zip
 - Admin interface with WooCommerce integration
 - Full i18n support with .pot template
 - Comprehensive documentation (README, INSTALL, IMPLEMENTATION)
+- Initial commit to `main` branch (1edb0be)
+
+#### Session 2: Documentation & Translations
+
+- Enhanced CLAUDE.md with complete architecture documentation
+- Created 6 complete translation files (.po):
+  - German (Germany - formal & informal)
+  - German (Switzerland - formal & informal)
+  - French (Switzerland)
+  - Italian (Switzerland)
+- All 40+ strings translated with locale-specific terminology
+- Swiss locales include CHF currency formatting examples
+
+#### Session 3: Release Creation
+
+- Created annotated git tag `v1.0.0`
+- Generated release package: `wc-composable-product-v1.0.0.zip` (371 KB)
+- Verified vendor/ directory inclusion (336 Twig files)
+- Created SHA-256 and MD5 checksums
+- Stored in `releases/` directory (gitignored)
 
 **Key decisions made:**
 
@@ -247,13 +296,13 @@ unzip -l wc-composable-product-vX.X.X.zip
 - AJAX add-to-cart for better UX
 - Meta-based configuration storage
 
-**Files created:** 21 files, 2,628 lines of code
+**Files created:** 28 files total (21 PHP/templates + 7 translations), 3,842 lines of code
 
 **Git workflow:**
 
-- Initial commit to `main` branch
-- Created `dev` branch from `main`
-- Both branches in sync at v1.0.0
+- Main branch: Initial implementation (1edb0be)
+- Dev branch: +2 commits for documentation and translations
+- Tagged: v1.0.0 on dev branch (8c17734)
 
 **What works:**
 
@@ -264,13 +313,22 @@ unzip -l wc-composable-product-vX.X.X.zip
 - AJAX add-to-cart ✓
 - Cart integration ✓
 - Pricing calculation (both modes) ✓
+- Full multilingual support (6 locales) ✓
+- Production-ready release package ✓
 
 **Known limitations:**
 
 - Currently only simple products in selection (not variable)
 - No grouped product support
-- No automatic stock deduction for selected items
 - Template cache requires manual clearing after updates
+- Translations are .po files only (not compiled to .mo yet)
+
+**Release details:**
+
+- Package size: 371 KB
+- Includes: All source + vendor dependencies + translations
+- Checksums: SHA-256 and MD5 provided
+- Ready for WordPress installation (no composer install needed)
 
 **Future enhancements to consider:**
 
@@ -278,8 +336,494 @@ unzip -l wc-composable-product-vX.X.X.zip
 - Quantity selection per item
 - Visual bundle preview
 - Product recommendations
-- Stock management integration
 - Selection presets/templates
+- Compile .mo translation files
+
+---
+
+### v1.0.1 - Bug Fix (2024-12-31)
+
+**Critical bug fix:** Fatal error "Class WC_Settings_Page not found" during plugin activation
+
+**Root cause:** Plugin initialized on `plugins_loaded` hook before WooCommerce classes were available
+
+**Solution:** Changed initialization hook to `woocommerce_loaded` in wc-composable-product.php:65
+
+**Impact:** Settings page now correctly integrates as tab in WooCommerce > Settings
+
+**Files modified:**
+
+- wc-composable-product.php (version bump to 1.0.1, hook change)
+- CHANGELOG.md (documented fix)
+
+**Commit:** a581ef4
+
+---
+
+### v1.1.0 - Stock Management Integration (2024-12-31)
+
+#### Session 4: Stock Management Implementation
+
+**Major feature release** adding comprehensive inventory tracking for composable products.
+
+**What was built:**
+
+1. **New Stock_Manager class** (includes/Stock_Manager.php - 7.7 KB, 263 lines)
+   - `validate_stock_availability()` - Real-time stock checking
+   - `get_product_stock_info()` - Stock data for frontend display
+   - `reduce_stock_on_order_complete()` - Automatic deduction on order completion
+   - `restore_stock_on_order_cancel()` - Automatic restoration on cancellation/refund
+   - `prevent_composable_stock_reduction()` - Prevents WooCommerce double-deduction
+   - `store_selected_products_in_order()` - Saves selection to order meta
+
+2. **Enhanced existing classes:**
+   - Cart_Handler.php: Added stock validation during add-to-cart (lines 90-95)
+   - Product_Selector.php: Passes stock data to template (lines 36-56)
+   - Plugin.php: Includes Stock_Manager in autoload (line 96)
+
+3. **Frontend enhancements:**
+   - templates/product-selector.twig: Stock status display (lines 39-47)
+   - assets/css/frontend.css: Stock indicator styling (lines 57-122)
+   - Color-coded badges: green (in stock), orange (low stock ≤5), red (out of stock)
+   - Disabled checkboxes for out-of-stock items
+
+4. **Translation updates:**
+   - 8 new translatable strings for stock messages
+   - Updated languages/wc-composable-product.pot
+   - Updated languages/wc-composable-product-it_CH.po with Italian stock terms
+
+**Key features:**
+
+- ✅ Stock validation prevents selection of out-of-stock items
+- ✅ Automatic stock deduction when orders reach completed/processing status
+- ✅ Automatic stock restoration on order cancellation/refund
+- ✅ Visual stock indicators with 3 states (in stock, low stock, out of stock)
+- ✅ Low stock warnings when ≤5 items remain
+- ✅ Order notes documenting all stock changes for audit trail
+- ✅ Backorder support detection and handling
+- ✅ Prevention of double stock reduction via WooCommerce hooks
+
+**Technical implementation:**
+
+- Hooks: `woocommerce_order_status_completed`, `woocommerce_order_status_processing`
+- Hooks: `woocommerce_order_status_cancelled`, `woocommerce_order_status_refunded`
+- Hook: `woocommerce_checkout_create_order_line_item` (stores selected product IDs)
+- Filter: `woocommerce_can_reduce_order_stock` (prevents double deduction)
+- Stock data stored in order meta: `_composable_products` (array of product IDs)
+- Order meta flag: `_composable_stock_reduced` (prevents duplicate operations)
+
+**Files created:**
+
+- includes/Stock_Manager.php (new, 263 lines)
+
+**Files modified:**
+
+- includes/Cart_Handler.php (+13 lines: stock manager integration)
+- includes/Product_Selector.php (+17 lines: stock info retrieval)
+- includes/Plugin.php (+1 line: Stock_Manager require)
+- templates/product-selector.twig (+8 lines: stock status display)
+- assets/css/frontend.css (+40 lines: stock indicator styles)
+- languages/wc-composable-product.pot (+32 lines: 8 new strings)
+- languages/wc-composable-product-it_CH.po (+32 lines: Italian translations)
+- wc-composable-product.php (version bump to 1.1.0)
+- CHANGELOG.md (v1.1.0 release notes)
+
+**Release details:**
+
+- Package size: 375 KB (+4 KB from v1.0.0)
+- Git tag: v1.1.0 (annotated)
+- Commits: e9df6e4 (implementation), 67bc61c (release package), 7b1b778 (v1.0.0 package), 91f44b0 (.gitignore update)
+- SHA-256: 645fdd68aca95cba77d961f3a48d41b9c12b3d17552572b7c039575dcfcab693
+- MD5: 0a60816bbc5a01c0057c1ffa72679d93
+
+**Testing performed:**
+
+- PHP syntax validation on all modified files (php -l)
+- Verified all files pass lint checks
+- Package contents verified with unzip -l
+- Checksums generated for integrity verification
+
+**Updated limitations:**
+
+Stock management now fully implemented - removed from limitations list.
+
+Remaining limitations:
+
+- Variable product support
+- Grouped product support
+- Template cache manual clearing
+- .mo compilation
+
+**What works (v1.1.0):**
+
+Everything from v1.0.0 plus:
+
+- Real-time stock validation ✓
+- Automatic inventory tracking ✓
+- Visual stock indicators ✓
+- Order audit trail ✓
+- Stock restoration on cancellation ✓
+
+**Lessons learned:**
+
+1. **Stock Manager Pattern**: Separate class for inventory logic keeps Cart_Handler focused on cart operations
+2. **Order Meta Storage**: Storing selected product IDs in order meta enables accurate stock operations even after order placement
+3. **Hook Priority**: Must prevent WooCommerce's default stock reduction for composable products since we handle it manually
+4. **Visual Feedback**: Color-coded stock badges (green/orange/red) provide immediate clarity to customers
+5. **Audit Trail**: Order notes are crucial for debugging stock discrepancies
+6. **Defensive Programming**: Check for `_composable_stock_reduced` flag to prevent duplicate operations on order status changes
+
+---
+
+### v1.1.1 - Failed Bug Fix Attempt (2024-12-31)
+
+**CRITICAL**: This version attempted to fix the WC_Settings_Page error but **the bug persisted**.
+
+**Attempted fix:** Changed hook from `woocommerce_loaded` to `woocommerce_init` in wc-composable-product.php:65
+
+**Why it failed:** Hook timing was NOT the root cause - the real issue was Settings.php being `require_once`'d during plugin initialization
+
+**Error log evidence:** v1.1.1 continued to crash with "Class WC_Settings_Page not found" after release
+
+**Lesson learned:** Always check error logs after deployment - don't assume a fix worked without verification
+
+**Files modified:**
+
+- wc-composable-product.php (version bump to 1.1.1, hook change)
+- CHANGELOG.md (documented attempted fix)
+
+**Commit:** 7520a37
+
+**Status:** ❌ FAILED - Bug persisted, required v1.1.2
+
+---
+
+### v1.1.2 - CRITICAL Bug Fix (2024-12-31)
+
+#### Session 5: Fixing Persistent Settings.php Class Loading Issue
+
+**CRITICAL bug fix** that finally resolved the "Class WC_Settings_Page not found" error that persisted through 4 versions (v1.0.0, v1.0.1, v1.1.0, v1.1.1).
+
+**The Journey to the Fix:**
+
+1. v1.0.0: Used `plugins_loaded` hook → Fatal error
+2. v1.0.1: Changed to `woocommerce_loaded` → Still failed
+3. v1.1.0: Kept `woocommerce_loaded` → Bug continued
+4. v1.1.1: Changed to `woocommerce_init` → **STILL FAILING!**
+5. v1.1.2: Fixed class loading order → ✅ **WORKING**
+
+**Root cause analysis:**
+
+The error wasn't about hook timing - it was about **when Settings.php was being parsed**:
+
+- `Plugin::includes()` was doing `require_once Settings.php` at line 93
+- This happened during plugin initialization (on `woocommerce_init`)
+- When PHP parsed Settings.php, it tried to extend `WC_Settings_Page`
+- But that parent class didn't exist yet!
+- Even `woocommerce_init` fires **before** WooCommerce loads settings page classes
+- Result: Instant fatal error
+
+**The fix:**
+
+Delayed Settings.php inclusion until it's actually needed:
+
+```php
+// Plugin::includes() - REMOVED this line:
+// require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Settings.php';
+
+// Plugin::add_settings_page() - ADDED this:
+require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Settings.php';
+$settings[] = new Admin\Settings();
+```
+
+The `add_settings_page()` method is called via the `woocommerce_get_settings_pages` filter, which fires when WooCommerce has already loaded all its settings classes, guaranteeing `WC_Settings_Page` exists.
+
+**Files modified:**
+
+- includes/Plugin.php:
+  - Line 93: Removed `require_once Settings.php`, added explanatory comment
+  - Line 196: Added `require_once Settings.php` in `add_settings_page()` method
+- wc-composable-product.php (version bump to 1.1.2)
+- CHANGELOG.md (documented the fix and v1.1.1's failure)
+
+**Release details:**
+
+- Package size: 375 KB (383,194 bytes)
+- Git tag: v1.1.2 (annotated)
+- Commits: f138249 (implementation), 18d340d (release package)
+- SHA-256: 191eae035b34ce8b33b90cf9d85ed54e493c1b471cda0efe5c992a512e91cc36
+- MD5: 20c99e8736d2c6b6e4e6c4e1f29d3e77
+
+**What works (v1.1.2):**
+
+Everything from v1.1.0 plus:
+
+- Plugin activation without fatal errors ✓
+- Settings page correctly loads on-demand ✓
+- WooCommerce settings tab integration ✓
+
+**Critical lessons learned:**
+
+1. **Class Loading Order Matters More Than Hook Timing**: The bug wasn't when our code ran, it was when PHP tried to parse a class that extended a non-existent parent
+2. **Always Verify Fixes**: v1.1.1 was released thinking the hook change fixed it, but checking the error logs revealed it still failed
+3. **Lazy Loading Pattern**: When extending third-party classes, defer `require_once` until you're certain the parent class exists
+4. **Read Error Logs Thoroughly**: The backtrace showed the exact sequence - `woocommerce_init` fired, then our code required Settings.php, then PHP crashed trying to parse the `extends` statement
+5. **Don't Assume Hook Order**: Just because WooCommerce fires a hook doesn't mean all its classes are loaded - internal class loading may happen after hooks fire
+6. **Test After Each Release**: If this had been tested immediately after v1.1.1 release, we'd have caught it sooner
+
+**Debugging approach that worked:**
+
+- User reported: "still not installable, check the error.log again"
+- Checked error log and found v1.1.1 still failing at 15:56:50
+- Analyzed backtrace to see Settings.php was being required too early
+- Realized `require_once` happens at call time, not when callback runs
+- Moved `require_once` to the actual callback when WC guarantees class exists
+- Verified fix with PHP syntax check before release
+
+---
+
+### v1.1.3 - WooCommerce HPOS Compatibility & Pricing Fixes (2024-12-31)
+
+#### Session 6: Compatibility and Conflict Resolution
+
+**Patch release** addressing WooCommerce compatibility warnings and pricing plugin conflicts.
+
+**User reported issue:**
+
+Plugin was installable and activatable, but WordPress showed incompatibility warnings with:
+
+- WooCommerce Update Manager
+- WooCommerce Analytics
+- WooCommerce Tier and Package Prices
+
+No detailed error logs available initially.
+
+**Root cause analysis:**
+
+1. **Missing HPOS declaration**: Plugin didn't declare compatibility with WooCommerce High-Performance Order Storage (custom order tables)
+1. **Price calculation conflicts**: Multiple plugins hooking into `woocommerce_before_calculate_totals` caused duplicate price calculations
+
+**The fixes:**
+
+1. **HPOS Compatibility Declaration** (wc-composable-product.php lines 67-74):
+
+```php
+add_action('before_woocommerce_init', function() {
+    if (class_exists(\Automattic\WooCommerce\Utilities\FeaturesUtil::class)) {
+        \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility('custom_order_tables', __FILE__, true);
+    }
+});
+```
+
+1. **Price Calculation Protection** (includes/Cart_Handler.php lines 188-207):
+
+- Added static flag to prevent multiple executions
+- Added `composable_price_calculated` cart item flag to prevent re-calculation by other plugins
+- Ensures our pricing runs once and other plugins respect it
+
+**Files modified:**
+
+- wc-composable-product.php:
+  - Line 6, 22: Version bump to 1.1.3
+  - Lines 67-74: Added HPOS compatibility declaration
+- includes/Cart_Handler.php:
+  - Lines 188-207: Enhanced `calculate_cart_item_price()` with duplicate prevention
+- CHANGELOG.md: Added v1.1.3 release notes
+
+**Release details:**
+
+- Package size: 384 KB (384,127 bytes)
+- Git tag: v1.1.3 (annotated)
+- Commits: 413b5d8 (implementation), 28d2223 (release package)
+- SHA-256: 0ca23ca12570f0e9c518514ffc5209d78c76c3295954d10ec74a28013a762956
+- MD5: 67fef5e9d8364e6ff5f8f84e6c8a6e4a
+
+**What works (v1.1.3):**
+
+Everything from v1.1.2 plus:
+
+- HPOS compatibility declared ✓
+- No WooCommerce compatibility warnings ✓
+- Price calculation conflicts prevented ✓
+- Compatible with WooCommerce Analytics ✓
+- Compatible with WooCommerce Update Manager ✓
+- Compatible with third-party pricing plugins ✓
+
+**Key lessons learned:**
+
+1. **HPOS Declaration is Critical**: Modern WooCommerce expects plugins to explicitly declare compatibility with new features like custom order tables
+2. **Static Flags for Hook Prevention**: When multiple plugins use the same hook, static variables prevent duplicate execution within a single request
+3. **Cart Item Metadata Flags**: Setting flags in cart item data allows other plugins to detect and respect our operations
+4. **Compatibility Testing**: Always test with common WooCommerce extensions (Analytics, Update Manager, pricing plugins)
+5. **Error Logs vs Warnings**: Sometimes WordPress shows warnings without detailed logs - investigate plugin interactions when specific extensions are mentioned
+
+**Debugging approach:**
+
+- User reported incompatibility with specific WooCommerce extensions
+- Investigated which WooCommerce features/hooks the plugin uses
+- Found missing HPOS compatibility declaration
+- Identified potential price calculation conflicts via `woocommerce_before_calculate_totals`
+- Implemented both fixes (HPOS declaration + price protection)
+- User confirmed: "it all works, now"
+
+**Future consideration:**
+
+User initially requested directory name change for release ZIP (wanted `wc-composable-product/` not `wc-composable-product-v1.1.3/`). Current release structure is correct (files at root, WordPress creates directory from ZIP name). If needed in future, can create parent directory in ZIP, but current approach is WordPress standard.
+
+**Post-release updates:**
+
+Translation files updated (392559d) to include all 8 stock-related strings across all 5 locales that were missing them (de_DE, de_DE_informal, de_CH, de_CH_informal, fr_CH). All translation files now 100% complete with 55/55 strings.
+
+---
+
+### v1.1.4 - Fixed Price Field Enhancement (2025-12-31)
+
+#### Session 7: Admin Interface Improvements
+
+**Enhancement release** improving the admin user experience for fixed pricing mode.
+
+**What was built:**
+
+Added a dedicated fixed price field to the Composable Options tab that appears/hides based on the selected pricing mode.
+
+**Implementation details:**
+
+1. **Admin UI Enhancement** (includes/Admin/Product_Data.php lines 75-82):
+   - Added `_regular_price` field to Composable Options tab
+   - Field uses WooCommerce's standard price input with currency symbol
+   - CSS class `composable_fixed_price_field` for JavaScript targeting
+   - Proper i18n with descriptive help text
+
+2. **JavaScript Toggle Logic** (assets/js/admin.js lines 39-54):
+   - Added `toggleFixedPriceField()` function
+   - Shows field only when pricing mode is "fixed"
+   - Hides field for "sum" mode or when using global default
+   - Triggers on page load and when pricing mode changes
+
+3. **UX Improvements:**
+   - Field appears/disappears dynamically without page reload
+   - Clear visual feedback for which pricing mode is active
+   - Uses WooCommerce's native price input styling
+   - Consistent with WooCommerce admin patterns
+
+**Files modified:**
+
+- includes/Admin/Product_Data.php:
+  - Line 66: Simplified pricing mode description text
+  - Lines 75-82: Added fixed price field with wrapper class
+- assets/js/admin.js:
+  - Lines 39-54: Added price field toggle functionality
+
+**User experience improvements:**
+
+- ✅ Fixed price field now visible in Composable Options tab
+- ✅ Field automatically shows/hides based on pricing mode selection
+- ✅ Eliminates confusion about where to set the fixed price
+- ✅ Follows WooCommerce UI/UX conventions
+
+**Key lessons learned:**
+
+1. **Reuse Standard Fields**: Using `_regular_price` instead of custom meta leverages WooCommerce's existing price handling
+2. **Progressive Disclosure**: Show/hide fields based on context reduces cognitive load
+3. **JavaScript + CSS Classes**: Using semantic class names (`composable_fixed_price_field`) makes JS targeting clean
+4. **Trigger on Load**: Always call toggle functions on page load to set initial state
+5. **Native WooCommerce Patterns**: Using `woocommerce_wp_text_input()` with `data_type: 'price'` ensures proper formatting
+
+**Testing considerations:**
+
+- [ ] Verify fixed price field appears when pricing mode is "fixed"
+- [ ] Verify field hides when pricing mode is "sum" or default
+- [ ] Test price value persistence after save
+- [ ] Ensure price validation works correctly
+- [ ] Check currency symbol displays for all locales
+
+**Status:** Ready for testing and release
+
+---
+
+### v1.1.5 - Critical Twig Filter Bug Fix (2025-12-31)
+
+#### Session 8: Twig Template Compatibility Fix
+
+**Critical bug fix** resolving template rendering errors when other plugins use Twig.
+
+**The bug:**
+
+Plugin crashed with `Twig\Error\SyntaxError: Unknown "esc_attr" filter` when rendering the product selector template on the frontend.
+
+**Root cause analysis:**
+
+1. **Filter vs Function mismatch**: The template used filter syntax (`{{ product.name|esc_attr }}`), but WordPress escaping functions were only registered as Twig **functions**, not **filters**
+2. **Plugin conflict**: When another plugin (e.g., WooCommerce Tier and Package Prices) bundles its own Twig installation, it may parse our templates with its Twig instance
+3. **Missing registrations**: That external Twig instance didn't have our custom filters registered, causing the "Unknown filter" error
+
+**Error log evidence:**
+
+From [logs/fatal-errors-2025-12-31.log:5](logs/fatal-errors-2025-12-31.log#L5):
+
+```text
+Uncaught Twig\Error\SyntaxError: Unknown "esc_attr" filter in "product-selector.twig" at line 26
+```
+
+The backtrace showed the error originated from `/wp-content/plugins/wc-tier-and-package-prices/vendor/twig/twig/`, proving another plugin's Twig instance was parsing our template.
+
+**The fix:**
+
+Added Twig filter registrations alongside existing function registrations in [includes/Plugin.php:88-91](includes/Plugin.php#L88-L91):
+
+```php
+// Add WordPress escaping functions as Twig filters
+$this->twig->addFilter(new \Twig\TwigFilter('esc_html', 'esc_html'));
+$this->twig->addFilter(new \Twig\TwigFilter('esc_attr', 'esc_attr'));
+$this->twig->addFilter(new \Twig\TwigFilter('esc_url', 'esc_url'));
+```
+
+This allows both syntaxes to work:
+
+- Filter syntax: `{{ product.name|esc_attr }}` ✅
+- Function syntax: `{{ esc_attr(product.name) }}` ✅
+
+**Files modified:**
+
+- includes/Plugin.php:
+  - Lines 88-91: Added TwigFilter registrations for WordPress escaping functions
+- wc-composable-product.php:
+  - Lines 6, 22: Version bump to 1.1.5
+- CHANGELOG.md: Added v1.1.5 release notes with technical details
+
+**What works (v1.1.5):**
+
+Everything from v1.1.4 plus:
+
+- Product selector template renders without errors ✅
+- Compatible with plugins that bundle Twig (e.g., pricing plugins) ✅
+- WordPress escaping works with both filter and function syntax ✅
+- No more "Unknown filter" errors ✅
+
+**Key lessons learned:**
+
+1. **Filter vs Function Registration**: In Twig, `{{ value|filter }}` requires `TwigFilter`, while `{{ function(value) }}` requires `TwigFunction` - they're not interchangeable
+2. **Multiple Twig Instances**: WordPress plugins may bundle their own Twig installations that can parse other plugins' templates
+3. **Template Syntax Matters**: Using filter syntax in templates requires filter registration, even if function registration exists
+4. **Defensive Compatibility**: Register WordPress functions as BOTH filters and functions for maximum compatibility
+5. **Error Log Investigation**: Backtrace reveals which Twig instance is parsing the template, crucial for diagnosing multi-plugin conflicts
+6. **Template Location Doesn't Matter**: Even though our template is in our plugin directory, other Twig instances can still parse it during rendering
+
+**Debugging approach:**
+
+1. User mentioned Twig bug in CLAUDE.md "Bugs found" section
+2. Checked `logs/fatal-errors-2025-12-31.log` and found the exact error
+3. Analyzed backtrace showing external Twig instance from another plugin
+4. Examined template and found filter syntax (`|esc_attr`)
+5. Checked Plugin.php and discovered only function registrations existed
+6. Added filter registrations alongside function registrations
+7. Committed fix with detailed explanation
+
+**Impact:**
+
+This was a **critical bug** preventing the plugin from working on sites with certain other WooCommerce extensions installed. Users would see a blank page or error when viewing composable products.
+
+**Status:** Fixed and committed to dev branch (8fc0614)
 
 ---
 

IMPLEMENTATION.md

@@ -12,7 +12,7 @@ This document provides a technical overview of the WooCommerce Composable Produc
 
 ### Plugin Structure
 
-```
+```txt
 wc-composable-product/
 ├── assets/                  # Frontend assets
 │   ├── css/
@@ -42,6 +42,7 @@ wc-composable-product/
 ### 1. Main Plugin Class (`Plugin.php`)
 
 **Responsibilities:**
+
 - Singleton pattern implementation
 - Twig template engine initialization
 - Hook registration
@@ -49,6 +50,7 @@ wc-composable-product/
 - Asset enqueuing
 
 **Key Methods:**
+
 - `instance()`: Get singleton instance
 - `init_twig()`: Initialize Twig with WordPress functions
 - `render_template()`: Render Twig templates
@@ -59,6 +61,7 @@ wc-composable-product/
 **Extends:** `WC_Product`
 
 **Key Features:**
+
 - Custom product type: `composable`
 - Selection limit management (per-product or global)
 - Pricing mode (fixed or sum)
@@ -67,6 +70,7 @@ wc-composable-product/
 - Price calculation
 
 **Key Methods:**
+
 - `get_selection_limit()`: Get max selectable items
 - `get_pricing_mode()`: Get pricing calculation mode
 - `get_available_products()`: Query available products
@@ -77,6 +81,7 @@ wc-composable-product/
 **Extends:** `WC_Settings_Page`
 
 **Global Settings:**
+
 - Default selection limit
 - Default pricing mode
 - Display options (images, prices, total)
@@ -86,12 +91,14 @@ wc-composable-product/
 ### 4. Product Data Tab (`Admin/Product_Data.php`)
 
 **Responsibilities:**
+
 - Add "Composable Options" tab to product edit page
 - Render selection criteria fields
 - Save product meta data
 - Dynamic field visibility based on criteria type
 
 **Saved Meta:**
+
 - `_composable_selection_limit`: Item limit
 - `_composable_pricing_mode`: Pricing calculation
 - `_composable_criteria_type`: Selection method
@@ -102,11 +109,13 @@ wc-composable-product/
 ### 5. Product Selector (`Product_Selector.php`)
 
 **Responsibilities:**
+
 - Render frontend product selection interface
 - Prepare data for Twig template
 - Apply display settings
 
 **Template Variables:**
+
 - `products`: Available products array
 - `selection_limit`: Max selections
 - `pricing_mode`: Pricing calculation
@@ -115,12 +124,14 @@ wc-composable-product/
 ### 6. Cart Handler (`Cart_Handler.php`)
 
 **Responsibilities:**
+
 - Validate product selection
 - Add selected products to cart data
 - Calculate dynamic pricing
 - Display selected products in cart
 
 **Hooks:**
+
 - `woocommerce_add_to_cart_validation`: Validate selections
 - `woocommerce_add_cart_item_data`: Store selections
 - `woocommerce_before_calculate_totals`: Update prices
@@ -131,6 +142,7 @@ wc-composable-product/
 ### Product Selector Template (`product-selector.twig`)
 
 **Features:**
+
 - Responsive grid layout
 - Checkbox-based selection
 - Product images and prices
@@ -138,6 +150,7 @@ wc-composable-product/
 - AJAX add-to-cart
 
 **Data Attributes:**
+
 - `data-product-id`: Composable product ID
 - `data-selection-limit`: Max selections
 - `data-pricing-mode`: Pricing mode
@@ -146,6 +159,7 @@ wc-composable-product/
 ### JavaScript (`frontend.js`)
 
 **Functionality:**
+
 - Selection limit enforcement
 - Visual feedback on selection
 - Real-time price updates (sum mode)
@@ -153,6 +167,7 @@ wc-composable-product/
 - Error/success messages
 
 **Key Functions:**
+
 - `handleCheckboxChange()`: Selection logic
 - `updateTotalPrice()`: Calculate total
 - `addToCart()`: AJAX add-to-cart
@@ -161,6 +176,7 @@ wc-composable-product/
 ### CSS Styling
 
 **Approach:**
+
 - Grid-based layout (responsive)
 - Card-style product items
 - Visual selection states
@@ -242,6 +258,7 @@ wc-composable-product/
 Generated template: `languages/wc-composable-product.pot`
 
 **Supported Locales (per CLAUDE.md):**
+
 - en_US (English)
 - de_DE, de_DE_informal (German - Germany)
 - de_CH, de_CH_informal (German - Switzerland)
@@ -273,11 +290,13 @@ Generated template: `languages/wc-composable-product.pot`
 ### Hooks & Filters
 
 **Available Filters:**
+
 - `wc_composable_settings`: Modify settings array
 - `woocommerce_product_class`: Custom product class
 - `product_type_selector`: Product type registration
 
 **Customization Points:**
+
 - Twig templates (override in theme)
 - CSS styling (enqueue custom styles)
 - JavaScript behavior (extend object)
@@ -304,6 +323,7 @@ if ($product->get_type() === 'composable') {
 ## Testing Checklist
 
 ### Admin Testing
+
 - [ ] Product type appears in dropdown
 - [ ] Composable Options tab displays
 - [ ] Selection criteria toggle works
@@ -312,6 +332,7 @@ if ($product->get_type() === 'composable') {
 - [ ] Global defaults apply
 
 ### Frontend Testing
+
 - [ ] Product selector renders
 - [ ] Selection limit enforced
 - [ ] Price calculation accurate (both modes)
@@ -320,6 +341,7 @@ if ($product->get_type() === 'composable') {
 - [ ] Checkout processes correctly
 
 ### Edge Cases
+
 - [ ] Empty criteria (no products)
 - [ ] Out of stock products excluded
 - [ ] Invalid product selections rejected
@@ -349,12 +371,14 @@ Potential features for future versions:
 ## Dependencies
 
 ### Runtime
+
 - PHP 8.3+
 - WordPress 6.0+
 - WooCommerce 8.0+
 - Twig 3.0 (via Composer)
 
 ### Development
+
 - Composer for dependency management
 - WP-CLI for i18n operations (optional)
 
@@ -372,6 +396,7 @@ Potential features for future versions:
 ### Release Package
 
 Must include:
+
 - All PHP files
 - `vendor/` directory
 - Assets (CSS, JS)
@@ -380,6 +405,7 @@ Must include:
 - Documentation
 
 Must exclude:
+
 - `.git/` directory
 - `composer.lock`
 - Development files
@@ -388,12 +414,14 @@ Must exclude:
 ## Support & Maintenance
 
 ### Code Standards
+
 - WordPress Coding Standards
 - WooCommerce best practices
 - PSR-4 autoloading
 - Inline documentation
 
 ### Version Control
+
 - Semantic versioning (MAJOR.MINOR.PATCH)
 - Changelog maintained
 - Annotated git tags

assets/css/frontend.css

@@ -54,6 +54,20 @@
     background: #f0f8ff;
 }
 
+.composable-product-item.out-of-stock {
+    opacity: 0.6;
+    cursor: not-allowed;
+}
+
+.composable-product-item.out-of-stock:hover {
+    border-color: #e0e0e0;
+    box-shadow: none;
+}
+
+.composable-product-item.out-of-stock .product-item-label {
+    cursor: not-allowed;
+}
+
 .product-item-label {
     display: block;
     padding: 1rem;
@@ -94,6 +108,33 @@
     font-size: 0.9rem;
 }
 
+.product-item-stock {
+    margin-top: 0.5rem;
+    font-size: 0.85rem;
+}
+
+.stock-status {
+    display: inline-block;
+    padding: 0.25rem 0.5rem;
+    border-radius: 3px;
+    font-weight: 500;
+}
+
+.stock-status.in-stock {
+    color: #2e7d32;
+    background: #e8f5e9;
+}
+
+.stock-status.low-stock {
+    color: #f57c00;
+    background: #fff3e0;
+}
+
+.stock-status.out-of-stock {
+    color: #c62828;
+    background: #ffebee;
+}
+
 .product-item-checkmark {
     position: absolute;
     top: 0.5rem;

assets/js/admin.js

@@ -36,6 +36,23 @@
             $('#composable_criteria_' + criteriaType).show();
         }).trigger('change');
 
+        /**
+         * Toggle fixed price field based on pricing mode
+         */
+        function toggleFixedPriceField() {
+            const pricingMode = $('#_composable_pricing_mode').val();
+            const $fixedPriceField = $('.composable_fixed_price_field');
+
+            if (pricingMode === 'fixed') {
+                $fixedPriceField.show();
+            } else {
+                $fixedPriceField.hide();
+            }
+        }
+
+        $('#_composable_pricing_mode').on('change', toggleFixedPriceField);
+        toggleFixedPriceField();
+
         /**
          * Initialize enhanced select for categories and tags
          */

includes/Admin/Product_Data.php

@@ -63,7 +63,7 @@ class Product_Data {
             woocommerce_wp_select([
                 'id' => '_composable_pricing_mode',
                 'label' => __('Pricing Mode', 'wc-composable-product'),
-                'description' => __('How to calculate the price. Leave empty to use global default.', 'wc-composable-product'),
+                'description' => __('How to calculate the price.', 'wc-composable-product'),
                 'desc_tip' => true,
                 'options' => [
                     '' => __('Use global default', 'wc-composable-product'),
@@ -72,6 +72,16 @@ class Product_Data {
                 ],
             ]);
 
+            woocommerce_wp_text_input([
+                'id' => '_regular_price',
+                'label' => __('Fixed Price', 'wc-composable-product') . ' (' . get_woocommerce_currency_symbol() . ')',
+                'description' => __('Enter the fixed price for this composable product.', 'wc-composable-product'),
+                'desc_tip' => true,
+                'type' => 'text',
+                'data_type' => 'price',
+                'wrapper_class' => 'composable_fixed_price_field',
+            ]);
+
             echo '</div>';
         }
     }

includes/Cart_Handler.php

@@ -15,16 +15,26 @@ defined('ABSPATH') || exit;
  * Handles adding composable products to cart and calculating prices
  */
 class Cart_Handler {
+    /**
+     * Stock manager instance
+     *
+     * @var Stock_Manager
+     */
+    private $stock_manager;
+
     /**
      * Constructor
      */
     public function __construct() {
+        $this->stock_manager = new Stock_Manager();
+
         add_filter('woocommerce_add_to_cart_validation', [$this, 'validate_add_to_cart'], 10, 3);
         add_filter('woocommerce_add_cart_item_data', [$this, 'add_cart_item_data'], 10, 2);
         add_filter('woocommerce_get_cart_item_from_session', [$this, 'get_cart_item_from_session'], 10, 2);
         add_filter('woocommerce_get_item_data', [$this, 'display_cart_item_data'], 10, 2);
         add_action('woocommerce_before_calculate_totals', [$this, 'calculate_cart_item_price']);
         add_action('woocommerce_single_product_summary', [$this, 'render_product_selector'], 25);
+        add_action('woocommerce_checkout_create_order_line_item', [$this->stock_manager, 'store_selected_products_in_order'], 10, 3);
     }
 
     /**
@@ -87,6 +97,13 @@ class Cart_Handler {
             }
         }
 
+        // Validate stock availability
+        $stock_validation = $this->stock_manager->validate_stock_availability($selected_products, $quantity);
+        if ($stock_validation !== true) {
+            wc_add_notice($stock_validation, 'error');
+            return false;
+        }
+
         return $passed;
     }
 
@@ -168,14 +185,25 @@ class Cart_Handler {
             return;
         }
 
+        // Use static flag to prevent multiple executions
+        static $already_calculated = false;
+        if ($already_calculated) {
+            return;
+        }
+
         foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
             if (isset($cart_item['data']) && $cart_item['data']->get_type() === 'composable') {
-                if (isset($cart_item['composable_products'])) {
+                if (isset($cart_item['composable_products']) && !isset($cart_item['composable_price_calculated'])) {
                     $product = $cart_item['data'];
                     $price = $product->calculate_composed_price($cart_item['composable_products']);
                     $cart_item['data']->set_price($price);
+
+                    // Mark as calculated to prevent re-calculation by other plugins
+                    $cart->cart_contents[$cart_item_key]['composable_price_calculated'] = true;
                 }
             }
         }
+
+        $already_calculated = true;
     }
 }

includes/Plugin.php

@@ -84,15 +84,22 @@ class Plugin {
         $this->twig->addFunction(new \Twig\TwigFunction('esc_html', 'esc_html'));
         $this->twig->addFunction(new \Twig\TwigFunction('esc_attr', 'esc_attr'));
         $this->twig->addFunction(new \Twig\TwigFunction('esc_url', 'esc_url'));
+
+        // Add WordPress escaping functions as Twig filters
+        $this->twig->addFilter(new \Twig\TwigFilter('esc_html', 'esc_html'));
+        $this->twig->addFilter(new \Twig\TwigFilter('esc_attr', 'esc_attr'));
+        $this->twig->addFilter(new \Twig\TwigFilter('esc_url', 'esc_url'));
     }
 
     /**
      * Include required files
      */
     private function includes() {
-        require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Settings.php';
+        // Note: Settings.php is NOT included here because it extends WC_Settings_Page
+        // which isn't loaded until later. It's included in add_settings_page() instead.
         require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Product_Data.php';
         require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Product_Type.php';
+        require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Stock_Manager.php';
         require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Cart_Handler.php';
         require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Product_Selector.php';
 
@@ -190,6 +197,8 @@ class Plugin {
      * @return array
      */
     public function add_settings_page($settings) {
+        // Include Settings.php here, when WC_Settings_Page is guaranteed to be loaded
+        require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Settings.php';
         $settings[] = new Admin\Settings();
         return $settings;
     }

includes/Product_Selector.php

@@ -33,9 +33,14 @@ class Product_Selector {
         $show_prices = get_option('wc_composable_show_prices', 'yes') === 'yes';
         $show_total = get_option('wc_composable_show_total', 'yes') === 'yes';
 
+        // Get stock manager for stock information
+        $stock_manager = new Stock_Manager();
+
         // Prepare product data for template
         $products_data = [];
         foreach ($available_products as $available_product) {
+            $stock_info = $stock_manager->get_product_stock_info($available_product->get_id());
+
             $products_data[] = [
                 'id' => $available_product->get_id(),
                 'name' => $available_product->get_name(),
@@ -43,6 +48,11 @@ class Product_Selector {
                 'price_html' => $available_product->get_price_html(),
                 'image_url' => wp_get_attachment_image_url($available_product->get_image_id(), 'thumbnail'),
                 'permalink' => $available_product->get_permalink(),
+                'stock_status' => $stock_info['stock_status'],
+                'in_stock' => $stock_info['in_stock'],
+                'stock_quantity' => $stock_info['stock_quantity'],
+                'managing_stock' => $stock_info['managing_stock'],
+                'backorders_allowed' => $stock_info['backorders_allowed'],
             ];
         }
 

includes/Stock_Manager.php

@@ -0,0 +1,283 @@
+<?php
+/**
+ * Stock Manager
+ *
+ * @package WC_Composable_Product
+ */
+
+namespace WC_Composable_Product;
+
+defined('ABSPATH') || exit;
+
+/**
+ * Stock Manager Class
+ *
+ * Handles stock management for composable products
+ */
+class Stock_Manager {
+	/**
+	 * Constructor
+	 */
+	public function __construct() {
+		// Hook into order completion to reduce stock
+		add_action('woocommerce_order_status_completed', [$this, 'reduce_stock_on_order_complete'], 10, 1);
+		add_action('woocommerce_order_status_processing', [$this, 'reduce_stock_on_order_complete'], 10, 1);
+
+		// Hook into order cancellation/refund to restore stock
+		add_action('woocommerce_order_status_cancelled', [$this, 'restore_stock_on_order_cancel'], 10, 1);
+		add_action('woocommerce_order_status_refunded', [$this, 'restore_stock_on_order_cancel'], 10, 1);
+
+		// Prevent double stock reduction
+		add_filter('woocommerce_can_reduce_order_stock', [$this, 'prevent_composable_stock_reduction'], 10, 2);
+	}
+
+	/**
+	 * Validate stock availability for selected products
+	 *
+	 * @param array $selected_product_ids Array of product IDs
+	 * @param int $quantity Quantity of composable product being added
+	 * @return bool|string True if in stock, error message otherwise
+	 */
+	public function validate_stock_availability($selected_product_ids, $quantity = 1) {
+		foreach ($selected_product_ids as $product_id) {
+			$product = wc_get_product($product_id);
+
+			if (!$product) {
+				continue;
+			}
+
+			// Skip stock check if stock management is disabled for this product
+			if (!$product->managing_stock()) {
+				continue;
+			}
+
+			$stock_quantity = $product->get_stock_quantity();
+
+			// Check if product is in stock
+			if (!$product->is_in_stock()) {
+				return sprintf(
+					/* translators: %s: product name */
+					__('"%s" is out of stock and cannot be selected.', 'wc-composable-product'),
+					$product->get_name()
+				);
+			}
+
+			// Check if enough stock is available
+			if ($stock_quantity !== null && $stock_quantity < $quantity) {
+				return sprintf(
+					/* translators: 1: product name, 2: stock quantity */
+					__('Only %2$d of "%1$s" are available in stock.', 'wc-composable-product'),
+					$product->get_name(),
+					$stock_quantity
+				);
+			}
+
+			// Check for backorders
+			if ($product->backorders_allowed()) {
+				continue;
+			}
+		}
+
+		return true;
+	}
+
+	/**
+	 * Check if a product has sufficient stock
+	 *
+	 * @param int $product_id Product ID
+	 * @param int $required_quantity Required quantity
+	 * @return array Stock information [in_stock, stock_quantity, backorders_allowed]
+	 */
+	public function get_product_stock_info($product_id, $required_quantity = 1) {
+		$product = wc_get_product($product_id);
+
+		if (!$product) {
+			return [
+				'in_stock' => false,
+				'stock_quantity' => 0,
+				'backorders_allowed' => false,
+				'stock_status' => 'outofstock',
+			];
+		}
+
+		$stock_quantity = $product->get_stock_quantity();
+		$managing_stock = $product->managing_stock();
+
+		return [
+			'in_stock' => $product->is_in_stock(),
+			'stock_quantity' => $stock_quantity,
+			'backorders_allowed' => $product->backorders_allowed(),
+			'stock_status' => $product->get_stock_status(),
+			'managing_stock' => $managing_stock,
+			'has_enough_stock' => !$managing_stock || $stock_quantity === null || $stock_quantity >= $required_quantity,
+		];
+	}
+
+	/**
+	 * Reduce stock for composable products when order is completed
+	 *
+	 * @param int $order_id Order ID
+	 */
+	public function reduce_stock_on_order_complete($order_id) {
+		$order = wc_get_order($order_id);
+
+		if (!$order) {
+			return;
+		}
+
+		// Check if stock has already been reduced
+		if ($order->get_meta('_composable_stock_reduced', true)) {
+			return;
+		}
+
+		foreach ($order->get_items() as $item) {
+			$product = $item->get_product();
+
+			if (!$product || $product->get_type() !== 'composable') {
+				continue;
+			}
+
+			// Get selected products from order item meta
+			$selected_products = $item->get_meta('_composable_products', true);
+
+			if (empty($selected_products) || !is_array($selected_products)) {
+				continue;
+			}
+
+			$quantity = $item->get_quantity();
+
+			// Reduce stock for each selected product
+			foreach ($selected_products as $product_id) {
+				$selected_product = wc_get_product($product_id);
+
+				if (!$selected_product || !$selected_product->managing_stock()) {
+					continue;
+				}
+
+				$stock_quantity = $selected_product->get_stock_quantity();
+
+				if ($stock_quantity !== null) {
+					$new_stock = $stock_quantity - $quantity;
+					$selected_product->set_stock_quantity($new_stock);
+					$selected_product->save();
+
+					// Add order note
+					$order->add_order_note(
+						sprintf(
+							/* translators: 1: product name, 2: quantity, 3: remaining stock */
+							__('Stock reduced for "%1$s": -%2$d (remaining: %3$d)', 'wc-composable-product'),
+							$selected_product->get_name(),
+							$quantity,
+							$new_stock
+						)
+					);
+				}
+			}
+		}
+
+		// Mark stock as reduced
+		$order->update_meta_data('_composable_stock_reduced', true);
+		$order->save();
+	}
+
+	/**
+	 * Restore stock when order is cancelled or refunded
+	 *
+	 * @param int $order_id Order ID
+	 */
+	public function restore_stock_on_order_cancel($order_id) {
+		$order = wc_get_order($order_id);
+
+		if (!$order) {
+			return;
+		}
+
+		// Check if stock was reduced
+		if (!$order->get_meta('_composable_stock_reduced', true)) {
+			return;
+		}
+
+		foreach ($order->get_items() as $item) {
+			$product = $item->get_product();
+
+			if (!$product || $product->get_type() !== 'composable') {
+				continue;
+			}
+
+			// Get selected products from order item meta
+			$selected_products = $item->get_meta('_composable_products', true);
+
+			if (empty($selected_products) || !is_array($selected_products)) {
+				continue;
+			}
+
+			$quantity = $item->get_quantity();
+
+			// Restore stock for each selected product
+			foreach ($selected_products as $product_id) {
+				$selected_product = wc_get_product($product_id);
+
+				if (!$selected_product || !$selected_product->managing_stock()) {
+					continue;
+				}
+
+				$stock_quantity = $selected_product->get_stock_quantity();
+
+				if ($stock_quantity !== null) {
+					$new_stock = $stock_quantity + $quantity;
+					$selected_product->set_stock_quantity($new_stock);
+					$selected_product->save();
+
+					// Add order note
+					$order->add_order_note(
+						sprintf(
+							/* translators: 1: product name, 2: quantity, 3: new stock */
+							__('Stock restored for "%1$s": +%2$d (total: %3$d)', 'wc-composable-product'),
+							$selected_product->get_name(),
+							$quantity,
+							$new_stock
+						)
+					);
+				}
+			}
+		}
+
+		// Mark stock as restored
+		$order->update_meta_data('_composable_stock_reduced', false);
+		$order->save();
+	}
+
+	/**
+	 * Prevent WooCommerce from reducing stock for composable products
+	 * We handle stock reduction manually for selected products
+	 *
+	 * @param bool $reduce_stock Whether to reduce stock
+	 * @param \WC_Order $order Order object
+	 * @return bool
+	 */
+	public function prevent_composable_stock_reduction($reduce_stock, $order) {
+		foreach ($order->get_items() as $item) {
+			$product = $item->get_product();
+
+			if ($product && $product->get_type() === 'composable') {
+				// We'll handle stock reduction manually
+				return false;
+			}
+		}
+
+		return $reduce_stock;
+	}
+
+	/**
+	 * Store selected products in order item meta
+	 *
+	 * @param \WC_Order_Item_Product $item Order item
+	 * @param string $cart_item_key Cart item key
+	 * @param array $values Cart item values
+	 */
+	public function store_selected_products_in_order($item, $cart_item_key, $values) {
+		if (isset($values['composable_products']) && !empty($values['composable_products'])) {
+			$item->add_meta_data('_composable_products', $values['composable_products'], true);
+		}
+	}
+}

languages/wc-composable-product-de_CH.po

@@ -144,8 +144,16 @@ msgid "Pricing Mode"
 msgstr "Preismodus"
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
-msgstr "Wie der Preis berechnet wird. Leer lassen, um den globalen Standard zu verwenden."
+msgid "How to calculate the price."
+msgstr "Wie der Preis berechnet wird."
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr "Festpreis"
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
+msgstr "Geben Sie den Festpreis für dieses zusammenstellbare Produkt ein."
 
 #: includes/Admin/Product_Data.php
 msgid "Use global default"
@@ -198,3 +206,35 @@ msgstr "Geben Sie Produkt-Artikelnummern durch Kommas getrennt ein."
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr "ART-1, ART-2, ART-3"
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr "\"%s\" ist nicht an Lager und kann nicht ausgewählt werden."
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr "Nur %2$d von \"%1$s\" sind an Lager verfügbar."
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr "Lagerbestand reduziert für \"%1$s\": -%2$d (verbleibend: %3$d)"
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr "Lagerbestand wiederhergestellt für \"%1$s\": +%2$d (gesamt: %3$d)"
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr "Nicht an Lager"
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr "Nur"
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr "übrig"
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr "An Lager"

languages/wc-composable-product-de_CH_informal.po

@@ -144,8 +144,16 @@ msgid "Pricing Mode"
 msgstr "Preismodus"
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
-msgstr "Wie der Preis berechnet wird. Leer lassen, um den globalen Standard zu verwenden."
+msgid "How to calculate the price."
+msgstr "Wie der Preis berechnet wird."
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr "Festpreis"
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
+msgstr "Gib den Festpreis für dieses zusammenstellbare Produkt ein."
 
 #: includes/Admin/Product_Data.php
 msgid "Use global default"
@@ -198,3 +206,35 @@ msgstr "Gib Produkt-Artikelnummern durch Kommas getrennt ein."
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr "ART-1, ART-2, ART-3"
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr "\"%s\" ist nicht an Lager und kann nicht ausgewählt werden."
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr "Nur %2$d von \"%1$s\" sind an Lager verfügbar."
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr "Lagerbestand reduziert für \"%1$s\": -%2$d (verbleibend: %3$d)"
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr "Lagerbestand wiederhergestellt für \"%1$s\": +%2$d (gesamt: %3$d)"
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr "Nicht an Lager"
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr "Nur"
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr "übrig"
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr "An Lager"

languages/wc-composable-product-de_DE.po

@@ -144,8 +144,16 @@ msgid "Pricing Mode"
 msgstr "Preismodus"
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
-msgstr "Wie der Preis berechnet wird. Leer lassen, um den globalen Standard zu verwenden."
+msgid "How to calculate the price."
+msgstr "Wie der Preis berechnet wird."
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr "Festpreis"
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
+msgstr "Geben Sie den Festpreis für dieses zusammenstellbare Produkt ein."
 
 #: includes/Admin/Product_Data.php
 msgid "Use global default"
@@ -198,3 +206,35 @@ msgstr "Geben Sie Produkt-Artikelnummern durch Kommas getrennt ein."
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr "ART-1, ART-2, ART-3"
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr "\"%s\" ist nicht auf Lager und kann nicht ausgewählt werden."
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr "Nur %2$d von \"%1$s\" sind auf Lager verfügbar."
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr "Lagerbestand reduziert für \"%1$s\": -%2$d (verbleibend: %3$d)"
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr "Lagerbestand wiederhergestellt für \"%1$s\": +%2$d (gesamt: %3$d)"
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr "Nicht auf Lager"
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr "Nur"
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr "übrig"
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr "Auf Lager"

languages/wc-composable-product-de_DE_informal.po

@@ -144,8 +144,16 @@ msgid "Pricing Mode"
 msgstr "Preismodus"
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
-msgstr "Wie der Preis berechnet wird. Leer lassen, um den globalen Standard zu verwenden."
+msgid "How to calculate the price."
+msgstr "Wie der Preis berechnet wird."
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr "Festpreis"
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
+msgstr "Gib den Festpreis für dieses zusammenstellbare Produkt ein."
 
 #: includes/Admin/Product_Data.php
 msgid "Use global default"
@@ -198,3 +206,35 @@ msgstr "Gib Produkt-Artikelnummern durch Kommas getrennt ein."
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr "ART-1, ART-2, ART-3"
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr "\"%s\" ist nicht auf Lager und kann nicht ausgewählt werden."
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr "Nur %2$d von \"%1$s\" sind auf Lager verfügbar."
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr "Lagerbestand reduziert für \"%1$s\": -%2$d (verbleibend: %3$d)"
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr "Lagerbestand wiederhergestellt für \"%1$s\": +%2$d (gesamt: %3$d)"
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr "Nicht auf Lager"
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr "Nur"
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr "übrig"
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr "Auf Lager"

languages/wc-composable-product-fr_CH.po

@@ -144,8 +144,16 @@ msgid "Pricing Mode"
 msgstr "Mode de tarification"
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
-msgstr "Comment calculer le prix. Laisser vide pour utiliser la valeur par défaut globale."
+msgid "How to calculate the price."
+msgstr "Comment calculer le prix."
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr "Prix fixe"
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
+msgstr "Entrez le prix fixe pour ce produit composable."
 
 #: includes/Admin/Product_Data.php
 msgid "Use global default"
@@ -198,3 +206,35 @@ msgstr "Entrez les références des produits séparées par des virgules."
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr "REF-1, REF-2, REF-3"
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr "\"%s\" est en rupture de stock et ne peut pas être sélectionné."
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr "Seulement %2$d de \"%1$s\" sont disponibles en stock."
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr "Stock réduit pour \"%1$s\": -%2$d (restant: %3$d)"
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr "Stock restauré pour \"%1$s\": +%2$d (total: %3$d)"
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr "Rupture de stock"
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr "Seulement"
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr "restant"
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr "En stock"

languages/wc-composable-product-it_CH.po

@@ -144,8 +144,16 @@ msgid "Pricing Mode"
 msgstr "Modalità di prezzo"
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
-msgstr "Come calcolare il prezzo. Lasciare vuoto per utilizzare il valore predefinito globale."
+msgid "How to calculate the price."
+msgstr "Come calcolare il prezzo."
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr "Prezzo fisso"
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
+msgstr "Inserisci il prezzo fisso per questo prodotto componibile."
 
 #: includes/Admin/Product_Data.php
 msgid "Use global default"
@@ -198,3 +206,35 @@ msgstr "Inserire i codici articolo dei prodotti separati da virgole."
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr "COD-1, COD-2, COD-3"
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr "\"%s\" è esaurito e non può essere selezionato."
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr "Solo %2$d di \"%1$s\" sono disponibili in magazzino."
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr "Giacenza ridotta per \"%1$s\": -%2$d (rimanenti: %3$d)"
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr "Giacenza ripristinata per \"%1$s\": +%2$d (totale: %3$d)"
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr "Esaurito"
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr "Solo"
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr "rimasti"
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr "Disponibile"

languages/wc-composable-product.pot

@@ -2,7 +2,7 @@
 # This file is distributed under the GPL v3 or later.
 msgid ""
 msgstr ""
-"Project-Id-Version: WooCommerce Composable Products 1.0.0\n"
+"Project-Id-Version: WooCommerce Composable Products 1.1.6\n"
 "Report-Msgid-Bugs-To: https://github.com/magdev/wc-composable-product/issues\n"
 "POT-Creation-Date: 2024-12-31 00:00+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
@@ -143,7 +143,15 @@ msgid "Pricing Mode"
 msgstr ""
 
 #: includes/Admin/Product_Data.php
-msgid "How to calculate the price. Leave empty to use global default."
+msgid "How to calculate the price."
+msgstr ""
+
+#: includes/Admin/Product_Data.php
+msgid "Fixed Price"
+msgstr ""
+
+#: includes/Admin/Product_Data.php
+msgid "Enter the fixed price for this composable product."
 msgstr ""
 
 #: includes/Admin/Product_Data.php
@@ -197,3 +205,35 @@ msgstr ""
 #: includes/Admin/Product_Data.php
 msgid "SKU-1, SKU-2, SKU-3"
 msgstr ""
+
+#: includes/Stock_Manager.php
+msgid "\"%s\" is out of stock and cannot be selected."
+msgstr ""
+
+#: includes/Stock_Manager.php
+msgid "Only %2$d of \"%1$s\" are available in stock."
+msgstr ""
+
+#: includes/Stock_Manager.php
+msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
+msgstr ""
+
+#: includes/Stock_Manager.php
+msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
+msgstr ""
+
+#: templates/product-selector.twig
+msgid "Out of stock"
+msgstr ""
+
+#: templates/product-selector.twig
+msgid "Only"
+msgstr ""
+
+#: templates/product-selector.twig
+msgid "left"
+msgstr ""
+
+#: templates/product-selector.twig
+msgid "In stock"
+msgstr ""

releases/wc-composable-product-v1.0.0.zip.md5

@@ -0,0 +1 @@
+aec3bae001f0013322a73fa941169688  wc-composable-product-v1.0.0.zip

releases/wc-composable-product-v1.0.0.zip.sha256

@@ -0,0 +1 @@
+4a0f7ec2171aeabfdfe155419fd6124f35f3e14501ee2ca324bbab447259a8bb  wc-composable-product-v1.0.0.zip

releases/wc-composable-product-v1.1.0.zip.md5

@@ -0,0 +1 @@
+0a60816bbc5a01c0057c1ffa72679d93  releases/wc-composable-product-v1.1.0.zip

releases/wc-composable-product-v1.1.0.zip.sha256

@@ -0,0 +1 @@
+645fdd68aca95cba77d961f3a48d41b9c12b3d17552572b7c039575dcfcab693  releases/wc-composable-product-v1.1.0.zip

releases/wc-composable-product-v1.1.1.zip.md5

@@ -0,0 +1 @@
+db09928aea6fffbf9c2e754d2264f2bc  wc-composable-product-v1.1.1.zip

releases/wc-composable-product-v1.1.1.zip.sha256

@@ -0,0 +1 @@
+761eef69da910ecfdb20ceeed70b5d0381c7cab895e81a040d132cb0f88d749b  wc-composable-product-v1.1.1.zip

releases/wc-composable-product-v1.1.2.zip.md5

@@ -0,0 +1 @@
+37cef191778b448dcbd2ae10141f64c6  wc-composable-product-v1.1.2.zip

releases/wc-composable-product-v1.1.2.zip.sha256

@@ -0,0 +1 @@
+191eae035b34ce8b33b90cf9d85ed54e493c1b471cda0efe5c992a512e91cc36  wc-composable-product-v1.1.2.zip

releases/wc-composable-product-v1.1.3.zip.md5

@@ -0,0 +1 @@
+9bbed416019a796b4d4a5ef72e016e1f  wc-composable-product-v1.1.3.zip

releases/wc-composable-product-v1.1.3.zip.sha256

@@ -0,0 +1 @@
+0ca23ca12570f0e9c518514ffc5209d78c76c3295954d10ec74a28013a762956  wc-composable-product-v1.1.3.zip

templates/product-selector.twig

@@ -10,7 +10,7 @@
 
     <div class="composable-products-grid">
         {% for product in products %}
-        <div class="composable-product-item" data-product-id="{{ product.id }}" data-price="{{ product.price }}">
+        <div class="composable-product-item{% if not product.in_stock %} out-of-stock{% endif %}" data-product-id="{{ product.id }}" data-price="{{ product.price }}" data-stock-status="{{ product.stock_status }}">
             <div class="product-item-inner">
                 <label class="product-item-label">
                     <input type="checkbox"
@@ -18,7 +18,8 @@
                            value="{{ product.id }}"
                            class="composable-product-checkbox"
                            data-product-id="{{ product.id }}"
-                           data-price="{{ product.price }}">
+                           data-price="{{ product.price }}"
+                           {% if not product.in_stock %}disabled{% endif %}>
 
                     {% if show_images and product.image_url %}
                     <div class="product-item-image">
@@ -34,6 +35,16 @@
                             {{ product.price_html|raw }}
                         </div>
                         {% endif %}
+
+                        <div class="product-item-stock">
+                            {% if not product.in_stock %}
+                                <span class="stock-status out-of-stock">{{ __('Out of stock') }}</span>
+                            {% elseif product.managing_stock and product.stock_quantity is not null and product.stock_quantity <= 5 %}
+                                <span class="stock-status low-stock">{{ __('Only') }} {{ product.stock_quantity }} {{ __('left') }}</span>
+                            {% elseif product.in_stock %}
+                                <span class="stock-status in-stock">{{ __('In stock') }}</span>
+                            {% endif %}
+                        </div>
                     </div>
 
                     <span class="product-item-checkmark"></span>

wc-composable-product.php

@@ -3,7 +3,7 @@
  * Plugin Name: WooCommerce Composable Products
  * Plugin URI: https://github.com/magdev/wc-composable-product
  * Description: Create composable products where customers select a limited number of items from a configurable set
- * Version: 1.0.0
+ * Version: 1.1.6
  * Author: Marco Graetsch
  * Author URI: https://example.com
  * License: GPL v3 or later
@@ -19,7 +19,7 @@
 defined('ABSPATH') || exit;
 
 // Define plugin constants
-define('WC_COMPOSABLE_PRODUCT_VERSION', '1.0.0');
+define('WC_COMPOSABLE_PRODUCT_VERSION', '1.1.6');
 define('WC_COMPOSABLE_PRODUCT_FILE', __FILE__);
 define('WC_COMPOSABLE_PRODUCT_PATH', plugin_dir_path(__FILE__));
 define('WC_COMPOSABLE_PRODUCT_URL', plugin_dir_url(__FILE__));
@@ -61,7 +61,17 @@ function wc_composable_product_init() {
     // Initialize main plugin class
     WC_Composable_Product\Plugin::instance();
 }
-add_action('plugins_loaded', 'wc_composable_product_init');
+// Use woocommerce_init to ensure all WooCommerce classes including settings are loaded
+add_action('woocommerce_init', 'wc_composable_product_init');
+
+/**
+ * Declare HPOS compatibility
+ */
+add_action('before_woocommerce_init', function() {
+    if (class_exists(\Automattic\WooCommerce\Utilities\FeaturesUtil::class)) {
+        \Automattic\WooCommerce\Utilities\FeaturesUtil::declare_compatibility('custom_order_tables', __FILE__, true);
+    }
+});
 
 /**
  * Activation hook