You've already forked wc-composable-product
Compare commits
58 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| dea1b055b2 | |||
| a7d6a57f01 | |||
| ea2261d8d7 | |||
| dd5965ae4c | |||
| 9bc7a62f20 | |||
| ed66c96d3d | |||
| ea64dbfb33 | |||
| 6507f4d8bb | |||
| 29a68b0be4 | |||
| fb8ddf903e | |||
| 33d2836de0 | |||
| c036a37602 | |||
| efedd1bf29 | |||
| 12388af5a0 | |||
| c39c13ffed | |||
| 7931dbeef9 | |||
| ee81de86c2 | |||
| 669888817b | |||
| 5564b888fc | |||
| 91aca25169 | |||
| 4195fb2651 | |||
| ba28ae174f | |||
| 755108a7d3 | |||
| 85983d5473 | |||
| 252b187600 | |||
| 8185a77697 | |||
| 6c2e317230 | |||
| 58f5329bc4 | |||
| 0767016370 | |||
| fa7ec0e422 | |||
| f4d2543d4e | |||
| 9e4513f911 | |||
| 4dc7b767a8 | |||
| f763e35d19 | |||
| 8b271c90c0 | |||
| 0dd4408b23 | |||
| 7a4a0a0135 | |||
| c6a48d6404 | |||
| ac1cb9b135 | |||
| f5bc0d0335 | |||
| 88a907c4dd | |||
| 03a7624564 | |||
| 1c3f44f3c2 | |||
| 287f8b778b | |||
| 63d8f9ed52 | |||
| 601570d724 | |||
| e9b2d1c79b | |||
| d27dd4b7bd | |||
| 1b7c7a0257 | |||
| 4f65c8e5e0 | |||
| 054617f320 | |||
| 8fc0614334 | |||
| 867abc8f63 | |||
| 818fd51502 | |||
| 392559dedc | |||
| 17d5312df3 | |||
| 037be97ece | |||
| 28d2223306 |
273
.gitea/workflows/release.yml
Normal file
273
.gitea/workflows/release.yml
Normal file
@@ -0,0 +1,273 @@
|
||||
name: Create Release Package
|
||||
|
||||
on:
|
||||
push:
|
||||
tags:
|
||||
- 'v*'
|
||||
|
||||
jobs:
|
||||
lint:
|
||||
name: PHP Lint
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- name: Checkout code
|
||||
uses: actions/checkout@v4
|
||||
with:
|
||||
submodules: recursive
|
||||
fetch-depth: 0
|
||||
|
||||
- name: Setup PHP
|
||||
uses: shivammathur/setup-php@v2
|
||||
with:
|
||||
php-version: '8.3'
|
||||
extensions: mbstring, xml, zip
|
||||
tools: composer:v2
|
||||
|
||||
- name: PHP Syntax Check
|
||||
run: |
|
||||
find includes -name "*.php" -print0 | xargs -0 -n1 php -l
|
||||
find tests -name "*.php" -print0 | xargs -0 -n1 php -l
|
||||
|
||||
phpcs:
|
||||
name: PHP CodeSniffer
|
||||
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
|
||||
tools: composer:v2
|
||||
|
||||
- name: Install Composer dependencies
|
||||
run: |
|
||||
composer config platform.php 8.3.0
|
||||
composer install --optimize-autoloader --no-interaction
|
||||
|
||||
- name: Run PHPCS
|
||||
run: vendor/bin/phpcs
|
||||
|
||||
test:
|
||||
name: PHP Unit
|
||||
runs-on: ubuntu-latest
|
||||
needs: lint
|
||||
steps:
|
||||
- name: Checkout code
|
||||
uses: actions/checkout@v4
|
||||
|
||||
- name: Setup PHP
|
||||
uses: shivammathur/setup-php@v2
|
||||
with:
|
||||
php-version: '8.3'
|
||||
extensions: mbstring, xml
|
||||
tools: composer:v2
|
||||
|
||||
- name: Install Composer dependencies
|
||||
run: |
|
||||
composer config platform.php 8.3.0
|
||||
composer install --optimize-autoloader --no-interaction
|
||||
|
||||
- name: Run PHPUnit tests
|
||||
run: vendor/bin/phpunit --testdox
|
||||
|
||||
build-release:
|
||||
needs: [test, phpcs]
|
||||
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}"
|
||||
16
.gitignore
vendored
Normal file → Executable file
16
.gitignore
vendored
Normal file → Executable file
@@ -1,14 +1,8 @@
|
||||
# Linked sources
|
||||
wp-core
|
||||
wp-plugins
|
||||
tpp
|
||||
|
||||
# Editor swap files
|
||||
*.*swp
|
||||
|
||||
# Composer
|
||||
vendor/
|
||||
composer.lock
|
||||
|
||||
# Cache
|
||||
cache/
|
||||
@@ -16,9 +10,19 @@ cache/
|
||||
# Development files
|
||||
.vscode/
|
||||
.idea/
|
||||
logs/
|
||||
*.log
|
||||
|
||||
# OS files
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
.directory
|
||||
|
||||
# PHPUnit local overrides
|
||||
phpunit.xml
|
||||
|
||||
# Binary files
|
||||
languages/*.mo
|
||||
|
||||
.phpunit.result.cache
|
||||
.phpunit.cache/
|
||||
|
||||
382
CHANGELOG.md
382
CHANGELOG.md
@@ -5,6 +5,388 @@ All notable changes to this project will be documented in this file.
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [1.3.1] - 2026-03-01
|
||||
|
||||
### Added
|
||||
|
||||
- **PHPUnit test suite**: 57 unit tests covering all 6 core classes (ProductType, StockManager, CartHandler, Plugin, Admin/ProductData, Admin/Settings)
|
||||
- **Brain Monkey + Mockery** for WordPress/WooCommerce function mocking without a full WP installation
|
||||
- **WooCommerce class stubs** in `tests/stubs/` for classes extended by the plugin (WC_Product, WC_Settings_Page, etc.)
|
||||
- **PHPCS** with WordPress-Extra and PHPCompatibilityWP coding standards (`phpcs.xml.dist`)
|
||||
- **PHPCS job** in release workflow — coding standards must pass before release is built
|
||||
- **PHP lint job** in release workflow — syntax-checks all PHP files before testing
|
||||
- **Test job** in release workflow — tests must pass before release package is built
|
||||
- Testing and linting sections in README and CLAUDE.md
|
||||
|
||||
### Changed
|
||||
|
||||
- **PSR-4 refactored**: Renamed files to PascalCase (Product_Type → ProductType, etc.) and changed namespace from `WC_Composable_Product` to `Magdev\WcComposableProduct`
|
||||
- Updated all cross-references in PHP files, main plugin file, composer.json, CSS/JS doc comments, and translation file source comments
|
||||
- **PHPUnit upgraded** from 9.6 to 10 (Brain Monkey 2.7 supports both)
|
||||
- **WPCS formatting** applied to all source files (tabs, Yoda conditions, strict `in_array`, `wp_json_encode`, long array syntax)
|
||||
- Release workflow now has four stages: lint + phpcs (parallel) → test → build-release
|
||||
- Composer platform pinned to PHP 8.3 to prevent incompatible dependency locks
|
||||
|
||||
## [1.3.0] - 2026-03-01
|
||||
|
||||
### Added
|
||||
|
||||
- **Include Non-Public Products**: New option to include draft and private products in composable product selections
|
||||
- Global setting under WooCommerce > Settings > Composable Products
|
||||
- Per-product override in the Composable Options tab (Use global default / Yes / No)
|
||||
- Useful when products should only be sold as part of a composition, not individually
|
||||
- Translations for the new setting in all 6 locales (de_DE, de_CH, fr_CH, it_CH + informal variants)
|
||||
|
||||
## [1.2.1] - 2026-03-01
|
||||
|
||||
### Changed
|
||||
|
||||
- Consolidated documentation: merged INSTALL.md into README.md, merged IMPLEMENTATION.md into CLAUDE.md
|
||||
- Condensed CLAUDE.md from ~1960 lines to ~160 lines, keeping only essential architecture and lessons learned
|
||||
- README.md now includes full installation guide, usage tutorial, and troubleshooting section
|
||||
- Cleaned up .gitignore
|
||||
|
||||
### Removed
|
||||
|
||||
- INSTALL.md (content merged into README.md)
|
||||
- IMPLEMENTATION.md (content merged into CLAUDE.md)
|
||||
|
||||
## [1.2.0] - 2026-03-01
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Product selection always empty regardless of configuration (categories, tags, or SKUs)
|
||||
- Root cause: Product query used a `meta_query` checking `_product_type` in `wp_postmeta`, but WooCommerce stores product types in the `product_type` **taxonomy** — the `!=` comparison with a non-existent meta key caused an INNER JOIN returning zero results
|
||||
- Fix: Replaced broken `meta_query` with correct `tax_query` using `product_type` taxonomy to exclude composable products
|
||||
- **CRITICAL**: Cart price always 0.00 despite correct frontend price calculation
|
||||
- Root cause: `composable_price_calculated` flag was persisted to the cart session, preventing price recalculation on subsequent page loads — but `set_price()` only modifies the in-memory product object and is lost between requests
|
||||
- Fix: Removed per-item session flag; the existing static `$already_calculated` flag already prevents duplicate calculation within a single request
|
||||
- **Admin tab rendering**: Both General and Composable Options panels visible on initial page load
|
||||
- Root cause: JavaScript manually showed `#composable_product_data` via `.show()` without hiding the General panel
|
||||
- Fix: Trigger WooCommerce's native tab click instead, so the tab system handles panel visibility correctly
|
||||
|
||||
### Added
|
||||
|
||||
- **Gitea CI/CD release workflow** (`.gitea/workflows/release.yml`)
|
||||
- Triggered on `v*` tags
|
||||
- Installs PHP 8.3 with production Composer dependencies
|
||||
- Compiles `.po` → `.mo` translations
|
||||
- Verifies plugin version matches tag
|
||||
- Builds release ZIP with proper WordPress directory structure
|
||||
- Generates SHA-256 checksums
|
||||
- Verifies package contains main plugin file and vendor directory
|
||||
- Extracts changelog for release notes
|
||||
- Creates Gitea release with attachments via API
|
||||
|
||||
### Removed
|
||||
|
||||
- Debug logging from v1.1.14 (no longer needed after root cause identified)
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified files: includes/Product_Type.php, includes/Cart_Handler.php, assets/js/admin.js
|
||||
- New file: .gitea/workflows/release.yml
|
||||
- Product query now correctly uses `tax_query` with `product_type` taxonomy (`NOT IN` operator)
|
||||
- Cart price recalculated on every request via `woocommerce_before_calculate_totals` hook
|
||||
- Admin JS uses `$('ul.product_data_tabs li.composable_options a').trigger('click')` for native WooCommerce tab handling
|
||||
|
||||
## [1.1.14] - 2025-12-31
|
||||
|
||||
### Added
|
||||
|
||||
- **DEBUG**: Comprehensive debug logging to troubleshoot product retrieval issues
|
||||
- Error log output shows selection criteria, query arguments, and results
|
||||
- Logs each product/variation being added to help identify filtering issues
|
||||
- Enable by setting WP_DEBUG to true in wp-config.php
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified file: includes/Product_Type.php (added error_log statements throughout get_available_products())
|
||||
- Logs criteria array (categories, tags, SKUs)
|
||||
- Logs WP_Query arguments before execution
|
||||
- Logs number of posts found by query
|
||||
- Logs each variable product's variation count
|
||||
- Logs each variation/simple product being added with name
|
||||
- Logs total products available at end
|
||||
- All logging wrapped in WP_DEBUG checks (no performance impact in production)
|
||||
|
||||
### Notes
|
||||
|
||||
- This is a debug release to help diagnose why products aren't showing
|
||||
- No functional changes from v1.1.13
|
||||
- User should enable WP_DEBUG and check debug.log or error.log
|
||||
- Log output will show exactly where products are being filtered out
|
||||
- All translation files remain at 100% completion (57/57 strings)
|
||||
|
||||
## [1.1.13] - 2025-12-31
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: "No products available for selection" message showing even when products are configured
|
||||
- Removed overly strict `is_in_stock()` requirement that was filtering out all products
|
||||
- Products now show regardless of stock status (out-of-stock items are displayed but disabled)
|
||||
- Added `'relation' => 'AND'` to meta_query for proper handling of multiple meta conditions
|
||||
|
||||
### Changed
|
||||
|
||||
- Product retrieval now shows all purchasable products, not just in-stock ones
|
||||
- Stock status still displayed on frontend with appropriate styling
|
||||
- Out-of-stock items shown but disabled via checkbox and visual indicators
|
||||
- Frontend stock management from v1.1.0 still fully functional
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified file: includes/Product_Type.php (lines 117-124, 177, 181)
|
||||
- Changed from `$variation->is_in_stock() && $variation->is_purchasable()` to just `$variation->is_purchasable()`
|
||||
- Changed from `$product->is_in_stock() && $product->is_purchasable()` to just `$product->is_purchasable()`
|
||||
- Added `'relation' => 'AND'` to meta_query array for WordPress query compatibility
|
||||
|
||||
### Notes
|
||||
|
||||
- This fixes the issue where NO products were showing in the selector
|
||||
- Stock validation still occurs at add-to-cart time (Stock_Manager class)
|
||||
- Frontend still displays stock badges (in stock, low stock, out of stock)
|
||||
- Out-of-stock items remain non-selectable via disabled checkboxes
|
||||
- All translation files remain at 100% completion (57/57 strings)
|
||||
|
||||
## [1.1.12] - 2025-12-31
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Variable product variations still not appearing in product selector after v1.1.11 release
|
||||
- Changed variation retrieval method from `get_available_variations()` to `get_children()` for more reliable variation ID retrieval
|
||||
- `get_available_variations()` returns complex data arrays which may not work in all contexts
|
||||
- `get_children()` returns simple array of variation IDs directly, ensuring consistent results
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified file: includes/Product_Type.php (lines 171-184)
|
||||
- Changed from `$product->get_available_variations()` to `$product->get_children()`
|
||||
- More direct and reliable method for retrieving variation IDs
|
||||
- Each variation ID passed to `wc_get_product()` for full product object
|
||||
- Maintains all stock and purchasability checks from v1.1.11
|
||||
|
||||
### Notes
|
||||
|
||||
- This is a patch release fixing the variable product support introduced in v1.1.11
|
||||
- User reported "nope, still no product selectable" after v1.1.11
|
||||
- Root cause: `get_available_variations()` returns variation data arrays instead of clean IDs
|
||||
- `get_children()` is the standard WooCommerce method for retrieving variation IDs
|
||||
- All translation files remain at 100% completion (57/57 strings - no changes needed)
|
||||
|
||||
## [1.1.11] - 2025-12-31
|
||||
|
||||
### Added
|
||||
|
||||
- **FEATURE**: Variable product support - composable products can now include variable products and their variations
|
||||
- Variable products automatically expand to show all available variations as selectable items
|
||||
- Each variation displays with full attribute information (e.g., "Product - Color: Red, Size: Large")
|
||||
|
||||
### Fixed
|
||||
|
||||
- Products not showing in selector when all available products were variable products
|
||||
- Variable products were being filtered out because parent products aren't directly purchasable
|
||||
|
||||
### Changed
|
||||
|
||||
- Modified `get_available_products()` to detect and handle variable products
|
||||
- Variable products now expand into their individual variations
|
||||
- Each variation checked individually for stock status and purchasability
|
||||
- Simple products continue to work exactly as before
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified file: includes/Product_Type.php (lines 160-188)
|
||||
- Added logic to detect `is_type('variable')` products
|
||||
- Uses `get_available_variations()` to retrieve all variations
|
||||
- Each variation validated with `is_in_stock()` and `is_purchasable()`
|
||||
- Maintains backward compatibility with simple products
|
||||
|
||||
### Notes
|
||||
|
||||
- This is a feature enhancement release, not a bug fix
|
||||
- Resolves the issue where categories containing only variable products showed no selections
|
||||
- Variations display with their parent product name plus selected attributes
|
||||
- Stock management works correctly for both simple products and variations
|
||||
- All translation files remain at 100% completion (57/57 strings - no new strings added)
|
||||
|
||||
## [1.1.10] - 2025-12-31
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Admin panel - Both General and Composable tabs visible simultaneously on initial page load
|
||||
- **CRITICAL**: Frontend - No products showing in product selector, only cart button and pricing visible
|
||||
- Empty product grid now shows helpful message instead of blank space
|
||||
|
||||
### Changed
|
||||
|
||||
- Added explicit `display: none` to `#composable_product_data` panel for proper initial hiding
|
||||
- Panel now only shows when `body.product-type-composable` class is present
|
||||
- Added empty state message in product selector template when no products are configured
|
||||
- Cleared Twig cache to ensure template changes take effect
|
||||
|
||||
### Added
|
||||
|
||||
- Empty state message: "No products available for selection. Please configure the product criteria in the admin panel."
|
||||
- Translations for empty state message in all 6 supported locales (de_DE, de_DE_informal, de_CH, de_CH_informal, fr_CH, it_CH)
|
||||
- Recompiled .mo translation files
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified files: assets/css/admin.css (lines 7-16), templates/product-selector.twig (lines 12-15)
|
||||
- Root cause (admin): Panel lacked explicit CSS hiding rule, relied only on `hidden` class
|
||||
- Root cause (frontend): No feedback when products array is empty
|
||||
- Solution: CSS specificity + empty state conditional in Twig template
|
||||
|
||||
### Notes
|
||||
|
||||
- This release fixes two critical bugs discovered immediately after v1.1.9
|
||||
- Admin interface now correctly hides composable panel until product type is selected
|
||||
- Frontend provides clear user feedback when product selection is unavailable
|
||||
- All translation files now 100% complete (57/57 strings)
|
||||
|
||||
## [1.1.9] - 2025-12-31
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Admin rendering completely broken - tabs disappeared and fields appeared out of context after v1.1.8 release
|
||||
- CSS selectors were too broad, hiding tab navigation along with field groups
|
||||
- Removed `!important` flags that caused overly aggressive hiding
|
||||
|
||||
### Changed
|
||||
|
||||
- Made CSS selectors more specific: `.options_group.show_if_composable` for field groups only
|
||||
- Added separate rule for tab links: `.product_data_tabs li.composable_options`
|
||||
- Tab navigation now works correctly without hiding itself
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified files: assets/css/admin.css (lines 22-40)
|
||||
- Root cause: `.show_if_composable` class used by WooCommerce for both tab links AND field groups
|
||||
- Solution: Separate selectors for each use case to prevent unintended hiding
|
||||
|
||||
### Notes
|
||||
|
||||
- This release fixes critical regression introduced in v1.1.8
|
||||
- Admin interface now renders correctly with visible tabs and properly positioned fields
|
||||
- No `!important` flags needed with specific selectors
|
||||
|
||||
## [1.1.8] - 2025-12-31
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Admin rendering bug where both General and Composable Options tabs showed simultaneously on initial page load
|
||||
- **CRITICAL**: Frontend product selector not appearing on product pages - WooCommerce's default add-to-cart button now hidden for composable products
|
||||
- **CRITICAL**: Price formatting not localized - prices now display with proper currency symbols, decimal separators, and thousand separators for all locales
|
||||
|
||||
### Added
|
||||
|
||||
- `wc_price()` Twig function for proper price formatting in templates
|
||||
- `formatPrice()` JavaScript method with full WooCommerce locale support
|
||||
- Price format localization data passed to frontend JavaScript (decimal/thousand separators, currency position, number of decimals)
|
||||
- `hide_default_add_to_cart()` method to prevent WooCommerce's default purchase UI for composable products
|
||||
|
||||
### Changed
|
||||
|
||||
- Enhanced CSS specificity with `!important` flags for proper tab visibility control
|
||||
- Template now uses `{{ fixed_price_html|raw }}` instead of raw currency concatenation
|
||||
- Product selector passes pre-formatted price HTML from `wc_price()` function
|
||||
- Frontend JavaScript updates prices dynamically using WooCommerce format settings
|
||||
|
||||
### Technical
|
||||
|
||||
- Modified files: assets/css/admin.css (+24 lines), includes/Cart_Handler.php (+14 lines), includes/Plugin.php (+7 lines), includes/Product_Selector.php (+2 lines), templates/product-selector.twig, assets/js/frontend.js (+28 lines)
|
||||
- All PHP files pass syntax validation
|
||||
- Supports Swiss format (CHF 50.-), European format (50,00 €), US format ($50.00), and all other WooCommerce locales
|
||||
- Thousand separator support: comma (1,000), dot (1.000), apostrophe (1'000), space (1 000)
|
||||
|
||||
### Notes
|
||||
|
||||
- This release fixes all three critical UI bugs reported in CLAUDE.md
|
||||
- Admin tabs now display correctly on initial page load without JavaScript flicker
|
||||
- Frontend product selector is now the only purchase interface (no WooCommerce default button)
|
||||
- All prices maintain proper locale formatting during dynamic updates
|
||||
|
||||
## [1.1.7] - 2025-12-31
|
||||
|
||||
### Added
|
||||
|
||||
- Compiled .mo translation files for all 6 supported locales (de_DE, de_DE_informal, de_CH, de_CH_informal, fr_CH, it_CH)
|
||||
- WordPress can now load translations in admin and frontend areas
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Missing translations in WordPress admin when using non-English locales
|
||||
- Settings page ("Composable Products", "Default Selection Limit", etc.) now properly translated
|
||||
- Product settings ("Composable Options", "Selection Criteria", etc.) now properly translated
|
||||
|
||||
### Technical
|
||||
|
||||
- Compiled .mo files from .po sources using msgfmt
|
||||
- All 6 locales now have complete translation coverage (56/56 strings translated and compiled)
|
||||
- .mo files required for WordPress i18n system to display translations
|
||||
|
||||
### Notes
|
||||
|
||||
- Previous versions included .po translation files but WordPress requires compiled .mo files
|
||||
- This release makes all existing translations actually visible to users
|
||||
|
||||
## [1.1.6] - 2025-12-31
|
||||
|
||||
### Added
|
||||
|
||||
- Complete translations for all admin area strings across all 6 supported locales
|
||||
- "Fixed Price" field label and description translations
|
||||
|
||||
### Changed
|
||||
|
||||
- Updated translation template (.pot) to version 1.1.6
|
||||
- Simplified "How to calculate the price" description text
|
||||
|
||||
### Technical
|
||||
|
||||
- All .po files now include translations for v1.1.4 admin strings
|
||||
- 100% translation coverage maintained across all locales (56/56 strings)
|
||||
- German formal/informal variants properly differentiated (Sie vs. du)
|
||||
|
||||
## [1.1.5] - 2025-12-31
|
||||
|
||||
### Fixed
|
||||
|
||||
- **CRITICAL**: Fixed Twig template error "Unknown 'esc_attr' filter" when rendering product selector
|
||||
- Template compatibility issue when other plugins (e.g., WooCommerce Tier and Package Prices) use Twig
|
||||
- WordPress escaping functions now properly registered as both Twig functions AND filters
|
||||
|
||||
### Technical
|
||||
|
||||
- Added `TwigFilter` registrations for `esc_html`, `esc_attr`, and `esc_url` in `Plugin::init_twig()`
|
||||
- Template can now use both syntax styles: `{{ value|esc_attr }}` (filter) and `{{ esc_attr(value) }}` (function)
|
||||
- Prevents conflicts when multiple plugins bundle their own Twig installations
|
||||
|
||||
### Notes
|
||||
|
||||
- Previous versions only registered escaping functions as Twig functions, not filters
|
||||
- Template used filter syntax (`|esc_attr`) which failed when parsed by external Twig instances
|
||||
- Fix ensures compatibility regardless of which Twig instance processes the template
|
||||
|
||||
## [1.1.4] - 2025-12-31
|
||||
|
||||
### Added
|
||||
|
||||
- Fixed price field in Composable Options tab for easier price configuration
|
||||
- JavaScript toggle to show/hide fixed price field based on selected pricing mode
|
||||
|
||||
### Changed
|
||||
|
||||
- Simplified pricing mode description text in admin interface
|
||||
- Fixed price field now appears dynamically when "Fixed" pricing mode is selected
|
||||
|
||||
### Technical
|
||||
|
||||
- Added `_regular_price` field with `composable_fixed_price_field` CSS class in `Product_Data.php`
|
||||
- Implemented `toggleFixedPriceField()` JavaScript function in `assets/js/admin.js`
|
||||
- Progressive disclosure pattern improves admin UX by showing relevant fields only
|
||||
|
||||
## [1.1.3] - 2024-12-31
|
||||
|
||||
### Added
|
||||
|
||||
637
CLAUDE.md
637
CLAUDE.md
@@ -1,107 +1,33 @@
|
||||
# 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`
|
||||
- **Testing:** PHPUnit 10 + Brain Monkey 2.7 + Mockery 1.6
|
||||
- **Linting:** PHPCS 3.13 with WordPress-Extra + PHPCompatibilityWP
|
||||
- **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
|
||||
@@ -109,484 +35,171 @@ wc-composable-product/
|
||||
│ └── 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
|
||||
│ │ ├── ProductData.php # Product data tab & meta boxes
|
||||
│ │ └── Settings.php # WooCommerce settings integration
|
||||
│ ├── Cart_Handler.php # Add-to-cart & cart display logic (with stock validation)
|
||||
│ ├── CartHandler.php # Add-to-cart & cart display logic (with stock validation)
|
||||
│ ├── Plugin.php # Main plugin class (Singleton)
|
||||
│ ├── Product_Selector.php # Frontend product selector renderer (with stock info)
|
||||
│ ├── Product_Type.php # Custom WC_Product extension
|
||||
│ └── Stock_Manager.php # Stock management & inventory tracking (v1.1.0+)
|
||||
├── languages/
|
||||
│ └── wc-composable-product.pot # Translation template
|
||||
│ ├── ProductSelector.php # Frontend product selector renderer (with stock info)
|
||||
│ ├── ProductType.php # Custom WC_Product extension
|
||||
│ └── StockManager.php # Stock management & inventory tracking
|
||||
├── languages/ # Translation files (.pot, .po, .mo)
|
||||
├── releases/ # Release packages (gitignored)
|
||||
├── tests/
|
||||
│ ├── bootstrap.php # Test environment setup (constants, stubs)
|
||||
│ ├── TestCase.php # Base test case with Brain Monkey
|
||||
│ ├── stubs/ # Minimal WooCommerce class stubs
|
||||
│ └── Unit/ # PHPUnit unit tests
|
||||
├── templates/
|
||||
│ └── product-selector.twig # Frontend selection interface (with stock display)
|
||||
├── vendor/ # Composer dependencies (gitignored)
|
||||
├── composer.json # Dependency configuration
|
||||
├── wc-composable-product.php # Main plugin file
|
||||
└── [Documentation files] # README, INSTALL, IMPLEMENTATION, etc.
|
||||
│ └── product-selector.twig # Frontend selection interface
|
||||
├── vendor/ # Composer dependencies (gitignored, included in releases)
|
||||
├── composer.json
|
||||
├── phpcs.xml.dist # PHPCS configuration (WordPress-Extra + PHPCompatibilityWP)
|
||||
├── phpunit.xml.dist # PHPUnit configuration
|
||||
└── 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. **ProductType.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. **CartHandler.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. **ProductSelector.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/ProductData.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 (v1.1.0+)
|
||||
- Stock validation for selected products
|
||||
- Automatic stock deduction on order completion
|
||||
- Stock restoration on order cancellation/refund
|
||||
- Order notes for audit trail
|
||||
- Backorder support detection
|
||||
7. **StockManager.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:** `CartHandler::render_product_selector()` → `ProductType::get_available_products()` queries products via taxonomy/SKU → `ProductSelector::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 → `StockManager` 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. `Stock_Manager::validate_stock_availability()` checks stock levels (v1.1.0+)
|
||||
5. `Cart_Handler::add_cart_item_data()` stores selections
|
||||
6. `Cart_Handler::calculate_cart_item_price()` applies pricing
|
||||
- `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
|
||||
|
||||
**Order Processing (v1.1.0+):**
|
||||
### Security
|
||||
|
||||
1. Order status changes to completed/processing
|
||||
2. `Stock_Manager::reduce_stock_on_order_complete()` deducts inventory
|
||||
3. Selected product IDs stored in order meta: `_composable_products`
|
||||
4. Order notes added documenting stock changes
|
||||
5. On cancellation/refund: `Stock_Manager::restore_stock_on_order_cancel()` reverses deduction
|
||||
- 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
|
||||
|
||||
## Development Workflow
|
||||
### Developer API
|
||||
|
||||
### Initial Setup
|
||||
|
||||
```bash
|
||||
composer install
|
||||
```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.
|
||||
|
||||
## Testing & Linting
|
||||
|
||||
Run unit tests: `vendor/bin/phpunit --testdox`
|
||||
|
||||
Run coding standards check: `vendor/bin/phpcs`
|
||||
|
||||
Auto-fix coding standard violations: `vendor/bin/phpcbf`
|
||||
|
||||
Tests use **Brain Monkey** to mock WordPress/WooCommerce functions without a full WP installation. WooCommerce classes (`WC_Product`, `WC_Settings_Page`, etc.) are provided as minimal stubs in `tests/stubs/` so PHP can parse `extends` declarations. PHPCS uses the **WordPress-Extra** standard plus **PHPCompatibilityWP** for PHP version checks. The release workflow runs lint, phpcs, and tests before building — any failure blocks the release.
|
||||
|
||||
## Release Workflow
|
||||
|
||||
### Automated (Gitea CI/CD)
|
||||
|
||||
Push an annotated tag (`v*`) to trigger the workflow. It first runs the PHPUnit test suite, then installs PHP 8.3, production Composer deps, compiles translations, verifies version matches tag, creates ZIP with checksums, and publishes a Gitea release. Tests must pass before the release package is built.
|
||||
|
||||
### 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
|
||||
- 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
|
||||
- Selection presets/templates
|
||||
- Compile .mo translation files
|
||||
|
||||
---
|
||||
|
||||
### v1.0.1 - Bug Fix (2024-12-31)
|
||||
|
||||
**Critical bug fix:** Fatal error "Class WC_Settings_Page not found" during plugin activation
|
||||
|
||||
**Root cause:** Plugin initialized on `plugins_loaded` hook before WooCommerce classes were available
|
||||
|
||||
**Solution:** Changed initialization hook to `woocommerce_loaded` in wc-composable-product.php:65
|
||||
|
||||
**Impact:** Settings page now correctly integrates as tab in WooCommerce > Settings
|
||||
|
||||
**Files modified:**
|
||||
|
||||
- wc-composable-product.php (version bump to 1.0.1, hook change)
|
||||
- CHANGELOG.md (documented fix)
|
||||
|
||||
**Commit:** a581ef4
|
||||
|
||||
---
|
||||
|
||||
### v1.1.0 - Stock Management Integration (2024-12-31)
|
||||
|
||||
#### Session 4: Stock Management Implementation
|
||||
|
||||
**Major feature release** adding comprehensive inventory tracking for composable products.
|
||||
|
||||
**What was built:**
|
||||
|
||||
1. **New Stock_Manager class** (includes/Stock_Manager.php - 7.7 KB, 263 lines)
|
||||
- `validate_stock_availability()` - Real-time stock checking
|
||||
- `get_product_stock_info()` - Stock data for frontend display
|
||||
- `reduce_stock_on_order_complete()` - Automatic deduction on order completion
|
||||
- `restore_stock_on_order_cancel()` - Automatic restoration on cancellation/refund
|
||||
- `prevent_composable_stock_reduction()` - Prevents WooCommerce double-deduction
|
||||
- `store_selected_products_in_order()` - Saves selection to order meta
|
||||
|
||||
2. **Enhanced existing classes:**
|
||||
- Cart_Handler.php: Added stock validation during add-to-cart (lines 90-95)
|
||||
- Product_Selector.php: Passes stock data to template (lines 36-56)
|
||||
- Plugin.php: Includes Stock_Manager in autoload (line 96)
|
||||
|
||||
3. **Frontend enhancements:**
|
||||
- templates/product-selector.twig: Stock status display (lines 39-47)
|
||||
- assets/css/frontend.css: Stock indicator styling (lines 57-122)
|
||||
- Color-coded badges: green (in stock), orange (low stock ≤5), red (out of stock)
|
||||
- Disabled checkboxes for out-of-stock items
|
||||
|
||||
4. **Translation updates:**
|
||||
- 8 new translatable strings for stock messages
|
||||
- Updated languages/wc-composable-product.pot
|
||||
- Updated languages/wc-composable-product-it_CH.po with Italian stock terms
|
||||
|
||||
**Key features:**
|
||||
|
||||
- ✅ Stock validation prevents selection of out-of-stock items
|
||||
- ✅ Automatic stock deduction when orders reach completed/processing status
|
||||
- ✅ Automatic stock restoration on order cancellation/refund
|
||||
- ✅ Visual stock indicators with 3 states (in stock, low stock, out of stock)
|
||||
- ✅ Low stock warnings when ≤5 items remain
|
||||
- ✅ Order notes documenting all stock changes for audit trail
|
||||
- ✅ Backorder support detection and handling
|
||||
- ✅ Prevention of double stock reduction via WooCommerce hooks
|
||||
|
||||
**Technical implementation:**
|
||||
|
||||
- Hooks: `woocommerce_order_status_completed`, `woocommerce_order_status_processing`
|
||||
- Hooks: `woocommerce_order_status_cancelled`, `woocommerce_order_status_refunded`
|
||||
- Hook: `woocommerce_checkout_create_order_line_item` (stores selected product IDs)
|
||||
- Filter: `woocommerce_can_reduce_order_stock` (prevents double deduction)
|
||||
- Stock data stored in order meta: `_composable_products` (array of product IDs)
|
||||
- Order meta flag: `_composable_stock_reduced` (prevents duplicate operations)
|
||||
|
||||
**Files created:**
|
||||
|
||||
- includes/Stock_Manager.php (new, 263 lines)
|
||||
|
||||
**Files modified:**
|
||||
|
||||
- includes/Cart_Handler.php (+13 lines: stock manager integration)
|
||||
- includes/Product_Selector.php (+17 lines: stock info retrieval)
|
||||
- includes/Plugin.php (+1 line: Stock_Manager require)
|
||||
- templates/product-selector.twig (+8 lines: stock status display)
|
||||
- assets/css/frontend.css (+40 lines: stock indicator styles)
|
||||
- languages/wc-composable-product.pot (+32 lines: 8 new strings)
|
||||
- languages/wc-composable-product-it_CH.po (+32 lines: Italian translations)
|
||||
- wc-composable-product.php (version bump to 1.1.0)
|
||||
- CHANGELOG.md (v1.1.0 release notes)
|
||||
|
||||
**Release details:**
|
||||
|
||||
- Package size: 375 KB (+4 KB from v1.0.0)
|
||||
- Git tag: v1.1.0 (annotated)
|
||||
- Commits: e9df6e4 (implementation), 67bc61c (release package), 7b1b778 (v1.0.0 package), 91f44b0 (.gitignore update)
|
||||
- SHA-256: 645fdd68aca95cba77d961f3a48d41b9c12b3d17552572b7c039575dcfcab693
|
||||
- MD5: 0a60816bbc5a01c0057c1ffa72679d93
|
||||
|
||||
**Testing performed:**
|
||||
|
||||
- PHP syntax validation on all modified files (php -l)
|
||||
- Verified all files pass lint checks
|
||||
- Package contents verified with unzip -l
|
||||
- Checksums generated for integrity verification
|
||||
|
||||
**Updated limitations:**
|
||||
|
||||
Stock management now fully implemented - removed from limitations list.
|
||||
|
||||
Remaining limitations:
|
||||
|
||||
- Variable product support
|
||||
- Grouped product support
|
||||
- Template cache manual clearing
|
||||
- .mo compilation
|
||||
|
||||
**What works (v1.1.0):**
|
||||
|
||||
Everything from v1.0.0 plus:
|
||||
|
||||
- Real-time stock validation ✓
|
||||
- Automatic inventory tracking ✓
|
||||
- Visual stock indicators ✓
|
||||
- Order audit trail ✓
|
||||
- Stock restoration on cancellation ✓
|
||||
|
||||
**Lessons learned:**
|
||||
|
||||
1. **Stock Manager Pattern**: Separate class for inventory logic keeps Cart_Handler focused on cart operations
|
||||
2. **Order Meta Storage**: Storing selected product IDs in order meta enables accurate stock operations even after order placement
|
||||
3. **Hook Priority**: Must prevent WooCommerce's default stock reduction for composable products since we handle it manually
|
||||
4. **Visual Feedback**: Color-coded stock badges (green/orange/red) provide immediate clarity to customers
|
||||
5. **Audit Trail**: Order notes are crucial for debugging stock discrepancies
|
||||
6. **Defensive Programming**: Check for `_composable_stock_reduced` flag to prevent duplicate operations on order status changes
|
||||
|
||||
---
|
||||
|
||||
### v1.1.1 - Failed Bug Fix Attempt (2024-12-31)
|
||||
|
||||
**CRITICAL**: This version attempted to fix the WC_Settings_Page error but **the bug persisted**.
|
||||
|
||||
**Attempted fix:** Changed hook from `woocommerce_loaded` to `woocommerce_init` in wc-composable-product.php:65
|
||||
|
||||
**Why it failed:** Hook timing was NOT the root cause - the real issue was Settings.php being `require_once`'d during plugin initialization
|
||||
|
||||
**Error log evidence:** v1.1.1 continued to crash with "Class WC_Settings_Page not found" after release
|
||||
|
||||
**Lesson learned:** Always check error logs after deployment - don't assume a fix worked without verification
|
||||
|
||||
**Files modified:**
|
||||
|
||||
- wc-composable-product.php (version bump to 1.1.1, hook change)
|
||||
- CHANGELOG.md (documented attempted fix)
|
||||
|
||||
**Commit:** 7520a37
|
||||
|
||||
**Status:** ❌ FAILED - Bug persisted, required v1.1.2
|
||||
|
||||
---
|
||||
|
||||
### v1.1.2 - CRITICAL Bug Fix (2024-12-31)
|
||||
|
||||
#### Session 5: Fixing Persistent Settings.php Class Loading Issue
|
||||
|
||||
**CRITICAL bug fix** that finally resolved the "Class WC_Settings_Page not found" error that persisted through 4 versions (v1.0.0, v1.0.1, v1.1.0, v1.1.1).
|
||||
|
||||
**The Journey to the Fix:**
|
||||
|
||||
1. v1.0.0: Used `plugins_loaded` hook → Fatal error
|
||||
2. v1.0.1: Changed to `woocommerce_loaded` → Still failed
|
||||
3. v1.1.0: Kept `woocommerce_loaded` → Bug continued
|
||||
4. v1.1.1: Changed to `woocommerce_init` → **STILL FAILING!**
|
||||
5. v1.1.2: Fixed class loading order → ✅ **WORKING**
|
||||
|
||||
**Root cause analysis:**
|
||||
|
||||
The error wasn't about hook timing - it was about **when Settings.php was being parsed**:
|
||||
|
||||
- `Plugin::includes()` was doing `require_once Settings.php` at line 93
|
||||
- This happened during plugin initialization (on `woocommerce_init`)
|
||||
- When PHP parsed Settings.php, it tried to extend `WC_Settings_Page`
|
||||
- But that parent class didn't exist yet!
|
||||
- Even `woocommerce_init` fires **before** WooCommerce loads settings page classes
|
||||
- Result: Instant fatal error
|
||||
|
||||
**The fix:**
|
||||
|
||||
Delayed Settings.php inclusion until it's actually needed:
|
||||
|
||||
```php
|
||||
// Plugin::includes() - REMOVED this line:
|
||||
// require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Settings.php';
|
||||
|
||||
// Plugin::add_settings_page() - ADDED this:
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Settings.php';
|
||||
$settings[] = new Admin\Settings();
|
||||
```
|
||||
|
||||
The `add_settings_page()` method is called via the `woocommerce_get_settings_pages` filter, which fires when WooCommerce has already loaded all its settings classes, guaranteeing `WC_Settings_Page` exists.
|
||||
|
||||
**Files modified:**
|
||||
|
||||
- includes/Plugin.php:
|
||||
- Line 93: Removed `require_once Settings.php`, added explanatory comment
|
||||
- Line 196: Added `require_once Settings.php` in `add_settings_page()` method
|
||||
- wc-composable-product.php (version bump to 1.1.2)
|
||||
- CHANGELOG.md (documented the fix and v1.1.1's failure)
|
||||
|
||||
**Release details:**
|
||||
|
||||
- Package size: 375 KB (383,194 bytes)
|
||||
- Git tag: v1.1.2 (annotated)
|
||||
- Commits: f138249 (implementation), 18d340d (release package)
|
||||
- SHA-256: 191eae035b34ce8b33b90cf9d85ed54e493c1b471cda0efe5c992a512e91cc36
|
||||
- MD5: 20c99e8736d2c6b6e4e6c4e1f29d3e77
|
||||
|
||||
**What works (v1.1.2):**
|
||||
|
||||
Everything from v1.1.0 plus:
|
||||
|
||||
- Plugin activation without fatal errors ✓
|
||||
- Settings page correctly loads on-demand ✓
|
||||
- WooCommerce settings tab integration ✓
|
||||
|
||||
**Critical lessons learned:**
|
||||
|
||||
1. **Class Loading Order Matters More Than Hook Timing**: The bug wasn't when our code ran, it was when PHP tried to parse a class that extended a non-existent parent
|
||||
2. **Always Verify Fixes**: v1.1.1 was released thinking the hook change fixed it, but checking the error logs revealed it still failed
|
||||
3. **Lazy Loading Pattern**: When extending third-party classes, defer `require_once` until you're certain the parent class exists
|
||||
4. **Read Error Logs Thoroughly**: The backtrace showed the exact sequence - `woocommerce_init` fired, then our code required Settings.php, then PHP crashed trying to parse the `extends` statement
|
||||
5. **Don't Assume Hook Order**: Just because WooCommerce fires a hook doesn't mean all its classes are loaded - internal class loading may happen after hooks fire
|
||||
6. **Test After Each Release**: If this had been tested immediately after v1.1.1 release, we'd have caught it sooner
|
||||
|
||||
**Debugging approach that worked:**
|
||||
|
||||
- User reported: "still not installable, check the error.log again"
|
||||
- Checked error log and found v1.1.1 still failing at 15:56:50
|
||||
- Analyzed backtrace to see Settings.php was being required too early
|
||||
- Realized `require_once` happens at call time, not when callback runs
|
||||
- Moved `require_once` to the actual callback when WC guarantees class exists
|
||||
- Verified fix with PHP syntax check before release
|
||||
|
||||
---
|
||||
|
||||
**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
|
||||
|
||||
@@ -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)
|
||||
150
INSTALL.md
150
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
|
||||
144
README.md
144
README.md
@@ -1,51 +1,113 @@
|
||||
# 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
|
||||
- **Tested**: 57 unit tests with PHPUnit, Brain Monkey, and Mockery
|
||||
- **CI/CD**: Automated release workflow with test gate 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
|
||||
|
||||
@@ -57,13 +119,41 @@ This project was created with AI assistance (Claude.AI) and follows WordPress an
|
||||
composer install
|
||||
```
|
||||
|
||||
### Running Tests
|
||||
|
||||
The plugin includes a PHPUnit test suite with Brain Monkey for WordPress function mocking:
|
||||
|
||||
```bash
|
||||
vendor/bin/phpunit --testdox
|
||||
```
|
||||
|
||||
Tests run without a WordPress installation. WooCommerce classes are provided as minimal stubs in `tests/stubs/`.
|
||||
|
||||
### 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 +164,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.
|
||||
|
||||
25
assets/css/admin.css
Normal file → Executable file
25
assets/css/admin.css
Normal file → Executable file
@@ -1,13 +1,20 @@
|
||||
/**
|
||||
* Admin Styles for Composable Products
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
/* 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;
|
||||
}
|
||||
|
||||
|
||||
2
assets/css/frontend.css
Normal file → Executable file
2
assets/css/frontend.css
Normal file → Executable file
@@ -1,7 +1,7 @@
|
||||
/**
|
||||
* Frontend Styles for Composable Products
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
.wc-composable-product-selector {
|
||||
|
||||
27
assets/js/admin.js
Normal file → Executable file
27
assets/js/admin.js
Normal file → Executable file
@@ -1,7 +1,7 @@
|
||||
/**
|
||||
* Admin JavaScript for Composable Products
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
(function($) {
|
||||
@@ -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
|
||||
*/
|
||||
|
||||
36
assets/js/frontend.js
Normal file → Executable file
36
assets/js/frontend.js
Normal file → Executable file
@@ -1,7 +1,7 @@
|
||||
/**
|
||||
* Frontend JavaScript for Composable Products
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
(function($) {
|
||||
@@ -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);
|
||||
},
|
||||
|
||||
/**
|
||||
|
||||
@@ -6,7 +6,7 @@
|
||||
"authors": [
|
||||
{
|
||||
"name": "Marco Graetsch",
|
||||
"email": "marco@example.com"
|
||||
"email": "magdev3.0@gmail.com"
|
||||
}
|
||||
],
|
||||
"require": {
|
||||
@@ -15,11 +15,31 @@
|
||||
},
|
||||
"autoload": {
|
||||
"psr-4": {
|
||||
"WC_Composable_Product\\": "includes/"
|
||||
"Magdev\\WcComposableProduct\\": "includes/"
|
||||
}
|
||||
},
|
||||
"require-dev": {
|
||||
"brain/monkey": "^2.7",
|
||||
"dealerdirect/phpcodesniffer-composer-installer": "^1.0",
|
||||
"mockery/mockery": "^1.6",
|
||||
"phpcompatibility/phpcompatibility-wp": "*",
|
||||
"phpunit/phpunit": "^10.0",
|
||||
"squizlabs/php_codesniffer": "^3.7",
|
||||
"wp-coding-standards/wpcs": "^3.0"
|
||||
},
|
||||
"autoload-dev": {
|
||||
"psr-4": {
|
||||
"Magdev\\WcComposableProduct\\Tests\\": "tests/"
|
||||
}
|
||||
},
|
||||
"config": {
|
||||
"optimize-autoloader": true,
|
||||
"sort-packages": true
|
||||
"sort-packages": true,
|
||||
"allow-plugins": {
|
||||
"dealerdirect/phpcodesniffer-composer-installer": true
|
||||
},
|
||||
"platform": {
|
||||
"php": "8.3.0"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
2889
composer.lock
generated
Normal file
2889
composer.lock
generated
Normal file
File diff suppressed because it is too large
Load Diff
245
includes/Admin/ProductData.php
Normal file
245
includes/Admin/ProductData.php
Normal file
@@ -0,0 +1,245 @@
|
||||
<?php
|
||||
/**
|
||||
* Product Data Tab
|
||||
*
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Admin;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Product Data Tab Class
|
||||
*/
|
||||
class ProductData {
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
add_filter( 'woocommerce_product_data_tabs', array( $this, 'add_product_data_tab' ) );
|
||||
add_action( 'woocommerce_product_data_panels', array( $this, 'add_product_data_panel' ) );
|
||||
add_action( 'woocommerce_process_product_meta_composable', array( $this, 'save_product_data' ) );
|
||||
add_action( 'woocommerce_product_options_general_product_data', array( $this, 'add_general_fields' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Add composable products tab
|
||||
*
|
||||
* @param array $tabs Product data tabs
|
||||
* @return array
|
||||
*/
|
||||
public function add_product_data_tab( $tabs ) {
|
||||
$tabs['composable'] = array(
|
||||
'label' => __( 'Composable Options', 'wc-composable-product' ),
|
||||
'target' => 'composable_product_data',
|
||||
'class' => array( 'show_if_composable' ),
|
||||
'priority' => 21,
|
||||
);
|
||||
return $tabs;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add fields to general tab
|
||||
*/
|
||||
public function add_general_fields() {
|
||||
global $product_object;
|
||||
|
||||
if ( $product_object && $product_object->get_type() === 'composable' ) {
|
||||
echo '<div class="options_group show_if_composable">';
|
||||
|
||||
woocommerce_wp_text_input(
|
||||
array(
|
||||
'id' => '_composable_selection_limit',
|
||||
'label' => __( 'Selection Limit', 'wc-composable-product' ),
|
||||
'description' => __( 'Maximum number of items customers can select. Leave empty to use global default.', 'wc-composable-product' ),
|
||||
'desc_tip' => true,
|
||||
'type' => 'number',
|
||||
'custom_attributes' => array(
|
||||
'min' => '1',
|
||||
'step' => '1',
|
||||
),
|
||||
)
|
||||
);
|
||||
|
||||
woocommerce_wp_select(
|
||||
array(
|
||||
'id' => '_composable_pricing_mode',
|
||||
'label' => __( 'Pricing Mode', 'wc-composable-product' ),
|
||||
'description' => __( 'How to calculate the price.', 'wc-composable-product' ),
|
||||
'desc_tip' => true,
|
||||
'options' => array(
|
||||
'' => __( 'Use global default', 'wc-composable-product' ),
|
||||
'sum' => __( 'Sum of selected products', 'wc-composable-product' ),
|
||||
'fixed' => __( 'Fixed price', 'wc-composable-product' ),
|
||||
),
|
||||
)
|
||||
);
|
||||
|
||||
woocommerce_wp_text_input(
|
||||
array(
|
||||
'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>';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Add product data panel
|
||||
*/
|
||||
public function add_product_data_panel() {
|
||||
global $post;
|
||||
?>
|
||||
<div id="composable_product_data" class="panel woocommerce_options_panel hidden">
|
||||
<div class="options_group">
|
||||
<?php
|
||||
woocommerce_wp_select(
|
||||
array(
|
||||
'id' => '_composable_include_unpublished',
|
||||
'label' => __( 'Include Non-Public Products', 'wc-composable-product' ),
|
||||
'description' => __( 'Allow draft and private products in the selection. Useful when products should only be sold as part of a composition.', 'wc-composable-product' ),
|
||||
'desc_tip' => true,
|
||||
'options' => array(
|
||||
'' => __( 'Use global default', 'wc-composable-product' ),
|
||||
'yes' => __( 'Yes', 'wc-composable-product' ),
|
||||
'no' => __( 'No', 'wc-composable-product' ),
|
||||
),
|
||||
'value' => get_post_meta( $post->ID, '_composable_include_unpublished', true ) ? get_post_meta( $post->ID, '_composable_include_unpublished', true ) : '',
|
||||
)
|
||||
);
|
||||
|
||||
woocommerce_wp_select(
|
||||
array(
|
||||
'id' => '_composable_criteria_type',
|
||||
'label' => __( 'Selection Criteria', 'wc-composable-product' ),
|
||||
'description' => __( 'How to select available products.', 'wc-composable-product' ),
|
||||
'desc_tip' => true,
|
||||
'options' => array(
|
||||
'category' => __( 'By Category', 'wc-composable-product' ),
|
||||
'tag' => __( 'By Tag', 'wc-composable-product' ),
|
||||
'sku' => __( 'By SKU', 'wc-composable-product' ),
|
||||
),
|
||||
'value' => get_post_meta( $post->ID, '_composable_criteria_type', true ) ? get_post_meta( $post->ID, '_composable_criteria_type', true ) : 'category',
|
||||
)
|
||||
);
|
||||
?>
|
||||
</div>
|
||||
|
||||
<div class="options_group composable_criteria_group" id="composable_criteria_category">
|
||||
<p class="form-field">
|
||||
<label for="_composable_categories"><?php esc_html_e( 'Select Categories', 'wc-composable-product' ); ?></label>
|
||||
<select id="_composable_categories" name="_composable_categories[]" class="wc-enhanced-select" multiple="multiple" style="width: 50%;">
|
||||
<?php
|
||||
$selected_categories = get_post_meta( $post->ID, '_composable_categories', true );
|
||||
$selected_categories = $selected_categories ? $selected_categories : array();
|
||||
$categories = get_terms(
|
||||
array(
|
||||
'taxonomy' => 'product_cat',
|
||||
'hide_empty' => false,
|
||||
)
|
||||
);
|
||||
foreach ( $categories as $category ) {
|
||||
printf(
|
||||
'<option value="%s" %s>%s</option>',
|
||||
esc_attr( $category->term_id ),
|
||||
selected( in_array( $category->term_id, (array) $selected_categories, true ), true, false ),
|
||||
esc_html( $category->name )
|
||||
);
|
||||
}
|
||||
?>
|
||||
</select>
|
||||
<span class="description"><?php esc_html_e( 'Select product categories to include.', 'wc-composable-product' ); ?></span>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="options_group composable_criteria_group" id="composable_criteria_tag" style="display: none;">
|
||||
<p class="form-field">
|
||||
<label for="_composable_tags"><?php esc_html_e( 'Select Tags', 'wc-composable-product' ); ?></label>
|
||||
<select id="_composable_tags" name="_composable_tags[]" class="wc-enhanced-select" multiple="multiple" style="width: 50%;">
|
||||
<?php
|
||||
$selected_tags = get_post_meta( $post->ID, '_composable_tags', true );
|
||||
$selected_tags = $selected_tags ? $selected_tags : array();
|
||||
$tags = get_terms(
|
||||
array(
|
||||
'taxonomy' => 'product_tag',
|
||||
'hide_empty' => false,
|
||||
)
|
||||
);
|
||||
foreach ( $tags as $tag ) {
|
||||
printf(
|
||||
'<option value="%s" %s>%s</option>',
|
||||
esc_attr( $tag->term_id ),
|
||||
selected( in_array( $tag->term_id, (array) $selected_tags, true ), true, false ),
|
||||
esc_html( $tag->name )
|
||||
);
|
||||
}
|
||||
?>
|
||||
</select>
|
||||
<span class="description"><?php esc_html_e( 'Select product tags to include.', 'wc-composable-product' ); ?></span>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="options_group composable_criteria_group" id="composable_criteria_sku" style="display: none;">
|
||||
<?php
|
||||
woocommerce_wp_textarea_input(
|
||||
array(
|
||||
'id' => '_composable_skus',
|
||||
'label' => __( 'Product SKUs', 'wc-composable-product' ),
|
||||
'description' => __( 'Enter product SKUs separated by commas.', 'wc-composable-product' ),
|
||||
'desc_tip' => true,
|
||||
'placeholder' => __( 'SKU-1, SKU-2, SKU-3', 'wc-composable-product' ),
|
||||
)
|
||||
);
|
||||
?>
|
||||
</div>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Save product data
|
||||
*
|
||||
* @param int $post_id Post ID
|
||||
*/
|
||||
public function save_product_data( $post_id ) {
|
||||
// phpcs:disable WordPress.Security.NonceVerification.Missing -- nonce verified by WooCommerce in woocommerce_process_product_meta.
|
||||
|
||||
// Save selection limit.
|
||||
$selection_limit = isset( $_POST['_composable_selection_limit'] ) ? absint( $_POST['_composable_selection_limit'] ) : '';
|
||||
update_post_meta( $post_id, '_composable_selection_limit', $selection_limit );
|
||||
|
||||
// Save pricing mode.
|
||||
$pricing_mode = isset( $_POST['_composable_pricing_mode'] ) ? sanitize_text_field( $_POST['_composable_pricing_mode'] ) : '';
|
||||
update_post_meta( $post_id, '_composable_pricing_mode', $pricing_mode );
|
||||
|
||||
// Save include unpublished.
|
||||
$include_unpublished = isset( $_POST['_composable_include_unpublished'] ) ? sanitize_text_field( $_POST['_composable_include_unpublished'] ) : '';
|
||||
update_post_meta( $post_id, '_composable_include_unpublished', $include_unpublished );
|
||||
|
||||
// Save criteria type.
|
||||
$criteria_type = isset( $_POST['_composable_criteria_type'] ) ? sanitize_text_field( $_POST['_composable_criteria_type'] ) : 'category';
|
||||
update_post_meta( $post_id, '_composable_criteria_type', $criteria_type );
|
||||
|
||||
// Save categories.
|
||||
$categories = isset( $_POST['_composable_categories'] ) ? array_map( 'absint', $_POST['_composable_categories'] ) : array();
|
||||
update_post_meta( $post_id, '_composable_categories', $categories );
|
||||
|
||||
// Save tags.
|
||||
$tags = isset( $_POST['_composable_tags'] ) ? array_map( 'absint', $_POST['_composable_tags'] ) : array();
|
||||
update_post_meta( $post_id, '_composable_tags', $tags );
|
||||
|
||||
// Save SKUs.
|
||||
$skus = isset( $_POST['_composable_skus'] ) ? sanitize_textarea_field( $_POST['_composable_skus'] ) : '';
|
||||
update_post_meta( $post_id, '_composable_skus', $skus );
|
||||
|
||||
// phpcs:enable WordPress.Security.NonceVerification.Missing
|
||||
}
|
||||
}
|
||||
@@ -1,190 +0,0 @@
|
||||
<?php
|
||||
/**
|
||||
* Product Data Tab
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product\Admin;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
/**
|
||||
* Product Data Tab Class
|
||||
*/
|
||||
class Product_Data {
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
add_filter('woocommerce_product_data_tabs', [$this, 'add_product_data_tab']);
|
||||
add_action('woocommerce_product_data_panels', [$this, 'add_product_data_panel']);
|
||||
add_action('woocommerce_process_product_meta_composable', [$this, 'save_product_data']);
|
||||
add_action('woocommerce_product_options_general_product_data', [$this, 'add_general_fields']);
|
||||
}
|
||||
|
||||
/**
|
||||
* Add composable products tab
|
||||
*
|
||||
* @param array $tabs Product data tabs
|
||||
* @return array
|
||||
*/
|
||||
public function add_product_data_tab($tabs) {
|
||||
$tabs['composable'] = [
|
||||
'label' => __('Composable Options', 'wc-composable-product'),
|
||||
'target' => 'composable_product_data',
|
||||
'class' => ['show_if_composable'],
|
||||
'priority' => 21,
|
||||
];
|
||||
return $tabs;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add fields to general tab
|
||||
*/
|
||||
public function add_general_fields() {
|
||||
global $product_object;
|
||||
|
||||
if ($product_object && $product_object->get_type() === 'composable') {
|
||||
echo '<div class="options_group show_if_composable">';
|
||||
|
||||
woocommerce_wp_text_input([
|
||||
'id' => '_composable_selection_limit',
|
||||
'label' => __('Selection Limit', 'wc-composable-product'),
|
||||
'description' => __('Maximum number of items customers can select. Leave empty to use global default.', 'wc-composable-product'),
|
||||
'desc_tip' => true,
|
||||
'type' => 'number',
|
||||
'custom_attributes' => [
|
||||
'min' => '1',
|
||||
'step' => '1',
|
||||
],
|
||||
]);
|
||||
|
||||
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'),
|
||||
'desc_tip' => true,
|
||||
'options' => [
|
||||
'' => __('Use global default', 'wc-composable-product'),
|
||||
'sum' => __('Sum of selected products', 'wc-composable-product'),
|
||||
'fixed' => __('Fixed price', 'wc-composable-product'),
|
||||
],
|
||||
]);
|
||||
|
||||
echo '</div>';
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Add product data panel
|
||||
*/
|
||||
public function add_product_data_panel() {
|
||||
global $post;
|
||||
?>
|
||||
<div id="composable_product_data" class="panel woocommerce_options_panel hidden">
|
||||
<div class="options_group">
|
||||
<?php
|
||||
woocommerce_wp_select([
|
||||
'id' => '_composable_criteria_type',
|
||||
'label' => __('Selection Criteria', 'wc-composable-product'),
|
||||
'description' => __('How to select available products.', 'wc-composable-product'),
|
||||
'desc_tip' => true,
|
||||
'options' => [
|
||||
'category' => __('By Category', 'wc-composable-product'),
|
||||
'tag' => __('By Tag', 'wc-composable-product'),
|
||||
'sku' => __('By SKU', 'wc-composable-product'),
|
||||
],
|
||||
'value' => get_post_meta($post->ID, '_composable_criteria_type', true) ?: 'category',
|
||||
]);
|
||||
?>
|
||||
</div>
|
||||
|
||||
<div class="options_group composable_criteria_group" id="composable_criteria_category">
|
||||
<p class="form-field">
|
||||
<label for="_composable_categories"><?php esc_html_e('Select Categories', 'wc-composable-product'); ?></label>
|
||||
<select id="_composable_categories" name="_composable_categories[]" class="wc-enhanced-select" multiple="multiple" style="width: 50%;">
|
||||
<?php
|
||||
$selected_categories = get_post_meta($post->ID, '_composable_categories', true) ?: [];
|
||||
$categories = get_terms(['taxonomy' => 'product_cat', 'hide_empty' => false]);
|
||||
foreach ($categories as $category) {
|
||||
printf(
|
||||
'<option value="%s" %s>%s</option>',
|
||||
esc_attr($category->term_id),
|
||||
selected(in_array($category->term_id, (array) $selected_categories), true, false),
|
||||
esc_html($category->name)
|
||||
);
|
||||
}
|
||||
?>
|
||||
</select>
|
||||
<span class="description"><?php esc_html_e('Select product categories to include.', 'wc-composable-product'); ?></span>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="options_group composable_criteria_group" id="composable_criteria_tag" style="display: none;">
|
||||
<p class="form-field">
|
||||
<label for="_composable_tags"><?php esc_html_e('Select Tags', 'wc-composable-product'); ?></label>
|
||||
<select id="_composable_tags" name="_composable_tags[]" class="wc-enhanced-select" multiple="multiple" style="width: 50%;">
|
||||
<?php
|
||||
$selected_tags = get_post_meta($post->ID, '_composable_tags', true) ?: [];
|
||||
$tags = get_terms(['taxonomy' => 'product_tag', 'hide_empty' => false]);
|
||||
foreach ($tags as $tag) {
|
||||
printf(
|
||||
'<option value="%s" %s>%s</option>',
|
||||
esc_attr($tag->term_id),
|
||||
selected(in_array($tag->term_id, (array) $selected_tags), true, false),
|
||||
esc_html($tag->name)
|
||||
);
|
||||
}
|
||||
?>
|
||||
</select>
|
||||
<span class="description"><?php esc_html_e('Select product tags to include.', 'wc-composable-product'); ?></span>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div class="options_group composable_criteria_group" id="composable_criteria_sku" style="display: none;">
|
||||
<?php
|
||||
woocommerce_wp_textarea_input([
|
||||
'id' => '_composable_skus',
|
||||
'label' => __('Product SKUs', 'wc-composable-product'),
|
||||
'description' => __('Enter product SKUs separated by commas.', 'wc-composable-product'),
|
||||
'desc_tip' => true,
|
||||
'placeholder' => __('SKU-1, SKU-2, SKU-3', 'wc-composable-product'),
|
||||
]);
|
||||
?>
|
||||
</div>
|
||||
</div>
|
||||
<?php
|
||||
}
|
||||
|
||||
/**
|
||||
* Save product data
|
||||
*
|
||||
* @param int $post_id Post ID
|
||||
*/
|
||||
public function save_product_data($post_id) {
|
||||
// Save selection limit
|
||||
$selection_limit = isset($_POST['_composable_selection_limit']) ? absint($_POST['_composable_selection_limit']) : '';
|
||||
update_post_meta($post_id, '_composable_selection_limit', $selection_limit);
|
||||
|
||||
// Save pricing mode
|
||||
$pricing_mode = isset($_POST['_composable_pricing_mode']) ? sanitize_text_field($_POST['_composable_pricing_mode']) : '';
|
||||
update_post_meta($post_id, '_composable_pricing_mode', $pricing_mode);
|
||||
|
||||
// Save criteria type
|
||||
$criteria_type = isset($_POST['_composable_criteria_type']) ? sanitize_text_field($_POST['_composable_criteria_type']) : 'category';
|
||||
update_post_meta($post_id, '_composable_criteria_type', $criteria_type);
|
||||
|
||||
// Save categories
|
||||
$categories = isset($_POST['_composable_categories']) ? array_map('absint', $_POST['_composable_categories']) : [];
|
||||
update_post_meta($post_id, '_composable_categories', $categories);
|
||||
|
||||
// Save tags
|
||||
$tags = isset($_POST['_composable_tags']) ? array_map('absint', $_POST['_composable_tags']) : [];
|
||||
update_post_meta($post_id, '_composable_tags', $tags);
|
||||
|
||||
// Save SKUs
|
||||
$skus = isset($_POST['_composable_skus']) ? sanitize_textarea_field($_POST['_composable_skus']) : '';
|
||||
update_post_meta($post_id, '_composable_skus', $skus);
|
||||
}
|
||||
}
|
||||
@@ -2,12 +2,12 @@
|
||||
/**
|
||||
* Admin Settings
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product\Admin;
|
||||
namespace Magdev\WcComposableProduct\Admin;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Settings class
|
||||
@@ -18,7 +18,7 @@ class Settings extends \WC_Settings_Page {
|
||||
*/
|
||||
public function __construct() {
|
||||
$this->id = 'composable_products';
|
||||
$this->label = __('Composable Products', 'wc-composable-product');
|
||||
$this->label = __( 'Composable Products', 'wc-composable-product' );
|
||||
|
||||
parent::__construct();
|
||||
}
|
||||
@@ -29,65 +29,72 @@ class Settings extends \WC_Settings_Page {
|
||||
* @return array
|
||||
*/
|
||||
public function get_settings() {
|
||||
$settings = [
|
||||
[
|
||||
'title' => __('Composable Products Settings', 'wc-composable-product'),
|
||||
$settings = array(
|
||||
array(
|
||||
'title' => __( 'Composable Products Settings', 'wc-composable-product' ),
|
||||
'type' => 'title',
|
||||
'desc' => __('Configure default settings for composable products.', 'wc-composable-product'),
|
||||
'desc' => __( 'Configure default settings for composable products.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_settings',
|
||||
],
|
||||
[
|
||||
'title' => __('Default Selection Limit', 'wc-composable-product'),
|
||||
'desc' => __('Default number of items customers can select.', 'wc-composable-product'),
|
||||
),
|
||||
array(
|
||||
'title' => __( 'Default Selection Limit', 'wc-composable-product' ),
|
||||
'desc' => __( 'Default number of items customers can select.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_default_limit',
|
||||
'type' => 'number',
|
||||
'default' => '5',
|
||||
'custom_attributes' => [
|
||||
'custom_attributes' => array(
|
||||
'min' => '1',
|
||||
'step' => '1',
|
||||
],
|
||||
),
|
||||
'desc_tip' => true,
|
||||
],
|
||||
[
|
||||
'title' => __('Default Pricing Mode', 'wc-composable-product'),
|
||||
'desc' => __('How to calculate the price of composable products.', 'wc-composable-product'),
|
||||
),
|
||||
array(
|
||||
'title' => __( 'Default Pricing Mode', 'wc-composable-product' ),
|
||||
'desc' => __( 'How to calculate the price of composable products.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_default_pricing',
|
||||
'type' => 'select',
|
||||
'default' => 'sum',
|
||||
'options' => [
|
||||
'sum' => __('Sum of selected products', 'wc-composable-product'),
|
||||
'fixed' => __('Fixed price', 'wc-composable-product'),
|
||||
],
|
||||
'options' => array(
|
||||
'sum' => __( 'Sum of selected products', 'wc-composable-product' ),
|
||||
'fixed' => __( 'Fixed price', 'wc-composable-product' ),
|
||||
),
|
||||
'desc_tip' => true,
|
||||
],
|
||||
[
|
||||
'title' => __('Show Product Images', 'wc-composable-product'),
|
||||
'desc' => __('Display product images in the selection interface.', 'wc-composable-product'),
|
||||
),
|
||||
array(
|
||||
'title' => __( 'Include Non-Public Products', 'wc-composable-product' ),
|
||||
'desc' => __( 'Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_include_unpublished',
|
||||
'type' => 'checkbox',
|
||||
'default' => 'no',
|
||||
),
|
||||
array(
|
||||
'title' => __( 'Show Product Images', 'wc-composable-product' ),
|
||||
'desc' => __( 'Display product images in the selection interface.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_show_images',
|
||||
'type' => 'checkbox',
|
||||
'default' => 'yes',
|
||||
],
|
||||
[
|
||||
'title' => __('Show Product Prices', 'wc-composable-product'),
|
||||
'desc' => __('Display individual product prices in the selection interface.', 'wc-composable-product'),
|
||||
),
|
||||
array(
|
||||
'title' => __( 'Show Product Prices', 'wc-composable-product' ),
|
||||
'desc' => __( 'Display individual product prices in the selection interface.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_show_prices',
|
||||
'type' => 'checkbox',
|
||||
'default' => 'yes',
|
||||
],
|
||||
[
|
||||
'title' => __('Show Total Price', 'wc-composable-product'),
|
||||
'desc' => __('Display the total price as customers make selections.', 'wc-composable-product'),
|
||||
),
|
||||
array(
|
||||
'title' => __( 'Show Total Price', 'wc-composable-product' ),
|
||||
'desc' => __( 'Display the total price as customers make selections.', 'wc-composable-product' ),
|
||||
'id' => 'wc_composable_show_total',
|
||||
'type' => 'checkbox',
|
||||
'default' => 'yes',
|
||||
],
|
||||
[
|
||||
),
|
||||
array(
|
||||
'type' => 'sectionend',
|
||||
'id' => 'wc_composable_settings',
|
||||
],
|
||||
];
|
||||
),
|
||||
);
|
||||
|
||||
return apply_filters('wc_composable_settings', $settings);
|
||||
return apply_filters( 'wc_composable_settings', $settings );
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -95,7 +102,7 @@ class Settings extends \WC_Settings_Page {
|
||||
*/
|
||||
public function output() {
|
||||
$settings = $this->get_settings();
|
||||
\WC_Admin_Settings::output_fields($settings);
|
||||
\WC_Admin_Settings::output_fields( $settings );
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -103,6 +110,6 @@ class Settings extends \WC_Settings_Page {
|
||||
*/
|
||||
public function save() {
|
||||
$settings = $this->get_settings();
|
||||
\WC_Admin_Settings::save_fields($settings);
|
||||
\WC_Admin_Settings::save_fields( $settings );
|
||||
}
|
||||
}
|
||||
|
||||
228
includes/CartHandler.php
Normal file
228
includes/CartHandler.php
Normal file
@@ -0,0 +1,228 @@
|
||||
<?php
|
||||
/**
|
||||
* Cart Handler
|
||||
*
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Cart Handler Class
|
||||
*
|
||||
* Handles adding composable products to cart and calculating prices
|
||||
*/
|
||||
class CartHandler {
|
||||
/**
|
||||
* Stock manager instance
|
||||
*
|
||||
* @var StockManager
|
||||
*/
|
||||
private $stock_manager;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
$this->stock_manager = new StockManager();
|
||||
|
||||
add_filter( 'woocommerce_add_to_cart_validation', array( $this, 'validate_add_to_cart' ), 10, 3 );
|
||||
add_filter( 'woocommerce_add_cart_item_data', array( $this, 'add_cart_item_data' ), 10, 2 );
|
||||
add_filter( 'woocommerce_get_cart_item_from_session', array( $this, 'get_cart_item_from_session' ), 10, 2 );
|
||||
add_filter( 'woocommerce_get_item_data', array( $this, 'display_cart_item_data' ), 10, 2 );
|
||||
add_action( 'woocommerce_before_calculate_totals', array( $this, 'calculate_cart_item_price' ) );
|
||||
add_action( 'woocommerce_single_product_summary', array( $this, 'render_product_selector' ), 25 );
|
||||
add_action( 'woocommerce_checkout_create_order_line_item', array( $this->stock_manager, 'store_selected_products_in_order' ), 10, 3 );
|
||||
add_filter( 'woocommerce_is_purchasable', array( $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;
|
||||
}
|
||||
|
||||
/**
|
||||
* Render product selector on product page
|
||||
*/
|
||||
public function render_product_selector() {
|
||||
global $product;
|
||||
|
||||
if ( $product && $product->get_type() === 'composable' ) {
|
||||
ProductSelector::render( $product );
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate add to cart
|
||||
*
|
||||
* @param bool $passed Validation status
|
||||
* @param int $product_id Product ID
|
||||
* @param int $quantity Quantity
|
||||
* @return bool
|
||||
*/
|
||||
public function validate_add_to_cart( $passed, $product_id, $quantity ) {
|
||||
$product = wc_get_product( $product_id );
|
||||
|
||||
if ( ! $product || $product->get_type() !== 'composable' ) {
|
||||
return $passed;
|
||||
}
|
||||
|
||||
// Check if selected products are provided.
|
||||
// phpcs:ignore WordPress.Security.NonceVerification.Missing -- nonce verified by WooCommerce add-to-cart handler.
|
||||
if ( ! isset( $_POST['composable_products'] ) || empty( $_POST['composable_products'] ) ) {
|
||||
wc_add_notice( __( 'Please select at least one product.', 'wc-composable-product' ), 'error' );
|
||||
return false;
|
||||
}
|
||||
|
||||
// phpcs:ignore WordPress.Security.NonceVerification.Missing -- nonce verified by WooCommerce add-to-cart handler.
|
||||
$selected_products = array_map( 'absint', $_POST['composable_products'] );
|
||||
$selection_limit = $product->get_selection_limit();
|
||||
|
||||
// Validate selection limit
|
||||
if ( count( $selected_products ) > $selection_limit ) {
|
||||
/* translators: %d: selection limit */
|
||||
wc_add_notice( sprintf( __( 'You can select a maximum of %d products.', 'wc-composable-product' ), $selection_limit ), 'error' );
|
||||
return false;
|
||||
}
|
||||
|
||||
if ( count( $selected_products ) === 0 ) {
|
||||
wc_add_notice( __( 'Please select at least one product.', 'wc-composable-product' ), 'error' );
|
||||
return false;
|
||||
}
|
||||
|
||||
// Validate that selected products are valid
|
||||
$available_products = $product->get_available_products();
|
||||
$available_ids = array_map(
|
||||
function ( $p ) {
|
||||
return $p->get_id();
|
||||
},
|
||||
$available_products
|
||||
);
|
||||
|
||||
foreach ( $selected_products as $selected_id ) {
|
||||
if ( ! in_array( $selected_id, $available_ids, true ) ) {
|
||||
wc_add_notice( __( 'One or more selected products are not available.', 'wc-composable-product' ), 'error' );
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// Validate stock availability
|
||||
$stock_validation = $this->stock_manager->validate_stock_availability( $selected_products, $quantity );
|
||||
if ( true !== $stock_validation ) {
|
||||
wc_add_notice( $stock_validation, 'error' );
|
||||
return false;
|
||||
}
|
||||
|
||||
return $passed;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add cart item data
|
||||
*
|
||||
* @param array $cart_item_data Cart item data
|
||||
* @param int $product_id Product ID
|
||||
* @return array
|
||||
*/
|
||||
public function add_cart_item_data( $cart_item_data, $product_id ) {
|
||||
$product = wc_get_product( $product_id );
|
||||
|
||||
if ( ! $product || $product->get_type() !== 'composable' ) {
|
||||
return $cart_item_data;
|
||||
}
|
||||
|
||||
// phpcs:ignore WordPress.Security.NonceVerification.Missing -- nonce verified by WooCommerce add-to-cart handler.
|
||||
if ( isset( $_POST['composable_products'] ) && ! empty( $_POST['composable_products'] ) ) {
|
||||
// phpcs:ignore WordPress.Security.NonceVerification.Missing -- nonce verified by WooCommerce add-to-cart handler.
|
||||
$selected_products = array_map( 'absint', $_POST['composable_products'] );
|
||||
$cart_item_data['composable_products'] = $selected_products;
|
||||
|
||||
// Make cart item unique.
|
||||
$cart_item_data['unique_key'] = md5( wp_json_encode( $selected_products ) . time() );
|
||||
}
|
||||
|
||||
return $cart_item_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get cart item from session
|
||||
*
|
||||
* @param array $cart_item Cart item
|
||||
* @param array $values Values from session
|
||||
* @return array
|
||||
*/
|
||||
public function get_cart_item_from_session( $cart_item, $values ) {
|
||||
if ( isset( $values['composable_products'] ) ) {
|
||||
$cart_item['composable_products'] = $values['composable_products'];
|
||||
}
|
||||
|
||||
return $cart_item;
|
||||
}
|
||||
|
||||
/**
|
||||
* Display cart item data
|
||||
*
|
||||
* @param array $item_data Item data
|
||||
* @param array $cart_item Cart item
|
||||
* @return array
|
||||
*/
|
||||
public function display_cart_item_data( $item_data, $cart_item ) {
|
||||
if ( isset( $cart_item['composable_products'] ) && ! empty( $cart_item['composable_products'] ) ) {
|
||||
$product_names = array();
|
||||
foreach ( $cart_item['composable_products'] as $product_id ) {
|
||||
$product = wc_get_product( $product_id );
|
||||
if ( $product ) {
|
||||
$product_names[] = $product->get_name();
|
||||
}
|
||||
}
|
||||
|
||||
if ( ! empty( $product_names ) ) {
|
||||
$item_data[] = array(
|
||||
'key' => __( 'Selected Products', 'wc-composable-product' ),
|
||||
'value' => implode( ', ', $product_names ),
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
return $item_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate cart item price
|
||||
*
|
||||
* @param \WC_Cart $cart Cart object
|
||||
*/
|
||||
public function calculate_cart_item_price( $cart ) {
|
||||
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
|
||||
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'] ) ) {
|
||||
$product = $cart_item['data'];
|
||||
$price = $product->calculate_composed_price( $cart_item['composable_products'] );
|
||||
$cart_item['data']->set_price( $price );
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$already_calculated = true;
|
||||
}
|
||||
}
|
||||
@@ -1,209 +0,0 @@
|
||||
<?php
|
||||
/**
|
||||
* Cart Handler
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
/**
|
||||
* Cart Handler Class
|
||||
*
|
||||
* Handles adding composable products to cart and calculating prices
|
||||
*/
|
||||
class Cart_Handler {
|
||||
/**
|
||||
* Stock manager instance
|
||||
*
|
||||
* @var Stock_Manager
|
||||
*/
|
||||
private $stock_manager;
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
$this->stock_manager = new Stock_Manager();
|
||||
|
||||
add_filter('woocommerce_add_to_cart_validation', [$this, 'validate_add_to_cart'], 10, 3);
|
||||
add_filter('woocommerce_add_cart_item_data', [$this, 'add_cart_item_data'], 10, 2);
|
||||
add_filter('woocommerce_get_cart_item_from_session', [$this, 'get_cart_item_from_session'], 10, 2);
|
||||
add_filter('woocommerce_get_item_data', [$this, 'display_cart_item_data'], 10, 2);
|
||||
add_action('woocommerce_before_calculate_totals', [$this, 'calculate_cart_item_price']);
|
||||
add_action('woocommerce_single_product_summary', [$this, 'render_product_selector'], 25);
|
||||
add_action('woocommerce_checkout_create_order_line_item', [$this->stock_manager, 'store_selected_products_in_order'], 10, 3);
|
||||
}
|
||||
|
||||
/**
|
||||
* Render product selector on product page
|
||||
*/
|
||||
public function render_product_selector() {
|
||||
global $product;
|
||||
|
||||
if ($product && $product->get_type() === 'composable') {
|
||||
Product_Selector::render($product);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate add to cart
|
||||
*
|
||||
* @param bool $passed Validation status
|
||||
* @param int $product_id Product ID
|
||||
* @param int $quantity Quantity
|
||||
* @return bool
|
||||
*/
|
||||
public function validate_add_to_cart($passed, $product_id, $quantity) {
|
||||
$product = wc_get_product($product_id);
|
||||
|
||||
if (!$product || $product->get_type() !== 'composable') {
|
||||
return $passed;
|
||||
}
|
||||
|
||||
// Check if selected products are provided
|
||||
if (!isset($_POST['composable_products']) || empty($_POST['composable_products'])) {
|
||||
wc_add_notice(__('Please select at least one product.', 'wc-composable-product'), 'error');
|
||||
return false;
|
||||
}
|
||||
|
||||
$selected_products = array_map('absint', $_POST['composable_products']);
|
||||
$selection_limit = $product->get_selection_limit();
|
||||
|
||||
// Validate selection limit
|
||||
if (count($selected_products) > $selection_limit) {
|
||||
/* translators: %d: selection limit */
|
||||
wc_add_notice(sprintf(__('You can select a maximum of %d products.', 'wc-composable-product'), $selection_limit), 'error');
|
||||
return false;
|
||||
}
|
||||
|
||||
if (count($selected_products) === 0) {
|
||||
wc_add_notice(__('Please select at least one product.', 'wc-composable-product'), 'error');
|
||||
return false;
|
||||
}
|
||||
|
||||
// Validate that selected products are valid
|
||||
$available_products = $product->get_available_products();
|
||||
$available_ids = array_map(function($p) {
|
||||
return $p->get_id();
|
||||
}, $available_products);
|
||||
|
||||
foreach ($selected_products as $selected_id) {
|
||||
if (!in_array($selected_id, $available_ids)) {
|
||||
wc_add_notice(__('One or more selected products are not available.', 'wc-composable-product'), 'error');
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// Validate stock availability
|
||||
$stock_validation = $this->stock_manager->validate_stock_availability($selected_products, $quantity);
|
||||
if ($stock_validation !== true) {
|
||||
wc_add_notice($stock_validation, 'error');
|
||||
return false;
|
||||
}
|
||||
|
||||
return $passed;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add cart item data
|
||||
*
|
||||
* @param array $cart_item_data Cart item data
|
||||
* @param int $product_id Product ID
|
||||
* @return array
|
||||
*/
|
||||
public function add_cart_item_data($cart_item_data, $product_id) {
|
||||
$product = wc_get_product($product_id);
|
||||
|
||||
if (!$product || $product->get_type() !== 'composable') {
|
||||
return $cart_item_data;
|
||||
}
|
||||
|
||||
if (isset($_POST['composable_products']) && !empty($_POST['composable_products'])) {
|
||||
$selected_products = array_map('absint', $_POST['composable_products']);
|
||||
$cart_item_data['composable_products'] = $selected_products;
|
||||
|
||||
// Make cart item unique
|
||||
$cart_item_data['unique_key'] = md5(json_encode($selected_products) . time());
|
||||
}
|
||||
|
||||
return $cart_item_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get cart item from session
|
||||
*
|
||||
* @param array $cart_item Cart item
|
||||
* @param array $values Values from session
|
||||
* @return array
|
||||
*/
|
||||
public function get_cart_item_from_session($cart_item, $values) {
|
||||
if (isset($values['composable_products'])) {
|
||||
$cart_item['composable_products'] = $values['composable_products'];
|
||||
}
|
||||
|
||||
return $cart_item;
|
||||
}
|
||||
|
||||
/**
|
||||
* Display cart item data
|
||||
*
|
||||
* @param array $item_data Item data
|
||||
* @param array $cart_item Cart item
|
||||
* @return array
|
||||
*/
|
||||
public function display_cart_item_data($item_data, $cart_item) {
|
||||
if (isset($cart_item['composable_products']) && !empty($cart_item['composable_products'])) {
|
||||
$product_names = [];
|
||||
foreach ($cart_item['composable_products'] as $product_id) {
|
||||
$product = wc_get_product($product_id);
|
||||
if ($product) {
|
||||
$product_names[] = $product->get_name();
|
||||
}
|
||||
}
|
||||
|
||||
if (!empty($product_names)) {
|
||||
$item_data[] = [
|
||||
'key' => __('Selected Products', 'wc-composable-product'),
|
||||
'value' => implode(', ', $product_names),
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
return $item_data;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate cart item price
|
||||
*
|
||||
* @param \WC_Cart $cart Cart object
|
||||
*/
|
||||
public function calculate_cart_item_price($cart) {
|
||||
if (is_admin() && !defined('DOING_AJAX')) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Use static flag to prevent multiple executions
|
||||
static $already_calculated = false;
|
||||
if ($already_calculated) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ($cart->get_cart() as $cart_item_key => $cart_item) {
|
||||
if (isset($cart_item['data']) && $cart_item['data']->get_type() === 'composable') {
|
||||
if (isset($cart_item['composable_products']) && !isset($cart_item['composable_price_calculated'])) {
|
||||
$product = $cart_item['data'];
|
||||
$price = $product->calculate_composed_price($cart_item['composable_products']);
|
||||
$cart_item['data']->set_price($price);
|
||||
|
||||
// Mark as calculated to prevent re-calculation by other plugins
|
||||
$cart->cart_contents[$cart_item_key]['composable_price_calculated'] = true;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
$already_calculated = true;
|
||||
}
|
||||
}
|
||||
@@ -2,12 +2,12 @@
|
||||
/**
|
||||
* Main Plugin Class
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product;
|
||||
namespace Magdev\WcComposableProduct;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Main plugin class - Singleton pattern
|
||||
@@ -35,7 +35,7 @@ class Plugin {
|
||||
* @return Plugin
|
||||
*/
|
||||
public static function instance() {
|
||||
if (is_null(self::$instance)) {
|
||||
if ( is_null( self::$instance ) ) {
|
||||
self::$instance = new self();
|
||||
}
|
||||
return self::$instance;
|
||||
@@ -55,35 +55,50 @@ class Plugin {
|
||||
*/
|
||||
private function init_hooks() {
|
||||
// Register product type
|
||||
add_filter('product_type_selector', [$this, 'add_product_type']);
|
||||
add_filter('woocommerce_product_class', [$this, 'product_class'], 10, 2);
|
||||
add_filter( 'product_type_selector', array( $this, 'add_product_type' ) );
|
||||
add_filter( 'woocommerce_product_class', array( $this, 'product_class' ), 10, 2 );
|
||||
|
||||
// Enqueue scripts and styles
|
||||
add_action('wp_enqueue_scripts', [$this, 'enqueue_frontend_scripts']);
|
||||
add_action('admin_enqueue_scripts', [$this, 'enqueue_admin_scripts']);
|
||||
add_action( 'wp_enqueue_scripts', array( $this, 'enqueue_frontend_scripts' ) );
|
||||
add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_admin_scripts' ) );
|
||||
|
||||
// Admin settings
|
||||
add_filter('woocommerce_get_settings_pages', [$this, 'add_settings_page']);
|
||||
add_filter( 'woocommerce_get_settings_pages', array( $this, 'add_settings_page' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialize Twig template engine
|
||||
*/
|
||||
private function init_twig() {
|
||||
$loader = new \Twig\Loader\FilesystemLoader(WC_COMPOSABLE_PRODUCT_PATH . 'templates');
|
||||
$this->twig = new \Twig\Environment($loader, [
|
||||
$loader = new \Twig\Loader\FilesystemLoader( WC_COMPOSABLE_PRODUCT_PATH . 'templates' );
|
||||
$this->twig = new \Twig\Environment(
|
||||
$loader,
|
||||
array(
|
||||
'cache' => WC_COMPOSABLE_PRODUCT_PATH . 'cache',
|
||||
'auto_reload' => true,
|
||||
'debug' => defined('WP_DEBUG') && WP_DEBUG,
|
||||
]);
|
||||
'debug' => defined( 'WP_DEBUG' ) && WP_DEBUG,
|
||||
)
|
||||
);
|
||||
|
||||
// Add WordPress functions to Twig
|
||||
$this->twig->addFunction(new \Twig\TwigFunction('__', function($text) {
|
||||
return __($text, 'wc-composable-product');
|
||||
}));
|
||||
$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(
|
||||
'__',
|
||||
function ( $text ) {
|
||||
// phpcs:ignore WordPress.WP.I18n.NonSingularStringLiteralText -- dynamic Twig template strings.
|
||||
return __( $text, 'wc-composable-product' );
|
||||
}
|
||||
)
|
||||
);
|
||||
$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' ) );
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -92,15 +107,15 @@ class Plugin {
|
||||
private function includes() {
|
||||
// Note: Settings.php is NOT included here because it extends WC_Settings_Page
|
||||
// which isn't loaded until later. It's included in add_settings_page() instead.
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/Product_Data.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Product_Type.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Stock_Manager.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Cart_Handler.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Product_Selector.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/Admin/ProductData.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/ProductType.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/StockManager.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/CartHandler.php';
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'includes/ProductSelector.php';
|
||||
|
||||
// Initialize components
|
||||
new Admin\Product_Data();
|
||||
new Cart_Handler();
|
||||
new Admin\ProductData();
|
||||
new CartHandler();
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -109,8 +124,8 @@ class Plugin {
|
||||
* @param array $types Product types
|
||||
* @return array
|
||||
*/
|
||||
public function add_product_type($types) {
|
||||
$types['composable'] = __('Composable product', 'wc-composable-product');
|
||||
public function add_product_type( $types ) {
|
||||
$types['composable'] = __( 'Composable product', 'wc-composable-product' );
|
||||
return $types;
|
||||
}
|
||||
|
||||
@@ -121,9 +136,9 @@ class Plugin {
|
||||
* @param string $product_type Product type
|
||||
* @return string
|
||||
*/
|
||||
public function product_class($classname, $product_type) {
|
||||
if ($product_type === 'composable') {
|
||||
$classname = 'WC_Composable_Product\Product_Type';
|
||||
public function product_class( $classname, $product_type ) {
|
||||
if ( 'composable' === $product_type ) {
|
||||
$classname = 'Magdev\WcComposableProduct\ProductType';
|
||||
}
|
||||
return $classname;
|
||||
}
|
||||
@@ -132,52 +147,63 @@ class Plugin {
|
||||
* Enqueue frontend scripts and styles
|
||||
*/
|
||||
public function enqueue_frontend_scripts() {
|
||||
if (is_product()) {
|
||||
if ( is_product() ) {
|
||||
wp_enqueue_style(
|
||||
'wc-composable-product',
|
||||
WC_COMPOSABLE_PRODUCT_URL . 'assets/css/frontend.css',
|
||||
[],
|
||||
array(),
|
||||
WC_COMPOSABLE_PRODUCT_VERSION
|
||||
);
|
||||
|
||||
wp_enqueue_script(
|
||||
'wc-composable-product',
|
||||
WC_COMPOSABLE_PRODUCT_URL . 'assets/js/frontend.js',
|
||||
['jquery'],
|
||||
array( 'jquery' ),
|
||||
WC_COMPOSABLE_PRODUCT_VERSION,
|
||||
true
|
||||
);
|
||||
|
||||
wp_localize_script('wc-composable-product', 'wcComposableProduct', [
|
||||
'ajax_url' => admin_url('admin-ajax.php'),
|
||||
'nonce' => wp_create_nonce('wc_composable_product_nonce'),
|
||||
'i18n' => [
|
||||
'select_items' => __('Please select items', 'wc-composable-product'),
|
||||
'max_items' => __('Maximum items selected', 'wc-composable-product'),
|
||||
'min_items' => __('Please select at least one item', 'wc-composable-product'),
|
||||
],
|
||||
]);
|
||||
wp_localize_script(
|
||||
'wc-composable-product',
|
||||
'wcComposableProduct',
|
||||
array(
|
||||
'ajax_url' => admin_url( 'admin-ajax.php' ),
|
||||
'nonce' => wp_create_nonce( 'wc_composable_product_nonce' ),
|
||||
'i18n' => array(
|
||||
'select_items' => __( 'Please select items', 'wc-composable-product' ),
|
||||
'max_items' => __( 'Maximum items selected', 'wc-composable-product' ),
|
||||
'min_items' => __( 'Please select at least one item', 'wc-composable-product' ),
|
||||
),
|
||||
'price_format' => array(
|
||||
'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(),
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Enqueue admin scripts and styles
|
||||
*/
|
||||
public function enqueue_admin_scripts($hook) {
|
||||
if ('post.php' === $hook || 'post-new.php' === $hook) {
|
||||
public function enqueue_admin_scripts( $hook ) {
|
||||
if ( 'post.php' === $hook || 'post-new.php' === $hook ) {
|
||||
global $post_type;
|
||||
if ('product' === $post_type) {
|
||||
if ( 'product' === $post_type ) {
|
||||
wp_enqueue_style(
|
||||
'wc-composable-product-admin',
|
||||
WC_COMPOSABLE_PRODUCT_URL . 'assets/css/admin.css',
|
||||
[],
|
||||
array(),
|
||||
WC_COMPOSABLE_PRODUCT_VERSION
|
||||
);
|
||||
|
||||
wp_enqueue_script(
|
||||
'wc-composable-product-admin',
|
||||
WC_COMPOSABLE_PRODUCT_URL . 'assets/js/admin.js',
|
||||
['jquery', 'wc-admin-product-meta-boxes'],
|
||||
array( 'jquery', 'wc-admin-product-meta-boxes' ),
|
||||
WC_COMPOSABLE_PRODUCT_VERSION,
|
||||
true
|
||||
);
|
||||
@@ -191,7 +217,7 @@ class Plugin {
|
||||
* @param array $settings WooCommerce settings pages
|
||||
* @return array
|
||||
*/
|
||||
public function add_settings_page($settings) {
|
||||
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();
|
||||
@@ -214,7 +240,7 @@ class Plugin {
|
||||
* @param array $context Template variables
|
||||
* @return string
|
||||
*/
|
||||
public function render_template($template, $context = []) {
|
||||
return $this->twig->render($template, $context);
|
||||
public function render_template( $template, $context = array() ) {
|
||||
return $this->twig->render( $template, $context );
|
||||
}
|
||||
}
|
||||
|
||||
78
includes/ProductSelector.php
Normal file
78
includes/ProductSelector.php
Normal file
@@ -0,0 +1,78 @@
|
||||
<?php
|
||||
/**
|
||||
* Product Selector
|
||||
*
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Product Selector Class
|
||||
*
|
||||
* Handles rendering the product selection interface
|
||||
*/
|
||||
class ProductSelector {
|
||||
/**
|
||||
* Render product selector
|
||||
*
|
||||
* @param ProductType $product Composable product
|
||||
*/
|
||||
public static function render( $product ) {
|
||||
if ( ! $product || $product->get_type() !== 'composable' ) {
|
||||
return;
|
||||
}
|
||||
|
||||
$available_products = $product->get_available_products();
|
||||
$selection_limit = $product->get_selection_limit();
|
||||
$pricing_mode = $product->get_pricing_mode();
|
||||
|
||||
$show_images = get_option( 'wc_composable_show_images', 'yes' ) === 'yes';
|
||||
$show_prices = get_option( 'wc_composable_show_prices', 'yes' ) === 'yes';
|
||||
$show_total = get_option( 'wc_composable_show_total', 'yes' ) === 'yes';
|
||||
|
||||
// Get stock manager for stock information
|
||||
$stock_manager = new StockManager();
|
||||
|
||||
// Prepare product data for template
|
||||
$products_data = array();
|
||||
foreach ( $available_products as $available_product ) {
|
||||
$stock_info = $stock_manager->get_product_stock_info( $available_product->get_id() );
|
||||
|
||||
$products_data[] = array(
|
||||
'id' => $available_product->get_id(),
|
||||
'name' => $available_product->get_name(),
|
||||
'price' => $available_product->get_price(),
|
||||
'price_html' => $available_product->get_price_html(),
|
||||
'image_url' => wp_get_attachment_image_url( $available_product->get_image_id(), 'thumbnail' ),
|
||||
'permalink' => $available_product->get_permalink(),
|
||||
'stock_status' => $stock_info['stock_status'],
|
||||
'in_stock' => $stock_info['in_stock'],
|
||||
'stock_quantity' => $stock_info['stock_quantity'],
|
||||
'managing_stock' => $stock_info['managing_stock'],
|
||||
'backorders_allowed' => $stock_info['backorders_allowed'],
|
||||
);
|
||||
}
|
||||
|
||||
$context = array(
|
||||
'product_id' => $product->get_id(),
|
||||
'products' => $products_data,
|
||||
'selection_limit' => $selection_limit,
|
||||
'pricing_mode' => $pricing_mode,
|
||||
'show_images' => $show_images,
|
||||
'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(),
|
||||
);
|
||||
|
||||
// Render template — Twig handles escaping via registered esc_html/esc_attr/esc_url functions.
|
||||
$plugin = Plugin::instance();
|
||||
// phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- output escaped by Twig template.
|
||||
echo $plugin->render_template( 'product-selector.twig', $context );
|
||||
}
|
||||
}
|
||||
254
includes/ProductType.php
Normal file
254
includes/ProductType.php
Normal file
@@ -0,0 +1,254 @@
|
||||
<?php
|
||||
/**
|
||||
* Composable Product Type
|
||||
*
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Composable Product Type Class
|
||||
*/
|
||||
class ProductType extends \WC_Product {
|
||||
/**
|
||||
* Product type
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $product_type = 'composable';
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param mixed $product Product ID or object
|
||||
*/
|
||||
public function __construct( $product = 0 ) {
|
||||
$this->supports[] = 'ajax_add_to_cart';
|
||||
parent::__construct( $product );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get product type
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_type() {
|
||||
return 'composable';
|
||||
}
|
||||
|
||||
/**
|
||||
* Get selection limit
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function get_selection_limit() {
|
||||
$limit = $this->get_meta( '_composable_selection_limit', true );
|
||||
if ( empty( $limit ) ) {
|
||||
$limit = get_option( 'wc_composable_default_limit', 5 );
|
||||
}
|
||||
return absint( $limit );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get pricing mode
|
||||
*
|
||||
* @return string 'fixed' or 'sum'
|
||||
*/
|
||||
public function get_pricing_mode() {
|
||||
$mode = $this->get_meta( '_composable_pricing_mode', true );
|
||||
if ( empty( $mode ) ) {
|
||||
$mode = get_option( 'wc_composable_default_pricing', 'sum' );
|
||||
}
|
||||
return $mode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get product selection criteria
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_selection_criteria() {
|
||||
$type = $this->get_meta( '_composable_criteria_type', true );
|
||||
$categories = $this->get_meta( '_composable_categories', true );
|
||||
$tags = $this->get_meta( '_composable_tags', true );
|
||||
$skus = $this->get_meta( '_composable_skus', true );
|
||||
|
||||
return array(
|
||||
'type' => $type ? $type : 'category',
|
||||
'categories' => $categories ? $categories : array(),
|
||||
'tags' => $tags ? $tags : array(),
|
||||
'skus' => $skus ? $skus : '',
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if product is purchasable
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function is_purchasable() {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if product is sold individually
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function is_sold_individually() {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if non-public products should be included
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function should_include_unpublished() {
|
||||
$per_product = $this->get_meta( '_composable_include_unpublished', true );
|
||||
if ( 'yes' === $per_product ) {
|
||||
return true;
|
||||
}
|
||||
if ( 'no' === $per_product ) {
|
||||
return false;
|
||||
}
|
||||
return 'yes' === get_option( 'wc_composable_include_unpublished', 'no' );
|
||||
}
|
||||
|
||||
/**
|
||||
* Get available products based on criteria
|
||||
*
|
||||
* @return array Array of WC_Product objects
|
||||
*/
|
||||
public function get_available_products() {
|
||||
$criteria = $this->get_selection_criteria();
|
||||
$include_unpublished = $this->should_include_unpublished();
|
||||
$args = array(
|
||||
'post_type' => 'product',
|
||||
'posts_per_page' => -1,
|
||||
'post_status' => $include_unpublished ? array( 'publish', 'draft', 'private' ) : 'publish',
|
||||
'orderby' => 'title',
|
||||
'order' => 'ASC',
|
||||
);
|
||||
|
||||
// Exclude composable products using the product_type taxonomy
|
||||
// (WooCommerce stores product types as taxonomy terms, NOT as postmeta)
|
||||
$args['tax_query'] = array(
|
||||
'relation' => 'AND',
|
||||
array(
|
||||
'taxonomy' => 'product_type',
|
||||
'field' => 'slug',
|
||||
'terms' => array( 'composable' ),
|
||||
'operator' => 'NOT IN',
|
||||
),
|
||||
);
|
||||
|
||||
switch ( $criteria['type'] ) {
|
||||
case 'category':
|
||||
if ( ! empty( $criteria['categories'] ) ) {
|
||||
$args['tax_query'][] = array(
|
||||
'taxonomy' => 'product_cat',
|
||||
'field' => 'term_id',
|
||||
'terms' => $criteria['categories'],
|
||||
'operator' => 'IN',
|
||||
);
|
||||
}
|
||||
break;
|
||||
|
||||
case 'tag':
|
||||
if ( ! empty( $criteria['tags'] ) ) {
|
||||
$args['tax_query'][] = array(
|
||||
'taxonomy' => 'product_tag',
|
||||
'field' => 'term_id',
|
||||
'terms' => $criteria['tags'],
|
||||
'operator' => 'IN',
|
||||
);
|
||||
}
|
||||
break;
|
||||
|
||||
case 'sku':
|
||||
if ( ! empty( $criteria['skus'] ) ) {
|
||||
$skus = array_map( 'trim', explode( ',', $criteria['skus'] ) );
|
||||
$args['meta_query'] = array(
|
||||
array(
|
||||
'key' => '_sku',
|
||||
'value' => $skus,
|
||||
'compare' => 'IN',
|
||||
),
|
||||
);
|
||||
}
|
||||
break;
|
||||
}
|
||||
|
||||
$query = new \WP_Query( $args );
|
||||
$products = array();
|
||||
|
||||
if ( $query->have_posts() ) {
|
||||
foreach ( $query->posts as $post ) {
|
||||
$product = wc_get_product( $post->ID );
|
||||
|
||||
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 && ( $include_unpublished || $variation->is_purchasable() ) ) {
|
||||
$products[] = $variation;
|
||||
}
|
||||
}
|
||||
} elseif ( $include_unpublished || $product->is_purchasable() ) {
|
||||
$products[] = $product;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
wp_reset_postdata();
|
||||
|
||||
return $products;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate price based on selected products
|
||||
*
|
||||
* @param array $selected_products Array of product IDs
|
||||
* @return float
|
||||
*/
|
||||
public function calculate_composed_price( $selected_products ) {
|
||||
$pricing_mode = $this->get_pricing_mode();
|
||||
|
||||
if ( 'fixed' === $pricing_mode ) {
|
||||
return floatval( $this->get_regular_price() );
|
||||
}
|
||||
|
||||
$total = 0;
|
||||
foreach ( $selected_products as $product_id ) {
|
||||
$product = wc_get_product( $product_id );
|
||||
if ( $product ) {
|
||||
$total += floatval( $product->get_price() );
|
||||
}
|
||||
}
|
||||
|
||||
return $total;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add to cart validation
|
||||
*
|
||||
* @param int $product_id Product ID
|
||||
* @param int $quantity Quantity
|
||||
* @param int $variation_id Variation ID
|
||||
* @param array $variations Variations
|
||||
* @param array $cart_item_data Cart item data
|
||||
* @return bool
|
||||
*/
|
||||
public function add_to_cart_validation( $product_id, $quantity, $variation_id = 0, $variations = array(), $cart_item_data = array() ) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
@@ -1,75 +0,0 @@
|
||||
<?php
|
||||
/**
|
||||
* Product Selector
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
/**
|
||||
* Product Selector Class
|
||||
*
|
||||
* Handles rendering the product selection interface
|
||||
*/
|
||||
class Product_Selector {
|
||||
/**
|
||||
* Render product selector
|
||||
*
|
||||
* @param Product_Type $product Composable product
|
||||
*/
|
||||
public static function render($product) {
|
||||
if (!$product || $product->get_type() !== 'composable') {
|
||||
return;
|
||||
}
|
||||
|
||||
$available_products = $product->get_available_products();
|
||||
$selection_limit = $product->get_selection_limit();
|
||||
$pricing_mode = $product->get_pricing_mode();
|
||||
|
||||
$show_images = get_option('wc_composable_show_images', 'yes') === 'yes';
|
||||
$show_prices = get_option('wc_composable_show_prices', 'yes') === 'yes';
|
||||
$show_total = get_option('wc_composable_show_total', 'yes') === 'yes';
|
||||
|
||||
// Get stock manager for stock information
|
||||
$stock_manager = new Stock_Manager();
|
||||
|
||||
// Prepare product data for template
|
||||
$products_data = [];
|
||||
foreach ($available_products as $available_product) {
|
||||
$stock_info = $stock_manager->get_product_stock_info($available_product->get_id());
|
||||
|
||||
$products_data[] = [
|
||||
'id' => $available_product->get_id(),
|
||||
'name' => $available_product->get_name(),
|
||||
'price' => $available_product->get_price(),
|
||||
'price_html' => $available_product->get_price_html(),
|
||||
'image_url' => wp_get_attachment_image_url($available_product->get_image_id(), 'thumbnail'),
|
||||
'permalink' => $available_product->get_permalink(),
|
||||
'stock_status' => $stock_info['stock_status'],
|
||||
'in_stock' => $stock_info['in_stock'],
|
||||
'stock_quantity' => $stock_info['stock_quantity'],
|
||||
'managing_stock' => $stock_info['managing_stock'],
|
||||
'backorders_allowed' => $stock_info['backorders_allowed'],
|
||||
];
|
||||
}
|
||||
|
||||
$context = [
|
||||
'product_id' => $product->get_id(),
|
||||
'products' => $products_data,
|
||||
'selection_limit' => $selection_limit,
|
||||
'pricing_mode' => $pricing_mode,
|
||||
'show_images' => $show_images,
|
||||
'show_prices' => $show_prices,
|
||||
'show_total' => $show_total,
|
||||
'fixed_price' => $product->get_price(),
|
||||
'currency_symbol' => get_woocommerce_currency_symbol(),
|
||||
];
|
||||
|
||||
// Render template
|
||||
$plugin = Plugin::instance();
|
||||
echo $plugin->render_template('product-selector.twig', $context);
|
||||
}
|
||||
}
|
||||
@@ -1,213 +0,0 @@
|
||||
<?php
|
||||
/**
|
||||
* Composable Product Type
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
/**
|
||||
* Composable Product Type Class
|
||||
*/
|
||||
class Product_Type extends \WC_Product {
|
||||
/**
|
||||
* Product type
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
protected $product_type = 'composable';
|
||||
|
||||
/**
|
||||
* Constructor
|
||||
*
|
||||
* @param mixed $product Product ID or object
|
||||
*/
|
||||
public function __construct($product = 0) {
|
||||
$this->supports[] = 'ajax_add_to_cart';
|
||||
parent::__construct($product);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get product type
|
||||
*
|
||||
* @return string
|
||||
*/
|
||||
public function get_type() {
|
||||
return 'composable';
|
||||
}
|
||||
|
||||
/**
|
||||
* Get selection limit
|
||||
*
|
||||
* @return int
|
||||
*/
|
||||
public function get_selection_limit() {
|
||||
$limit = $this->get_meta('_composable_selection_limit', true);
|
||||
if (empty($limit)) {
|
||||
$limit = get_option('wc_composable_default_limit', 5);
|
||||
}
|
||||
return absint($limit);
|
||||
}
|
||||
|
||||
/**
|
||||
* Get pricing mode
|
||||
*
|
||||
* @return string 'fixed' or 'sum'
|
||||
*/
|
||||
public function get_pricing_mode() {
|
||||
$mode = $this->get_meta('_composable_pricing_mode', true);
|
||||
if (empty($mode)) {
|
||||
$mode = get_option('wc_composable_default_pricing', 'sum');
|
||||
}
|
||||
return $mode;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get product selection criteria
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function get_selection_criteria() {
|
||||
return [
|
||||
'type' => $this->get_meta('_composable_criteria_type', true) ?: 'category',
|
||||
'categories' => $this->get_meta('_composable_categories', true) ?: [],
|
||||
'tags' => $this->get_meta('_composable_tags', true) ?: [],
|
||||
'skus' => $this->get_meta('_composable_skus', true) ?: '',
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if product is purchasable
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function is_purchasable() {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if product is sold individually
|
||||
*
|
||||
* @return bool
|
||||
*/
|
||||
public function is_sold_individually() {
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get available products based on criteria
|
||||
*
|
||||
* @return array Array of WC_Product objects
|
||||
*/
|
||||
public function get_available_products() {
|
||||
$criteria = $this->get_selection_criteria();
|
||||
$args = [
|
||||
'post_type' => 'product',
|
||||
'posts_per_page' => -1,
|
||||
'post_status' => 'publish',
|
||||
'orderby' => 'title',
|
||||
'order' => 'ASC',
|
||||
'tax_query' => [],
|
||||
];
|
||||
|
||||
// Exclude composable products from selection
|
||||
$args['meta_query'] = [
|
||||
[
|
||||
'key' => '_product_type',
|
||||
'value' => 'composable',
|
||||
'compare' => '!=',
|
||||
],
|
||||
];
|
||||
|
||||
switch ($criteria['type']) {
|
||||
case 'category':
|
||||
if (!empty($criteria['categories'])) {
|
||||
$args['tax_query'][] = [
|
||||
'taxonomy' => 'product_cat',
|
||||
'field' => 'term_id',
|
||||
'terms' => $criteria['categories'],
|
||||
'operator' => 'IN',
|
||||
];
|
||||
}
|
||||
break;
|
||||
|
||||
case 'tag':
|
||||
if (!empty($criteria['tags'])) {
|
||||
$args['tax_query'][] = [
|
||||
'taxonomy' => 'product_tag',
|
||||
'field' => 'term_id',
|
||||
'terms' => $criteria['tags'],
|
||||
'operator' => 'IN',
|
||||
];
|
||||
}
|
||||
break;
|
||||
|
||||
case 'sku':
|
||||
if (!empty($criteria['skus'])) {
|
||||
$skus = array_map('trim', explode(',', $criteria['skus']));
|
||||
$args['meta_query'][] = [
|
||||
'key' => '_sku',
|
||||
'value' => $skus,
|
||||
'compare' => 'IN',
|
||||
];
|
||||
}
|
||||
break;
|
||||
}
|
||||
|
||||
$query = new \WP_Query($args);
|
||||
$products = [];
|
||||
|
||||
if ($query->have_posts()) {
|
||||
foreach ($query->posts as $post) {
|
||||
$product = wc_get_product($post->ID);
|
||||
if ($product && $product->is_in_stock() && $product->is_purchasable()) {
|
||||
$products[] = $product;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
wp_reset_postdata();
|
||||
return $products;
|
||||
}
|
||||
|
||||
/**
|
||||
* Calculate price based on selected products
|
||||
*
|
||||
* @param array $selected_products Array of product IDs
|
||||
* @return float
|
||||
*/
|
||||
public function calculate_composed_price($selected_products) {
|
||||
$pricing_mode = $this->get_pricing_mode();
|
||||
|
||||
if ($pricing_mode === 'fixed') {
|
||||
return floatval($this->get_regular_price());
|
||||
}
|
||||
|
||||
$total = 0;
|
||||
foreach ($selected_products as $product_id) {
|
||||
$product = wc_get_product($product_id);
|
||||
if ($product) {
|
||||
$total += floatval($product->get_price());
|
||||
}
|
||||
}
|
||||
|
||||
return $total;
|
||||
}
|
||||
|
||||
/**
|
||||
* Add to cart validation
|
||||
*
|
||||
* @param int $product_id Product ID
|
||||
* @param int $quantity Quantity
|
||||
* @param int $variation_id Variation ID
|
||||
* @param array $variations Variations
|
||||
* @param array $cart_item_data Cart item data
|
||||
* @return bool
|
||||
*/
|
||||
public function add_to_cart_validation($product_id, $quantity, $variation_id = 0, $variations = [], $cart_item_data = []) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
283
includes/StockManager.php
Normal file
283
includes/StockManager.php
Normal file
@@ -0,0 +1,283 @@
|
||||
<?php
|
||||
/**
|
||||
* Stock Manager
|
||||
*
|
||||
* @package Magdev\WcComposableProduct
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct;
|
||||
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
/**
|
||||
* Stock Manager Class
|
||||
*
|
||||
* Handles stock management for composable products
|
||||
*/
|
||||
class StockManager {
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
// Hook into order completion to reduce stock
|
||||
add_action( 'woocommerce_order_status_completed', array( $this, 'reduce_stock_on_order_complete' ), 10, 1 );
|
||||
add_action( 'woocommerce_order_status_processing', array( $this, 'reduce_stock_on_order_complete' ), 10, 1 );
|
||||
|
||||
// Hook into order cancellation/refund to restore stock
|
||||
add_action( 'woocommerce_order_status_cancelled', array( $this, 'restore_stock_on_order_cancel' ), 10, 1 );
|
||||
add_action( 'woocommerce_order_status_refunded', array( $this, 'restore_stock_on_order_cancel' ), 10, 1 );
|
||||
|
||||
// Prevent double stock reduction
|
||||
add_filter( 'woocommerce_can_reduce_order_stock', array( $this, 'prevent_composable_stock_reduction' ), 10, 2 );
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate stock availability for selected products
|
||||
*
|
||||
* @param array $selected_product_ids Array of product IDs
|
||||
* @param int $quantity Quantity of composable product being added
|
||||
* @return bool|string True if in stock, error message otherwise
|
||||
*/
|
||||
public function validate_stock_availability( $selected_product_ids, $quantity = 1 ) {
|
||||
foreach ( $selected_product_ids as $product_id ) {
|
||||
$product = wc_get_product( $product_id );
|
||||
|
||||
if ( ! $product ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Skip stock check if stock management is disabled for this product
|
||||
if ( ! $product->managing_stock() ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$stock_quantity = $product->get_stock_quantity();
|
||||
|
||||
// Check if product is in stock
|
||||
if ( ! $product->is_in_stock() ) {
|
||||
return sprintf(
|
||||
/* translators: %s: product name */
|
||||
__( '"%s" is out of stock and cannot be selected.', 'wc-composable-product' ),
|
||||
$product->get_name()
|
||||
);
|
||||
}
|
||||
|
||||
// Check if enough stock is available
|
||||
if ( null !== $stock_quantity && $stock_quantity < $quantity ) {
|
||||
return sprintf(
|
||||
/* translators: 1: product name, 2: stock quantity */
|
||||
__( 'Only %2$d of "%1$s" are available in stock.', 'wc-composable-product' ),
|
||||
$product->get_name(),
|
||||
$stock_quantity
|
||||
);
|
||||
}
|
||||
|
||||
// Check for backorders
|
||||
if ( $product->backorders_allowed() ) {
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if a product has sufficient stock
|
||||
*
|
||||
* @param int $product_id Product ID
|
||||
* @param int $required_quantity Required quantity
|
||||
* @return array Stock information [in_stock, stock_quantity, backorders_allowed]
|
||||
*/
|
||||
public function get_product_stock_info( $product_id, $required_quantity = 1 ) {
|
||||
$product = wc_get_product( $product_id );
|
||||
|
||||
if ( ! $product ) {
|
||||
return array(
|
||||
'in_stock' => false,
|
||||
'stock_quantity' => 0,
|
||||
'backorders_allowed' => false,
|
||||
'stock_status' => 'outofstock',
|
||||
);
|
||||
}
|
||||
|
||||
$stock_quantity = $product->get_stock_quantity();
|
||||
$managing_stock = $product->managing_stock();
|
||||
|
||||
return array(
|
||||
'in_stock' => $product->is_in_stock(),
|
||||
'stock_quantity' => $stock_quantity,
|
||||
'backorders_allowed' => $product->backorders_allowed(),
|
||||
'stock_status' => $product->get_stock_status(),
|
||||
'managing_stock' => $managing_stock,
|
||||
'has_enough_stock' => ! $managing_stock || null === $stock_quantity || $stock_quantity >= $required_quantity,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Reduce stock for composable products when order is completed
|
||||
*
|
||||
* @param int $order_id Order ID
|
||||
*/
|
||||
public function reduce_stock_on_order_complete( $order_id ) {
|
||||
$order = wc_get_order( $order_id );
|
||||
|
||||
if ( ! $order ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check if stock has already been reduced
|
||||
if ( $order->get_meta( '_composable_stock_reduced', true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $order->get_items() as $item ) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if ( ! $product || $product->get_type() !== 'composable' ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Get selected products from order item meta
|
||||
$selected_products = $item->get_meta( '_composable_products', true );
|
||||
|
||||
if ( empty( $selected_products ) || ! is_array( $selected_products ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$quantity = $item->get_quantity();
|
||||
|
||||
// Reduce stock for each selected product
|
||||
foreach ( $selected_products as $product_id ) {
|
||||
$selected_product = wc_get_product( $product_id );
|
||||
|
||||
if ( ! $selected_product || ! $selected_product->managing_stock() ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$stock_quantity = $selected_product->get_stock_quantity();
|
||||
|
||||
if ( null !== $stock_quantity ) {
|
||||
$new_stock = $stock_quantity - $quantity;
|
||||
$selected_product->set_stock_quantity( $new_stock );
|
||||
$selected_product->save();
|
||||
|
||||
// Add order note
|
||||
$order->add_order_note(
|
||||
sprintf(
|
||||
/* translators: 1: product name, 2: quantity, 3: remaining stock */
|
||||
__( 'Stock reduced for "%1$s": -%2$d (remaining: %3$d)', 'wc-composable-product' ),
|
||||
$selected_product->get_name(),
|
||||
$quantity,
|
||||
$new_stock
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Mark stock as reduced
|
||||
$order->update_meta_data( '_composable_stock_reduced', true );
|
||||
$order->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Restore stock when order is cancelled or refunded
|
||||
*
|
||||
* @param int $order_id Order ID
|
||||
*/
|
||||
public function restore_stock_on_order_cancel( $order_id ) {
|
||||
$order = wc_get_order( $order_id );
|
||||
|
||||
if ( ! $order ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check if stock was reduced
|
||||
if ( ! $order->get_meta( '_composable_stock_reduced', true ) ) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ( $order->get_items() as $item ) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if ( ! $product || $product->get_type() !== 'composable' ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Get selected products from order item meta
|
||||
$selected_products = $item->get_meta( '_composable_products', true );
|
||||
|
||||
if ( empty( $selected_products ) || ! is_array( $selected_products ) ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$quantity = $item->get_quantity();
|
||||
|
||||
// Restore stock for each selected product
|
||||
foreach ( $selected_products as $product_id ) {
|
||||
$selected_product = wc_get_product( $product_id );
|
||||
|
||||
if ( ! $selected_product || ! $selected_product->managing_stock() ) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$stock_quantity = $selected_product->get_stock_quantity();
|
||||
|
||||
if ( null !== $stock_quantity ) {
|
||||
$new_stock = $stock_quantity + $quantity;
|
||||
$selected_product->set_stock_quantity( $new_stock );
|
||||
$selected_product->save();
|
||||
|
||||
// Add order note
|
||||
$order->add_order_note(
|
||||
sprintf(
|
||||
/* translators: 1: product name, 2: quantity, 3: new stock */
|
||||
__( 'Stock restored for "%1$s": +%2$d (total: %3$d)', 'wc-composable-product' ),
|
||||
$selected_product->get_name(),
|
||||
$quantity,
|
||||
$new_stock
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Mark stock as restored
|
||||
$order->update_meta_data( '_composable_stock_reduced', false );
|
||||
$order->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Prevent WooCommerce from reducing stock for composable products
|
||||
* We handle stock reduction manually for selected products
|
||||
*
|
||||
* @param bool $reduce_stock Whether to reduce stock
|
||||
* @param \WC_Order $order Order object
|
||||
* @return bool
|
||||
*/
|
||||
public function prevent_composable_stock_reduction( $reduce_stock, $order ) {
|
||||
foreach ( $order->get_items() as $item ) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if ( $product && $product->get_type() === 'composable' ) {
|
||||
// We'll handle stock reduction manually
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return $reduce_stock;
|
||||
}
|
||||
|
||||
/**
|
||||
* Store selected products in order item meta
|
||||
*
|
||||
* @param \WC_Order_Item_Product $item Order item
|
||||
* @param string $cart_item_key Cart item key
|
||||
* @param array $values Cart item values
|
||||
*/
|
||||
public function store_selected_products_in_order( $item, $cart_item_key, $values ) {
|
||||
if ( isset( $values['composable_products'] ) && ! empty( $values['composable_products'] ) ) {
|
||||
$item->add_meta_data( '_composable_products', $values['composable_products'], true );
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,283 +0,0 @@
|
||||
<?php
|
||||
/**
|
||||
* Stock Manager
|
||||
*
|
||||
* @package WC_Composable_Product
|
||||
*/
|
||||
|
||||
namespace WC_Composable_Product;
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
|
||||
/**
|
||||
* Stock Manager Class
|
||||
*
|
||||
* Handles stock management for composable products
|
||||
*/
|
||||
class Stock_Manager {
|
||||
/**
|
||||
* Constructor
|
||||
*/
|
||||
public function __construct() {
|
||||
// Hook into order completion to reduce stock
|
||||
add_action('woocommerce_order_status_completed', [$this, 'reduce_stock_on_order_complete'], 10, 1);
|
||||
add_action('woocommerce_order_status_processing', [$this, 'reduce_stock_on_order_complete'], 10, 1);
|
||||
|
||||
// Hook into order cancellation/refund to restore stock
|
||||
add_action('woocommerce_order_status_cancelled', [$this, 'restore_stock_on_order_cancel'], 10, 1);
|
||||
add_action('woocommerce_order_status_refunded', [$this, 'restore_stock_on_order_cancel'], 10, 1);
|
||||
|
||||
// Prevent double stock reduction
|
||||
add_filter('woocommerce_can_reduce_order_stock', [$this, 'prevent_composable_stock_reduction'], 10, 2);
|
||||
}
|
||||
|
||||
/**
|
||||
* Validate stock availability for selected products
|
||||
*
|
||||
* @param array $selected_product_ids Array of product IDs
|
||||
* @param int $quantity Quantity of composable product being added
|
||||
* @return bool|string True if in stock, error message otherwise
|
||||
*/
|
||||
public function validate_stock_availability($selected_product_ids, $quantity = 1) {
|
||||
foreach ($selected_product_ids as $product_id) {
|
||||
$product = wc_get_product($product_id);
|
||||
|
||||
if (!$product) {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Skip stock check if stock management is disabled for this product
|
||||
if (!$product->managing_stock()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$stock_quantity = $product->get_stock_quantity();
|
||||
|
||||
// Check if product is in stock
|
||||
if (!$product->is_in_stock()) {
|
||||
return sprintf(
|
||||
/* translators: %s: product name */
|
||||
__('"%s" is out of stock and cannot be selected.', 'wc-composable-product'),
|
||||
$product->get_name()
|
||||
);
|
||||
}
|
||||
|
||||
// Check if enough stock is available
|
||||
if ($stock_quantity !== null && $stock_quantity < $quantity) {
|
||||
return sprintf(
|
||||
/* translators: 1: product name, 2: stock quantity */
|
||||
__('Only %2$d of "%1$s" are available in stock.', 'wc-composable-product'),
|
||||
$product->get_name(),
|
||||
$stock_quantity
|
||||
);
|
||||
}
|
||||
|
||||
// Check for backorders
|
||||
if ($product->backorders_allowed()) {
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
return true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if a product has sufficient stock
|
||||
*
|
||||
* @param int $product_id Product ID
|
||||
* @param int $required_quantity Required quantity
|
||||
* @return array Stock information [in_stock, stock_quantity, backorders_allowed]
|
||||
*/
|
||||
public function get_product_stock_info($product_id, $required_quantity = 1) {
|
||||
$product = wc_get_product($product_id);
|
||||
|
||||
if (!$product) {
|
||||
return [
|
||||
'in_stock' => false,
|
||||
'stock_quantity' => 0,
|
||||
'backorders_allowed' => false,
|
||||
'stock_status' => 'outofstock',
|
||||
];
|
||||
}
|
||||
|
||||
$stock_quantity = $product->get_stock_quantity();
|
||||
$managing_stock = $product->managing_stock();
|
||||
|
||||
return [
|
||||
'in_stock' => $product->is_in_stock(),
|
||||
'stock_quantity' => $stock_quantity,
|
||||
'backorders_allowed' => $product->backorders_allowed(),
|
||||
'stock_status' => $product->get_stock_status(),
|
||||
'managing_stock' => $managing_stock,
|
||||
'has_enough_stock' => !$managing_stock || $stock_quantity === null || $stock_quantity >= $required_quantity,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* Reduce stock for composable products when order is completed
|
||||
*
|
||||
* @param int $order_id Order ID
|
||||
*/
|
||||
public function reduce_stock_on_order_complete($order_id) {
|
||||
$order = wc_get_order($order_id);
|
||||
|
||||
if (!$order) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check if stock has already been reduced
|
||||
if ($order->get_meta('_composable_stock_reduced', true)) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ($order->get_items() as $item) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if (!$product || $product->get_type() !== 'composable') {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Get selected products from order item meta
|
||||
$selected_products = $item->get_meta('_composable_products', true);
|
||||
|
||||
if (empty($selected_products) || !is_array($selected_products)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$quantity = $item->get_quantity();
|
||||
|
||||
// Reduce stock for each selected product
|
||||
foreach ($selected_products as $product_id) {
|
||||
$selected_product = wc_get_product($product_id);
|
||||
|
||||
if (!$selected_product || !$selected_product->managing_stock()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$stock_quantity = $selected_product->get_stock_quantity();
|
||||
|
||||
if ($stock_quantity !== null) {
|
||||
$new_stock = $stock_quantity - $quantity;
|
||||
$selected_product->set_stock_quantity($new_stock);
|
||||
$selected_product->save();
|
||||
|
||||
// Add order note
|
||||
$order->add_order_note(
|
||||
sprintf(
|
||||
/* translators: 1: product name, 2: quantity, 3: remaining stock */
|
||||
__('Stock reduced for "%1$s": -%2$d (remaining: %3$d)', 'wc-composable-product'),
|
||||
$selected_product->get_name(),
|
||||
$quantity,
|
||||
$new_stock
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Mark stock as reduced
|
||||
$order->update_meta_data('_composable_stock_reduced', true);
|
||||
$order->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Restore stock when order is cancelled or refunded
|
||||
*
|
||||
* @param int $order_id Order ID
|
||||
*/
|
||||
public function restore_stock_on_order_cancel($order_id) {
|
||||
$order = wc_get_order($order_id);
|
||||
|
||||
if (!$order) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Check if stock was reduced
|
||||
if (!$order->get_meta('_composable_stock_reduced', true)) {
|
||||
return;
|
||||
}
|
||||
|
||||
foreach ($order->get_items() as $item) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if (!$product || $product->get_type() !== 'composable') {
|
||||
continue;
|
||||
}
|
||||
|
||||
// Get selected products from order item meta
|
||||
$selected_products = $item->get_meta('_composable_products', true);
|
||||
|
||||
if (empty($selected_products) || !is_array($selected_products)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$quantity = $item->get_quantity();
|
||||
|
||||
// Restore stock for each selected product
|
||||
foreach ($selected_products as $product_id) {
|
||||
$selected_product = wc_get_product($product_id);
|
||||
|
||||
if (!$selected_product || !$selected_product->managing_stock()) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$stock_quantity = $selected_product->get_stock_quantity();
|
||||
|
||||
if ($stock_quantity !== null) {
|
||||
$new_stock = $stock_quantity + $quantity;
|
||||
$selected_product->set_stock_quantity($new_stock);
|
||||
$selected_product->save();
|
||||
|
||||
// Add order note
|
||||
$order->add_order_note(
|
||||
sprintf(
|
||||
/* translators: 1: product name, 2: quantity, 3: new stock */
|
||||
__('Stock restored for "%1$s": +%2$d (total: %3$d)', 'wc-composable-product'),
|
||||
$selected_product->get_name(),
|
||||
$quantity,
|
||||
$new_stock
|
||||
)
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Mark stock as restored
|
||||
$order->update_meta_data('_composable_stock_reduced', false);
|
||||
$order->save();
|
||||
}
|
||||
|
||||
/**
|
||||
* Prevent WooCommerce from reducing stock for composable products
|
||||
* We handle stock reduction manually for selected products
|
||||
*
|
||||
* @param bool $reduce_stock Whether to reduce stock
|
||||
* @param \WC_Order $order Order object
|
||||
* @return bool
|
||||
*/
|
||||
public function prevent_composable_stock_reduction($reduce_stock, $order) {
|
||||
foreach ($order->get_items() as $item) {
|
||||
$product = $item->get_product();
|
||||
|
||||
if ($product && $product->get_type() === 'composable') {
|
||||
// We'll handle stock reduction manually
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
return $reduce_stock;
|
||||
}
|
||||
|
||||
/**
|
||||
* Store selected products in order item meta
|
||||
*
|
||||
* @param \WC_Order_Item_Product $item Order item
|
||||
* @param string $cart_item_key Cart item key
|
||||
* @param array $values Cart item values
|
||||
*/
|
||||
public function store_selected_products_in_order($item, $cart_item_key, $values) {
|
||||
if (isset($values['composable_products']) && !empty($values['composable_products'])) {
|
||||
$item->add_meta_data('_composable_products', $values['composable_products'], true);
|
||||
}
|
||||
}
|
||||
}
|
||||
114
languages/wc-composable-product-de_CH.po
Normal file → Executable file
114
languages/wc-composable-product-de_CH.po
Normal file → Executable file
@@ -91,7 +91,7 @@ msgstr "Den Gesamtpreis anzeigen, während Kunden Auswahlen treffen."
|
||||
msgid "Composable product"
|
||||
msgstr "Zusammenstellbares Produkt"
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr "Wählen Sie Ihre Produkte"
|
||||
|
||||
@@ -111,90 +111,154 @@ msgstr "Gesamtpreis:"
|
||||
msgid "Add to Cart"
|
||||
msgstr "In den Warenkorb"
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr "Bitte wählen Sie mindestens ein Produkt aus."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr "Sie können maximal %d Produkte auswählen."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr "Ein oder mehrere ausgewählte Produkte sind nicht verfügbar."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr "Ausgewählte Produkte"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr "Zusammenstellungsoptionen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr "Auswahllimit"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr "Maximale Anzahl der Artikel, die Kunden auswählen können. Leer lassen, um den globalen Standard zu verwenden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
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."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr "Wie der Preis berechnet wird."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr "Festpreis"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr "Geben Sie den Festpreis für dieses zusammenstellbare Produkt ein."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr "Globalen Standard verwenden"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr "Auswahlkriterien"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr "Wie verfügbare Produkte ausgewählt werden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr "Nach Kategorie"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr "Nach Schlagwort"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr "Nach Artikelnummer"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr "Kategorien auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr "Produktkategorien auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr "Schlagwörter auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr "Produkt-Schlagwörter auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr "Produkt-Artikelnummern"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr "Geben Sie Produkt-Artikelnummern durch Kommas getrennt ein."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr "ART-1, ART-2, ART-3"
|
||||
|
||||
#: includes/StockManager.php
|
||||
msgid "\"%s\" is out of stock and cannot be selected."
|
||||
msgstr "\"%s\" ist nicht an Lager und kann nicht ausgewählt werden."
|
||||
|
||||
#: includes/StockManager.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/StockManager.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/StockManager.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."
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr "Nicht-öffentliche Produkte einbeziehen"
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zusammenstellbarer Produkte anzeigen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen, nicht einzeln."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zulassen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr "Ja"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr "Nein"
|
||||
|
||||
114
languages/wc-composable-product-de_CH_informal.po
Normal file → Executable file
114
languages/wc-composable-product-de_CH_informal.po
Normal file → Executable file
@@ -91,7 +91,7 @@ msgstr "Den Gesamtpreis anzeigen, während Kunden Auswahlen treffen."
|
||||
msgid "Composable product"
|
||||
msgstr "Zusammenstellbares Produkt"
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr "Wähle deine Produkte"
|
||||
|
||||
@@ -111,90 +111,154 @@ msgstr "Gesamtpreis:"
|
||||
msgid "Add to Cart"
|
||||
msgstr "In den Warenkorb"
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr "Bitte wähle mindestens ein Produkt aus."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr "Du kannst maximal %d Produkte auswählen."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr "Ein oder mehrere ausgewählte Produkte sind nicht verfügbar."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr "Ausgewählte Produkte"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr "Zusammenstellungsoptionen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr "Auswahllimit"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr "Maximale Anzahl der Artikel, die Kunden auswählen können. Leer lassen, um den globalen Standard zu verwenden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
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."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr "Wie der Preis berechnet wird."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr "Festpreis"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr "Gib den Festpreis für dieses zusammenstellbare Produkt ein."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr "Globalen Standard verwenden"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr "Auswahlkriterien"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr "Wie verfügbare Produkte ausgewählt werden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr "Nach Kategorie"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr "Nach Schlagwort"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr "Nach Artikelnummer"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr "Kategorien auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr "Produktkategorien auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr "Schlagwörter auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr "Produkt-Schlagwörter auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr "Produkt-Artikelnummern"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr "Gib Produkt-Artikelnummern durch Kommas getrennt ein."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr "ART-1, ART-2, ART-3"
|
||||
|
||||
#: includes/StockManager.php
|
||||
msgid "\"%s\" is out of stock and cannot be selected."
|
||||
msgstr "\"%s\" ist nicht an Lager und kann nicht ausgewählt werden."
|
||||
|
||||
#: includes/StockManager.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/StockManager.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/StockManager.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."
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr "Nicht-öffentliche Produkte einbeziehen"
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zusammenstellbarer Produkte anzeigen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen, nicht einzeln."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zulassen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr "Ja"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr "Nein"
|
||||
|
||||
114
languages/wc-composable-product-de_DE.po
Normal file → Executable file
114
languages/wc-composable-product-de_DE.po
Normal file → Executable file
@@ -91,7 +91,7 @@ msgstr "Den Gesamtpreis anzeigen, während Kunden Auswahlen treffen."
|
||||
msgid "Composable product"
|
||||
msgstr "Zusammenstellbares Produkt"
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr "Wählen Sie Ihre Produkte"
|
||||
|
||||
@@ -111,90 +111,154 @@ msgstr "Gesamtpreis:"
|
||||
msgid "Add to Cart"
|
||||
msgstr "In den Warenkorb"
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr "Bitte wählen Sie mindestens ein Produkt aus."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr "Sie können maximal %d Produkte auswählen."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr "Ein oder mehrere ausgewählte Produkte sind nicht verfügbar."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr "Ausgewählte Produkte"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr "Zusammenstellungsoptionen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr "Auswahllimit"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr "Maximale Anzahl der Artikel, die Kunden auswählen können. Leer lassen, um den globalen Standard zu verwenden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
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."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr "Wie der Preis berechnet wird."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr "Festpreis"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr "Geben Sie den Festpreis für dieses zusammenstellbare Produkt ein."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr "Globalen Standard verwenden"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr "Auswahlkriterien"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr "Wie verfügbare Produkte ausgewählt werden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr "Nach Kategorie"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr "Nach Schlagwort"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr "Nach Artikelnummer"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr "Kategorien auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr "Produktkategorien auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr "Schlagwörter auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr "Produkt-Schlagwörter auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr "Produkt-Artikelnummern"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr "Geben Sie Produkt-Artikelnummern durch Kommas getrennt ein."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr "ART-1, ART-2, ART-3"
|
||||
|
||||
#: includes/StockManager.php
|
||||
msgid "\"%s\" is out of stock and cannot be selected."
|
||||
msgstr "\"%s\" ist nicht auf Lager und kann nicht ausgewählt werden."
|
||||
|
||||
#: includes/StockManager.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/StockManager.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/StockManager.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."
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr "Nicht-öffentliche Produkte einbeziehen"
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zusammenstellbarer Produkte anzeigen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen, nicht einzeln."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zulassen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr "Ja"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr "Nein"
|
||||
|
||||
114
languages/wc-composable-product-de_DE_informal.po
Normal file → Executable file
114
languages/wc-composable-product-de_DE_informal.po
Normal file → Executable file
@@ -91,7 +91,7 @@ msgstr "Den Gesamtpreis anzeigen, während Kunden Auswahlen treffen."
|
||||
msgid "Composable product"
|
||||
msgstr "Zusammenstellbares Produkt"
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr "Wähle deine Produkte"
|
||||
|
||||
@@ -111,90 +111,154 @@ msgstr "Gesamtpreis:"
|
||||
msgid "Add to Cart"
|
||||
msgstr "In den Warenkorb"
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr "Bitte wähle mindestens ein Produkt aus."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr "Du kannst maximal %d Produkte auswählen."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr "Ein oder mehrere ausgewählte Produkte sind nicht verfügbar."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr "Ausgewählte Produkte"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr "Zusammenstellungsoptionen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr "Auswahllimit"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr "Maximale Anzahl der Artikel, die Kunden auswählen können. Leer lassen, um den globalen Standard zu verwenden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
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."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr "Wie der Preis berechnet wird."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr "Festpreis"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr "Gib den Festpreis für dieses zusammenstellbare Produkt ein."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr "Globalen Standard verwenden"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr "Auswahlkriterien"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr "Wie verfügbare Produkte ausgewählt werden."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr "Nach Kategorie"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr "Nach Schlagwort"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr "Nach Artikelnummer"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr "Kategorien auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr "Produktkategorien auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr "Schlagwörter auswählen"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr "Produkt-Schlagwörter auswählen, die einbezogen werden sollen."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr "Produkt-Artikelnummern"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr "Gib Produkt-Artikelnummern durch Kommas getrennt ein."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr "ART-1, ART-2, ART-3"
|
||||
|
||||
#: includes/StockManager.php
|
||||
msgid "\"%s\" is out of stock and cannot be selected."
|
||||
msgstr "\"%s\" ist nicht auf Lager und kann nicht ausgewählt werden."
|
||||
|
||||
#: includes/StockManager.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/StockManager.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/StockManager.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."
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr "Nicht-öffentliche Produkte einbeziehen"
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zusammenstellbarer Produkte anzeigen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen, nicht einzeln."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr "Entwürfe und private Produkte in der Auswahl zulassen. Nützlich, wenn Produkte nur als Teil einer Zusammenstellung verkauft werden sollen."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr "Ja"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr "Nein"
|
||||
|
||||
114
languages/wc-composable-product-fr_CH.po
Normal file → Executable file
114
languages/wc-composable-product-fr_CH.po
Normal file → Executable file
@@ -91,7 +91,7 @@ msgstr "Afficher le prix total pendant que les clients font leurs sélections."
|
||||
msgid "Composable product"
|
||||
msgstr "Produit composable"
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr "Sélectionnez vos produits"
|
||||
|
||||
@@ -111,90 +111,154 @@ msgstr "Prix total :"
|
||||
msgid "Add to Cart"
|
||||
msgstr "Ajouter au panier"
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr "Veuillez sélectionner au moins un produit."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr "Vous pouvez sélectionner un maximum de %d produits."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr "Un ou plusieurs produits sélectionnés ne sont pas disponibles."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr "Produits sélectionnés"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr "Options de composition"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr "Limite de sélection"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr "Nombre maximum d'articles que les clients peuvent sélectionner. Laisser vide pour utiliser la valeur par défaut globale."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
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."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr "Comment calculer le prix."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr "Prix fixe"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr "Entrez le prix fixe pour ce produit composable."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr "Utiliser la valeur par défaut globale"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr "Critères de sélection"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr "Comment sélectionner les produits disponibles."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr "Par catégorie"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr "Par étiquette"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr "Par référence"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr "Sélectionner les catégories"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr "Sélectionner les catégories de produits à inclure."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr "Sélectionner les étiquettes"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr "Sélectionner les étiquettes de produits à inclure."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr "Références des produits"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr "Entrez les références des produits séparées par des virgules."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr "REF-1, REF-2, REF-3"
|
||||
|
||||
#: includes/StockManager.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/StockManager.php
|
||||
msgid "Only %2$d of \"%1$s\" are available in stock."
|
||||
msgstr "Seulement %2$d de \"%1$s\" sont disponibles en stock."
|
||||
|
||||
#: includes/StockManager.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/StockManager.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."
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr "Inclure les produits non publics"
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr "Autoriser les brouillons et les produits privés dans les sélections de produits composables. Utile lorsque les produits ne doivent être vendus que dans le cadre d'une composition, pas individuellement."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr "Autoriser les brouillons et les produits privés dans la sélection. Utile lorsque les produits ne doivent être vendus que dans le cadre d'une composition."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr "Oui"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr "Non"
|
||||
|
||||
90
languages/wc-composable-product-it_CH.po
Normal file → Executable file
90
languages/wc-composable-product-it_CH.po
Normal file → Executable file
@@ -91,7 +91,7 @@ msgstr "Visualizzare il prezzo totale mentre i clienti effettuano le selezioni."
|
||||
msgid "Composable product"
|
||||
msgstr "Prodotto componibile"
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr "Seleziona i tuoi prodotti"
|
||||
|
||||
@@ -111,107 +111,115 @@ msgstr "Prezzo totale:"
|
||||
msgid "Add to Cart"
|
||||
msgstr "Aggiungi al carrello"
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr "Seleziona almeno un prodotto."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr "Puoi selezionare un massimo di %d prodotti."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr "Uno o più prodotti selezionati non sono disponibili."
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr "Prodotti selezionati"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr "Opzioni di composizione"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr "Limite di selezione"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr "Numero massimo di articoli che i clienti possono selezionare. Lasciare vuoto per utilizzare il valore predefinito globale."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
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."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr "Come calcolare il prezzo."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr "Prezzo fisso"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr "Inserisci il prezzo fisso per questo prodotto componibile."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr "Usa predefinito globale"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr "Criteri di selezione"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr "Come selezionare i prodotti disponibili."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr "Per categoria"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr "Per etichetta"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr "Per codice articolo"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr "Seleziona categorie"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr "Selezionare le categorie di prodotti da includere."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr "Seleziona etichette"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr "Selezionare le etichette dei prodotti da includere."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr "Codici articolo prodotti"
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr "Inserire i codici articolo dei prodotti separati da virgole."
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr "COD-1, COD-2, COD-3"
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "\"%s\" is out of stock and cannot be selected."
|
||||
msgstr "\"%s\" è esaurito e non può essere selezionato."
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "Only %2$d of \"%1$s\" are available in stock."
|
||||
msgstr "Solo %2$d di \"%1$s\" sono disponibili in magazzino."
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
|
||||
msgstr "Giacenza ridotta per \"%1$s\": -%2$d (rimanenti: %3$d)"
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
|
||||
msgstr "Giacenza ripristinata per \"%1$s\": +%2$d (totale: %3$d)"
|
||||
|
||||
@@ -230,3 +238,27 @@ 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."
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr "Includi prodotti non pubblici"
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr "Consenti la visualizzazione di bozze e prodotti privati nelle selezioni dei prodotti componibili. Utile quando i prodotti devono essere venduti solo come parte di una composizione, non singolarmente."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr "Consenti bozze e prodotti privati nella selezione. Utile quando i prodotti devono essere venduti solo come parte di una composizione."
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr "Sì"
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr "No"
|
||||
|
||||
90
languages/wc-composable-product.pot
Normal file → Executable file
90
languages/wc-composable-product.pot
Normal file → Executable file
@@ -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"
|
||||
@@ -90,7 +90,7 @@ msgstr ""
|
||||
msgid "Composable product"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Product_Selector.php, templates/product-selector.twig
|
||||
#: includes/ProductSelector.php, templates/product-selector.twig
|
||||
msgid "Select Your Products"
|
||||
msgstr ""
|
||||
|
||||
@@ -110,107 +110,115 @@ msgstr ""
|
||||
msgid "Add to Cart"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Please select at least one product."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "You can select a maximum of %d products."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "One or more selected products are not available."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Cart_Handler.php
|
||||
#: includes/CartHandler.php
|
||||
msgid "Selected Products"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Composable Options"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Limit"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Maximum number of items customers can select. Leave empty to use global default."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Pricing Mode"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
msgid "How to calculate the price. Leave empty to use global default."
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to calculate the price."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Fixed Price"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter the fixed price for this composable product."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Use global default"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Selection Criteria"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "How to select available products."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Category"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By Tag"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "By SKU"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Categories"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product categories to include."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select Tags"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Select product tags to include."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Product SKUs"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Enter product SKUs separated by commas."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Product_Data.php
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "SKU-1, SKU-2, SKU-3"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "\"%s\" is out of stock and cannot be selected."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "Only %2$d of \"%1$s\" are available in stock."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "Stock reduced for \"%1$s\": -%2$d (remaining: %3$d)"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Stock_Manager.php
|
||||
#: includes/StockManager.php
|
||||
msgid "Stock restored for \"%1$s\": +%2$d (total: %3$d)"
|
||||
msgstr ""
|
||||
|
||||
@@ -229,3 +237,27 @@ 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 ""
|
||||
|
||||
#: includes/Admin/Settings.php, includes/Admin/ProductData.php
|
||||
msgid "Include Non-Public Products"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/Settings.php
|
||||
msgid "Allow draft and private products to appear in composable product selections. Useful when products should only be sold as part of a composition, not individually."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Allow draft and private products in the selection. Useful when products should only be sold as part of a composition."
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "Yes"
|
||||
msgstr ""
|
||||
|
||||
#: includes/Admin/ProductData.php
|
||||
msgid "No"
|
||||
msgstr ""
|
||||
|
||||
34
phpcs.xml.dist
Normal file
34
phpcs.xml.dist
Normal file
@@ -0,0 +1,34 @@
|
||||
<?xml version="1.0"?>
|
||||
<ruleset name="WC Composable Product">
|
||||
<description>PHPCS rules for WooCommerce Composable Products plugin</description>
|
||||
|
||||
<!-- Scan plugin source -->
|
||||
<file>includes</file>
|
||||
<file>wc-composable-product.php</file>
|
||||
|
||||
<!-- Show progress and use colors -->
|
||||
<arg value="ps"/>
|
||||
<arg name="colors"/>
|
||||
|
||||
<!-- Use WordPress Extra standard (Core + Extra, without Docs) -->
|
||||
<rule ref="WordPress-Extra">
|
||||
<!-- Allow PSR-4 PascalCase file naming -->
|
||||
<exclude name="WordPress.Files.FileName"/>
|
||||
</rule>
|
||||
|
||||
<!-- Check PHP 8.3+ compatibility -->
|
||||
<rule ref="PHPCompatibilityWP"/>
|
||||
<config name="testVersion" value="8.3-"/>
|
||||
|
||||
<!-- WordPress minimum version -->
|
||||
<config name="minimum_wp_version" value="6.0"/>
|
||||
|
||||
<!-- Enforce text domain -->
|
||||
<rule ref="WordPress.WP.I18n">
|
||||
<properties>
|
||||
<property name="text_domain" type="array">
|
||||
<element value="wc-composable-product"/>
|
||||
</property>
|
||||
</properties>
|
||||
</rule>
|
||||
</ruleset>
|
||||
21
phpunit.xml.dist
Normal file
21
phpunit.xml.dist
Normal file
@@ -0,0 +1,21 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<phpunit
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.0/phpunit.xsd"
|
||||
bootstrap="tests/bootstrap.php"
|
||||
colors="true"
|
||||
failOnWarning="true"
|
||||
cacheDirectory=".phpunit.cache"
|
||||
>
|
||||
<testsuites>
|
||||
<testsuite name="Unit">
|
||||
<directory suffix="Test.php">tests/Unit</directory>
|
||||
</testsuite>
|
||||
</testsuites>
|
||||
|
||||
<source>
|
||||
<include>
|
||||
<directory suffix=".php">includes</directory>
|
||||
</include>
|
||||
</source>
|
||||
</phpunit>
|
||||
Binary file not shown.
@@ -1 +0,0 @@
|
||||
aec3bae001f0013322a73fa941169688 wc-composable-product-v1.0.0.zip
|
||||
@@ -1 +0,0 @@
|
||||
4a0f7ec2171aeabfdfe155419fd6124f35f3e14501ee2ca324bbab447259a8bb wc-composable-product-v1.0.0.zip
|
||||
Binary file not shown.
@@ -1 +0,0 @@
|
||||
0a60816bbc5a01c0057c1ffa72679d93 releases/wc-composable-product-v1.1.0.zip
|
||||
@@ -1 +0,0 @@
|
||||
645fdd68aca95cba77d961f3a48d41b9c12b3d17552572b7c039575dcfcab693 releases/wc-composable-product-v1.1.0.zip
|
||||
Binary file not shown.
@@ -1 +0,0 @@
|
||||
db09928aea6fffbf9c2e754d2264f2bc wc-composable-product-v1.1.1.zip
|
||||
@@ -1 +0,0 @@
|
||||
761eef69da910ecfdb20ceeed70b5d0381c7cab895e81a040d132cb0f88d749b wc-composable-product-v1.1.1.zip
|
||||
Binary file not shown.
@@ -1 +0,0 @@
|
||||
37cef191778b448dcbd2ae10141f64c6 wc-composable-product-v1.1.2.zip
|
||||
@@ -1 +0,0 @@
|
||||
191eae035b34ce8b33b90cf9d85ed54e493c1b471cda0efe5c992a512e91cc36 wc-composable-product-v1.1.2.zip
|
||||
12
templates/product-selector.twig
Normal file → Executable file
12
templates/product-selector.twig
Normal file → Executable file
@@ -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>
|
||||
|
||||
75
tests/TestCase.php
Normal file
75
tests/TestCase.php
Normal file
@@ -0,0 +1,75 @@
|
||||
<?php
|
||||
/**
|
||||
* Base Test Case
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests;
|
||||
|
||||
use PHPUnit\Framework\TestCase as PHPUnitTestCase;
|
||||
use Mockery\Adapter\Phpunit\MockeryPHPUnitIntegration;
|
||||
use Brain\Monkey;
|
||||
|
||||
/**
|
||||
* Base test case with Brain Monkey and Mockery integration.
|
||||
*
|
||||
* All test classes should extend this instead of PHPUnit\Framework\TestCase.
|
||||
*/
|
||||
abstract class TestCase extends PHPUnitTestCase
|
||||
{
|
||||
use MockeryPHPUnitIntegration;
|
||||
|
||||
protected function setUp(): void
|
||||
{
|
||||
parent::setUp();
|
||||
Monkey\setUp();
|
||||
|
||||
// Stub common WordPress translation functions (__(), _e(), esc_html__(), etc.)
|
||||
Monkey\Functions\stubTranslationFunctions();
|
||||
|
||||
// Stub common WordPress escaping functions (esc_html(), esc_attr(), etc.)
|
||||
Monkey\Functions\stubEscapeFunctions();
|
||||
}
|
||||
|
||||
protected function tearDown(): void
|
||||
{
|
||||
Monkey\tearDown();
|
||||
parent::tearDown();
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a Mockery mock of WC_Product with sensible defaults.
|
||||
*
|
||||
* @param array $overrides Method return value overrides
|
||||
* @return \Mockery\MockInterface
|
||||
*/
|
||||
protected function createProductMock(array $overrides = []): \Mockery\MockInterface
|
||||
{
|
||||
$defaults = [
|
||||
'get_id' => 100,
|
||||
'get_name' => 'Test Product',
|
||||
'get_type' => 'simple',
|
||||
'get_price' => '10.00',
|
||||
'get_regular_price' => '10.00',
|
||||
'get_price_html' => '<span>$10.00</span>',
|
||||
'get_permalink' => 'https://example.com/product/test',
|
||||
'get_image_id' => 1,
|
||||
'get_stock_quantity' => null,
|
||||
'get_stock_status' => 'instock',
|
||||
'is_purchasable' => true,
|
||||
'is_in_stock' => true,
|
||||
'managing_stock' => false,
|
||||
'backorders_allowed' => false,
|
||||
];
|
||||
|
||||
$config = array_merge($defaults, $overrides);
|
||||
$mock = \Mockery::mock('WC_Product');
|
||||
|
||||
foreach ($config as $method => $return) {
|
||||
$mock->shouldReceive($method)->andReturn($return)->byDefault();
|
||||
}
|
||||
|
||||
return $mock;
|
||||
}
|
||||
}
|
||||
108
tests/Unit/Admin/ProductDataTest.php
Normal file
108
tests/Unit/Admin/ProductDataTest.php
Normal file
@@ -0,0 +1,108 @@
|
||||
<?php
|
||||
/**
|
||||
* Admin ProductData Tests
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests\Unit\Admin;
|
||||
|
||||
use Magdev\WcComposableProduct\Tests\TestCase;
|
||||
use Magdev\WcComposableProduct\Admin\ProductData;
|
||||
use Brain\Monkey\Functions;
|
||||
|
||||
class ProductDataTest extends TestCase
|
||||
{
|
||||
protected function setUp(): void
|
||||
{
|
||||
parent::setUp();
|
||||
$_POST = [];
|
||||
}
|
||||
|
||||
protected function tearDown(): void
|
||||
{
|
||||
$_POST = [];
|
||||
parent::tearDown();
|
||||
}
|
||||
|
||||
public function testConstructor_RegistersExpectedHooks(): void
|
||||
{
|
||||
$productData = new ProductData();
|
||||
|
||||
self::assertNotFalse(has_filter('woocommerce_product_data_tabs', 'Magdev\WcComposableProduct\Admin\ProductData->add_product_data_tab()'));
|
||||
self::assertNotFalse(has_action('woocommerce_product_data_panels', 'Magdev\WcComposableProduct\Admin\ProductData->add_product_data_panel()'));
|
||||
self::assertNotFalse(has_action('woocommerce_process_product_meta_composable', 'Magdev\WcComposableProduct\Admin\ProductData->save_product_data()'));
|
||||
self::assertNotFalse(has_action('woocommerce_product_options_general_product_data', 'Magdev\WcComposableProduct\Admin\ProductData->add_general_fields()'));
|
||||
}
|
||||
|
||||
public function testAddProductDataTab_AddsComposableTab(): void
|
||||
{
|
||||
$productData = new ProductData();
|
||||
$tabs = $productData->add_product_data_tab([]);
|
||||
|
||||
$this->assertArrayHasKey('composable', $tabs);
|
||||
$this->assertSame('composable_product_data', $tabs['composable']['target']);
|
||||
$this->assertContains('show_if_composable', $tabs['composable']['class']);
|
||||
$this->assertSame(21, $tabs['composable']['priority']);
|
||||
}
|
||||
|
||||
public function testSaveProductData_SavesAllFields(): void
|
||||
{
|
||||
$_POST = [
|
||||
'_composable_selection_limit' => '5',
|
||||
'_composable_pricing_mode' => 'fixed',
|
||||
'_composable_include_unpublished' => 'yes',
|
||||
'_composable_criteria_type' => 'tag',
|
||||
'_composable_categories' => ['1', '2'],
|
||||
'_composable_tags' => ['3', '4'],
|
||||
'_composable_skus' => 'SKU-1, SKU-2',
|
||||
];
|
||||
|
||||
Functions\expect('absint')->andReturnUsing(function ($val) {
|
||||
return abs((int) $val);
|
||||
});
|
||||
Functions\expect('sanitize_text_field')->andReturnUsing(function ($val) {
|
||||
return $val;
|
||||
});
|
||||
Functions\expect('sanitize_textarea_field')->andReturnUsing(function ($val) {
|
||||
return $val;
|
||||
});
|
||||
|
||||
Functions\expect('update_post_meta')->times(7);
|
||||
|
||||
$productData = new ProductData();
|
||||
$productData->save_product_data(42);
|
||||
}
|
||||
|
||||
public function testSaveProductData_DefaultsWhenPostEmpty(): void
|
||||
{
|
||||
// No POST data at all
|
||||
Functions\expect('absint')->andReturnUsing(function ($val) {
|
||||
return abs((int) $val);
|
||||
});
|
||||
Functions\expect('sanitize_text_field')->andReturnUsing(function ($val) {
|
||||
return $val;
|
||||
});
|
||||
Functions\expect('sanitize_textarea_field')->andReturnUsing(function ($val) {
|
||||
return $val;
|
||||
});
|
||||
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_selection_limit', \Mockery::any())->once();
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_pricing_mode', '')->once();
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_include_unpublished', '')->once();
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_criteria_type', 'category')->once();
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_categories', [])->once();
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_tags', [])->once();
|
||||
Functions\expect('update_post_meta')
|
||||
->with(42, '_composable_skus', '')->once();
|
||||
|
||||
$productData = new ProductData();
|
||||
$productData->save_product_data(42);
|
||||
}
|
||||
}
|
||||
84
tests/Unit/Admin/SettingsTest.php
Normal file
84
tests/Unit/Admin/SettingsTest.php
Normal file
@@ -0,0 +1,84 @@
|
||||
<?php
|
||||
/**
|
||||
* Admin Settings Tests
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests\Unit\Admin;
|
||||
|
||||
use Magdev\WcComposableProduct\Tests\TestCase;
|
||||
use Magdev\WcComposableProduct\Admin\Settings;
|
||||
use Brain\Monkey\Functions;
|
||||
|
||||
class SettingsTest extends TestCase
|
||||
{
|
||||
public function testConstructor_SetsIdAndLabel(): void
|
||||
{
|
||||
$settings = new Settings();
|
||||
|
||||
$this->assertSame('composable_products', $settings->get_id());
|
||||
}
|
||||
|
||||
public function testGetSettings_ReturnsExpectedFieldIds(): void
|
||||
{
|
||||
Functions\expect('apply_filters')
|
||||
->once()
|
||||
->with('wc_composable_settings', \Mockery::type('array'))
|
||||
->andReturnUsing(function ($hook, $settings) {
|
||||
return $settings;
|
||||
});
|
||||
|
||||
$settings = new Settings();
|
||||
$fields = $settings->get_settings();
|
||||
|
||||
// Extract all field IDs
|
||||
$ids = array_column($fields, 'id');
|
||||
|
||||
$this->assertContains('wc_composable_settings', $ids);
|
||||
$this->assertContains('wc_composable_default_limit', $ids);
|
||||
$this->assertContains('wc_composable_default_pricing', $ids);
|
||||
$this->assertContains('wc_composable_include_unpublished', $ids);
|
||||
$this->assertContains('wc_composable_show_images', $ids);
|
||||
$this->assertContains('wc_composable_show_prices', $ids);
|
||||
$this->assertContains('wc_composable_show_total', $ids);
|
||||
}
|
||||
|
||||
public function testGetSettings_HasCorrectFieldTypes(): void
|
||||
{
|
||||
Functions\expect('apply_filters')
|
||||
->once()
|
||||
->andReturnUsing(function ($hook, $settings) {
|
||||
return $settings;
|
||||
});
|
||||
|
||||
$settings = new Settings();
|
||||
$fields = $settings->get_settings();
|
||||
|
||||
// Index fields by ID for easy lookup
|
||||
$indexed = [];
|
||||
foreach ($fields as $field) {
|
||||
if (isset($field['id'])) {
|
||||
$indexed[$field['id']] = $field;
|
||||
}
|
||||
}
|
||||
|
||||
$this->assertSame('number', $indexed['wc_composable_default_limit']['type']);
|
||||
$this->assertSame('select', $indexed['wc_composable_default_pricing']['type']);
|
||||
$this->assertSame('checkbox', $indexed['wc_composable_include_unpublished']['type']);
|
||||
$this->assertSame('checkbox', $indexed['wc_composable_show_images']['type']);
|
||||
}
|
||||
|
||||
public function testGetSettings_AppliesFilter(): void
|
||||
{
|
||||
Functions\expect('apply_filters')
|
||||
->once()
|
||||
->with('wc_composable_settings', \Mockery::type('array'))
|
||||
->andReturnUsing(function ($hook, $settings) {
|
||||
return $settings;
|
||||
});
|
||||
|
||||
$settings = new Settings();
|
||||
$settings->get_settings();
|
||||
}
|
||||
}
|
||||
184
tests/Unit/CartHandlerTest.php
Normal file
184
tests/Unit/CartHandlerTest.php
Normal file
@@ -0,0 +1,184 @@
|
||||
<?php
|
||||
/**
|
||||
* CartHandler Tests
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests\Unit;
|
||||
|
||||
use Magdev\WcComposableProduct\Tests\TestCase;
|
||||
use Magdev\WcComposableProduct\CartHandler;
|
||||
use Brain\Monkey\Functions;
|
||||
use Brain\Monkey\Actions;
|
||||
use Brain\Monkey\Filters;
|
||||
|
||||
class CartHandlerTest extends TestCase
|
||||
{
|
||||
protected function setUp(): void
|
||||
{
|
||||
parent::setUp();
|
||||
|
||||
// Clean up POST superglobal between tests
|
||||
$_POST = [];
|
||||
}
|
||||
|
||||
protected function tearDown(): void
|
||||
{
|
||||
$_POST = [];
|
||||
parent::tearDown();
|
||||
}
|
||||
|
||||
public function testConstructor_RegistersExpectedHooks(): void
|
||||
{
|
||||
$handler = new CartHandler();
|
||||
|
||||
self::assertNotFalse(has_filter('woocommerce_add_to_cart_validation', 'Magdev\WcComposableProduct\CartHandler->validate_add_to_cart()'));
|
||||
self::assertNotFalse(has_filter('woocommerce_add_cart_item_data', 'Magdev\WcComposableProduct\CartHandler->add_cart_item_data()'));
|
||||
self::assertNotFalse(has_filter('woocommerce_get_cart_item_from_session', 'Magdev\WcComposableProduct\CartHandler->get_cart_item_from_session()'));
|
||||
self::assertNotFalse(has_filter('woocommerce_get_item_data', 'Magdev\WcComposableProduct\CartHandler->display_cart_item_data()'));
|
||||
self::assertNotFalse(has_action('woocommerce_before_calculate_totals', 'Magdev\WcComposableProduct\CartHandler->calculate_cart_item_price()'));
|
||||
self::assertNotFalse(has_action('woocommerce_single_product_summary', 'Magdev\WcComposableProduct\CartHandler->render_product_selector()'));
|
||||
self::assertNotFalse(has_filter('woocommerce_is_purchasable', 'Magdev\WcComposableProduct\CartHandler->hide_default_add_to_cart()'));
|
||||
}
|
||||
|
||||
public function testHideDefaultAddToCart_ReturnsFalseForComposable(): void
|
||||
{
|
||||
$handler = new CartHandler();
|
||||
$product = $this->createProductMock(['get_type' => 'composable']);
|
||||
|
||||
$result = $handler->hide_default_add_to_cart(true, $product);
|
||||
$this->assertFalse($result);
|
||||
}
|
||||
|
||||
public function testHideDefaultAddToCart_PassesThroughForSimple(): void
|
||||
{
|
||||
$handler = new CartHandler();
|
||||
$product = $this->createProductMock(['get_type' => 'simple']);
|
||||
|
||||
$result = $handler->hide_default_add_to_cart(true, $product);
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
public function testValidateAddToCart_PassesThroughForNonComposable(): void
|
||||
{
|
||||
$product = $this->createProductMock(['get_type' => 'simple']);
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($product);
|
||||
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->validate_add_to_cart(true, 1, 1);
|
||||
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
public function testValidateAddToCart_ReturnsFalseWhenNoProductsSelected(): void
|
||||
{
|
||||
$product = $this->createProductMock(['get_type' => 'composable']);
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($product);
|
||||
Functions\expect('wc_add_notice')->once();
|
||||
|
||||
$_POST['composable_products'] = [];
|
||||
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->validate_add_to_cart(true, 1, 1);
|
||||
|
||||
$this->assertFalse($result);
|
||||
}
|
||||
|
||||
public function testValidateAddToCart_ReturnsFalseWhenNoPostData(): void
|
||||
{
|
||||
$product = $this->createProductMock(['get_type' => 'composable']);
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($product);
|
||||
Functions\expect('wc_add_notice')->once();
|
||||
|
||||
// No $_POST['composable_products'] at all
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->validate_add_to_cart(true, 1, 1);
|
||||
|
||||
$this->assertFalse($result);
|
||||
}
|
||||
|
||||
public function testAddCartItemData_AddsSelectionsForComposable(): void
|
||||
{
|
||||
$product = $this->createProductMock(['get_type' => 'composable']);
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($product);
|
||||
Functions\expect('absint')->andReturnUsing(function ($val) {
|
||||
return abs((int) $val);
|
||||
});
|
||||
|
||||
$_POST['composable_products'] = ['101', '102'];
|
||||
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->add_cart_item_data([], 1);
|
||||
|
||||
$this->assertArrayHasKey('composable_products', $result);
|
||||
$this->assertSame([101, 102], $result['composable_products']);
|
||||
$this->assertArrayHasKey('unique_key', $result);
|
||||
}
|
||||
|
||||
public function testAddCartItemData_PassesThroughForNonComposable(): void
|
||||
{
|
||||
$product = $this->createProductMock(['get_type' => 'simple']);
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($product);
|
||||
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->add_cart_item_data(['existing' => 'data'], 1);
|
||||
|
||||
$this->assertSame(['existing' => 'data'], $result);
|
||||
}
|
||||
|
||||
public function testGetCartItemFromSession_RestoresComposableProducts(): void
|
||||
{
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->get_cart_item_from_session(
|
||||
['data' => 'test'],
|
||||
['composable_products' => [101, 102]]
|
||||
);
|
||||
|
||||
$this->assertSame([101, 102], $result['composable_products']);
|
||||
}
|
||||
|
||||
public function testGetCartItemFromSession_PassesThroughWithoutComposableData(): void
|
||||
{
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->get_cart_item_from_session(
|
||||
['data' => 'test'],
|
||||
[]
|
||||
);
|
||||
|
||||
$this->assertArrayNotHasKey('composable_products', $result);
|
||||
}
|
||||
|
||||
public function testDisplayCartItemData_FormatsProductNames(): void
|
||||
{
|
||||
$mock1 = $this->createProductMock(['get_name' => 'Product A']);
|
||||
$mock2 = $this->createProductMock(['get_name' => 'Product B']);
|
||||
|
||||
Functions\expect('wc_get_product')
|
||||
->andReturnUsing(function ($id) use ($mock1, $mock2) {
|
||||
return match ($id) {
|
||||
101 => $mock1,
|
||||
102 => $mock2,
|
||||
default => false,
|
||||
};
|
||||
});
|
||||
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->display_cart_item_data(
|
||||
[],
|
||||
['composable_products' => [101, 102]]
|
||||
);
|
||||
|
||||
$this->assertCount(1, $result);
|
||||
$this->assertStringContainsString('Product A', $result[0]['value']);
|
||||
$this->assertStringContainsString('Product B', $result[0]['value']);
|
||||
}
|
||||
|
||||
public function testDisplayCartItemData_ReturnsEmptyForNonComposable(): void
|
||||
{
|
||||
$handler = new CartHandler();
|
||||
$result = $handler->display_cart_item_data([], []);
|
||||
|
||||
$this->assertSame([], $result);
|
||||
}
|
||||
}
|
||||
72
tests/Unit/PluginTest.php
Normal file
72
tests/Unit/PluginTest.php
Normal file
@@ -0,0 +1,72 @@
|
||||
<?php
|
||||
/**
|
||||
* Plugin Tests
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests\Unit;
|
||||
|
||||
use Magdev\WcComposableProduct\Tests\TestCase;
|
||||
use Magdev\WcComposableProduct\Plugin;
|
||||
use Brain\Monkey\Functions;
|
||||
|
||||
class PluginTest extends TestCase
|
||||
{
|
||||
protected function setUp(): void
|
||||
{
|
||||
parent::setUp();
|
||||
|
||||
// Reset the singleton instance between tests
|
||||
$reflection = new \ReflectionClass(Plugin::class);
|
||||
$property = $reflection->getProperty('instance');
|
||||
$property->setAccessible(true);
|
||||
$property->setValue(null, null);
|
||||
}
|
||||
|
||||
public function testInstance_ReturnsSingleton(): void
|
||||
{
|
||||
$instance1 = Plugin::instance();
|
||||
$instance2 = Plugin::instance();
|
||||
|
||||
$this->assertSame($instance1, $instance2);
|
||||
}
|
||||
|
||||
public function testInstance_ReturnsPluginClass(): void
|
||||
{
|
||||
$instance = Plugin::instance();
|
||||
|
||||
$this->assertInstanceOf(Plugin::class, $instance);
|
||||
}
|
||||
|
||||
public function testAddProductType_AddsComposableToTypes(): void
|
||||
{
|
||||
$plugin = Plugin::instance();
|
||||
$types = $plugin->add_product_type([]);
|
||||
|
||||
$this->assertArrayHasKey('composable', $types);
|
||||
}
|
||||
|
||||
public function testProductClass_ReturnsCustomClassForComposable(): void
|
||||
{
|
||||
$plugin = Plugin::instance();
|
||||
$class = $plugin->product_class('WC_Product', 'composable');
|
||||
|
||||
$this->assertSame('Magdev\WcComposableProduct\ProductType', $class);
|
||||
}
|
||||
|
||||
public function testProductClass_PassesThroughForOtherTypes(): void
|
||||
{
|
||||
$plugin = Plugin::instance();
|
||||
$class = $plugin->product_class('WC_Product', 'simple');
|
||||
|
||||
$this->assertSame('WC_Product', $class);
|
||||
}
|
||||
|
||||
public function testGetTwig_ReturnsTwigEnvironment(): void
|
||||
{
|
||||
$plugin = Plugin::instance();
|
||||
|
||||
$this->assertInstanceOf(\Twig\Environment::class, $plugin->get_twig());
|
||||
}
|
||||
}
|
||||
218
tests/Unit/ProductTypeTest.php
Normal file
218
tests/Unit/ProductTypeTest.php
Normal file
@@ -0,0 +1,218 @@
|
||||
<?php
|
||||
/**
|
||||
* ProductType Tests
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests\Unit;
|
||||
|
||||
use Magdev\WcComposableProduct\Tests\TestCase;
|
||||
use Magdev\WcComposableProduct\ProductType;
|
||||
use Brain\Monkey\Functions;
|
||||
|
||||
class ProductTypeTest extends TestCase
|
||||
{
|
||||
private function createProductType(array $meta = []): ProductType
|
||||
{
|
||||
$product = new ProductType();
|
||||
foreach ($meta as $key => $value) {
|
||||
$product->update_meta_data($key, $value);
|
||||
}
|
||||
return $product;
|
||||
}
|
||||
|
||||
public function testGetType_ReturnsComposable(): void
|
||||
{
|
||||
$product = $this->createProductType();
|
||||
$this->assertSame('composable', $product->get_type());
|
||||
}
|
||||
|
||||
public function testIsPurchasable_ReturnsTrue(): void
|
||||
{
|
||||
$product = $this->createProductType();
|
||||
$this->assertTrue($product->is_purchasable());
|
||||
}
|
||||
|
||||
public function testIsSoldIndividually_ReturnsTrue(): void
|
||||
{
|
||||
$product = $this->createProductType();
|
||||
$this->assertTrue($product->is_sold_individually());
|
||||
}
|
||||
|
||||
public function testGetSelectionLimit_UsesProductMeta(): void
|
||||
{
|
||||
Functions\expect('absint')->once()->andReturnUsing(function ($val) {
|
||||
return abs((int) $val);
|
||||
});
|
||||
|
||||
$product = $this->createProductType(['_composable_selection_limit' => '3']);
|
||||
$this->assertSame(3, $product->get_selection_limit());
|
||||
}
|
||||
|
||||
public function testGetSelectionLimit_FallsBackToGlobalDefault(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->once()
|
||||
->with('wc_composable_default_limit', 5)
|
||||
->andReturn(7);
|
||||
|
||||
Functions\expect('absint')->once()->andReturnUsing(function ($val) {
|
||||
return abs((int) $val);
|
||||
});
|
||||
|
||||
$product = $this->createProductType();
|
||||
$this->assertSame(7, $product->get_selection_limit());
|
||||
}
|
||||
|
||||
public function testGetSelectionLimit_FallsBackToHardDefault(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->once()
|
||||
->with('wc_composable_default_limit', 5)
|
||||
->andReturn(5);
|
||||
|
||||
Functions\expect('absint')->once()->andReturnUsing(function ($val) {
|
||||
return abs((int) $val);
|
||||
});
|
||||
|
||||
$product = $this->createProductType();
|
||||
$this->assertSame(5, $product->get_selection_limit());
|
||||
}
|
||||
|
||||
public function testGetPricingMode_UsesProductMeta(): void
|
||||
{
|
||||
$product = $this->createProductType(['_composable_pricing_mode' => 'fixed']);
|
||||
$this->assertSame('fixed', $product->get_pricing_mode());
|
||||
}
|
||||
|
||||
public function testGetPricingMode_FallsBackToGlobalDefault(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->once()
|
||||
->with('wc_composable_default_pricing', 'sum')
|
||||
->andReturn('sum');
|
||||
|
||||
$product = $this->createProductType();
|
||||
$this->assertSame('sum', $product->get_pricing_mode());
|
||||
}
|
||||
|
||||
public function testShouldIncludeUnpublished_PerProductYes(): void
|
||||
{
|
||||
$product = $this->createProductType(['_composable_include_unpublished' => 'yes']);
|
||||
$this->assertTrue($product->should_include_unpublished());
|
||||
}
|
||||
|
||||
public function testShouldIncludeUnpublished_PerProductNo(): void
|
||||
{
|
||||
$product = $this->createProductType(['_composable_include_unpublished' => 'no']);
|
||||
$this->assertFalse($product->should_include_unpublished());
|
||||
}
|
||||
|
||||
public function testShouldIncludeUnpublished_FallsBackToGlobalYes(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->once()
|
||||
->with('wc_composable_include_unpublished', 'no')
|
||||
->andReturn('yes');
|
||||
|
||||
$product = $this->createProductType();
|
||||
$this->assertTrue($product->should_include_unpublished());
|
||||
}
|
||||
|
||||
public function testShouldIncludeUnpublished_FallsBackToGlobalNo(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->once()
|
||||
->with('wc_composable_include_unpublished', 'no')
|
||||
->andReturn('no');
|
||||
|
||||
$product = $this->createProductType();
|
||||
$this->assertFalse($product->should_include_unpublished());
|
||||
}
|
||||
|
||||
public function testGetSelectionCriteria_DefaultsToCategory(): void
|
||||
{
|
||||
$product = $this->createProductType();
|
||||
$criteria = $product->get_selection_criteria();
|
||||
|
||||
$this->assertSame('category', $criteria['type']);
|
||||
$this->assertSame([], $criteria['categories']);
|
||||
$this->assertSame([], $criteria['tags']);
|
||||
$this->assertSame('', $criteria['skus']);
|
||||
}
|
||||
|
||||
public function testGetSelectionCriteria_UsesProductMeta(): void
|
||||
{
|
||||
$product = $this->createProductType([
|
||||
'_composable_criteria_type' => 'tag',
|
||||
'_composable_tags' => [5, 10],
|
||||
]);
|
||||
$criteria = $product->get_selection_criteria();
|
||||
|
||||
$this->assertSame('tag', $criteria['type']);
|
||||
$this->assertSame([5, 10], $criteria['tags']);
|
||||
}
|
||||
|
||||
public function testCalculateComposedPrice_FixedMode(): void
|
||||
{
|
||||
$product = $this->createProductType(['_composable_pricing_mode' => 'fixed']);
|
||||
|
||||
// Set regular price via the stub's data property
|
||||
$reflection = new \ReflectionClass($product);
|
||||
$dataProp = $reflection->getProperty('data');
|
||||
$dataProp->setAccessible(true);
|
||||
$data = $dataProp->getValue($product);
|
||||
$data['regular_price'] = '25.00';
|
||||
$dataProp->setValue($product, $data);
|
||||
|
||||
$price = $product->calculate_composed_price([101, 102]);
|
||||
$this->assertSame(25.0, $price);
|
||||
}
|
||||
|
||||
public function testCalculateComposedPrice_SumMode(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->with('wc_composable_default_pricing', 'sum')
|
||||
->andReturn('sum');
|
||||
|
||||
$mock1 = $this->createProductMock(['get_price' => '5.00']);
|
||||
$mock2 = $this->createProductMock(['get_price' => '7.50']);
|
||||
|
||||
Functions\expect('wc_get_product')
|
||||
->andReturnUsing(function ($id) use ($mock1, $mock2) {
|
||||
return match ($id) {
|
||||
101 => $mock1,
|
||||
102 => $mock2,
|
||||
default => false,
|
||||
};
|
||||
});
|
||||
|
||||
$product = $this->createProductType();
|
||||
$price = $product->calculate_composed_price([101, 102]);
|
||||
|
||||
$this->assertSame(12.5, $price);
|
||||
}
|
||||
|
||||
public function testCalculateComposedPrice_SumMode_SkipsInvalidProducts(): void
|
||||
{
|
||||
Functions\expect('get_option')
|
||||
->with('wc_composable_default_pricing', 'sum')
|
||||
->andReturn('sum');
|
||||
|
||||
$mock1 = $this->createProductMock(['get_price' => '5.00']);
|
||||
|
||||
Functions\expect('wc_get_product')
|
||||
->andReturnUsing(function ($id) use ($mock1) {
|
||||
return match ($id) {
|
||||
101 => $mock1,
|
||||
default => false,
|
||||
};
|
||||
});
|
||||
|
||||
$product = $this->createProductType();
|
||||
$price = $product->calculate_composed_price([101, 999]);
|
||||
|
||||
$this->assertSame(5.0, $price);
|
||||
}
|
||||
}
|
||||
226
tests/Unit/StockManagerTest.php
Normal file
226
tests/Unit/StockManagerTest.php
Normal file
@@ -0,0 +1,226 @@
|
||||
<?php
|
||||
/**
|
||||
* StockManager Tests
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
namespace Magdev\WcComposableProduct\Tests\Unit;
|
||||
|
||||
use Magdev\WcComposableProduct\Tests\TestCase;
|
||||
use Magdev\WcComposableProduct\StockManager;
|
||||
use Brain\Monkey\Functions;
|
||||
|
||||
class StockManagerTest extends TestCase
|
||||
{
|
||||
private StockManager $manager;
|
||||
|
||||
protected function setUp(): void
|
||||
{
|
||||
parent::setUp();
|
||||
$this->manager = new StockManager();
|
||||
}
|
||||
|
||||
// --- validate_stock_availability ---
|
||||
|
||||
public function testValidateStock_ReturnsTrueWhenAllInStock(): void
|
||||
{
|
||||
$mock = $this->createProductMock([
|
||||
'managing_stock' => false,
|
||||
'is_in_stock' => true,
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
Functions\expect('wc_get_product')->with(2)->andReturn($mock);
|
||||
|
||||
$result = $this->manager->validate_stock_availability([1, 2]);
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
public function testValidateStock_ReturnsTrueWhenNotManagingStock(): void
|
||||
{
|
||||
$mock = $this->createProductMock(['managing_stock' => false]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$result = $this->manager->validate_stock_availability([1]);
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
public function testValidateStock_ReturnsErrorForOutOfStock(): void
|
||||
{
|
||||
$mock = $this->createProductMock([
|
||||
'managing_stock' => true,
|
||||
'is_in_stock' => false,
|
||||
'get_name' => 'Widget',
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$result = $this->manager->validate_stock_availability([1]);
|
||||
$this->assertIsString($result);
|
||||
$this->assertStringContainsString('Widget', $result);
|
||||
}
|
||||
|
||||
public function testValidateStock_ReturnsErrorForInsufficientQuantity(): void
|
||||
{
|
||||
$mock = $this->createProductMock([
|
||||
'managing_stock' => true,
|
||||
'is_in_stock' => true,
|
||||
'get_stock_quantity' => 1,
|
||||
'get_name' => 'Widget',
|
||||
'backorders_allowed' => false,
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$result = $this->manager->validate_stock_availability([1], 5);
|
||||
$this->assertIsString($result);
|
||||
$this->assertStringContainsString('Widget', $result);
|
||||
}
|
||||
|
||||
public function testValidateStock_PassesWhenBackordersAllowed(): void
|
||||
{
|
||||
// When stock_quantity is null the insufficient-stock check is skipped,
|
||||
// and the backorders_allowed() branch is reached.
|
||||
$mock = $this->createProductMock([
|
||||
'managing_stock' => true,
|
||||
'is_in_stock' => true,
|
||||
'get_stock_quantity' => null,
|
||||
'backorders_allowed' => true,
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$result = $this->manager->validate_stock_availability([1], 5);
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
public function testValidateStock_SkipsNullProducts(): void
|
||||
{
|
||||
Functions\expect('wc_get_product')->with(999)->andReturn(false);
|
||||
|
||||
$result = $this->manager->validate_stock_availability([999]);
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
// --- get_product_stock_info ---
|
||||
|
||||
public function testGetProductStockInfo_ReturnsCorrectStructure(): void
|
||||
{
|
||||
$mock = $this->createProductMock([
|
||||
'is_in_stock' => true,
|
||||
'get_stock_quantity' => 10,
|
||||
'backorders_allowed' => false,
|
||||
'get_stock_status' => 'instock',
|
||||
'managing_stock' => true,
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$info = $this->manager->get_product_stock_info(1);
|
||||
|
||||
$this->assertTrue($info['in_stock']);
|
||||
$this->assertSame(10, $info['stock_quantity']);
|
||||
$this->assertFalse($info['backorders_allowed']);
|
||||
$this->assertSame('instock', $info['stock_status']);
|
||||
$this->assertTrue($info['managing_stock']);
|
||||
$this->assertTrue($info['has_enough_stock']);
|
||||
}
|
||||
|
||||
public function testGetProductStockInfo_ReturnsFallbackForInvalidProduct(): void
|
||||
{
|
||||
Functions\expect('wc_get_product')->with(999)->andReturn(false);
|
||||
|
||||
$info = $this->manager->get_product_stock_info(999);
|
||||
|
||||
$this->assertFalse($info['in_stock']);
|
||||
$this->assertSame(0, $info['stock_quantity']);
|
||||
$this->assertFalse($info['backorders_allowed']);
|
||||
$this->assertSame('outofstock', $info['stock_status']);
|
||||
}
|
||||
|
||||
public function testGetProductStockInfo_HasEnoughStockTrueWhenNotManaging(): void
|
||||
{
|
||||
$mock = $this->createProductMock([
|
||||
'managing_stock' => false,
|
||||
'get_stock_quantity' => null,
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$info = $this->manager->get_product_stock_info(1, 100);
|
||||
$this->assertTrue($info['has_enough_stock']);
|
||||
}
|
||||
|
||||
public function testGetProductStockInfo_HasEnoughStockFalseWhenInsufficient(): void
|
||||
{
|
||||
$mock = $this->createProductMock([
|
||||
'managing_stock' => true,
|
||||
'get_stock_quantity' => 2,
|
||||
]);
|
||||
|
||||
Functions\expect('wc_get_product')->with(1)->andReturn($mock);
|
||||
|
||||
$info = $this->manager->get_product_stock_info(1, 5);
|
||||
$this->assertFalse($info['has_enough_stock']);
|
||||
}
|
||||
|
||||
// --- prevent_composable_stock_reduction ---
|
||||
|
||||
public function testPreventStockReduction_ReturnsFalseForComposableItem(): void
|
||||
{
|
||||
$productMock = $this->createProductMock(['get_type' => 'composable']);
|
||||
|
||||
$itemMock = \Mockery::mock('WC_Order_Item_Product');
|
||||
$itemMock->shouldReceive('get_product')->andReturn($productMock);
|
||||
|
||||
$orderMock = \Mockery::mock('WC_Order');
|
||||
$orderMock->shouldReceive('get_items')->andReturn([$itemMock]);
|
||||
|
||||
$result = $this->manager->prevent_composable_stock_reduction(true, $orderMock);
|
||||
$this->assertFalse($result);
|
||||
}
|
||||
|
||||
public function testPreventStockReduction_PassesThroughForNonComposable(): void
|
||||
{
|
||||
$productMock = $this->createProductMock(['get_type' => 'simple']);
|
||||
|
||||
$itemMock = \Mockery::mock('WC_Order_Item_Product');
|
||||
$itemMock->shouldReceive('get_product')->andReturn($productMock);
|
||||
|
||||
$orderMock = \Mockery::mock('WC_Order');
|
||||
$orderMock->shouldReceive('get_items')->andReturn([$itemMock]);
|
||||
|
||||
$result = $this->manager->prevent_composable_stock_reduction(true, $orderMock);
|
||||
$this->assertTrue($result);
|
||||
}
|
||||
|
||||
// --- store_selected_products_in_order ---
|
||||
|
||||
public function testStoreSelectedProducts_AddsMetaWhenPresent(): void
|
||||
{
|
||||
$itemMock = \Mockery::mock('WC_Order_Item_Product');
|
||||
$itemMock->shouldReceive('add_meta_data')
|
||||
->once()
|
||||
->with('_composable_products', [1, 2], true);
|
||||
|
||||
$this->manager->store_selected_products_in_order(
|
||||
$itemMock,
|
||||
'cart_key',
|
||||
['composable_products' => [1, 2]]
|
||||
);
|
||||
}
|
||||
|
||||
public function testStoreSelectedProducts_DoesNothingWithoutData(): void
|
||||
{
|
||||
$itemMock = \Mockery::mock('WC_Order_Item_Product');
|
||||
$itemMock->shouldNotReceive('add_meta_data');
|
||||
|
||||
$this->manager->store_selected_products_in_order(
|
||||
$itemMock,
|
||||
'cart_key',
|
||||
[]
|
||||
);
|
||||
}
|
||||
}
|
||||
33
tests/bootstrap.php
Normal file
33
tests/bootstrap.php
Normal file
@@ -0,0 +1,33 @@
|
||||
<?php
|
||||
/**
|
||||
* PHPUnit Bootstrap
|
||||
*
|
||||
* Sets up WooCommerce stubs, plugin constants, and the Composer autoloader
|
||||
* for running unit tests without a full WordPress installation.
|
||||
*
|
||||
* @package Magdev\WcComposableProduct\Tests
|
||||
*/
|
||||
|
||||
// Composer autoloader (loads Brain Monkey, Mockery, plugin classes)
|
||||
require_once dirname(__DIR__) . '/vendor/autoload.php';
|
||||
|
||||
// Define WordPress constants that the plugin expects
|
||||
defined('ABSPATH') || define('ABSPATH', '/tmp/wordpress/');
|
||||
defined('WP_DEBUG') || define('WP_DEBUG', true);
|
||||
defined('DOING_AJAX') || define('DOING_AJAX', false);
|
||||
|
||||
// Define plugin constants
|
||||
defined('WC_COMPOSABLE_PRODUCT_VERSION') || define('WC_COMPOSABLE_PRODUCT_VERSION', '1.3.1');
|
||||
defined('WC_COMPOSABLE_PRODUCT_FILE') || define('WC_COMPOSABLE_PRODUCT_FILE', dirname(__DIR__) . '/wc-composable-product.php');
|
||||
defined('WC_COMPOSABLE_PRODUCT_PATH') || define('WC_COMPOSABLE_PRODUCT_PATH', dirname(__DIR__) . '/');
|
||||
defined('WC_COMPOSABLE_PRODUCT_URL') || define('WC_COMPOSABLE_PRODUCT_URL', 'https://example.com/wp-content/plugins/wc-composable-product/');
|
||||
defined('WC_COMPOSABLE_PRODUCT_BASENAME') || define('WC_COMPOSABLE_PRODUCT_BASENAME', 'wc-composable-product/wc-composable-product.php');
|
||||
|
||||
// Load WooCommerce class stubs (parent before child)
|
||||
require_once __DIR__ . '/stubs/class-wc-data.php';
|
||||
require_once __DIR__ . '/stubs/class-wc-product.php';
|
||||
require_once __DIR__ . '/stubs/class-wc-settings-page.php';
|
||||
require_once __DIR__ . '/stubs/class-wc-order.php';
|
||||
require_once __DIR__ . '/stubs/class-wc-order-item-product.php';
|
||||
require_once __DIR__ . '/stubs/class-wc-cart.php';
|
||||
require_once __DIR__ . '/stubs/class-wc-admin-settings.php';
|
||||
11
tests/stubs/class-wc-admin-settings.php
Normal file
11
tests/stubs/class-wc-admin-settings.php
Normal file
@@ -0,0 +1,11 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Admin_Settings stub for unit testing.
|
||||
*/
|
||||
class WC_Admin_Settings {
|
||||
public static function output_fields($options) {
|
||||
}
|
||||
|
||||
public static function save_fields($options) {
|
||||
}
|
||||
}
|
||||
15
tests/stubs/class-wc-cart.php
Normal file
15
tests/stubs/class-wc-cart.php
Normal file
@@ -0,0 +1,15 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Cart stub for unit testing.
|
||||
*/
|
||||
class WC_Cart {
|
||||
protected $cart_contents = [];
|
||||
|
||||
public function get_cart() {
|
||||
return $this->cart_contents;
|
||||
}
|
||||
|
||||
public function set_cart_contents($contents) {
|
||||
$this->cart_contents = $contents;
|
||||
}
|
||||
}
|
||||
35
tests/stubs/class-wc-data.php
Normal file
35
tests/stubs/class-wc-data.php
Normal file
@@ -0,0 +1,35 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Data stub for unit testing.
|
||||
*/
|
||||
class WC_Data {
|
||||
protected $id = 0;
|
||||
protected $data = [];
|
||||
protected $meta_data = [];
|
||||
|
||||
public function __construct($id = 0) {
|
||||
if (is_numeric($id) && $id > 0) {
|
||||
$this->id = (int) $id;
|
||||
}
|
||||
}
|
||||
|
||||
public function get_id() {
|
||||
return $this->id;
|
||||
}
|
||||
|
||||
public function set_id($id) {
|
||||
$this->id = (int) $id;
|
||||
}
|
||||
|
||||
public function get_meta($key, $single = true, $context = 'view') {
|
||||
return $this->meta_data[$key] ?? ($single ? '' : []);
|
||||
}
|
||||
|
||||
public function update_meta_data($key, $value, $meta_id = 0) {
|
||||
$this->meta_data[$key] = $value;
|
||||
}
|
||||
|
||||
public function save() {
|
||||
return $this->get_id();
|
||||
}
|
||||
}
|
||||
28
tests/stubs/class-wc-order-item-product.php
Normal file
28
tests/stubs/class-wc-order-item-product.php
Normal file
@@ -0,0 +1,28 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Order_Item_Product stub for unit testing.
|
||||
*/
|
||||
class WC_Order_Item_Product extends WC_Data {
|
||||
protected $product = null;
|
||||
protected $quantity = 1;
|
||||
|
||||
public function get_product() {
|
||||
return $this->product;
|
||||
}
|
||||
|
||||
public function set_product($product) {
|
||||
$this->product = $product;
|
||||
}
|
||||
|
||||
public function get_quantity() {
|
||||
return $this->quantity;
|
||||
}
|
||||
|
||||
public function set_quantity($quantity) {
|
||||
$this->quantity = $quantity;
|
||||
}
|
||||
|
||||
public function add_meta_data($key, $value, $unique = false) {
|
||||
$this->meta_data[$key] = $value;
|
||||
}
|
||||
}
|
||||
24
tests/stubs/class-wc-order.php
Normal file
24
tests/stubs/class-wc-order.php
Normal file
@@ -0,0 +1,24 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Order stub for unit testing.
|
||||
*/
|
||||
class WC_Order extends WC_Data {
|
||||
protected $items = [];
|
||||
protected $order_notes = [];
|
||||
|
||||
public function get_items($type = '') {
|
||||
return $this->items;
|
||||
}
|
||||
|
||||
public function set_items($items) {
|
||||
$this->items = $items;
|
||||
}
|
||||
|
||||
public function add_order_note($note) {
|
||||
$this->order_notes[] = $note;
|
||||
}
|
||||
|
||||
public function get_order_notes() {
|
||||
return $this->order_notes;
|
||||
}
|
||||
}
|
||||
88
tests/stubs/class-wc-product.php
Normal file
88
tests/stubs/class-wc-product.php
Normal file
@@ -0,0 +1,88 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Product stub for unit testing.
|
||||
*/
|
||||
class WC_Product extends WC_Data {
|
||||
protected $supports = [];
|
||||
protected $data = [
|
||||
'name' => '',
|
||||
'price' => '',
|
||||
'regular_price' => '',
|
||||
'status' => 'publish',
|
||||
];
|
||||
|
||||
public function get_type() {
|
||||
return 'simple';
|
||||
}
|
||||
|
||||
public function get_name($context = 'view') {
|
||||
return $this->data['name'] ?? '';
|
||||
}
|
||||
|
||||
public function get_price($context = 'view') {
|
||||
return $this->data['price'] ?? '';
|
||||
}
|
||||
|
||||
public function get_regular_price($context = 'view') {
|
||||
return $this->data['regular_price'] ?? '';
|
||||
}
|
||||
|
||||
public function get_price_html() {
|
||||
return '';
|
||||
}
|
||||
|
||||
public function get_permalink() {
|
||||
return '';
|
||||
}
|
||||
|
||||
public function get_image_id($context = 'view') {
|
||||
return 0;
|
||||
}
|
||||
|
||||
public function get_stock_quantity($context = 'view') {
|
||||
return null;
|
||||
}
|
||||
|
||||
public function get_stock_status($context = 'view') {
|
||||
return 'instock';
|
||||
}
|
||||
|
||||
public function get_children() {
|
||||
return [];
|
||||
}
|
||||
|
||||
public function is_type($type) {
|
||||
return $this->get_type() === $type;
|
||||
}
|
||||
|
||||
public function is_purchasable() {
|
||||
return true;
|
||||
}
|
||||
|
||||
public function is_in_stock() {
|
||||
return true;
|
||||
}
|
||||
|
||||
public function managing_stock() {
|
||||
return false;
|
||||
}
|
||||
|
||||
public function backorders_allowed() {
|
||||
return false;
|
||||
}
|
||||
|
||||
public function is_sold_individually() {
|
||||
return false;
|
||||
}
|
||||
|
||||
public function set_price($price) {
|
||||
$this->data['price'] = $price;
|
||||
}
|
||||
|
||||
public function set_stock_quantity($quantity) {
|
||||
}
|
||||
|
||||
public function supports($feature) {
|
||||
return in_array($feature, $this->supports, true);
|
||||
}
|
||||
}
|
||||
29
tests/stubs/class-wc-settings-page.php
Normal file
29
tests/stubs/class-wc-settings-page.php
Normal file
@@ -0,0 +1,29 @@
|
||||
<?php
|
||||
/**
|
||||
* Minimal WC_Settings_Page stub for unit testing.
|
||||
*/
|
||||
class WC_Settings_Page {
|
||||
protected $id = '';
|
||||
protected $label = '';
|
||||
|
||||
public function __construct() {
|
||||
}
|
||||
|
||||
public function get_id() {
|
||||
return $this->id;
|
||||
}
|
||||
|
||||
public function get_label() {
|
||||
return $this->label;
|
||||
}
|
||||
|
||||
public function get_settings() {
|
||||
return [];
|
||||
}
|
||||
|
||||
public function output() {
|
||||
}
|
||||
|
||||
public function save() {
|
||||
}
|
||||
}
|
||||
@@ -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.3
|
||||
* Version: 1.3.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
|
||||
@@ -16,17 +17,17 @@
|
||||
* WC tested up to: 10.0
|
||||
*/
|
||||
|
||||
defined('ABSPATH') || exit;
|
||||
defined( 'ABSPATH' ) || exit;
|
||||
|
||||
// Define plugin constants
|
||||
define('WC_COMPOSABLE_PRODUCT_VERSION', '1.1.3');
|
||||
define('WC_COMPOSABLE_PRODUCT_FILE', __FILE__);
|
||||
define('WC_COMPOSABLE_PRODUCT_PATH', plugin_dir_path(__FILE__));
|
||||
define('WC_COMPOSABLE_PRODUCT_URL', plugin_dir_url(__FILE__));
|
||||
define('WC_COMPOSABLE_PRODUCT_BASENAME', plugin_basename(__FILE__));
|
||||
define( 'WC_COMPOSABLE_PRODUCT_VERSION', '1.3.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__ ) );
|
||||
define( 'WC_COMPOSABLE_PRODUCT_BASENAME', plugin_basename( __FILE__ ) );
|
||||
|
||||
// Load Composer autoloader
|
||||
if (file_exists(WC_COMPOSABLE_PRODUCT_PATH . 'vendor/autoload.php')) {
|
||||
if ( file_exists( WC_COMPOSABLE_PRODUCT_PATH . 'vendor/autoload.php' ) ) {
|
||||
require_once WC_COMPOSABLE_PRODUCT_PATH . 'vendor/autoload.php';
|
||||
}
|
||||
|
||||
@@ -34,14 +35,17 @@ if (file_exists(WC_COMPOSABLE_PRODUCT_PATH . 'vendor/autoload.php')) {
|
||||
* Check if WooCommerce is active
|
||||
*/
|
||||
function wc_composable_product_check_woocommerce() {
|
||||
if (!class_exists('WooCommerce')) {
|
||||
add_action('admin_notices', function() {
|
||||
if ( ! class_exists( 'WooCommerce' ) ) {
|
||||
add_action(
|
||||
'admin_notices',
|
||||
function () {
|
||||
?>
|
||||
<div class="notice notice-error">
|
||||
<p><?php esc_html_e('WooCommerce Composable Products requires WooCommerce to be installed and active.', 'wc-composable-product'); ?></p>
|
||||
<p><?php esc_html_e( 'WooCommerce Composable Products requires WooCommerce to be installed and active.', 'wc-composable-product' ); ?></p>
|
||||
</div>
|
||||
<?php
|
||||
});
|
||||
}
|
||||
);
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
@@ -51,39 +55,42 @@ function wc_composable_product_check_woocommerce() {
|
||||
* Initialize the plugin
|
||||
*/
|
||||
function wc_composable_product_init() {
|
||||
if (!wc_composable_product_check_woocommerce()) {
|
||||
if ( ! wc_composable_product_check_woocommerce() ) {
|
||||
return;
|
||||
}
|
||||
|
||||
// Load text domain
|
||||
load_plugin_textdomain('wc-composable-product', false, dirname(WC_COMPOSABLE_PRODUCT_BASENAME) . '/languages');
|
||||
load_plugin_textdomain( 'wc-composable-product', false, dirname( WC_COMPOSABLE_PRODUCT_BASENAME ) . '/languages' );
|
||||
|
||||
// Initialize main plugin class
|
||||
WC_Composable_Product\Plugin::instance();
|
||||
Magdev\WcComposableProduct\Plugin::instance();
|
||||
}
|
||||
// Use woocommerce_init to ensure all WooCommerce classes including settings are loaded
|
||||
add_action('woocommerce_init', 'wc_composable_product_init');
|
||||
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);
|
||||
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
|
||||
*/
|
||||
function wc_composable_product_activate() {
|
||||
if (!class_exists('WooCommerce')) {
|
||||
deactivate_plugins(WC_COMPOSABLE_PRODUCT_BASENAME);
|
||||
if ( ! class_exists( 'WooCommerce' ) ) {
|
||||
deactivate_plugins( WC_COMPOSABLE_PRODUCT_BASENAME );
|
||||
wp_die(
|
||||
esc_html__('This plugin requires WooCommerce to be installed and active.', 'wc-composable-product'),
|
||||
esc_html__('Plugin Activation Error', 'wc-composable-product'),
|
||||
array('back_link' => true)
|
||||
esc_html__( 'This plugin requires WooCommerce to be installed and active.', 'wc-composable-product' ),
|
||||
esc_html__( 'Plugin Activation Error', 'wc-composable-product' ),
|
||||
array( 'back_link' => true )
|
||||
);
|
||||
}
|
||||
}
|
||||
register_activation_hook(__FILE__, 'wc_composable_product_activate');
|
||||
register_activation_hook( __FILE__, 'wc_composable_product_activate' );
|
||||
|
||||
Reference in New Issue
Block a user