Consolidate documentation, bump to v1.2.1

Condense CLAUDE.md from ~1960 to ~160 lines keeping only essential architecture and lessons learned. Merge INSTALL.md into README.md and IMPLEMENTATION.md into CLAUDE.md, then delete the source files. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Update .gitignore: add logs/ dir and compiled .mo files
2026-03-01 12:14:07 +01:00 · 2026-03-01 12:04:34 +01:00 · 2026-03-01 12:01:20 +01:00 · 2026-01-01 02:29:46 +01:00 · 2026-01-01 02:28:45 +01:00 · 2026-01-01 02:11:31 +01:00
26 changed files with 1267 additions and 920 deletions
--- a/.gitea/workflows/release.yml
+++ b/.gitea/workflows/release.yml
@@ -0,0 +1,205 @@
+name: Create Release Package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: mbstring, xml, zip, intl, gettext
+          tools: composer:v2
+
+      - name: Get version from tag
+        id: version
+        run: |
+          VERSION=${GITHUB_REF_NAME#v}
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Building version: $VERSION"
+
+      - name: Validate composer.json
+        run: composer validate --strict
+
+      - name: Install Composer dependencies (production)
+        run: |
+          composer config platform.php 8.3.0
+          composer install --no-dev --optimize-autoloader --no-interaction
+
+      - name: Install gettext
+        run: apt-get update && apt-get install -y gettext
+
+      - name: Compile translations
+        run: |
+          for po in languages/*.po; do
+            if [ -f "$po" ]; then
+              mo="${po%.po}.mo"
+              echo "Compiling $po to $mo"
+              msgfmt -o "$mo" "$po"
+            fi
+          done
+
+      - name: Verify plugin version matches tag
+        run: |
+          PLUGIN_VERSION=$(grep -oP "Version:\s*\K[0-9]+\.[0-9]+\.[0-9]+" wc-composable-product.php | head -1)
+          TAG_VERSION=${{ steps.version.outputs.version }}
+          if [ "$PLUGIN_VERSION" != "$TAG_VERSION" ]; then
+            echo "Error: Plugin version ($PLUGIN_VERSION) does not match tag version ($TAG_VERSION)"
+            exit 1
+          fi
+          echo "Version verified: $PLUGIN_VERSION"
+
+      - name: Create release directory
+        run: mkdir -p releases
+
+      - name: Build release package
+        run: |
+          VERSION=${{ steps.version.outputs.version }}
+          PLUGIN_NAME="wc-composable-product"
+          RELEASE_FILE="releases/${PLUGIN_NAME}-${VERSION}.zip"
+
+          # Move to parent directory for proper zip structure
+          cd ..
+
+          # Create zip with proper WordPress plugin structure
+          zip -r "${PLUGIN_NAME}/${RELEASE_FILE}" "${PLUGIN_NAME}" \
+            -x "${PLUGIN_NAME}/.git/*" \
+            -x "${PLUGIN_NAME}/.gitea/*" \
+            -x "${PLUGIN_NAME}/.github/*" \
+            -x "${PLUGIN_NAME}/.vscode/*" \
+            -x "${PLUGIN_NAME}/.claude/*" \
+            -x "${PLUGIN_NAME}/CLAUDE.md" \
+            -x "${PLUGIN_NAME}/wp-core" \
+            -x "${PLUGIN_NAME}/wp-core/*" \
+            -x "${PLUGIN_NAME}/wp-plugins" \
+            -x "${PLUGIN_NAME}/wp-plugins/*" \
+            -x "${PLUGIN_NAME}/releases/*" \
+            -x "${PLUGIN_NAME}/cache/*" \
+            -x "${PLUGIN_NAME}/composer.lock" \
+            -x "${PLUGIN_NAME}/*.log" \
+            -x "${PLUGIN_NAME}/.gitignore" \
+            -x "${PLUGIN_NAME}/.editorconfig" \
+            -x "${PLUGIN_NAME}/phpcs.xml*" \
+            -x "${PLUGIN_NAME}/phpunit.xml*" \
+            -x "${PLUGIN_NAME}/tests/*" \
+            -x "${PLUGIN_NAME}/*.po~" \
+            -x "${PLUGIN_NAME}/*.bak" \
+            -x "*.DS_Store"
+
+          cd "${PLUGIN_NAME}"
+          echo "Created: ${RELEASE_FILE}"
+
+      - name: Generate checksums
+        run: |
+          VERSION=${{ steps.version.outputs.version }}
+
+          cd releases
+          sha256sum "wc-composable-product-${VERSION}.zip" > "wc-composable-product-${VERSION}.zip.sha256"
+
+          echo "SHA256:"
+          cat "wc-composable-product-${VERSION}.zip.sha256"
+
+      - name: Verify package structure
+        run: |
+          set +o pipefail
+          VERSION=${{ steps.version.outputs.version }}
+          echo "Package contents:"
+          unzip -l "releases/wc-composable-product-${VERSION}.zip" | head -50 || true
+
+          # Verify main file is at correct location
+          if unzip -l "releases/wc-composable-product-${VERSION}.zip" | grep -q "wc-composable-product/wc-composable-product.php"; then
+            echo "✓ Main plugin file at correct location"
+          else
+            echo "✗ Error: Main plugin file not found at wc-composable-product/wc-composable-product.php"
+            exit 1
+          fi
+
+          # Verify vendor directory is included
+          if unzip -l "releases/wc-composable-product-${VERSION}.zip" | grep -q "wc-composable-product/vendor/"; then
+            echo "✓ Vendor directory included"
+          else
+            echo "✗ Error: Vendor directory not found"
+            exit 1
+          fi
+
+      - name: Extract changelog for release notes
+        id: changelog
+        run: |
+          VERSION=${{ steps.version.outputs.version }}
+          # Extract changelog section for this version
+          NOTES=$(sed -n "/^## \[${VERSION}\]/,/^## \[/p" CHANGELOG.md | sed '$ d' | tail -n +2)
+          if [ -z "$NOTES" ]; then
+            NOTES="Release version ${VERSION}"
+          fi
+          # Save to file for multi-line output
+          echo "$NOTES" > release_notes.txt
+          echo "Release notes extracted"
+
+      - name: Create Gitea Release
+        env:
+          GITEA_TOKEN: ${{ secrets.SRC_GITEA_TOKEN }}
+        run: |
+          VERSION=${{ steps.version.outputs.version }}
+          TAG_NAME=${{ github.ref_name }}
+          PRERELEASE="false"
+          if [[ "$TAG_NAME" == *-* ]]; then
+            PRERELEASE="true"
+          fi
+
+          # Read release notes
+          BODY=$(cat release_notes.txt)
+
+          # Check if release already exists for this tag and delete it
+          EXISTING_RELEASE=$(curl -s \
+            -H "Authorization: token ${GITEA_TOKEN}" \
+            "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/releases/tags/${TAG_NAME}")
+
+          EXISTING_ID=$(echo "$EXISTING_RELEASE" | jq -r '.id // empty')
+
+          if [ -n "$EXISTING_ID" ] && [ "$EXISTING_ID" != "null" ]; then
+            echo "Deleting existing release ID: $EXISTING_ID"
+            curl -s -X DELETE \
+              -H "Authorization: token ${GITEA_TOKEN}" \
+              "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/releases/${EXISTING_ID}"
+          fi
+
+          # Create release via Gitea API
+          RELEASE_RESPONSE=$(curl -s -X POST \
+            -H "Authorization: token ${GITEA_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\": \"${TAG_NAME}\", \"name\": \"Release ${VERSION}\", \"body\": $(echo "$BODY" | jq -Rs .), \"draft\": false, \"prerelease\": ${PRERELEASE}}" \
+            "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/releases")
+
+          RELEASE_ID=$(echo "$RELEASE_RESPONSE" | jq -r '.id')
+
+          if [ "$RELEASE_ID" == "null" ] || [ -z "$RELEASE_ID" ]; then
+            echo "Failed to create release:"
+            echo "$RELEASE_RESPONSE"
+            exit 1
+          fi
+
+          echo "Created release ID: $RELEASE_ID"
+
+          # Upload attachments
+          for file in "releases/wc-composable-product-${VERSION}.zip" "releases/wc-composable-product-${VERSION}.zip.sha256"; do
+            if [ -f "$file" ]; then
+              FILENAME=$(basename "$file")
+              echo "Uploading $FILENAME..."
+              curl -s -X POST \
+                -H "Authorization: token ${GITEA_TOKEN}" \
+                -H "Content-Type: application/octet-stream" \
+                --data-binary "@$file" \
+                "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/releases/${RELEASE_ID}/assets?name=${FILENAME}"
+              echo "Uploaded $FILENAME"
+            fi
+          done
+
+          echo "Release created successfully: ${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/releases/tag/${TAG_NAME}"
--- a/.gitignore
+++ b/.gitignore
@@ -1,13 +1,8 @@
-# Linked sources
-wp-core
-wp-plugins
-
 # Editor swap files
 *.*swp

 # Composer
 vendor/
-composer.lock

 # Cache
 cache/
@@ -15,12 +10,14 @@ cache/
 # Development files
 .vscode/
 .idea/
+logs/
 *.log

 # OS files
 .DS_Store
 Thumbs.db
+.directory
+
+# Binary files
+languages/*.mo

-# Release files
-*.zip
-releases/
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,408 @@ 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.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
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,336 +1,186 @@
-# WooCommerce plugin for user composable products - AI Context Document
+# WooCommerce Composable Products - AI Context Document

 **Author:** Marco Graetsch

 ## Project Overview

-This plugin implements a special product type, for which users can select a limited number of product from a configurable set of simple or variable products. The limit of selectable products should be a global and per-product setting, for which global is the fallback. The set of selectable products can be defined per category, tag or SKU. The price is either a fixed price or the sum of the prices of the selected products. Think of a package of stickers as composable product, where each package can contain $limit number of stickers.
+This plugin implements a custom WooCommerce product type where customers select a limited number of products from a configurable set of simple or variable products. The limit is configurable globally and per-product. The selectable products are defined by category, tag, or SKU. Pricing is either fixed or the sum of selected products. Think of a sticker pack where each package contains N stickers chosen by the customer.

-### Key Fact: 100% AI-Generated
-
-This project is proudly **"vibe-coded"** using Claude.AI - the entire codebase was created through AI assistance.
+This project is 100% AI-generated ("vibe-coded") using Claude.AI.

 ## Technical Stack

 - **Language:** PHP 8.3+
- **Framework:** Latest WordPress Plugin API
+- **Framework:** WordPress Plugin API
 - **E-commerce:** WooCommerce 10.0+
 - **Template Engine:** Twig 3.0 (via Composer)
 - **Frontend:** Vanilla JavaScript + jQuery
 - **Styling:** Custom CSS
- **Dependency Management:** Composer
- **Internationalization:** WordPress i18n (.pot/.po/.mo files)
-
-## Implementation Details
-
-### Security Best Practices
-
- All user inputs are sanitized (integers for quantities/prices)
- Nonce verification on form submissions
- Output escaping in templates (`esc_attr`, `esc_html`, `esc_js`)
- Direct file access prevention via `ABSPATH` check
-
-### Translation Ready
-
-All user-facing strings use:
-
-```php
-__('Text to translate', 'wc-composable-product')
-_e('Text to translate', 'wc-composable-product')
-```
-
-Text domain: `wc-composable-product`
-
-**Translation Template:**
-
- Base `.pot` file created: `languages/wc-composable-product.pot`
- Ready for translation to any locale
- All translatable strings properly marked with text domain
-
-**Available Translations:**
-
- `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
-
-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
-
- The `vendor/` directory MUST be included in releases (Twig dependency required for runtime)
- Running zip from wrong directory creates empty or malformed archives
- Exclusion patterns must match the relative path structure used in zip command
- Always verify the package with `unzip -l` and test extraction before committing
- The `wp-core/` and `wp-plugins/` directories MUST NOT be included in releases
- Releases are stored in `releases/` including checksums
-
-**Important Git Notes:**
-
- Always commit from `dev` branch first
- Tags should use format `vX.X.X` (e.g., `v1.1.22`)
- Use annotated tags (`-a`) not lightweight tags
- Commit messages should follow the established format with Claude Code attribution
- `.claude/settings.local.json` changes are typically local-only (stash before rebasing)
-
-#### What Gets Released
-
- All plugin source files
- Compiled vendor dependencies
- Translation files (.mo compiled from .po)
- Assets (CSS, JS)
- Documentation (README, CHANGELOG, etc.)
-
-#### What's Excluded
-
- Git metadata (`.git/`)
- Development files (`.vscode/`, `.claude/`, `CLAUDE.md`)
- Logs and cache files
- Previous releases
- `composer.lock` (but `vendor/` is included)
+- **Dependencies:** Composer
+- **i18n:** WordPress i18n (.pot/.po/.mo), text domain: `wc-composable-product`
+- **CI/CD:** Gitea Actions (`.gitea/workflows/release.yml`)

 ## Project Structure

 ```txt
 wc-composable-product/
+├── .gitea/workflows/
+│   └── release.yml            # CI/CD release workflow
 ├── 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
-├── cache/                     # Twig template cache (writable)
+├── cache/                     # Twig template cache (writable, gitignored)
 ├── includes/
 │   ├── 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
-├── languages/
-│   └── wc-composable-product.pot  # Translation template
+│   ├── Product_Selector.php   # Frontend product selector renderer (with stock info)
+│   ├── Product_Type.php       # Custom WC_Product extension
+│   └── Stock_Manager.php      # Stock management & inventory tracking
+├── languages/                 # Translation files (.pot, .po, .mo)
+├── releases/                  # Release packages (gitignored)
 ├── templates/
 │   └── product-selector.twig  # Frontend selection interface
-├── vendor/                    # Composer dependencies (gitignored)
-├── composer.json              # Dependency configuration
-├── wc-composable-product.php  # Main plugin file
-└── [Documentation files]      # README, INSTALL, IMPLEMENTATION, etc.
+├── vendor/                    # Composer dependencies (gitignored, included in releases)
+├── composer.json
+└── wc-composable-product.php  # Main plugin file
 ```

-## Architecture Overview
+## Architecture

 ### Core Classes

-1. **Plugin.php** - Main singleton class
-   - Initializes Twig template engine
-   - Registers hooks and filters
-   - Manages asset enqueuing
-   - Provides template rendering API
+1. **Plugin.php** — Main singleton class
+   - Initializes Twig with WordPress functions registered as both Twig functions AND filters
+   - Registers hooks, manages asset enqueuing, provides template rendering API
+   - Settings.php is lazy-loaded via `woocommerce_get_settings_pages` filter (not in `includes()`) to avoid "Class WC_Settings_Page not found" errors

-2. **Product_Type.php** - Custom WooCommerce product type
+2. **Product_Type.php** — Custom WooCommerce product type (`composable`)
   - Extends `WC_Product`
-   - Handles selection criteria (category/tag/SKU)
-   - Manages pricing modes (fixed/sum)
-   - Queries available products dynamically
+   - Queries available products via `get_available_products()` using `WP_Query`
+   - **Critical**: Uses `tax_query` with `product_type` taxonomy to exclude composable products (NOT `meta_query` — WooCommerce stores product types as taxonomy terms)
+   - Handles variable products by expanding them into individual variations via `get_children()`
+   - Products are filtered by `is_purchasable()` only (not `is_in_stock()` — stock is shown visually and validated at add-to-cart)

-3. **Cart_Handler.php** - Cart integration
-   - Validates product selections
-   - Stores selected products in cart meta
-   - Calculates dynamic pricing
-   - Displays selections in cart/checkout
+3. **Cart_Handler.php** — Cart integration
+   - Validates selections, stores selected products in cart meta, calculates pricing
+   - Uses `woocommerce_is_purchasable` filter to hide default add-to-cart button for composable products
+   - Price recalculation uses a static `$already_calculated` flag per request (no persistent session flags — `set_price()` is in-memory only)

-4. **Product_Selector.php** - Frontend renderer
-   - Renders Twig template with product data
-   - Applies display settings (images/prices/total)
+4. **Product_Selector.php** — Frontend renderer
+   - Renders Twig template with product data, stock info, and pre-formatted price HTML via `wc_price()`

-5. **Admin/Product_Data.php** - Product edit interface
-   - Adds "Composable Options" tab
-   - Category/tag/SKU selection fields
-   - Saves product metadata
+5. **Admin/Product_Data.php** — Product edit interface
+   - Adds "Composable Options" tab with category/tag/SKU selection fields
+   - Saved meta: `_composable_selection_limit`, `_composable_pricing_mode`, `_composable_criteria_type`, `_composable_categories`, `_composable_tags`, `_composable_skus`

-6. **Admin/Settings.php** - Global settings
-   - WooCommerce settings tab integration
-   - Default limits and pricing mode
-   - Display preferences
+6. **Admin/Settings.php** — Global settings (extends `WC_Settings_Page`)
+   - Default selection limit, pricing mode, display preferences
+
+7. **Stock_Manager.php** — Inventory management
+   - Stock validation, automatic deduction on order completion, restoration on cancellation
+   - Prevents WooCommerce double-deduction via `woocommerce_can_reduce_order_stock`

 ### Data Flow

-**Product Creation:**
+**Product Creation:** Admin selects "Composable product" type → configures criteria/limits/pricing → metadata saved as `_composable_*` fields

-1. Admin selects "Composable product" type
-2. Configures criteria, limits, pricing in product data tab
-3. Metadata saved: `_composable_*` fields
+**Frontend Display:** `Cart_Handler::render_product_selector()` → `Product_Type::get_available_products()` queries products via taxonomy/SKU → `Product_Selector::render()` passes data to Twig template → JavaScript handles selection UI

-**Frontend Display:**
+**Add to Cart:** Customer selects products → JS validates limit → AJAX request with `composable_products[]` → server-side validation (selection + stock) → selections stored in cart item data → price calculated per pricing mode

-1. `Cart_Handler::render_product_selector()` called on product page
-2. `Product_Type::get_available_products()` queries matching products
-3. `Product_Selector::render()` passes data to Twig template
-4. JavaScript handles selection UI and AJAX
+**Order Processing:** Order completed → `Stock_Manager` deducts inventory → order notes added for audit → on cancellation/refund: stock restored

-**Add to Cart:**
+### Key Hooks

-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
+- `woocommerce_add_to_cart_validation` — validate selections
+- `woocommerce_add_cart_item_data` — store selections
+- `woocommerce_before_calculate_totals` — update prices
+- `woocommerce_get_item_data` — display in cart
+- `woocommerce_order_status_completed/processing` — deduct stock
+- `woocommerce_order_status_cancelled/refunded` — restore stock

-## Development Workflow
+### Security

-### Initial Setup
+- Input: `absint()` for IDs/limits, `sanitize_text_field()` for modes, `sanitize_textarea_field()` for SKUs
+- Output: `esc_html()`, `esc_attr()`, `esc_url()` (registered as both Twig functions and filters)
+- Nonce verification via WooCommerce

-```bash
-composer install
+### Developer API
+
+```php
+$product = wc_get_product($product_id);
+if ($product->get_type() === 'composable') {
+    $products = $product->get_available_products();
+    $limit = $product->get_selection_limit();
+    $price = $product->calculate_composed_price($selected_ids);
+}
 ```

-### Making Changes
+## Translations

-1. **PHP Classes:** Edit files in `includes/` or `includes/Admin/`
-2. **Templates:** Modify `templates/*.twig` (cache clears on auto-reload)
-3. **Styles:** Update `assets/css/*.css`
-4. **JavaScript:** Edit `assets/js/*.js`
-5. **Translations:** Update `.pot` file, create `.po` translations
+All strings use text domain `wc-composable-product`. Available locales:

-### Testing Checklist
+- `en_US` (base), `de_DE`, `de_DE_informal`, `de_CH`, `de_CH_informal`, `fr_CH`, `it_CH`

- [ ] Create composable product in admin
- [ ] Test each selection criteria type (category/tag/SKU)
- [ ] Verify selection limit enforcement
- [ ] Test both pricing modes (fixed/sum)
- [ ] Check AJAX add-to-cart functionality
- [ ] Verify cart display shows selected products
- [ ] Test checkout process
- [ ] Check responsive design on mobile
- [ ] Validate all strings are translatable
+Compile .po to .mo: `for po in languages/*.po; do msgfmt -o "${po%.po}.mo" "$po"; done`

-### Creating Releases
+WordPress requires compiled .mo files — .po files alone are insufficient.
+
+## Release Workflow
+
+### Automated (Gitea CI/CD)
+
+Push an annotated tag (`v*`) to trigger the workflow. It installs PHP 8.3, production Composer deps, compiles translations, verifies version matches tag, creates ZIP with checksums, and publishes a Gitea release.
+
+### Manual

 ```bash
 # From project root
-zip -r wc-composable-product-vX.X.X.zip . \
+zip -r releases/wc-composable-product-vX.X.X.zip . \
  -x "*.git*" "*.vscode*" "*.claude*" "CLAUDE.md" \
-  "wp-core" "wp-plugins" "*.log" "composer.lock" \
-  "cache/*" "releases/*" "*.zip"
-
-# Verify contents
-unzip -l wc-composable-product-vX.X.X.zip
-
-# IMPORTANT: Ensure vendor/ is included!
+  "wp-core/*" "wp-plugins/*" "*.log" "composer.lock" \
+  "cache/*" "releases/*" "*.zip" "logs/*"
 ```

-## Session History
+The `vendor/` directory MUST be included in releases (Twig dependency required at runtime).

-### v1.0.0 - Initial Implementation & Release (2024-12-31)
+### Git Workflow

-#### Session 1: Core Implementation
+- Develop on `dev` branch, merge to `main` for releases
+- Tags: annotated, format `vX.X.X` (e.g., `v1.2.0`)
+- Commit messages include `Co-Authored-By: Claude` attribution

- Complete plugin implementation from scratch
- All 6 core PHP classes with PSR-4 autoloading
- Twig template system integration
- Responsive frontend with AJAX functionality
- Admin interface with WooCommerce integration
- Full i18n support with .pot template
- Comprehensive documentation (README, INSTALL, IMPLEMENTATION)
- Initial commit to `main` branch (1edb0be)
+## Critical Lessons Learned

-#### Session 2: Documentation & Translations
+1. **WooCommerce stores product types as taxonomy terms** (`product_type` taxonomy), NOT as postmeta. Using `meta_query` on `_product_type` silently returns zero results because the meta key doesn't exist.

- 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
+2. **`WC_Product::set_price()` is in-memory only** — changes are lost between HTTP requests. Never persist a "price already calculated" flag to cart session; use a static per-request flag instead.

-#### Session 3: Release Creation
+3. **Settings.php must be lazy-loaded** — `require_once` in `Plugin::includes()` causes "Class WC_Settings_Page not found" because WooCommerce hasn't loaded that class yet. Load it inside the `woocommerce_get_settings_pages` filter callback instead.

- 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)
+4. **Register WordPress functions as both Twig functions AND filters** — other plugins may bundle their own Twig instance that parses our templates. Both `{{ esc_attr(value) }}` and `{{ value|esc_attr }}` syntax must work.

-**Key decisions made:**
+5. **HPOS compatibility declaration is required** — without it, WooCommerce shows incompatibility warnings.

- Used Singleton pattern for main Plugin class
- Twig for templating (per requirements)
- Vanilla JS + jQuery for frontend (WooCommerce standard)
- Grid layout for product selector (responsive)
- AJAX add-to-cart for better UX
- Meta-based configuration storage
+6. **WordPress i18n requires compiled .mo files** — .po files are source only; WordPress cannot use them directly.

-**Files created:** 28 files total (21 PHP/templates + 7 translations), 3,842 lines of code
+7. **Don't filter by `is_in_stock()` during product retrieval** — it's too strict (excludes backorder-enabled products, products without stock management). Show all purchasable products; let the frontend display stock status and validate at add-to-cart time.

-**Git workflow:**
+## For AI Assistants

- Main branch: Initial implementation (1edb0be)
- Dev branch: +2 commits for documentation and translations
- Tagged: v1.0.0 on dev branch (8c17734)
+When starting a new session:

-**What works:**
-
- Product type registration ✓
- Admin product data tab ✓
- Category/tag/SKU selection ✓
- Frontend product selector ✓
- 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:**
-
- Variable product support
- Quantity selection per item
- Visual bundle preview
- Product recommendations
- Stock management integration
- Selection presets/templates
- Compile .mo translation files
-
---
-
-**For AI Assistants:**
-
-When starting a new session on this project:
-
-1. Read this CLAUDE.md file first
-2. Review IMPLEMENTATION.md for technical details
-3. Check git log for recent changes
-4. Verify you're on the `dev` branch before making changes
-5. Run `composer install` if vendor/ is missing
-6. Test changes before committing
-7. Follow commit message format with Claude Code attribution
-8. Update this session history section with learnings
-
-Always refer to this document when starting work on this project. Good luck!
+1. Read this CLAUDE.md first
+2. Check git log for recent changes
+3. Verify you're on the `dev` branch before making changes
+4. Run `composer install` if vendor/ is missing
+5. Test changes before committing
+6. Follow commit message format with Claude Code attribution
+7. Always use `tax_query` (not `meta_query`) for product type filtering
--- a/IMPLEMENTATION.md
+++ b/IMPLEMENTATION.md
@@ -1,434 +0,0 @@
-# WooCommerce Composable Products - Implementation Summary
-
-## Overview
-
-This document provides a technical overview of the WooCommerce Composable Products plugin implementation.
-
-**Version:** 1.0.0
-**Created:** 2024-12-31
-**AI-Generated:** 100% created with Claude.AI assistance
-
-## Architecture
-
-### Plugin Structure
-
-```txt
-wc-composable-product/
-├── assets/                  # Frontend assets
-│   ├── css/
-│   │   ├── admin.css       # Admin styles
-│   │   └── frontend.css    # Frontend styles
-│   └── js/
-│       ├── admin.js        # Admin JavaScript
-│       └── frontend.js     # Frontend JavaScript
-├── cache/                  # Twig template cache
-├── includes/               # PHP classes
-│   ├── Admin/
-│   │   ├── Product_Data.php    # Product data tab
-│   │   └── Settings.php        # Settings page
-│   ├── Cart_Handler.php        # Cart integration
-│   ├── Plugin.php              # Main plugin class
-│   ├── Product_Selector.php    # Frontend selector
-│   └── Product_Type.php        # Custom product type
-├── languages/              # Translation files
-│   └── wc-composable-product.pot
-├── templates/              # Twig templates
-│   └── product-selector.twig
-└── wc-composable-product.php   # Main plugin file
-```
-
-## Core Components
-
-### 1. Main Plugin Class (`Plugin.php`)
-
-**Responsibilities:**
-
- Singleton pattern implementation
- Twig template engine initialization
- Hook registration
- Component initialization
- Asset enqueuing
-
-**Key Methods:**
-
- `instance()`: Get singleton instance
- `init_twig()`: Initialize Twig with WordPress functions
- `render_template()`: Render Twig templates
- `add_product_type()`: Register composable product type
-
-### 2. Product Type (`Product_Type.php`)
-
-**Extends:** `WC_Product`
-
-**Key Features:**
-
- Custom product type: `composable`
- Selection limit management (per-product or global)
- Pricing mode (fixed or sum)
- Product selection criteria (category/tag/SKU)
- Dynamic product availability
- Price calculation
-
-**Key Methods:**
-
- `get_selection_limit()`: Get max selectable items
- `get_pricing_mode()`: Get pricing calculation mode
- `get_available_products()`: Query available products
- `calculate_composed_price()`: Calculate final price
-
-### 3. Admin Settings (`Admin/Settings.php`)
-
-**Extends:** `WC_Settings_Page`
-
-**Global Settings:**
-
- Default selection limit
- Default pricing mode
- Display options (images, prices, total)
-
-**Integration:** Adds tab to WooCommerce Settings
-
-### 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
- `_composable_categories`: Selected categories
- `_composable_tags`: Selected tags
- `_composable_skus`: SKU list
-
-### 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
- `show_images/prices/total`: Display flags
-
-### 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
- `woocommerce_get_item_data`: Display in cart
-
-## Frontend Implementation
-
-### Product Selector Template (`product-selector.twig`)
-
-**Features:**
-
- Responsive grid layout
- Checkbox-based selection
- Product images and prices
- Real-time total calculation
- AJAX add-to-cart
-
-**Data Attributes:**
-
- `data-product-id`: Composable product ID
- `data-selection-limit`: Max selections
- `data-pricing-mode`: Pricing mode
- `data-price`: Individual product prices
-
-### JavaScript (`frontend.js`)
-
-**Functionality:**
-
- Selection limit enforcement
- Visual feedback on selection
- Real-time price updates (sum mode)
- AJAX cart operations
- Error/success messages
-
-**Key Functions:**
-
- `handleCheckboxChange()`: Selection logic
- `updateTotalPrice()`: Calculate total
- `addToCart()`: AJAX add-to-cart
- `showMessage()`: User feedback
-
-### CSS Styling
-
-**Approach:**
-
- Grid-based layout (responsive)
- Card-style product items
- Visual selection states
- Mobile-first design
- Breakpoints: 768px, 480px
-
-## Data Flow
-
-### Creating a Composable Product
-
-1. Admin selects "Composable product" type
-2. Configure selection limit and pricing mode
-3. Choose selection criteria (category/tag/SKU)
-4. Save product metadata
-5. WooCommerce registers product with custom type
-
-### Frontend Display
-
-1. Customer visits product page
-2. `Cart_Handler` renders `Product_Selector`
-3. `Product_Type::get_available_products()` queries products
-4. Twig template renders grid with products
-5. JavaScript handles interactions
-
-### Adding to Cart
-
-1. Customer selects products (JavaScript validation)
-2. Click "Add to Cart" button
-3. AJAX request with selected product IDs
-4. `Cart_Handler::validate_add_to_cart()` validates
-5. `Cart_Handler::add_cart_item_data()` stores selections
-6. `Cart_Handler::calculate_cart_item_price()` updates price
-7. Product added to cart with custom data
-
-### Cart Display
-
-1. WooCommerce loads cart
-2. `Cart_Handler::get_cart_item_from_session()` restores data
-3. `Cart_Handler::display_cart_item_data()` shows selections
-4. Price calculated dynamically on each cart load
-
-## Security Implementation
-
-### Input Sanitization
-
- **Integers:** `absint()` for IDs and limits
- **Text:** `sanitize_text_field()` for modes and types
- **Textarea:** `sanitize_textarea_field()` for SKUs
- **Arrays:** `array_map()` with sanitization functions
-
-### Output Escaping
-
- **HTML:** `esc_html()`, `esc_html_e()`
- **Attributes:** `esc_attr()`
- **URLs:** `esc_url()`
- **JavaScript:** Localized scripts with escaped data
-
-### Validation
-
- Selection limit enforcement
- Product availability verification
- Cart data validation
- Nonce verification (via WooCommerce)
-
-## Internationalization
-
-### Text Domain
-
-`wc-composable-product`
-
-### Translation Functions
-
- `__()`: Return translated string
- `_e()`: Echo translated string
- `sprintf()` with `__()`: Variable substitution
-
-### POT File
-
-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)
- fr_CH (French - Switzerland)
- it_CH (Italian - Switzerland)
-
-## Performance Considerations
-
-### Caching
-
- Twig templates cached in `cache/` directory
- Auto-reload enabled in debug mode
- Optimized Composer autoloader
-
-### Database Queries
-
- Efficient `WP_Query` for product selection
- Meta queries for SKU filtering
- Taxonomy queries for category/tag filtering
-
-### Asset Loading
-
- Scripts only on relevant pages
- Minification ready (use build tools)
- Conditional enqueuing
-
-## Extensibility
-
-### 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)
-
-### Developer API
-
-```php
-// Get composable product
-$product = wc_get_product($product_id);
-
-// Check if composable
-if ($product->get_type() === 'composable') {
-    // Get available products
-    $products = $product->get_available_products();
-
-    // Get selection limit
-    $limit = $product->get_selection_limit();
-
-    // Calculate price
-    $price = $product->calculate_composed_price($selected_ids);
-}
-```
-
-## Testing Checklist
-
-### Admin Testing
-
- [ ] Product type appears in dropdown
- [ ] Composable Options tab displays
- [ ] Selection criteria toggle works
- [ ] Meta data saves correctly
- [ ] Settings page accessible
- [ ] Global defaults apply
-
-### Frontend Testing
-
- [ ] Product selector renders
- [ ] Selection limit enforced
- [ ] Price calculation accurate (both modes)
- [ ] AJAX add-to-cart works
- [ ] Cart displays selections
- [ ] Checkout processes correctly
-
-### Edge Cases
-
- [ ] Empty criteria (no products)
- [ ] Out of stock products excluded
- [ ] Invalid product selections rejected
- [ ] Multiple cart items unique
- [ ] Session persistence
-
-## Known Limitations
-
-1. **Variable Products:** Currently supports simple products in selection
-2. **Grouped Products:** Cannot be used as selectable items
-3. **Stock Management:** No automatic stock reduction for selected items
-4. **Caching:** Template cache needs manual clearing after updates
-
-## Future Enhancements
-
-Potential features for future versions:
-
- Variable product support in selection
- Quantity selection per item (not just presence)
- Visual bundle previews
- Advanced pricing rules
- Stock management integration
- Product recommendations
- Selection templates/presets
- Multi-currency support enhancements
-
-## 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)
-
-## Deployment
-
-### Production Checklist
-
-1. Run `composer install --no-dev --optimize-autoloader`
-2. Ensure `vendor/` directory is included
-3. Ensure `cache/` directory is writable
-4. Test on staging environment
-5. Clear all caches after activation
-6. Verify WooCommerce compatibility
-
-### Release Package
-
-Must include:
-
- All PHP files
- `vendor/` directory
- Assets (CSS, JS)
- Templates
- Language files
- Documentation
-
-Must exclude:
-
- `.git/` directory
- `composer.lock`
- Development files
- `wp-core/`, `wp-plugins/` symlinks
-
-## 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
- Development on `dev` branch
-
---
-
-**Last Updated:** 2024-12-31
-**Maintainer:** Marco Graetsch
-**AI Assistant:** Claude.AI (Anthropic)
--- a/INSTALL.md
+++ b/INSTALL.md
@@ -1,150 +0,0 @@
-# Installation Guide
-
-## Requirements
-
-Before installing the WooCommerce Composable Products plugin, ensure your system meets these requirements:
-
- **PHP**: 8.3 or higher
- **WordPress**: 6.0 or higher
- **WooCommerce**: 8.0 or higher
- **Composer**: For dependency management
-
-## Installation Steps
-
-### 1. Upload Plugin Files
-
-Upload the plugin directory to your WordPress installation:
-
-```bash
-/wp-content/plugins/wc-composable-product/
-```
-
-### 2. Install Dependencies
-
-Navigate to the plugin directory and install dependencies:
-
-```bash
-cd /wp-content/plugins/wc-composable-product/
-composer install --no-dev --optimize-autoloader
-```
-
-### 3. Activate Plugin
-
-1. Log in to your WordPress admin panel
-2. Navigate to **Plugins > Installed Plugins**
-3. Find "WooCommerce Composable Products"
-4. Click **Activate**
-
-### 4. Configure Settings
-
-After activation, configure the plugin:
-
-1. Navigate to **WooCommerce > Settings**
-2. Click on the **Composable Products** tab
-3. Configure default settings:
-   - **Default Selection Limit**: Number of items customers can select (default: 5)
-   - **Default Pricing Mode**: Choose between "Sum of selected products" or "Fixed price"
-   - **Display Options**: Toggle product images, prices, and totals
-
-## Creating Your First Composable Product
-
-### Step 1: Create a New Product
-
-1. Go to **Products > Add New**
-2. Enter a product name (e.g., "Custom Sticker Pack")
-
-### Step 2: Set Product Type
-
-1. In the **Product Data** panel, select **Composable product** from the dropdown
-
-### Step 3: Configure General Settings
-
-In the **General** tab:
- Set a **Regular price** (used if pricing mode is "Fixed")
- Configure **Selection Limit** (leave empty to use global default)
- Choose **Pricing Mode** (leave empty to use global default)
-
-### Step 4: Configure Composable Options
-
-Click on the **Composable Options** tab:
-
-1. **Selection Criteria**: Choose how to select available products
-   - **By Category**: Select product categories
-   - **By Tag**: Select product tags
-   - **By SKU**: Enter comma-separated SKUs
-
-2. Based on your selection:
-   - **Categories**: Select one or more categories from the dropdown
-   - **Tags**: Select one or more tags from the dropdown
-   - **SKUs**: Enter SKUs like: `STICKER-01, STICKER-02, STICKER-03`
-
-### Step 5: Publish
-
-Click **Publish** to make your composable product live.
-
-## Frontend Usage
-
-When customers visit your composable product:
-
-1. They see a grid of available products based on your criteria
-2. They can select up to the configured limit
-3. The total price updates in real-time (if using sum pricing mode)
-4. Click "Add to Cart" to add the composition to their cart
-5. Selected products are displayed in the cart
-
-## Troubleshooting
-
-### Plugin Won't Activate
-
- Ensure WooCommerce is installed and activated first
- Check PHP version (must be 8.3+)
- Verify Composer dependencies are installed
-
-### Products Not Showing in Selector
-
- Check that products are published and in stock
- Verify the selection criteria (category/tag/SKU) is correct
- Ensure products match the criteria you configured
-
-### Twig Template Errors
-
- Ensure the `vendor/` directory exists and contains Twig
- Run `composer install` again
- Check that the `cache/` directory is writable
-
-### JavaScript Not Working
-
- Clear browser cache
- Check browser console for errors
- Ensure jQuery is loaded (WooCommerce includes it)
-
-## Updating
-
-When updating the plugin:
-
-1. Deactivate the plugin
-2. Replace plugin files
-3. Run `composer install --no-dev --optimize-autoloader`
-4. Reactivate the plugin
-5. Clear all caches (WordPress, browser, CDN)
-
-## Uninstallation
-
-To completely remove the plugin:
-
-1. Deactivate the plugin
-2. Delete the plugin from the Plugins page
-3. Optionally clean up database entries (WooCommerce will handle this automatically)
-
-## Support
-
-For issues and feature requests:
- GitHub: https://github.com/magdev/wc-composable-product/issues
- Documentation: See README.md
-
-## Next Steps
-
- Customize the template by editing `templates/product-selector.twig`
- Modify styles in `assets/css/frontend.css`
- Translate the plugin using the provided `.pot` file
- Create categories/tags for easier product organization
--- a/README.md
+++ b/README.md
@@ -1,51 +1,112 @@
 # WooCommerce Composable Products

-Create composable products where customers can select a limited number of items from a configurable set of products.
+Create composable products where customers can select a limited number of items from a configurable set of products. Think of it as a "build your own gift box" or "create your sticker pack" feature.

-## Description
-
-This plugin adds a new product type to WooCommerce that allows customers to build their own product bundles by selecting from a predefined set of simple or variable products. Think of it as a "build your own gift box" or "create your sticker pack" feature.
-
-### Key Features
+## Key Features

 - **Custom Product Type**: New "Composable Product" type in WooCommerce
 - **Flexible Selection**: Define available products by category, tag, or SKU
+- **Variable Product Support**: Automatically expands variable products into selectable variations
+- **Stock Management**: Real-time stock validation, visual indicators, and automatic inventory tracking
 - **Configurable Limits**: Set global or per-product selection limits
- **Pricing Options**: Fixed price or sum of selected products
- **Multi-language Support**: Fully translatable with i18n support
+- **Pricing Options**: Fixed price or sum of selected products with full locale-aware formatting
+- **Multi-language Support**: Fully translated in 6 locales (de_DE, de_CH, fr_CH, it_CH + informal variants)
 - **Modern UI**: Clean interface built with Twig templates and vanilla JavaScript
+- **CI/CD**: Automated release workflow for Gitea

 ## Requirements

 - PHP 8.3 or higher
 - WordPress 6.0 or higher
 - WooCommerce 8.0 or higher
+- Composer (for dependency management)

 ## Installation

-1. Upload the plugin files to `/wp-content/plugins/wc-composable-product/`
-2. Run `composer install --no-dev` in the plugin directory
-3. Activate the plugin through the 'Plugins' menu in WordPress
-4. Configure global settings under WooCommerce > Settings > Composable Products
+### From Release Package
+
+1. Download the latest release ZIP from the releases page
+2. In WordPress admin, go to **Plugins > Add New > Upload Plugin**
+3. Upload the ZIP file and click **Install Now**
+4. Activate the plugin through the **Plugins** menu
+5. Configure global settings under **WooCommerce > Settings > Composable Products**
+
+### From Source
+
+1. Upload the plugin directory to `/wp-content/plugins/wc-composable-product/`
+2. Install dependencies:
+
+   ```bash
+   cd /wp-content/plugins/wc-composable-product/
+   composer install --no-dev --optimize-autoloader
+   ```
+
+3. Activate the plugin through the **Plugins** menu in WordPress
+4. Configure global settings under **WooCommerce > Settings > Composable Products**

 ## Usage

-### Creating a Composable Product
-
-1. Go to Products > Add New
-2. Select "Composable Product" as the product type
-3. Configure product details:
-   - Set the selection limit (or use global default)
-   - Choose pricing mode (fixed or sum)
-   - Define available products by category, tag, or SKU
-4. Publish the product
-
 ### Global Settings

-Navigate to WooCommerce > Settings > Composable Products to configure:
- Default selection limit
- Default pricing mode
- Display options
+Navigate to **WooCommerce > Settings > Composable Products** to configure:
+
+- **Default Selection Limit**: Number of items customers can select (default: 5)
+- **Default Pricing Mode**: Choose between "Sum of selected products" or "Fixed price"
+- **Display Options**: Toggle product images, prices, and totals
+
+### Creating a Composable Product
+
+1. Go to **Products > Add New**
+2. Select **Composable product** from the Product Data dropdown
+3. In the **General** tab:
+   - Set a **Regular price** (used when pricing mode is "Fixed")
+   - Configure **Selection Limit** (leave empty to use global default)
+   - Choose **Pricing Mode** (leave empty to use global default)
+4. Click the **Composable Options** tab:
+   - **Selection Criteria**: Choose how to define available products
+     - **By Category**: Select one or more product categories
+     - **By Tag**: Select one or more product tags
+     - **By SKU**: Enter comma-separated SKUs (e.g., `STICKER-01, STICKER-02`)
+5. Click **Publish**
+
+### Frontend Behavior
+
+When customers visit a composable product page:
+
+1. A grid of available products is displayed based on configured criteria
+2. Customers select up to the configured limit via checkboxes
+3. Total price updates in real-time (in sum pricing mode)
+4. Stock indicators show availability (green/orange/red badges)
+5. Click "Add to Cart" to add the composition to cart
+6. Selected products are listed in the cart and checkout
+
+## Troubleshooting
+
+### Plugin Won't Activate
+
+- Ensure WooCommerce is installed and activated first
+- Check PHP version (must be 8.3+)
+- Verify Composer dependencies are installed (`vendor/` directory exists)
+
+### Products Not Showing in Selector
+
+- Check that products are published
+- Verify the selection criteria (category/tag/SKU) matches existing products
+- Ensure the criteria type and values are saved in the Composable Options tab
+
+### Twig Template Errors
+
+- Ensure the `vendor/` directory exists and contains Twig
+- Run `composer install` again
+- Check that the `cache/` directory is writable
+
+### Updating
+
+1. Deactivate the plugin
+2. Replace plugin files (or upload new release ZIP)
+3. If installed from source: run `composer install --no-dev --optimize-autoloader`
+4. Reactivate the plugin
+5. Clear all caches (WordPress, browser, CDN)

 ## Development

@@ -60,10 +121,28 @@ composer install
 ### Translation

 Generate POT file:
+
 ```bash
 wp i18n make-pot . languages/wc-composable-product.pot
 ```

+Compile translations:
+
+```bash
+for po in languages/*.po; do msgfmt -o "${po%.po}.mo" "$po"; done
+```
+
+### Creating Releases
+
+Releases are automated via Gitea CI/CD. Push an annotated tag to trigger:
+
+```bash
+git tag -a v1.2.0 -m "Release v1.2.0"
+git push origin v1.2.0
+```
+
+The workflow builds the release ZIP, compiles translations, generates checksums, and creates a Gitea release with attachments.
+
 ## License

 GPL v3 or later - see LICENSE file for details
@@ -74,4 +153,4 @@ Marco Graetsch

 ## Support

-For issues and feature requests, please use the GitHub issue tracker.
+For issues and feature requests, please use the issue tracker.
--- a/assets/css/admin.css
+++ b/assets/css/admin.css
@@ -4,10 +4,17 @@
 * @package WC_Composable_Product
 */

+/* Hide composable panel by default */
 #composable_product_data {
+    display: none;
    padding: 12px;
 }

+/* Show composable panel when composable type is selected */
+body.product-type-composable #composable_product_data {
+    display: block;
+}
+
 .composable_criteria_group {
    border-top: 1px solid #eee;
    padding-top: 12px;
@@ -19,11 +26,23 @@
    min-height: 150px;
 }

-.show_if_composable {
+/* Hide composable-specific elements by default (but not tabs) */
+.options_group.show_if_composable {
    display: none;
 }

-.product-type-composable .show_if_composable {
+/* Show composable elements when composable product type is selected */
+body.product-type-composable .options_group.show_if_composable {
+    display: block;
+}
+
+/* Hide the Composable Options tab link by default */
+.product_data_tabs li.composable_options {
+    display: none;
+}
+
+/* Show the Composable Options tab when composable type selected */
+body.product-type-composable .product_data_tabs li.composable_options {
    display: block;
 }

--- a/assets/css/frontend.css
+++ b/assets/css/frontend.css
--- a/assets/js/admin.js
+++ b/assets/js/admin.js
@@ -17,12 +17,14 @@
            if (productType === 'composable') {
                $('.show_if_composable').show();
                $('.hide_if_composable').hide();
-                $('#composable_product_data').show();
-                $('.product_data_tabs .composable_options a').show();
+                // Show the composable tab, then click it so WooCommerce's
+                // native tab system hides all other panels properly
+                $('.product_data_tabs li.composable_options').show();
+                $('ul.product_data_tabs li.composable_options a').trigger('click');
            } else {
                $('.show_if_composable').hide();
+                $('.product_data_tabs li.composable_options').hide();
                $('#composable_product_data').hide();
-                $('.product_data_tabs .composable_options a').hide();
            }
        }).trigger('change');

@@ -36,6 +38,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
         */
--- a/assets/js/frontend.js
+++ b/assets/js/frontend.js
@@ -63,6 +63,36 @@
            this.clearMessages($container);
        },

+        /**
+         * Format price using WooCommerce settings
+         *
+         * @param {number} price Price amount
+         * @return {string} Formatted price HTML
+         */
+        formatPrice: function(price) {
+            if (typeof wcComposableProduct === 'undefined' || !wcComposableProduct.price_format) {
+                return price.toFixed(2);
+            }
+
+            const format = wcComposableProduct.price_format;
+            const decimals = parseInt(format.decimals, 10);
+            const decimalSep = format.decimal_separator;
+            const thousandSep = format.thousand_separator;
+
+            // Format number
+            let priceStr = price.toFixed(decimals);
+            const parts = priceStr.split('.');
+            parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, thousandSep);
+            priceStr = parts.join(decimalSep);
+
+            // Apply price format (e.g., "%1$s%2$s" for symbol+price or "%2$s%1$s" for price+symbol)
+            let formatted = format.price_format
+                .replace('%1$s', '<span class="woocommerce-Price-currencySymbol">' + format.currency_symbol + '</span>')
+                .replace('%2$s', priceStr);
+
+            return '<span class="woocommerce-Price-amount amount">' + formatted + '</span>';
+        },
+
        /**
         * Update total price
         *
@@ -79,8 +109,8 @@
                }
            });

-            const currencySymbol = $container.find('.total-price').data('currency');
-            $container.find('.calculated-total').text(currencySymbol + total.toFixed(2));
+            const formattedPrice = this.formatPrice(total);
+            $container.find('.calculated-total').html(formattedPrice);
        },

        /**
--- a/composer.json
+++ b/composer.json
@@ -6,7 +6,7 @@
    "authors": [
        {
            "name": "Marco Graetsch",
-            "email": "marco@example.com"
+            "email": "magdev3.0@gmail.com"
        }
    ],
    "require": {
--- a/includes/Admin/Product_Data.php
+++ b/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>';
        }
    }
--- a/includes/Cart_Handler.php
+++ b/includes/Cart_Handler.php
@@ -35,6 +35,21 @@ class Cart_Handler {
        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);
+        add_filter('woocommerce_is_purchasable', [$this, 'hide_default_add_to_cart'], 10, 2);
+    }
+
+    /**
+     * Hide default WooCommerce add to cart button for composable products
+     *
+     * @param bool $is_purchasable Is purchasable status
+     * @param \WC_Product $product Product object
+     * @return bool
+     */
+    public function hide_default_add_to_cart($is_purchasable, $product) {
+        if ($product && $product->get_type() === 'composable') {
+            return false;
+        }
+        return $is_purchasable;
    }

    /**
@@ -185,6 +200,12 @@ class Cart_Handler {
            return;
        }

+        // Use static flag to prevent multiple executions within the same request
+        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'])) {
@@ -194,5 +215,7 @@ class Cart_Handler {
                }
            }
        }
+
+        $already_calculated = true;
    }
 }
--- a/includes/Plugin.php
+++ b/includes/Plugin.php
@@ -84,13 +84,20 @@ 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'));
+        $this->twig->addFunction(new \Twig\TwigFunction('wc_price', 'wc_price'));
+
+        // 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';
@@ -155,6 +162,13 @@ class Plugin {
                    'max_items' => __('Maximum items selected', 'wc-composable-product'),
                    'min_items' => __('Please select at least one item', 'wc-composable-product'),
                ],
+                'price_format' => [
+                    'currency_symbol' => get_woocommerce_currency_symbol(),
+                    'decimal_separator' => wc_get_price_decimal_separator(),
+                    'thousand_separator' => wc_get_price_thousand_separator(),
+                    'decimals' => wc_get_price_decimals(),
+                    'price_format' => get_woocommerce_price_format(),
+                ],
            ]);
        }
    }
@@ -191,6 +205,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;
    }
--- a/includes/Product_Selector.php
+++ b/includes/Product_Selector.php
@@ -65,6 +65,8 @@ class Product_Selector {
            'show_prices' => $show_prices,
            'show_total' => $show_total,
            'fixed_price' => $product->get_price(),
+            'fixed_price_html' => wc_price($product->get_price()),
+            'zero_price_html' => wc_price(0),
            'currency_symbol' => get_woocommerce_currency_symbol(),
        ];

--- a/includes/Product_Type.php
+++ b/includes/Product_Type.php
@@ -110,15 +110,17 @@ class Product_Type extends \WC_Product {
            'post_status' => 'publish',
            'orderby' => 'title',
            'order' => 'ASC',
-            'tax_query' => [],
        ];

-        // Exclude composable products from selection
-        $args['meta_query'] = [
+        // Exclude composable products using the product_type taxonomy
+        // (WooCommerce stores product types as taxonomy terms, NOT as postmeta)
+        $args['tax_query'] = [
+            'relation' => 'AND',
            [
-                'key' => '_product_type',
-                'value' => 'composable',
-                'compare' => '!=',
+                'taxonomy' => 'product_type',
+                'field' => 'slug',
+                'terms' => ['composable'],
+                'operator' => 'NOT IN',
            ],
        ];

@@ -148,10 +150,12 @@ class Product_Type extends \WC_Product {
            case 'sku':
                if (!empty($criteria['skus'])) {
                    $skus = array_map('trim', explode(',', $criteria['skus']));
-                    $args['meta_query'][] = [
+                    $args['meta_query'] = [
+                        [
                            'key' => '_sku',
                            'value' => $skus,
                            'compare' => 'IN',
+                        ],
                    ];
                }
                break;
@@ -163,13 +167,28 @@ class Product_Type extends \WC_Product {
        if ($query->have_posts()) {
            foreach ($query->posts as $post) {
                $product = wc_get_product($post->ID);
-                if ($product && $product->is_in_stock() && $product->is_purchasable()) {
+
+                if (!$product) {
+                    continue;
+                }
+
+                // Handle variable products by including their variations
+                if ($product->is_type('variable')) {
+                    $variation_ids = $product->get_children();
+                    foreach ($variation_ids as $variation_id) {
+                        $variation = wc_get_product($variation_id);
+                        if ($variation && $variation->is_purchasable()) {
+                            $products[] = $variation;
+                        }
+                    }
+                } elseif ($product->is_purchasable()) {
                    $products[] = $product;
                }
            }
        }

        wp_reset_postdata();
+
        return $products;
    }

--- a/languages/wc-composable-product-de_CH.po
+++ b/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,39 @@ 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"
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr "Keine Produkte zur Auswahl verfügbar. Bitte konfigurieren Sie die Produktkriterien im Admin-Bereich."
--- a/languages/wc-composable-product-de_CH_informal.po
+++ b/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,39 @@ 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"
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr "Keine Produkte zur Auswahl verfügbar. Bitte konfiguriere die Produktkriterien im Admin-Bereich."
--- a/languages/wc-composable-product-de_DE.po
+++ b/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,39 @@ 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"
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr "Keine Produkte zur Auswahl verfügbar. Bitte konfigurieren Sie die Produktkriterien im Admin-Bereich."
--- a/languages/wc-composable-product-de_DE_informal.po
+++ b/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,39 @@ 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"
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr "Keine Produkte zur Auswahl verfügbar. Bitte konfiguriere die Produktkriterien im Admin-Bereich."
--- a/languages/wc-composable-product-fr_CH.po
+++ b/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,39 @@ 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"
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr "Aucun produit disponible pour la sélection. Veuillez configurer les critères de produit dans le panneau d'administration."
--- a/languages/wc-composable-product-it_CH.po
+++ b/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"
@@ -230,3 +238,7 @@ msgstr "rimasti"
 #: templates/product-selector.twig
 msgid "In stock"
 msgstr "Disponibile"
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr "Nessun prodotto disponibile per la selezione. Si prega di configurare i criteri del prodotto nel pannello di amministrazione."
--- a/languages/wc-composable-product.pot
+++ b/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
@@ -229,3 +237,7 @@ msgstr ""
 #: templates/product-selector.twig
 msgid "In stock"
 msgstr ""
+
+#: templates/product-selector.twig
+msgid "No products available for selection. Please configure the product criteria in the admin panel."
+msgstr ""
--- a/templates/product-selector.twig
+++ b/templates/product-selector.twig
@@ -9,6 +9,11 @@
    </div>

    <div class="composable-products-grid">
+        {% if products is empty %}
+        <div class="composable-no-products">
+            <p>{{ __('No products available for selection. Please configure the product criteria in the admin panel.') }}</p>
+        </div>
+        {% else %}
        {% for product in products %}
        <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">
@@ -52,16 +57,17 @@
            </div>
        </div>
        {% endfor %}
+        {% endif %}
    </div>

    {% if show_total %}
    <div class="composable-total">
        <div class="total-label">{{ __('Total Price:') }}</div>
-        <div class="total-price" data-currency="{{ currency_symbol }}">
+        <div class="total-price" data-currency="{{ currency_symbol }}" data-fixed-price="{{ fixed_price }}">
            {% if pricing_mode == 'fixed' %}
-                {{ currency_symbol }}{{ fixed_price }}
+                {{ fixed_price_html|raw }}
            {% else %}
-                <span class="calculated-total">{{ currency_symbol }}0.00</span>
+                <span class="calculated-total">{{ zero_price_html|raw }}</span>
            {% endif %}
        </div>
    </div>
--- a/wc-composable-product.php
+++ b/wc-composable-product.php
@@ -1,11 +1,12 @@
 <?php
+
 /**
 * Plugin Name: WooCommerce Composable Products
- * Plugin URI: https://github.com/magdev/wc-composable-product
+ * Plugin URI: https://src.bundespruefstelle.ch/magdev/wc-composable-product
 * Description: Create composable products where customers select a limited number of items from a configurable set
- * Version: 1.1.0
+ * Version: 1.2.1
 * Author: Marco Graetsch
- * Author URI: https://example.com
+ * Author URI: https://src.bundespruefstelle.ch/magdev
 * License: GPL v3 or later
 * License URI: https://www.gnu.org/licenses/gpl-3.0.html
 * Text Domain: wc-composable-product
@@ -19,7 +20,7 @@
 defined('ABSPATH') || exit;

 // Define plugin constants
-define('WC_COMPOSABLE_PRODUCT_VERSION', '1.1.0');
+define('WC_COMPOSABLE_PRODUCT_VERSION', '1.2.1');
 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,8 +62,17 @@ function wc_composable_product_init() {
    // Initialize main plugin class
    WC_Composable_Product\Plugin::instance();
 }
-// Use woocommerce_loaded to ensure WooCommerce classes are available
-add_action('woocommerce_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