21 Commits

Author SHA1 Message Date
d721ab123a Release version 1.1.20 - Fix WooCommerce Blocks fatal error
## Fixed
- Fatal error in WooCommerce Blocks: "Cannot use object of type WC_Product_Simple as array"
- Error occurred in class-wc-tpp-cart.php:233 in block_quantity_editable() method

## Technical Details
- Filter woocommerce_store_api_product_quantity_editable passes WC_Product object as second parameter, not cart item array
- Updated method signature from block_quantity_editable($editable, $cart_item) to block_quantity_editable($editable, $product)
- Changed parameter access from $cart_item['id'] to $product->get_id()
- Added proper product object validation with is_a($product, 'WC_Product')

## Added
- CLAUDE.md - Comprehensive AI context document for future development
- Complete project architecture documentation
- Historical bug context and solutions
- Development guidelines and testing checklists

## Release
- Version bumped to 1.1.20
- Release package created with MD5 and SHA256 checksums

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-23 00:17:01 +01:00
dfe1a4364a added new packages, now it works! 2025-12-22 23:41:31 +01:00
9b7638a7e2 Release version 1.1.19 - Enhanced duplicate detection
Fixed persistent duplicate settings page by improving duplicate detection
to check by class type and ID instead of strict instance comparison.

Issue:
- Strict instance comparison (===) failed to detect duplicates
- Different object instances of same class not caught by previous check
- Settings page still appearing twice despite singleton and instance caching

Solution:
- Changed duplicate detection from instance comparison to type/ID checks
- Added instanceof WC_TPP_Settings check
- Added get_id() method check for ID 'tier_package_prices'
- Added direct id property check as fallback
- Multiple layers of detection to catch duplicates regardless of how created

Fixes:
- Settings page rendering twice in WooCommerce backend
- Duplicate detection failing for different instances of same class

Changes:
- Enhanced add_settings_page() with multi-layer duplicate detection
- Checks: instanceof, get_id(), and id property
- Returns early if any existing page matches criteria

Technical Details:
- Strict comparison only works if exact same object instance
- Different instances (even of same class/ID) fail === check
- instanceof checks class type regardless of which instance
- ID checks ensure no duplicate pages with same identifier
- Fallback checks handle different WooCommerce versions/implementations

Updated Files:
- includes/class-wc-tpp-admin.php (enhanced duplicate detection)
- wc-tier-and-package-prices.php (version 1.1.19)
- composer.json (version 1.1.19)
- CHANGELOG.md (v1.1.19 section)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 23:33:12 +01:00
db9ba2bacd Release version 1.1.18 - Fix root cause of duplicate settings
Identified and fixed the actual root cause of duplicate settings page:
automatic instantiation in settings file being executed multiple times.

Root Cause Analysis:
- Settings file ended with: return new WC_TPP_Settings();
- File is in Composer's classmap for autoloading
- When autoloader loads class, it executes the entire file including instantiation
- Each include/autoload created a NEW instance despite admin singleton pattern
- Admin singleton prevented multiple admin instances but not multiple settings instances

The Fix:
- Removed automatic instantiation (return new) from settings file
- Settings file now only contains class definition
- Admin class explicitly creates instance: new WC_TPP_Settings()
- Changed from include to require_once to prevent multiple file loads
- Settings instance now created exactly once, when filter needs it

Fixes:
- Settings page rendering twice in WooCommerce backend
- Multiple WC_TPP_Settings instances being created
- Composer autoload triggering unintended instantiation

Changes:
- Removed line 145 from class-wc-tpp-settings.php (return new WC_TPP_Settings())
- Modified add_settings_page() to use require_once + explicit new
- Settings file now side-effect free, safe for autoloading

Technical Details:
- Composer classmap autoloader includes files when class is referenced
- Previous code had side effect (instantiation) on every include
- New code separates class definition from instantiation
- Instance creation now controlled explicitly by admin class
- require_once ensures file loaded once even if accessed multiple times

Updated Files:
- includes/class-wc-tpp-settings.php (removed return new line)
- includes/class-wc-tpp-admin.php (explicit instantiation)
- wc-tier-and-package-prices.php (version 1.1.18)
- composer.json (version 1.1.18)
- CHANGELOG.md (v1.1.18 section)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 23:29:35 +01:00
e46372da51 Release version 1.1.17 - Array duplicate prevention
Fixed persistent duplicate settings page by adding array-level duplicate
detection in addition to singleton pattern from v1.1.16.

Root Cause:
- WooCommerce calls woocommerce_get_settings_pages filter multiple times
- Even with singleton pattern, each filter call added settings instance to array
- Singleton prevented multiple class instances but not multiple array entries

Fixes:
- Settings page rendering twice despite singleton pattern in v1.1.16
- Filter adding same settings instance to array on repeated calls

Changes:
- Added duplicate detection loop in add_settings_page() before array append
- Uses strict comparison (===) to check if instance already in array
- Returns early if settings page already present, preventing duplicate

Technical Details:
- foreach loop iterates through existing $settings array
- Compares each element against cached self::$settings_instance
- Only appends to array if instance not found
- Complements singleton pattern with array-level protection
- Handles WooCommerce calling filter multiple times during page load

Updated Files:
- includes/class-wc-tpp-admin.php (added duplicate check in filter)
- wc-tier-and-package-prices.php (version 1.1.17)
- composer.json (version 1.1.17)
- CHANGELOG.md (v1.1.17 section)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 23:05:11 +01:00
2b2c06794b Release version 1.1.16 - Singleton pattern for settings page
Fixed persistent duplicate settings page rendering by implementing proper
singleton pattern for admin class and caching settings instance.

Fixes:
- Settings page still appearing twice despite v1.1.15 fix
- Multiple instantiation of WC_TPP_Admin class
- Duplicate creation of WC_TPP_Settings instances

Changes:
- Implemented singleton pattern for WC_TPP_Admin class
- Added private static $instance property with get_instance() method
- Made WC_TPP_Admin constructor private
- Added static $settings_instance property to cache settings page
- Modified add_settings_page() to check and reuse cached settings instance
- Changed instantiation from new WC_TPP_Admin() to WC_TPP_Admin::get_instance()

Technical Details:
- Ensures only one WC_TPP_Admin instance exists throughout plugin lifecycle
- Prevents duplicate filter registrations even if woocommerce_get_settings_pages called multiple times
- Settings page object created once and reused on subsequent filter calls
- Follows WordPress/WooCommerce best practices for singleton implementation

Updated Files:
- includes/class-wc-tpp-admin.php (singleton pattern implementation)
- wc-tier-and-package-prices.php (version 1.1.16)
- composer.json (version 1.1.16)
- CHANGELOG.md (v1.1.16 section)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 20:01:27 +01:00
959229b9d8 Release version 1.1.15 - Fix duplicate settings page
Fixed settings page appearing twice in WooCommerce settings due to double instantiation of WC_TPP_Settings class.

**Issue:**
- Settings page rendered twice on same page
- WC_TPP_Settings class instantiated twice: once automatically in settings file, once via admin class include

**Fix:**
- Removed conditional wrapper `if (class_exists('WC_TPP_Settings'))` from settings return statement
- Settings class now only instantiated when admin class includes the file via `return new WC_TPP_Settings();`
- Restored v1.1.2 pattern for settings file

**Files Modified:**
- includes/class-wc-tpp-settings.php (simplified return statement)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 19:39:20 +01:00
f0ab2ff755 Release version 1.1.14 - Restore plugin functionality
**CRITICAL FIX:** Restored plugin to working state after v1.1.8-1.1.13 were completely non-functional.

**Root Cause:**
- v1.1.8 moved class instantiation from individual files to init_classes() method
- v1.1.13 wrapped classes in class_exists() guards
- Combination prevented any classes from being instantiated
- Result: No settings, no frontend, no backend functionality

**Solution:**
- Reverted to v1.1.2 pattern (last working version)
- Each class file now instantiates itself with `new ClassName();`
- Removed init_classes() method and woocommerce_loaded hook
- All class_exists() guards remain for redeclaration protection

**What Now Works:**
 WooCommerce Settings → Tier & Package Prices tab
 Product edit pages show tier/package pricing meta boxes
 Frontend displays pricing tables on product pages
 Cart applies tier/package pricing correctly
 All plugin functionality fully operational

**Files Modified:**
- includes/class-wc-tpp-admin.php
- includes/class-wc-tpp-product-meta.php
- includes/class-wc-tpp-frontend.php
- includes/class-wc-tpp-cart.php
- wc-tier-and-package-prices.php (removed init_classes)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 19:32:47 +01:00
4dd9b3cd62 Release version 1.1.13 - Critical class redeclaration fixes
Fixed critical class redeclaration errors affecting all plugin functionality
in version 1.1.12. All plugin component classes now properly guarded.

**CRITICAL FIXES:**
- Plugin completely non-functional in v1.1.12 (no settings, no frontend, no backend)
- Fatal errors for WC_TPP_Admin, WC_TPP_Product_Meta, WC_TPP_Frontend, WC_TPP_Cart, WC_TPP_Settings classes
- All classes now wrapped in class_exists() checks

**Files Modified:**
- includes/class-wc-tpp-admin.php
- includes/class-wc-tpp-product-meta.php
- includes/class-wc-tpp-frontend.php
- includes/class-wc-tpp-cart.php
- includes/class-wc-tpp-settings.php

**Technical Details:**
- Completes comprehensive redeclaration protection started in v1.1.9-1.1.12
- All 2 functions, 4 constants, and 6 classes now protected
- Plugin activates successfully and all features functional
- Settings page, product meta boxes, frontend display, cart integration all working

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 19:02:18 +01:00
9dab123209 Release version 1.1.12 - Final redeclaration fix
Fixed critical class redeclaration error for WC_Tier_Package_Prices
affecting version 1.1.11. This completes all redeclaration protection
by protecting the main plugin class.

Fixes:
- Class redeclaration error for WC_Tier_Package_Prices
- Fatal error "Cannot redeclare class WC_Tier_Package_Prices" when plugin file loaded multiple times
- Plugin activation failures caused by class redeclaration

Technical Changes:
- Wrapped WC_Tier_Package_Prices class declaration in class_exists() check
- Completes comprehensive redeclaration protection for all plugin components
- All functions, constants, and classes now safely guarded against redeclaration
- Plugin now fully protected from all redeclaration scenarios

Protected Components:
- Functions: wc_tpp_woocommerce_missing_notice(), wc_tpp_init()
- Constants: WC_TPP_VERSION, WC_TPP_PLUGIN_DIR, WC_TPP_PLUGIN_URL, WC_TPP_PLUGIN_BASENAME
- Classes: WC_Tier_Package_Prices

Updated Files:
- wc-tier-and-package-prices.php (version 1.1.12, class protection)
- composer.json (version 1.1.12)
- CHANGELOG.md (v1.1.12 section)
- All translation files compiled (.mo files)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 18:52:34 +01:00
3f117ae519 Release version 1.1.11 - Complete redeclaration protection
Fixed critical constant redeclaration warnings/errors for all plugin
constants affecting versions 1.1.3-1.1.10. This completes comprehensive
protection against all redeclaration issues by protecting constants.

Fixes:
- Constant redeclaration warnings/errors for WC_TPP_VERSION, WC_TPP_PLUGIN_DIR, WC_TPP_PLUGIN_URL, WC_TPP_PLUGIN_BASENAME
- Potential errors when plugin constants already defined
- Plugin initialization failures caused by constant redeclaration

Technical Changes:
- Wrapped all define() calls in defined() checks
- Protected WC_TPP_VERSION, WC_TPP_PLUGIN_DIR, WC_TPP_PLUGIN_URL, WC_TPP_PLUGIN_BASENAME
- Prevents warnings/errors during WordPress plugin activation/deactivation cycles
- Comprehensive protection: all global functions and constants now safely guarded
- No more redeclaration issues possible

Updated Files:
- wc-tier-and-package-prices.php (version 1.1.11, all constants protected)
- composer.json (version 1.1.11)
- CHANGELOG.md (v1.1.11 section)
- All translation files compiled (.mo files)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 18:48:01 +01:00
58bbd5164f Release version 1.1.10 - Complete function redeclaration fix
Fixed critical function redeclaration error for wc_tpp_init() affecting
version 1.1.9. This completes the fix started in v1.1.9 by protecting
all global functions from redeclaration during plugin lifecycle events.

Fixes:
- Function redeclaration error for wc_tpp_init()
- Fatal error "Cannot redeclare function wc_tpp_init()" when plugin file loaded multiple times
- Plugin activation failures

Technical Changes:
- Wrapped wc_tpp_init() function in function_exists() check
- Both wc_tpp_woocommerce_missing_notice() and wc_tpp_init() now safely guarded
- Prevents fatal errors during WordPress plugin activation/deactivation cycles
- Comprehensive protection for all global function declarations

Updated Files:
- wc-tier-and-package-prices.php (version 1.1.10, wc_tpp_init safety check)
- composer.json (version 1.1.10)
- CHANGELOG.md (v1.1.10 section)
- All translation files compiled (.mo files)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 18:45:05 +01:00
cfdbfe1504 Release version 1.1.9 - Critical function redeclaration fix
Fixed critical function redeclaration error affecting versions 1.1.3-1.1.8
that caused fatal errors during plugin activation and deactivation.

Fixes:
- Function redeclaration error for wc_tpp_woocommerce_missing_notice()
- Fatal error "Cannot redeclare function" when plugin file loaded multiple times
- Plugin activation/deactivation failures

Technical Changes:
- Wrapped wc_tpp_woocommerce_missing_notice() in function_exists() check
- Moved function declaration before WooCommerce check for better organization
- Prevents fatal errors during WordPress plugin lifecycle events

Updated Files:
- wc-tier-and-package-prices.php (version 1.1.9, function safety check)
- composer.json (version 1.1.9)
- CHANGELOG.md (v1.1.9 section)
- All translation files compiled (.mo files)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 18:40:48 +01:00
e4e4de82cb Release version 1.1.8 - Critical activation fix
Fixed critical plugin activation error that was preventing the plugin from
being activated on WordPress 6.9.x and WooCommerce 10.x.

The issue was introduced in v1.1.3 when admin classes were still being
instantiated immediately at file include time, before WooCommerce was loaded.
While v1.1.6 fixed this for Frontend and Cart classes, the Admin and
Product Meta classes were missed.

Critical Fix:
- Removed immediate instantiation from WC_TPP_Admin class
- Removed immediate instantiation from WC_TPP_Product_Meta class
- Both classes now instantiated via woocommerce_loaded hook
- Ensures all WooCommerce hooks are available before registration

Technical Changes:
- Removed "new WC_TPP_Admin();" from class-wc-tpp-admin.php
- Removed "new WC_TPP_Product_Meta();" from class-wc-tpp-product-meta.php
- Added both classes to init_classes() method in main plugin file
- All four main classes now follow consistent initialization pattern

Impact:
- Plugin now activates correctly on all WordPress/WooCommerce versions
- Resolves fatal errors during plugin activation
- Last working version was v1.1.2, now fixed in v1.1.8

Updated Files:
- includes/class-wc-tpp-admin.php (removed auto-instantiation)
- includes/class-wc-tpp-product-meta.php (removed auto-instantiation)
- wc-tier-and-package-prices.php (version 1.1.8, init_classes updated)
- composer.json (version 1.1.8)
- CHANGELOG.md (v1.1.8 section added)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 00:24:12 +01:00
af532b56eb Release version 1.1.7 - Enhanced user experience features
Added three new customer-facing features to improve product page interaction
and tier pricing functionality.

Features:
- Optional text labels for tier pricing (similar to package labels)
- Clickable tier pricing table rows to auto-populate quantity field
- Add to Cart button auto-disables when quantity is 0 or less

Enhanced User Experience:
- Tier pricing rows now clickable with cursor pointer and hover animation
- Clicking tier row sets quantity and smoothly scrolls to quantity field
- Add to Cart button shows disabled state with reduced opacity
- Tier labels display below quantity in italic gray text

Technical Changes:
- Added optional 'label' field to tier pricing admin meta box
- Updated tier save logic to include label field (sanitized)
- Enhanced tier pricing frontend template to display labels
- Added click handler for tier pricing rows in frontend.js
- Added updateAddToCartButton() function to manage button state
- CSS: .wc-tpp-tier-label styling for tier labels
- CSS: Clickable cursor and hover transform for tier rows
- CSS: Disabled button styling (.single_add_to_cart_button:disabled)

Updated Files:
- templates/admin/tier-row.twig (added label field)
- includes/class-wc-tpp-product-meta.php (save label, template update)
- templates/frontend/tier-pricing-table.twig (display labels)
- assets/js/frontend.js (tier row clicks, button disable logic)
- assets/css/frontend.css (tier label style, clickable rows, disabled button)
- wc-tier-and-package-prices.php (version 1.1.7)
- composer.json (version 1.1.7)
- CHANGELOG.md (v1.1.7 section)

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 00:15:48 +01:00
e2a11de80a Release version 1.1.6 - Minor improvements
Updated Plugin URI to correct repository path and added notes files to gitignore.

Changes:
- Updated Plugin URI from /wc-tier-package-prices to /magdev/wc-tier-package-prices
- Added notes.* to .gitignore to exclude local notes files

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-22 00:02:19 +01:00
e40830b69b Release version 1.1.6 - Critical fix for plugin activation
Fixed critical bug that prevented plugin activation in v1.1.3, v1.1.4, and v1.1.5.

Root Cause:
- WC_TPP_Cart and WC_TPP_Frontend classes were instantiated immediately when
  their files were loaded (via `new ClassName();` at bottom of files)
- This happened BEFORE WooCommerce was fully loaded
- Hook registration attempted to access WooCommerce functions before they existed
- Result: Fatal error during plugin activation

Solution:
- Removed immediate instantiation from class-wc-tpp-cart.php (line 251)
- Removed immediate instantiation from class-wc-tpp-frontend.php (line 186)
- Added init_classes() method to main plugin class
- Classes now instantiated via woocommerce_loaded hook
- Ensures WooCommerce is fully initialized before any hooks are registered

Changes:
- includes/class-wc-tpp-cart.php - Removed `new WC_TPP_Cart();`
- includes/class-wc-tpp-frontend.php - Removed `new WC_TPP_Frontend();`
- wc-tier-and-package-prices.php - Added init_classes() and woocommerce_loaded hook
- CHANGELOG.md - Added v1.1.6 section
- composer.json - Version 1.1.6
- All translation files updated to 1.1.6
- All .mo files recompiled

This fix ensures proper WordPress plugin lifecycle:
1. Plugin file loaded
2. Classes defined (but not instantiated)
3. WooCommerce loads
4. woocommerce_loaded hook fires
5. Classes instantiated with full WooCommerce availability

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 19:57:27 +01:00
9765c5f119 Release version 1.1.5 - Critical bug fix for plugin activation
CRITICAL FIX: Resolved fatal error that prevented plugin activation in
versions 1.1.3 and 1.1.4. The add_cart_quantity_css() method was attempting
to access WooCommerce cart object during wp_head action, causing failures
when WooCommerce wasn't fully initialized or on admin pages.

Fixes:
- Plugin activation error in v1.1.3 and v1.1.4
- Fatal error when WooCommerce cart object not available
- Frontend errors on admin pages
- Issues during plugin initialization

Technical Changes:
- Added function_exists('WC') check before accessing WooCommerce
- Added is_admin() check to prevent CSS injection on admin pages
- Enhanced add_cart_quantity_css() with proper guards
- Line 191: if (!function_exists('WC') || !WC()->cart || is_admin())

Root Cause:
The add_cart_quantity_css() method (added in v1.1.3) hooks into wp_head
but didn't properly check if WooCommerce cart was available, causing
errors during plugin activation and on admin pages.

Updated Files:
- includes/class-wc-tpp-cart.php (enhanced error checking)
- wc-tier-and-package-prices.php (version 1.1.5)
- composer.json (version 1.1.5)
- CHANGELOG.md (v1.1.5 section)
- All translation files (.pot, .po, .mo) updated to version 1.1.5

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 19:49:24 +01:00
5cfabedb94 released v1.1.4 2025-12-21 19:36:35 +01:00
88e30d028c Release version 1.1.4 - WooCommerce Blocks support and improved styling
Added comprehensive WooCommerce Blocks support for quantity restrictions
and improved "View Options" button styling to match standard WooCommerce
Add to Cart buttons.

Features:
- WooCommerce Blocks cart/mini-cart quantity restriction support
- Store API integration for block-based carts
- Improved "View Options" button styling with WooCommerce standards
- Enhanced hover effects and transitions

Technical Changes:
- Added woocommerce_store_api_product_quantity_editable filter
- Added block_quantity_editable() method in WC_TPP_Cart class
- Enhanced CSS for .wc-block-components-quantity-selector targeting
- Updated button styling: padding (0.618em × 1em), font-weight (700)
- Added transition effects for smooth hover states

Fixed:
- WooCommerce blocks cart quantity selector now properly hidden
- WooCommerce blocks mini-cart quantity selector visibility
- "View Options" button now matches Add to Cart button appearance

Updated Files:
- includes/class-wc-tpp-cart.php (WooCommerce Blocks support)
- assets/css/frontend.css (enhanced button styling)
- wc-tier-and-package-prices.php (version 1.1.4)
- composer.json (version 1.1.4)
- CHANGELOG.md (v1.1.4 section)
- All translation files (.pot, .po, .mo) updated to version 1.1.4

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 19:33:34 +01:00
d55ada7924 Release version 1.1.3 - Cart quantity visibility fix
Fixed persistent cart quantity input visibility issues for products with
package quantity restrictions. Enhanced implementation ensures quantity
inputs are properly hidden in both main cart and mini-cart/sidebar.

Fixes:
- Cart quantity inputs now properly hidden with increased filter priority
- Mini-cart quantity inputs correctly replaced with read-only text
- Added fallback CSS injection to handle theme/plugin conflicts
- Enhanced DOM targeting with data attributes and multiple CSS selectors

Technical Changes:
- Increased filter priority to 999 for woocommerce_cart_item_quantity
- Added woocommerce_widget_cart_item_quantity filter for mini-cart support
- Added add_cart_quantity_css() method for dynamic CSS injection
- Added maybe_hide_mini_cart_quantity_input() method
- Enhanced quantity spans with data-product-id attribute
- Added wc-tpp-restricted-qty CSS class
- Implemented sibling (+) and general sibling (~) CSS selectors

Updated Files:
- includes/class-wc-tpp-cart.php (enhanced with mini-cart support)
- wc-tier-and-package-prices.php (version 1.1.3)
- composer.json (version 1.1.3)
- CHANGELOG.md (v1.1.3 section)
- All translation files (.pot, .po, .mo) updated to version 1.1.3

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-21 19:19:18 +01:00
84 changed files with 1114 additions and 1026 deletions

View File

@@ -9,12 +9,16 @@
"Bash(composer install:*)",
"Bash(composer update:*)",
"Bash(git add:*)",
"Bash(git commit -m \"$\\(cat <<''EOF''\nRelease version 1.1.0 - Package quantity restriction feature\n\nAdded comprehensive package quantity restriction functionality that allows\nlimiting product purchases to predefined package sizes only.\n\nFeatures:\n- Global setting to enable package quantity restrictions\n- Per-product override for quantity restrictions\n- Automatic hiding of quantity input field when restricted\n- Frontend validation with package selection UI\n- Server-side cart validation\n- User-friendly error messages\n- Complete translations for all supported languages\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
"Bash(git tag:*)",
"Bash(rsync:*)",
"Bash(zip -r:*)",
"Bash(cat:*)",
"Bash(git commit -m \"$\\(cat <<''EOF''\nRelease version 1.1.2 - Catalog button modification\n\nEnhanced package quantity restriction enforcement by replacing \"Add to Cart\"\nbuttons with \"View Options\" links on catalog pages for products with\nquantity restrictions. This prevents customers from attempting to add\nrestricted products directly from shop/category pages.\n\nChanges:\n- Added catalog button modification for restricted products\n- Implemented \"View Options\" button with eye icon styling\n- Created has_quantity_restriction\\(\\) helper method\n- Extended CSS loading to all WooCommerce pages\n- Added modify_catalog_add_to_cart_button\\(\\) filter method\n- Updated translations with 2 new strings \\(en_US, de_DE, de_CH_informal\\)\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>\nEOF\n\\)\")"
"Bash(for po in *.po)",
"Bash(do msgfmt -o \"$po%.po.mo\" \"$po\")",
"Bash(done)",
"Bash(git commit:*)",
"Bash(node -c:*)",
"Bash(php -l:*)"
]
}
}

4
.gitignore vendored
View File

@@ -21,6 +21,10 @@ npm-debug.log
# Logs
*.log
/logs
# Notes
notes.*
# OS
.DS_Store

View File

@@ -5,6 +5,326 @@ All notable changes to WooCommerce Tier and Package Prices will be documented in
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [1.1.19] - 2025-12-22
### Fixed
- Settings page still appearing twice despite instance caching
- Duplicate detection using strict instance comparison failing for different object instances
### Changed
- Enhanced duplicate detection to check by class type and ID instead of instance
- Added `instanceof WC_TPP_Settings` check
- Added ID-based duplicate detection via `get_id()` method and direct property access
- Multiple fallback checks to catch duplicates regardless of instance identity
### Technical Details
- Previous strict comparison (`===`) failed when different instances of same class existed
- New approach checks: instanceof, get_id() method, and id property
- Returns early if any settings page with ID 'tier_package_prices' found
- Prevents duplicates even if settings instance recreated or serialized
## [1.1.18] - 2025-12-22
### Fixed
- **ROOT CAUSE IDENTIFIED**: Settings page rendering twice due to automatic instantiation in settings file
- Settings file being included multiple times via Composer autoloader creating duplicate instances
### Changed
- Removed `return new WC_TPP_Settings();` from bottom of settings file
- Changed admin class to explicitly instantiate settings with `new WC_TPP_Settings()`
- Changed from `include` to `require_once` for settings file to prevent multiple loads
### Technical Details
- Settings file (class-wc-tpp-settings.php) was creating instance automatically on include
- File is in Composer's classmap, so when autoloaded it executed instantiation again
- Each include/autoload created new instance even with singleton pattern in admin class
- Solution: Remove automatic instantiation, use `require_once` + explicit `new` in admin class
- Now settings instance only created once, explicitly, when needed by filter
- Composer autoload can load class definition without side effects
## [1.1.17] - 2025-12-22
### Fixed
- Settings page still rendering twice despite singleton pattern in v1.1.16
- Filter adding settings instance to array multiple times when called repeatedly
### Changed
- Added duplicate detection in `add_settings_page()` filter method
- Filter now checks if settings instance already exists in array before adding
### Technical Details
- Added foreach loop to check existing settings pages in array
- Uses strict comparison (`===`) to detect if exact instance already present
- Returns early if settings instance found, preventing duplicate array entries
- Complements singleton pattern from v1.1.16 with array-level duplicate prevention
- Handles edge case where WooCommerce calls filter multiple times
## [1.1.16] - 2025-12-22
### Fixed
- Settings page still rendering twice in WooCommerce backend despite v1.1.15 fix
- Multiple instantiation of WC_TPP_Admin and WC_TPP_Settings classes
### Changed
- Implemented singleton pattern for WC_TPP_Admin class with `get_instance()` method
- Made WC_TPP_Admin constructor private to prevent direct instantiation
- Added static caching of WC_TPP_Settings instance to prevent duplicate creation
- Changed class instantiation from `new WC_TPP_Admin()` to `WC_TPP_Admin::get_instance()`
### Technical Details
- Added `private static $instance` property to WC_TPP_Admin class
- Added `private static $settings_instance` property to cache settings page instance
- Modified `add_settings_page()` to check and reuse cached settings instance
- Ensures only one instance of each class exists throughout plugin lifecycle
- Prevents duplicate filter registrations even if called multiple times
## [1.1.15] - 2025-12-22
### Fixed
- Settings page rendering twice in WooCommerce settings
- Duplicate instantiation of WC_TPP_Settings class causing double rendering
### Technical Details
- Removed conditional `if (class_exists('WC_TPP_Settings'))` wrapper from settings return statement
- Settings class now only instantiated via `return new WC_TPP_Settings();` when included by admin class
- Matches v1.1.2 pattern where settings file returns instance without automatic instantiation
- Prevents double registration in WooCommerce settings pages array
## [1.1.14] - 2025-12-22
### Fixed
- **CRITICAL:** Plugin completely non-functional in v1.1.8-1.1.13 - no settings, no frontend, no backend
- Classes never instantiated due to incorrect initialization pattern introduced in v1.1.8
- Restored v1.1.2 pattern: classes auto-instantiate when files are included
- All plugin functionality now working: settings page, product meta boxes, frontend display, cart integration
### Changed
- Reverted to direct class instantiation pattern from v1.1.2 (last known working version)
- Removed `init_classes()` method and `woocommerce_loaded` hook approach from v1.1.8
- Each class file now instantiates itself with `new ClassName()` at end of file
- Simplified plugin initialization for better reliability
### Technical Details
- Restored class instantiation in all 5 component files:
- `class-wc-tpp-admin.php`: Added `new WC_TPP_Admin();` after class declaration
- `class-wc-tpp-product-meta.php`: Added `new WC_TPP_Product_Meta();` after class declaration
- `class-wc-tpp-frontend.php`: Added `new WC_TPP_Frontend();` after class declaration
- `class-wc-tpp-cart.php`: Added `new WC_TPP_Cart();` after class declaration
- `class-wc-tpp-settings.php`: Already has instantiation via return statement
- Removed `init_classes()` method from main plugin class
- Removed `woocommerce_loaded` hook that delayed class instantiation
- Classes now instantiate immediately when `require_once` loads them
- All `class_exists()` guards remain in place for redeclaration protection
## [1.1.13] - 2025-12-22
### Fixed
- **CRITICAL:** Class redeclaration errors for all plugin component classes affecting version 1.1.12
- Fatal errors "Cannot redeclare class WC_TPP_Admin", "Cannot redeclare class WC_TPP_Product_Meta", "Cannot redeclare class WC_TPP_Frontend", "Cannot redeclare class WC_TPP_Cart", "Cannot redeclare class WC_TPP_Settings"
- Plugin functionality completely broken in v1.1.12 - no settings page, no frontend display, no backend controls
- All plugin features now working correctly after adding class guards
### Technical Details
- Wrapped all 5 plugin component class declarations in `class_exists()` checks:
- `WC_TPP_Admin` (includes/class-wc-tpp-admin.php)
- `WC_TPP_Product_Meta` (includes/class-wc-tpp-product-meta.php)
- `WC_TPP_Frontend` (includes/class-wc-tpp-frontend.php)
- `WC_TPP_Cart` (includes/class-wc-tpp-cart.php)
- `WC_TPP_Settings` (includes/class-wc-tpp-settings.php)
- Completes comprehensive redeclaration protection started in v1.1.9-1.1.12
- All functions, constants, and classes now fully protected against redeclaration
- Plugin now activates and functions correctly without fatal errors
## [1.1.12] - 2025-12-22
### Fixed
- **CRITICAL:** Class redeclaration error for `WC_Tier_Package_Prices` affecting version 1.1.11
- Fatal error "Cannot redeclare class WC_Tier_Package_Prices" when plugin file loaded multiple times
- Plugin activation failures caused by class redeclaration
### Technical Details
- Wrapped `WC_Tier_Package_Prices` class declaration in `class_exists()` check
- Completes comprehensive redeclaration protection for all plugin components
- Prevents fatal errors during WordPress plugin activation/deactivation cycles
- All functions, constants, and classes now safely guarded against redeclaration
## [1.1.11] - 2025-12-22
### Fixed
- **CRITICAL:** Constant redeclaration warnings/errors for plugin constants affecting versions 1.1.3-1.1.10
- Potential errors when plugin constants (WC_TPP_VERSION, WC_TPP_PLUGIN_DIR, etc.) already defined
- Plugin initialization failures caused by constant redeclaration
### Technical Details
- Wrapped all `define()` calls in `defined()` checks for WC_TPP_VERSION, WC_TPP_PLUGIN_DIR, WC_TPP_PLUGIN_URL, WC_TPP_PLUGIN_BASENAME
- Prevents warnings/errors during WordPress plugin activation/deactivation cycles
- Completes comprehensive protection against all redeclaration issues
- All global functions and constants now safely guarded
## [1.1.10] - 2025-12-22
### Fixed
- **CRITICAL:** Function redeclaration error for `wc_tpp_init()` affecting version 1.1.9
- Fatal error "Cannot redeclare function wc_tpp_init()" when plugin file loaded multiple times
- Plugin activation failures caused by function redeclaration
### Technical Details
- Wrapped `wc_tpp_init()` function in `function_exists()` check
- Completes the fix started in v1.1.9 by protecting all global functions
- Prevents fatal errors during WordPress plugin activation cycles
- Both `wc_tpp_woocommerce_missing_notice()` and `wc_tpp_init()` now safely guarded
## [1.1.9] - 2025-12-22
### Fixed
- **CRITICAL:** Function redeclaration error for `wc_tpp_woocommerce_missing_notice()` affecting versions 1.1.3-1.1.8
- Fatal error "Cannot redeclare function wc_tpp_woocommerce_missing_notice()" when plugin file loaded multiple times
- Plugin activation and deactivation failures caused by function redeclaration
### Technical Details
- Wrapped `wc_tpp_woocommerce_missing_notice()` function in `function_exists()` check
- Prevents fatal error during WordPress plugin activation/deactivation cycles
- Ensures function can safely be declared even if file is included multiple times
- Moved function declaration before WooCommerce check for better code organization
## [1.1.8] - 2025-12-22
### Fixed
- **CRITICAL:** Plugin activation fatal error introduced in v1.1.3-v1.1.7
- Fixed premature class instantiation of `WC_TPP_Admin` and `WC_TPP_Product_Meta`
- Both classes now instantiated via `woocommerce_loaded` hook after WooCommerce is available
- Resolves WordPress 6.9.x and WooCommerce 10.x compatibility issues
### Technical Details
- Removed `new WC_TPP_Admin();` from bottom of class-wc-tpp-admin.php
- Removed `new WC_TPP_Product_Meta();` from bottom of class-wc-tpp-product-meta.php
- Added both classes to `init_classes()` method in main plugin file
- All four main classes (Admin, Product Meta, Frontend, Cart) now follow same initialization pattern
- Ensures WooCommerce hooks are available before registration
## [1.1.7] - 2025-12-22
### Added
- Optional text labels for tier pricing (similar to package labels)
- Clickable tier pricing rows that auto-populate quantity field
- Add to Cart button auto-disable when quantity is 0 or less
### Enhanced
- Tier pricing table rows now clickable with visual hover feedback
- Clicking a tier row sets quantity to that tier's minimum quantity
- Smooth scroll animation to quantity field when tier is clicked
- Add to Cart button disabled state with visual feedback (opacity, cursor)
- Tier labels display below quantity in frontend table (italic, gray text)
### Technical Details
- Added optional `label` field to tier pricing meta box (admin/tier-row.twig)
- Updated tier save logic to store label field (class-wc-tpp-product-meta.php)
- Enhanced tier pricing template to display labels (frontend/tier-pricing-table.twig)
- Added click handler for tier rows (assets/js/frontend.js)
- Added `updateAddToCartButton()` function to manage button state
- CSS: `.wc-tpp-tier-label` styling for tier labels
- CSS: Clickable cursor and hover animation for tier rows
- CSS: Disabled button styling (`.single_add_to_cart_button:disabled`)
## [1.1.6] - 2025-12-21
### Fixed
- **CRITICAL:** Plugin activation fatal error in v1.1.3, v1.1.4, and v1.1.5
- Fatal error caused by premature class instantiation before WooCommerce is loaded
- Removed immediate class instantiation from `class-wc-tpp-cart.php` and `class-wc-tpp-frontend.php`
### Technical
- Moved `WC_TPP_Cart` and `WC_TPP_Frontend` instantiation to `woocommerce_loaded` hook
- Added `init_classes()` method to main plugin class for controlled class initialization
- Ensures WooCommerce is fully loaded before registering hooks that depend on WC functions
- Fixed hook registration timing to prevent accessing WooCommerce before it's available
## [1.1.5] - 2025-12-21
### Fixed
- **CRITICAL:** Plugin activation error in v1.1.3 and v1.1.4 caused by `add_cart_quantity_css()` method
- Fatal error when WooCommerce cart object not available during plugin initialization
- Frontend errors on admin pages and during activation
### Technical
- Added `function_exists('WC')` check before accessing WooCommerce functions
- Added `is_admin()` check to prevent CSS injection on admin pages
- Enhanced error prevention in `add_cart_quantity_css()` method
## [1.1.4] - 2025-12-21
### Added
- WooCommerce Blocks support for quantity restrictions
- `woocommerce_store_api_product_quantity_editable` filter for block-based carts
- `block_quantity_editable()` method in WC_TPP_Cart class
- CSS targeting for `.wc-block-components-quantity-selector` elements
### Enhanced
- "View Options" button styling to match standard WooCommerce "Add to Cart" buttons
- Button padding, font weight, and border radius for better visual consistency
- Hover effects with smooth transitions
### Fixed
- WooCommerce blocks cart quantity selector visibility for restricted products
- WooCommerce blocks mini-cart quantity selector visibility
### Technical
- Added Store API integration for block-based cart/mini-cart
- Enhanced CSS for block cart items with product-specific selectors
- Improved button styling with WooCommerce standard values (0.618em × 1em padding)
- Added transition effects for better UX
## [1.1.3] - 2025-12-21
### Fixed
- Cart quantity input visibility issue in cart and cart sidebar for restricted products
- Enhanced filter priority (999) to ensure quantity hiding runs after other plugins
- Mini-cart quantity input now properly hidden for restricted products
### Added
- `woocommerce_widget_cart_item_quantity` filter support for mini-cart
- `add_cart_quantity_css()` method for dynamic CSS injection
- `data-product-id` attribute to quantity spans for targeted CSS selectors
- CSS class `wc-tpp-restricted-qty` for improved targeting
### Technical
- Increased filter priority from 10 to 999 for `woocommerce_cart_item_quantity`
- Added `maybe_hide_mini_cart_quantity_input()` method in WC_TPP_Cart class
- Dynamic CSS injection via `wp_head` action as fallback
- Used both sibling (+) and general sibling (~) CSS selectors for DOM variations
## [1.1.2] - 2025-12-21
### Added

429
CLAUDE.md Normal file
View File

@@ -0,0 +1,429 @@
# WooCommerce Tier and Package Prices - AI Context Document
**Last Updated:** 2025-12-23
**Current Version:** 1.1.20
**Author:** Marco Graetsch
**Project Status:** Production-ready WordPress plugin
## Project Overview
This is a WooCommerce plugin that adds flexible pricing capabilities to products through two distinct pricing models:
1. **Tier Pricing (Volume Discounts)**: Progressive discounts based on quantity ranges (e.g., 1-9 items @ $12, 10-24 @ $10, 25+ @ $8)
2. **Package Pricing (Fixed Bundles)**: Exact quantity packages at fixed prices (e.g., exactly 10 items for $95, exactly 25 for $200)
### Key Fact: 100% AI-Generated
This project is proudly **"vibe-coded"** using Claude.AI - the entire codebase was created through AI assistance.
## Technical Stack
- **Language:** PHP 7.4+
- **Framework:** WordPress Plugin API
- **E-commerce:** WooCommerce 8.0+ (tested up to 10.x)
- **Template Engine:** Twig 3.0 (via Composer)
- **Frontend:** Vanilla JavaScript + jQuery
- **Styling:** Custom CSS
- **Dependency Management:** Composer
- **Internationalization:** WordPress i18n (.pot/.po/.mo files)
### Dependencies
```json
{
"twig/twig": "^3.0",
"symfony/polyfill-ctype": "^1.x",
"symfony/polyfill-mbstring": "^1.x"
}
```
## Architecture
### Directory Structure
```
wc-tier-and-package-prices/
├── wc-tier-and-package-prices.php # Main plugin file (entry point)
├── includes/ # PHP classes
│ ├── class-wc-tpp-admin.php # Admin settings integration
│ ├── class-wc-tpp-settings.php # WooCommerce settings page
│ ├── class-wc-tpp-product-meta.php # Product edit page meta boxes
│ ├── class-wc-tpp-frontend.php # Product page display logic
│ ├── class-wc-tpp-cart.php # Cart price calculations
│ └── class-wc-tpp-template-loader.php # Twig template loader
├── templates/ # Twig templates
│ ├── admin/ # Admin interface templates
│ │ ├── tier-row.twig # Single tier input row
│ │ └── package-row.twig # Single package input row
│ └── frontend/ # Customer-facing templates
│ ├── pricing-table.twig # Main pricing display wrapper
│ ├── tier-pricing-table.twig # Tier pricing display
│ └── package-pricing-display.twig # Package buttons/cards
├── assets/
│ ├── css/
│ │ ├── admin.css # Backend styling
│ │ └── frontend.css # Product page & cart styling
│ └── js/
│ ├── admin.js # Meta box interaction (add/remove rows)
│ └── frontend.js # Dynamic price updates, package selection
├── languages/ # Translation files
│ ├── *.pot # Translation template
│ ├── *.po # Translation sources
│ └── *.mo # Compiled translations
├── vendor/ # Composer dependencies (included in releases)
├── releases/ # Release packages (not in git)
└── *.md # Documentation files
```
### Class Responsibilities
#### 1. `WC_Tier_Package_Prices` (Main Plugin Class)
- **Location:** `wc-tier-and-package-prices.php`
- **Pattern:** Singleton
- **Responsibilities:**
- Plugin initialization and bootstrapping
- Loading all component classes via `includes()`
- HPOS (High-Performance Order Storage) compatibility declaration
- Text domain loading for internationalization
- Activation/deactivation hooks
#### 2. `WC_TPP_Admin`
- **Location:** `includes/class-wc-tpp-admin.php`
- **Pattern:** Singleton
- **Responsibilities:**
- Enqueues admin CSS/JS
- Registers WooCommerce settings page via filter
- Manages settings page instance (cached to prevent duplicates)
- Product meta box asset loading
#### 3. `WC_TPP_Settings`
- **Location:** `includes/class-wc-tpp-settings.php`
- **Extends:** `WC_Settings_Page` (WooCommerce core)
- **Responsibilities:**
- Creates "Tier & Package Prices" tab in WooCommerce settings
- Defines global plugin settings (enable/disable features, display position, etc.)
- Setting persistence through WooCommerce options API
**Global Settings:**
- `wc_tpp_enable_tier_pricing` (yes/no)
- `wc_tpp_enable_package_pricing` (yes/no)
- `wc_tpp_display_table` (yes/no) - Show pricing tables on product pages
- `wc_tpp_display_position` (before_add_to_cart / after_add_to_cart / after_price)
- `wc_tpp_restrict_package_quantities` (yes/no) - Global quantity restrictions
#### 4. `WC_TPP_Product_Meta`
- **Location:** `includes/class-wc-tpp-product-meta.php`
- **Responsibilities:**
- Adds tier/package pricing fields to product edit page
- Renders Twig templates for meta box rows
- Saves tier/package data to post meta
- Nonce verification and capability checks for security
- Prevents autosave from corrupting data
**Product Meta Keys:**
- `_wc_tpp_tiers` - Array of tier objects `[{min_qty, price, label}]`
- `_wc_tpp_packages` - Array of package objects `[{qty, price, label}]`
- `_wc_tpp_restrict_to_packages` - Per-product quantity restriction (yes/no)
#### 5. `WC_TPP_Frontend`
- **Location:** `includes/class-wc-tpp-frontend.php`
- **Responsibilities:**
- Enqueues frontend CSS/JS on product pages
- Displays pricing tables via Twig templates
- Localizes currency settings to JavaScript
- Hides quantity inputs for restricted products
- Modifies catalog "Add to Cart" buttons to "View Options" for restricted products
- Static methods for price lookups (`get_tier_price()`, `get_package_price()`)
#### 6. `WC_TPP_Cart`
- **Location:** `includes/class-wc-tpp-cart.php`
- **Responsibilities:**
- **MOST CRITICAL CLASS** - Handles all cart price calculations
- Applies tier/package pricing during cart totals calculation
- Stores pricing metadata in cart items for display
- Customizes cart item display (price labels, quantity indicators)
- Validates package quantities on add-to-cart
- Hides/disables quantity inputs for restricted products (classic cart + blocks)
- **WooCommerce Blocks support** via `woocommerce_store_api_product_quantity_editable` filter
**Price Calculation Priority (in `apply_tier_package_pricing()`):**
1. Check for exact package match → Use package price if found
2. Check for tier match → Use tier price if found
3. Fall back to regular product price
#### 7. `WC_TPP_Template_Loader`
- **Location:** `includes/class-wc-tpp-template-loader.php`
- **Pattern:** Singleton
- **Responsibilities:**
- Initializes Twig environment with proper paths
- Renders Twig templates from both admin and frontend directories
- Handles template caching and error handling
## Important Implementation Details
### Price Calculation Logic
**Package Pricing** (exact match):
```php
// In cart: if quantity == 10 and package exists for 10, use package price
if ($quantity == $package['qty']) {
$unit_price = $package['price'] / $quantity; // Total price divided by quantity
$product->set_price($unit_price); // WooCommerce expects unit price
}
```
**Tier Pricing** (range-based):
```php
// In cart: if quantity >= 10, use tier price for quantities 10+
foreach ($tiers as $tier) {
if ($quantity >= $tier['min_qty']) {
$applicable_price = $tier['price']; // This is already unit price
}
}
$product->set_price($applicable_price);
```
### Quantity Restriction Feature
Products can be configured to ONLY allow purchase in package quantities:
- **Global setting:** `wc_tpp_restrict_package_quantities`
- **Per-product setting:** `_wc_tpp_restrict_to_packages`
- **When enabled:**
- Quantity inputs are hidden on product page, cart, and mini-cart
- Customers must use package selection buttons
- Validation prevents arbitrary quantities from being added
- Catalog buttons change to "View Options" instead of "Add to Cart"
### WooCommerce Blocks Compatibility
**CRITICAL BUG FIXED in v1.1.20:**
- Filter `woocommerce_store_api_product_quantity_editable` passes `WC_Product` object, NOT cart item array
- Previous code tried to use product object as array → fatal error
- Fixed by accepting product object and using `$product->get_id()`
### Cart Item Metadata
The plugin stores additional data in cart items for display purposes:
```php
WC()->cart->cart_contents[$cart_item_key]['wc_tpp_pricing_type'] = 'package' | 'tier';
WC()->cart->cart_contents[$cart_item_key]['wc_tpp_total_price'] = 99.99; // For packages
WC()->cart->cart_contents[$cart_item_key]['wc_tpp_unit_price'] = 9.99; // For tiers
```
This metadata is used by display filters to show "(Package price)" or "(Volume discount)" labels.
## Common Patterns & Conventions
### Class Instantiation Pattern
All classes auto-instantiate at the end of their file:
```php
if (!class_exists('WC_TPP_Frontend')) {
class WC_TPP_Frontend {
// class code
}
}
new WC_TPP_Frontend(); // Auto-instantiate
```
**Exception:** Admin and Settings classes use singleton pattern to prevent duplicates.
### Security Best Practices
- All user inputs are sanitized (integers for quantities/prices)
- Nonce verification on form submissions
- Capability checks (`edit_products`) before saving
- 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-tier-package-prices')
_e('Text to translate', 'wc-tier-package-prices')
```
Text domain: `wc-tier-package-prices`
## Known Issues & Historical Context
### Settings Page Duplication Saga (v1.1.15-1.1.19)
Multiple versions attempted to fix settings page appearing twice:
- **Root cause:** Settings file auto-instantiation + Composer autoloader
- **Solution:** Removed auto-instantiation from settings file, explicit instantiation in admin class
- **Prevention:** Singleton pattern + duplicate detection in array
### Class Redeclaration Issues (v1.1.8-1.1.14)
Plugin was completely non-functional:
- **Cause:** Incorrect initialization pattern without `class_exists()` guards
- **Solution:** Added guards and restored direct instantiation pattern
- **Lesson:** Always wrap class declarations in `class_exists()` checks
### WooCommerce Blocks Fatal Error (v1.1.19 → v1.1.20)
```
Fatal error: Cannot use object of type WC_Product_Simple as array
Location: includes/class-wc-tpp-cart.php:233
```
- **Cause:** Filter signature mismatch - expected array, received product object
- **Fix:** Changed method signature to accept `WC_Product $product` instead of `$cart_item` array
- **Status:** FIXED in v1.1.20
## Release Process
### Version Bumping
Update version in 3 places:
1. `wc-tier-and-package-prices.php` - Plugin header comment (line 7)
2. `wc-tier-and-package-prices.php` - `WC_TPP_VERSION` constant (line 26)
3. `composer.json` - version field (optional, not critical)
### Creating Release Package
```bash
# From project root
cd releases
# Create zip excluding dev files
zip -r wc-tier-and-package-prices-X.X.X.zip .. \
-x '*.git*' '*.log' '.claude/*' 'releases/*' 'node_modules/*' \
'.DS_Store' 'Thumbs.db' '.vscode/*' '.idea/*' '*.sublime-*' \
'notes.*' 'logs/*' 'templates/cache/*' 'composer.lock'
# Generate checksums
md5sum wc-tier-and-package-prices-X.X.X.zip > wc-tier-and-package-prices-X.X.X.zip.md5
sha256sum wc-tier-and-package-prices-X.X.X.zip > wc-tier-and-package-prices-X.X.X.zip.sha256
```
**IMPORTANT:** The `vendor/` directory MUST be included in releases (Twig dependency required for runtime).
### 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/`, `.idea/`)
- Logs and cache files
- Previous releases
- `composer.lock` (but `vendor/` is included)
## Testing Checklist
When making changes, test these critical paths:
### Admin
- [ ] Settings page appears once under WooCommerce > Tier & Package Prices
- [ ] Settings save correctly
- [ ] Product edit page shows tier/package meta boxes
- [ ] Adding/removing tiers works
- [ ] Adding/removing packages works
- [ ] Data saves when clicking "Update" on product
### Frontend (Product Page)
- [ ] Pricing tables display when configured
- [ ] Package buttons update quantity selector
- [ ] Price updates dynamically when quantity changes
- [ ] Restricted products hide quantity input
- [ ] "View Options" appears on catalog for restricted products
### Cart & Checkout
- [ ] Correct prices applied for tier pricing
- [ ] Correct prices applied for package pricing
- [ ] Cart displays pricing type labels
- [ ] Package quantities can't be edited if restricted
- [ ] Prices recalculate if quantity changed (non-restricted products)
- [ ] Checkout totals are correct
### WooCommerce Blocks (Critical!)
- [ ] Mini cart block doesn't throw fatal errors
- [ ] Cart block works correctly
- [ ] Checkout block processes orders
- [ ] Quantity editable flag works for blocks
## Development Tips for Future AI Assistants
### When Debugging Cart Issues
1. Check `includes/class-wc-tpp-cart.php` first
2. The `apply_tier_package_pricing()` method runs on `woocommerce_before_calculate_totals`
3. Always validate product objects with `is_a($product, 'WC_Product')`
4. Remember: WooCommerce expects UNIT prices, not total prices (except for internal calculations)
### When Working with WooCommerce Hooks
- WooCommerce has both classic and block-based systems
- Classic cart uses different hooks than Store API (blocks)
- Always check filter/action documentation for parameter types
- Don't assume cart item arrays everywhere - sometimes it's product objects!
### When Adding Features
- Follow the existing pattern: add setting → add UI → add logic → add template
- Use Twig for all new templates (consistency)
- Add translations for all user-facing strings
- Test with both simple products and variable products (if applicable)
- Consider both classic and block-based cart/checkout
### When Fixing Bugs
1. Check `CHANGELOG.md` for historical context
2. Look for similar issues in past versions
3. Always add detailed changelog entry explaining root cause
4. Consider edge cases (guest checkout, logged-in users, AJAX add-to-cart, etc.)
## File Locations Quick Reference
| Task | File(s) |
|------|---------|
| Change version | `wc-tier-and-package-prices.php` (2 places) |
| Add global setting | `includes/class-wc-tpp-settings.php` |
| Modify product meta box | `includes/class-wc-tpp-product-meta.php` + `templates/admin/*.twig` |
| Change product page display | `includes/class-wc-tpp-frontend.php` + `templates/frontend/*.twig` |
| Fix cart pricing | `includes/class-wc-tpp-cart.php` |
| Update styles | `assets/css/frontend.css` or `assets/css/admin.css` |
| Fix JavaScript bugs | `assets/js/frontend.js` or `assets/js/admin.js` |
| Add translations | `languages/*.po` then compile to `.mo` |
| Document changes | `CHANGELOG.md` |
## Compatibility Notes
### WordPress
- Minimum: 6.0
- Tested up to: 6.9.x
- Uses standard plugin API, no deprecated functions
### WooCommerce
- Minimum: 8.0
- Tested up to: 10.x
- HPOS compatible (declared via `FeaturesUtil::declare_compatibility`)
- Blocks compatible (with proper filter handling)
### PHP
- Minimum: 7.4
- Uses modern PHP features (type hints acceptable in new code)
- Composer autoloader handles namespacing
### Browsers
- Modern browsers (ES6+ JavaScript)
- Responsive CSS (mobile-friendly)
- jQuery dependency (WooCommerce provides)
## Support & Resources
- **Repository:** https://src.bundespruefstelle.ch/magdev/wc-tier-package-prices
- **Documentation:** See `README.md`, `QUICKSTART.md`, `USAGE_EXAMPLES.md`, `INSTALLATION.md`
- **Changelog:** `CHANGELOG.md` (detailed version history)
- **Issue Tracking:** Check fatal-errors-*.log files for production errors
## Final Notes
This is a production-quality plugin with real-world usage. Any changes should:
1. Maintain backward compatibility with existing tier/package configurations
2. Not break WooCommerce core functionality
3. Work with both classic and block-based themes
4. Be thoroughly tested before release
5. Include proper error handling and validation
6. Update CHANGELOG.md with detailed explanations
The plugin architecture is solid and well-tested. Most bugs arise from:
- WooCommerce API changes (especially blocks)
- Filter/action signature changes
- Edge cases in cart calculations
- Settings persistence issues
Always refer to this document when starting work on this project. Good luck!

View File

@@ -1,5 +1,7 @@
# WooCommerce Tier and Package Prices
__THIS PROJECT IS 100% VIBE-CODED USING CLAUDE.AI__
A powerful WooCommerce plugin that adds tier pricing and package pricing functionality to your products with configurable quantities at fixed prices.
## Features

View File

@@ -50,11 +50,13 @@
.wc-tpp-table tbody tr {
border-bottom: 1px solid #e0e0e0;
transition: background-color 0.2s;
transition: all 0.2s;
cursor: pointer;
}
.wc-tpp-table tbody tr:hover {
background: #f5f5f5;
transform: translateX(2px);
}
.wc-tpp-table tbody tr.wc-tpp-active-tier {
@@ -67,6 +69,14 @@
font-size: 0.95em;
}
.wc-tpp-tier-label {
display: inline-block;
margin-top: 4px;
color: #666;
font-style: italic;
font-size: 0.9em;
}
/* Package pricing */
.wc-tpp-packages {
display: grid;
@@ -161,8 +171,15 @@ a.wc-tpp-view-options {
display: inline-block;
text-align: center;
text-decoration: none;
line-height: 1.5;
position: relative;
/* Match WooCommerce button styling */
font-size: 1em;
font-weight: 700;
padding: 0.618em 1em;
line-height: 1.5;
border-radius: 3px;
cursor: pointer;
transition: all 0.2s ease;
}
a.wc-tpp-view-options::before {
@@ -170,8 +187,15 @@ a.wc-tpp-view-options::before {
font-family: "dashicons";
margin-right: 5px;
display: inline-block;
font-size: 1.1em;
font-size: 1em;
vertical-align: middle;
line-height: 1;
}
/* Hover state for View Options button */
a.wc-tpp-view-options:hover {
opacity: 0.85;
text-decoration: none;
}
/* Cart quantity display for restricted products */
@@ -195,6 +219,14 @@ a.wc-tpp-view-options::before {
font-size: 0.95em;
}
/* Disabled add to cart button */
.single_add_to_cart_button.disabled,
.single_add_to_cart_button:disabled {
opacity: 0.5;
cursor: not-allowed;
pointer-events: none;
}
/* Responsive design */
@media (max-width: 768px) {
.wc-tpp-packages {

View File

@@ -8,6 +8,7 @@
$(document).ready(function() {
const $quantityInput = $('input.qty');
const $priceDisplay = $('.woocommerce-Price-amount.amount').first();
const $addToCartButton = $('.single_add_to_cart_button');
const isRestrictedMode = $('.wc-tpp-package-pricing-table').hasClass('wc-tpp-restricted-mode');
if ($quantityInput.length === 0 && !isRestrictedMode) {
@@ -154,9 +155,35 @@
$('.wc-tpp-price-message').remove();
}
// Toggle add to cart button state based on quantity
function updateAddToCartButton() {
const quantity = parseInt($quantityInput.val()) || 0;
if (quantity <= 0) {
$addToCartButton.prop('disabled', true).addClass('disabled');
} else {
$addToCartButton.prop('disabled', false).removeClass('disabled');
}
}
// Handle quantity input changes
$quantityInput.on('input change', function() {
updatePriceDisplay();
updateAddToCartButton();
});
// Handle tier pricing row clicks
$('.wc-tpp-tier-pricing-table tbody tr').on('click', function() {
const minQty = parseInt($(this).data('min-qty'));
if ($quantityInput.length > 0 && !isRestrictedMode) {
$quantityInput.val(minQty).trigger('change');
// Scroll to quantity input for better UX
$('html, body').animate({
scrollTop: $quantityInput.offset().top - 100
}, 300);
}
});
// Handle package selection
@@ -212,6 +239,11 @@
if (!isRestrictedMode) {
updatePriceDisplay();
}
// Initial button state check
if ($quantityInput.length > 0 && $addToCartButton.length > 0) {
updateAddToCartButton();
}
});
})(jQuery);

View File

@@ -1,7 +1,7 @@
{
"name": "magdev/wc-tier-package-prices",
"description": "WooCommerce plugin for tier pricing and package prices with Twig templates",
"version": "1.1.2",
"version": "1.1.19",
"type": "wordpress-plugin",
"license": "GPL-2.0-or-later",
"authors": [

View File

@@ -7,9 +7,20 @@ if (!defined('ABSPATH')) {
exit;
}
class WC_TPP_Admin {
if (!class_exists('WC_TPP_Admin')) {
class WC_TPP_Admin {
public function __construct() {
private static $instance = null;
private static $settings_instance = null;
public static function get_instance() {
if (null === self::$instance) {
self::$instance = new self();
}
return self::$instance;
}
private function __construct() {
add_filter('woocommerce_get_settings_pages', array($this, 'add_settings_page'));
add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts'));
}
@@ -18,7 +29,32 @@ class WC_TPP_Admin {
* Add settings page to WooCommerce settings
*/
public function add_settings_page($settings) {
$settings[] = include WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-settings.php';
if (null === self::$settings_instance) {
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-settings.php';
self::$settings_instance = new WC_TPP_Settings();
}
// Check if our settings page is already in the array to prevent duplicates
// Check by class type and ID instead of instance comparison
foreach ($settings as $settings_page) {
if ($settings_page instanceof WC_TPP_Settings) {
return $settings;
}
// Also check by ID property if it's a WC_Settings_Page
if (is_object($settings_page) &&
method_exists($settings_page, 'get_id') &&
$settings_page->get_id() === 'tier_package_prices') {
return $settings;
}
// Check id property directly
if (is_object($settings_page) &&
isset($settings_page->id) &&
$settings_page->id === 'tier_package_prices') {
return $settings;
}
}
$settings[] = self::$settings_instance;
return $settings;
}
@@ -30,4 +66,5 @@ class WC_TPP_Admin {
}
}
new WC_TPP_Admin();
WC_TPP_Admin::get_instance();
}

View File

@@ -7,14 +7,20 @@ if (!defined('ABSPATH')) {
exit;
}
class WC_TPP_Cart {
if (!class_exists('WC_TPP_Cart')) {
class WC_TPP_Cart {
public function __construct() {
add_action('woocommerce_before_calculate_totals', array($this, 'apply_tier_package_pricing'), 10, 1);
add_filter('woocommerce_cart_item_price', array($this, 'display_cart_item_price'), 10, 3);
add_filter('woocommerce_cart_item_subtotal', array($this, 'display_cart_item_subtotal'), 10, 3);
add_filter('woocommerce_add_to_cart_validation', array($this, 'validate_package_quantity'), 10, 3);
add_filter('woocommerce_cart_item_quantity', array($this, 'maybe_hide_cart_quantity_input'), 10, 3);
add_filter('woocommerce_cart_item_quantity', array($this, 'maybe_hide_cart_quantity_input'), 999, 3);
add_filter('woocommerce_widget_cart_item_quantity', array($this, 'maybe_hide_mini_cart_quantity_input'), 999, 3);
add_action('wp_head', array($this, 'add_cart_quantity_css'));
// WooCommerce Blocks support
add_filter('woocommerce_store_api_product_quantity_editable', array($this, 'block_quantity_editable'), 10, 2);
}
public function apply_tier_package_pricing($cart) {
@@ -151,11 +157,102 @@ class WC_TPP_Cart {
// If restriction is enabled and packages exist, show quantity as text only
if (($global_restrict || $product_restrict) && !empty($packages)) {
return sprintf('<span class="wc-tpp-cart-quantity">%s</span>', $cart_item['quantity']);
return sprintf('<span class="wc-tpp-cart-quantity wc-tpp-restricted-qty" data-product-id="%d">%s</span>',
$product_id,
$cart_item['quantity']
);
}
return $product_quantity;
}
public function maybe_hide_mini_cart_quantity_input($product_quantity, $cart_item, $cart_item_key) {
$product_id = $cart_item['product_id'];
// Check if restriction is enabled globally or for this product
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
// Get packages for this product
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
// If restriction is enabled and packages exist, show quantity as text only
if (($global_restrict || $product_restrict) && !empty($packages)) {
return sprintf('<span class="wc-tpp-cart-quantity wc-tpp-restricted-qty" data-product-id="%d">%s &times;</span>',
$product_id,
$cart_item['quantity']
);
}
return $product_quantity;
}
public function add_cart_quantity_css() {
// Get all cart items and check which products have restrictions
if (!function_exists('WC') || !WC()->cart || is_admin()) {
return;
}
$restricted_products = array();
foreach (WC()->cart->get_cart() as $cart_item) {
$product_id = $cart_item['product_id'];
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
if (($global_restrict || $product_restrict) && !empty($packages)) {
$restricted_products[] = $product_id;
}
}
if (!empty($restricted_products)) {
echo '<style type="text/css">';
foreach ($restricted_products as $product_id) {
// Hide quantity inputs for restricted products in cart (classic cart)
echo '.cart_item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] + .quantity,';
echo '.cart_item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] ~ .quantity,';
echo '.woocommerce-mini-cart-item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] + .quantity,';
echo '.woocommerce-mini-cart-item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] ~ .quantity { display: none !important; }';
// Hide WooCommerce blocks quantity selector for restricted products
echo '.wc-block-cart-item[data-product-id="' . esc_attr($product_id) . '"] .wc-block-components-quantity-selector,';
echo '.wc-block-mini-cart__items .wc-block-cart-item[data-product-id="' . esc_attr($product_id) . '"] .wc-block-components-quantity-selector { display: none !important; }';
}
echo '</style>';
}
}
/**
* Make quantity non-editable for restricted products in WooCommerce blocks
*
* @param bool $editable Whether the quantity is editable
* @param WC_Product $product Product object
* @return bool
*/
public function block_quantity_editable($editable, $product) {
// Validate product object
if (!$product || !is_a($product, 'WC_Product')) {
return $editable;
}
$product_id = $product->get_id();
if (!$product_id) {
return $editable;
}
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
// If restriction is enabled and packages exist, make quantity non-editable
if (($global_restrict || $product_restrict) && !empty($packages)) {
return false;
}
return $editable;
}
}
new WC_TPP_Cart();
}

View File

@@ -7,7 +7,8 @@ if (!defined('ABSPATH')) {
exit;
}
class WC_TPP_Frontend {
if (!class_exists('WC_TPP_Frontend')) {
class WC_TPP_Frontend {
public function __construct() {
add_action('wp_enqueue_scripts', array($this, 'enqueue_scripts'));
@@ -184,3 +185,4 @@ class WC_TPP_Frontend {
}
new WC_TPP_Frontend();
}

View File

@@ -7,7 +7,8 @@ if (!defined('ABSPATH')) {
exit;
}
class WC_TPP_Product_Meta {
if (!class_exists('WC_TPP_Product_Meta')) {
class WC_TPP_Product_Meta {
public function __construct() {
add_action('woocommerce_product_options_pricing', array($this, 'add_tier_pricing_fields'));
@@ -81,7 +82,7 @@ class WC_TPP_Product_Meta {
</div>
<script type="text/html" id="wc-tpp-tier-row-template">
<?php $this->render_tier_row('{{INDEX}}', array('min_qty' => '', 'price' => '')); ?>
<?php $this->render_tier_row('{{INDEX}}', array('min_qty' => '', 'price' => '', 'label' => '')); ?>
</script>
<script type="text/html" id="wc-tpp-package-row-template">
@@ -127,7 +128,8 @@ class WC_TPP_Product_Meta {
if (!empty($tier['min_qty']) && !empty($tier['price'])) {
$tiers[] = array(
'min_qty' => absint($tier['min_qty']),
'price' => wc_format_decimal($tier['price'])
'price' => wc_format_decimal($tier['price']),
'label' => sanitize_text_field($tier['label'] ?? '')
);
}
}
@@ -168,3 +170,4 @@ class WC_TPP_Product_Meta {
}
new WC_TPP_Product_Meta();
}

View File

@@ -18,7 +18,8 @@ if (!class_exists('WC_Settings_Page')) {
/**
* WC_TPP_Settings class
*/
class WC_TPP_Settings extends WC_Settings_Page {
if (!class_exists('WC_TPP_Settings')) {
class WC_TPP_Settings extends WC_Settings_Page {
/**
* Constructor
@@ -139,5 +140,4 @@ class WC_TPP_Settings extends WC_Settings_Page {
WC_Admin_Settings::save_fields($settings);
}
}
return new WC_TPP_Settings();
}

View File

@@ -3,7 +3,7 @@
# This file is distributed under the GPL v2 or later.
msgid ""
msgstr ""
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.2\n"
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.6\n"
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
"PO-Revision-Date: 2025-12-21 00:00+0000\n"

View File

@@ -3,7 +3,7 @@
# This file is distributed under the GPL v2 or later.
msgid ""
msgstr ""
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.2\n"
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.6\n"
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
"PO-Revision-Date: 2025-12-21 00:00+0000\n"

View File

@@ -3,7 +3,7 @@
# This file is distributed under the GPL v2 or later.
msgid ""
msgstr ""
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.2\n"
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.6\n"
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
"PO-Revision-Date: 2025-12-21 00:00+0000\n"

View File

@@ -2,7 +2,7 @@
# This file is distributed under the GPL v2 or later.
msgid ""
msgstr ""
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.2\n"
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.6\n"
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
"MIME-Version: 1.0\n"

View File

@@ -1,127 +0,0 @@
# WooCommerce Tier and Package Prices - Release 1.0.1
**Release Date:** December 21, 2025
**Version:** 1.0.1
**Package Size:** 395 KB
**Git Tag:** v1.0.1
## Download
**File:** `wc-tier-and-package-prices-1.0.1.zip`
### Checksums
**SHA256:**
```
92c1385d92527e77646e37f23c1bd1555a4290a5ec9314c0ee6ed896ded55e88
```
**MD5:**
```
e6cfc9b88df9e7763be0cd56517ce8ab
```
## Installation
1. Download the ZIP file: `wc-tier-and-package-prices-1.0.1.zip`
2. Log in to your WordPress admin panel
3. Navigate to **Plugins > Add New > Upload Plugin**
4. Choose the downloaded ZIP file
5. Click **Install Now**
6. After installation, click **Activate Plugin**
### Requirements
- **WordPress:** 6.0 or higher
- **PHP:** 7.4 or higher
- **WooCommerce:** 8.0 or higher
## What's New in 1.0.1
### New Features
-**Twig Template Engine** - Modern template system with automatic escaping
-**Swiss German Translation** - Added de_CH_informal translation
-**Template Caching** - Improved performance with compiled templates
-**Composer Integration** - Professional dependency management
### Improvements
- 🔄 Migrated all templates from PHP to Twig format
- 🔒 Enhanced security with automatic HTML escaping
- 📁 Better template organization (admin/ and frontend/ directories)
- 🎨 Cleaner separation of logic and presentation
### Technical Changes
- Added Twig v3.22.2 dependency
- Created WC_TPP_Template_Loader class for centralized rendering
- Integrated WordPress functions (__(), wc_price(), etc.) into Twig
- Optimized autoloader for production
- Removed legacy PHP templates
## Package Contents
The installation package includes:
### Core Files
- `wc-tier-and-package-prices.php` - Main plugin file
- `composer.json` - Dependency configuration
- `CHANGELOG.md` - Full version history
- `README.md` - Plugin documentation
### Directories
- `includes/` - PHP class files
- `class-wc-tpp-admin.php`
- `class-wc-tpp-cart.php`
- `class-wc-tpp-frontend.php`
- `class-wc-tpp-product-meta.php`
- `class-wc-tpp-template-loader.php`
- `templates/` - Twig template files
- `admin/` - Admin interface templates
- `frontend/` - Customer-facing templates
- `languages/` - Translation files
- de_CH_informal (Swiss German, Informal)
- de_DE (German, Germany)
- en_US (English, US)
- `assets/` - CSS and JavaScript files
- `vendor/` - Composer dependencies (Twig)
## Translations Included
1. **English (US)** - en_US ✅
2. **German (Germany)** - de_DE ✅
3. **German (Switzerland, Informal)** - de_CH_informal ✅ NEW!
## Features
### Tier Pricing
- Quantity-based discount tiers
- Automatic price calculation
- Volume discount display
### Package Pricing
- Fixed-price bundles
- Custom package labels
- Multiple package options per product
### Admin Features
- Easy-to-use product meta boxes
- Configurable display positions
- Settings page for global options
### Frontend Features
- Beautiful pricing tables
- Real-time cart updates
- Responsive design
## Support
- **Documentation:** See README.md and USAGE_EXAMPLES.md
- **Issues:** https://src.bundespruefstelle.ch/wc-tier-package-prices/issues
- **Author:** Marco Graetsch
## License
GPL v2 or later - https://www.gnu.org/licenses/gpl-2.0.html
---
**Note:** This is a production-ready package with optimized autoloader and no development dependencies.

View File

@@ -1,198 +0,0 @@
# WooCommerce Tier and Package Prices - Release 1.0.2
**Release Date:** December 21, 2025
**Version:** 1.0.2
**Package Size:** 396 KB
**Git Tag:** v1.0.2
## Download
**File:** `wc-tier-and-package-prices-1.0.2.zip`
### Checksums
**SHA256:**
```
c1a5339da10b3625156b8fff4ec848e4a1318d6edc497bd5026cfe0a3ef39daa
```
**MD5:**
```
830f443ce4b65e2ca9cfede3257bc4f5
```
## What's New in 1.0.2
### Major Changes
-**Settings Migrated to WooCommerce Settings Page**
- Settings now appear as a dedicated tab: **WooCommerce > Settings > Tier & Package Prices**
- Removed standalone submenu for better integration
- Consistent UI with native WooCommerce settings
### Improvements
- 🔄 Uses WooCommerce's native settings API (WC_Settings_Page)
- 🎨 Better integration with WooCommerce admin interface
- 💾 Automatic settings persistence via WooCommerce
- 🌍 Updated all translations with new settings strings
### New Features
- ✨ WC_TPP_Settings class for proper WooCommerce integration
- 📝 9 new translatable strings in all languages
- 🔧 Enhanced tooltips and descriptions for better UX
### Technical Changes
- Implemented `woocommerce_get_settings_pages` filter hook
- Uses `WC_Admin_Settings` for rendering and saving
- Removed custom Twig settings template
- Updated all translation files to version 1.0.2
### Removed
- ❌ Standalone settings submenu (WooCommerce > Tier & Package Prices)
- ❌ Custom settings template (templates/admin/settings-page.twig)
## Installation
1. Download the ZIP file: `wc-tier-and-package-prices-1.0.2.zip`
2. Log in to your WordPress admin panel
3. Navigate to **Plugins > Add New > Upload Plugin**
4. Choose the downloaded ZIP file
5. Click **Install Now**
6. After installation, click **Activate Plugin**
7. Go to **WooCommerce > Settings > Tier & Package Prices** to configure
### Upgrade from 1.0.1
This is a **minor update** with improved settings integration. No data migration needed.
**Steps:**
1. Deactivate the current version
2. Upload and activate version 1.0.2
3. Your existing settings will be automatically preserved
4. Settings location changed: Now under **WooCommerce > Settings** tab
### Requirements
- **WordPress:** 6.0 or higher
- **PHP:** 7.4 or higher
- **WooCommerce:** 8.0 or higher
## Translation Updates
All translation files updated with new strings:
### New Translations (9 new strings)
1. "General" - Settings section
2. "Tier & Package Prices Settings" - Section title
3. "Configure tier pricing and package pricing options..." - Description
4. "Allow quantity-based pricing tiers..." - Tooltip
5. "Allow fixed-price packages..." - Tooltip
6. "Display the pricing table to customers..." - Tooltip
7. "Choose where to display the pricing table..." - Description
8. "Before Add to Cart Button" - Option
9. "After Add to Cart Button" - Option
### Languages Included
- 🇺🇸 **English (US)** - en_US - Fully updated
- 🇩🇪 **German (Germany)** - de_DE - Fully updated (formal "Sie")
- 🇨🇭 **German (Switzerland, Informal)** - de_CH_informal - Fully updated (informal "du")
## Package Contents
The installation package includes:
### Core Files
- `wc-tier-and-package-prices.php` (v1.0.2)
- `composer.json` - Updated to 1.0.2
- `CHANGELOG.md` - Full version history
### New/Modified Files
- `includes/class-wc-tpp-settings.php` ✨ NEW
- `includes/class-wc-tpp-admin.php` - Updated
- All translation files (.po/.mo) - Updated
### Complete Directory Structure
```
wc-tier-and-package-prices/
├── assets/ # CSS and JavaScript
│ ├── css/
│ └── js/
├── includes/ # PHP classes
│ ├── class-wc-tpp-admin.php
│ ├── class-wc-tpp-cart.php
│ ├── class-wc-tpp-frontend.php
│ ├── class-wc-tpp-product-meta.php
│ ├── class-wc-tpp-settings.php ✨ NEW
│ └── class-wc-tpp-template-loader.php
├── languages/ # Translation files (all updated)
│ ├── wc-tier-package-prices-de_CH_informal.po/mo
│ ├── wc-tier-package-prices-de_DE.po/mo
│ ├── wc-tier-package-prices-en_US.po/mo
│ └── wc-tier-package-prices.pot
├── templates/ # Twig templates
│ ├── admin/
│ │ ├── package-row.twig
│ │ └── tier-row.twig
│ └── frontend/
│ ├── package-pricing-display.twig
│ ├── pricing-table.twig
│ └── tier-pricing-table.twig
├── vendor/ # Composer dependencies
│ └── twig/twig/ (v3.22.2)
├── CHANGELOG.md
├── README.md
└── composer.json
```
## Features (Complete List)
### Tier Pricing
- ✅ Quantity-based discount tiers
- ✅ Automatic price calculation
- ✅ Volume discount display
### Package Pricing
- ✅ Fixed-price bundles
- ✅ Custom package labels
- ✅ Multiple package options per product
### Admin Features
-**WooCommerce Settings integration** (NEW in 1.0.2)
- ✅ Easy-to-use product meta boxes
- ✅ Configurable display positions
- ✅ Native WooCommerce UI
### Frontend Features
- ✅ Beautiful pricing tables (Twig templates)
- ✅ Real-time cart updates
- ✅ Responsive design
- ✅ 3 languages supported
## Migration Notes
### Settings Location Changed
**Old Location:** WooCommerce > Tier & Package Prices
**New Location:** WooCommerce > Settings > Tier & Package Prices
All your existing settings are automatically preserved and will appear in the new location.
### Benefits of New Location
1. ✅ Better discoverability - users expect settings under Settings
2. ✅ Consistent with WooCommerce patterns
3. ✅ Native WooCommerce UI/UX
4. ✅ Better mobile support
5. ✅ Follows WordPress/WooCommerce best practices
## Support
- **Documentation:** See README.md and USAGE_EXAMPLES.md
- **Changelog:** See CHANGELOG.md for detailed changes
- **Issues:** https://src.bundespruefstelle.ch/wc-tier-package-prices/issues
- **Author:** Marco Graetsch
## License
GPL v2 or later - https://www.gnu.org/licenses/gpl-2.0.html
---
**Production Ready:** This package includes optimized autoloader and no development dependencies.

View File

@@ -1,345 +0,0 @@
# WooCommerce Tier and Package Prices - Release 1.1.0
**Release Date:** December 21, 2025
**Version:** 1.1.0
**Package Size:** 387 KB
**Git Tag:** v1.1.0
## Download
**File:** `wc-tier-and-package-prices-1.1.0.zip`
### Checksums
**SHA256:**
```
da6b462f3dc297b282ed0da258b78fd9f2f82f3e76289c4c8fadd1ac9e02c55b
```
**MD5:**
```
ef68125c54b0c10f04ba82d48a98b4aa
```
## What's New in 1.1.0
### Major Features
-**Package Quantity Restriction** - NEW
- Limit product purchases to predefined package sizes only
- Perfect for bulk-only sales, sample packs, or fixed bundle quantities
- Global and per-product configuration options
### New Settings
- 🌍 **Global Restriction Setting**
- Enable quantity restrictions site-wide
- Located in: WooCommerce > Settings > Tier & Package Prices
- Description: "Limit quantities to defined package sizes only"
- 📦 **Per-Product Restriction Setting**
- Override global setting on individual products
- Located in: Product Edit > Package Pricing section
- Checkbox: "Restrict to Package Quantities"
### Frontend Enhancements
- 🎨 **Enhanced Package Selection UI**
- Automatic quantity field hiding when restriction is enabled
- Clear notice: "Choose a package size below"
- Visual package selection with highlighted states
- Responsive package selection buttons
-**Client-Side Validation**
- JavaScript prevents form submission without package selection
- Alert message guides users to select a package
- Real-time visual feedback on selection
### Backend Validation
- 🛡️ **Server-Side Cart Validation**
- Validates quantity matches defined packages
- Prevents manual quantity manipulation
- User-friendly error messages
- Example: "The quantity 15 is not available for Product Name. Please choose from the available package sizes: 10, 20, 50"
### Technical Improvements
- New method: `WC_TPP_Cart::validate_package_quantity()`
- New method: `WC_TPP_Frontend::maybe_hide_quantity_input()`
- Enhanced `woocommerce_add_to_cart_validation` filter integration
- Added `wc-tpp-restricted-mode` CSS class
- Added `wc-tpp-package-selectable` CSS class for styling
- New product meta key: `_wc_tpp_restrict_to_packages`
- New global option: `wc_tpp_restrict_package_quantities`
### Translations
- Added 7 new translatable strings
- Updated all language files (en_US, de_DE, de_CH_informal)
- All .mo files recompiled with new strings
## Installation
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.0.zip`
2. Log in to your WordPress admin panel
3. Navigate to **Plugins > Add New > Upload Plugin**
4. Choose the downloaded ZIP file
5. Click **Install Now**
6. After installation, click **Activate Plugin**
7. Go to **WooCommerce > Settings > Tier & Package Prices** to configure
### Upgrade from 1.0.x
This is a **minor version** update with new features. No data migration needed.
**Steps:**
1. Deactivate the current version
2. Upload and activate version 1.1.0
3. All existing settings and data will be automatically preserved
4. Review new restriction settings if desired
### Upgrade from 1.0.2
No breaking changes. Safe to upgrade directly. New restriction feature is disabled by default.
### Requirements
- **WordPress:** 6.0 or higher
- **PHP:** 7.4 or higher
- **WooCommerce:** 8.0 or higher
## New Strings Translation Reference
All new strings in this release:
### Settings Page
1. "Restrict to Package Quantities" - Checkbox label
2. "Limit quantities to defined package sizes only" - Checkbox description
3. "When enabled, customers can only purchase..." - Tooltip text
### Product Meta Box
4. "Restrict to Package Quantities" - Checkbox label (same as above)
5. "Only allow quantities defined in packages above" - Tooltip text
### Frontend Display
6. "Choose a package size below" - User notice in restricted mode
### Cart Validation
7. "this product" - Fallback product name
8. "The quantity %1$d is not available for %2$s..." - Error message template
## Use Cases
### Bulk-Only Sales
Enable restriction globally to sell products only in bulk quantities.
**Example:**
- Package 1: 100 units at $500
- Package 2: 250 units at $1,100
- Package 3: 500 units at $2,000
Customers can only purchase these exact quantities.
### Sample Packs
Create fixed sample packs with no custom quantities.
**Example:**
- Starter Pack: 10 items
- Trial Pack: 25 items
- Full Pack: 50 items
### Promotional Bundles
Offer promotional pricing only for specific bundle sizes.
**Example:**
- Holiday Bundle: 12 units (seasonal pricing)
- Party Pack: 24 units (bulk discount)
- Wholesale Bundle: 100 units (wholesale pricing)
## Configuration Examples
### Example 1: Site-Wide Restriction
**Scenario:** All products should only be sold in packages
**Configuration:**
1. Go to WooCommerce > Settings > Tier & Package Prices
2. Check "Restrict to Package Quantities"
3. Save changes
4. Configure package sizes for each product
**Result:** All products with packages defined will enforce quantity restrictions
### Example 2: Per-Product Restriction
**Scenario:** Only specific products need quantity restrictions
**Configuration:**
1. Leave global setting unchecked
2. Edit the specific product
3. Scroll to Package Pricing section
4. Check "Restrict to Package Quantities"
5. Update product
**Result:** Only that product enforces restrictions
### Example 3: Mixed Approach
**Scenario:** Most products are restricted, but some allow custom quantities
**Configuration:**
1. Enable global restriction
2. For products that should allow custom quantities, simply don't define any packages
3. Products without packages defined won't show restrictions
## Feature Compatibility
### Works With
- ✅ WooCommerce 8.0 - 10.0
- ✅ WordPress 6.0+
- ✅ HPOS (High-Performance Order Storage)
- ✅ All WooCommerce themes
- ✅ Tier pricing (can use both features together)
- ✅ Package pricing (required for restriction)
- ✅ All pricing table display positions
### Requirements for Restriction Feature
- Product must have at least one package defined
- Either global or per-product restriction must be enabled
- Package pricing must be enabled in settings
## Package Contents
The installation package includes all files from version 1.0.2 plus:
### Modified Files
- `wc-tier-and-package-prices.php` - Version updated to 1.1.0
- `composer.json` - Version updated to 1.1.0
- `CHANGELOG.md` - Added v1.1.0 section
- `includes/class-wc-tpp-settings.php` - Added restriction setting
- `includes/class-wc-tpp-product-meta.php` - Added per-product checkbox
- `includes/class-wc-tpp-frontend.php` - Added quantity hiding logic
- `includes/class-wc-tpp-cart.php` - Added validation method
- `assets/js/frontend.js` - Added restricted mode handling
- `templates/frontend/package-pricing-display.twig` - Added restriction notice
- `templates/frontend/pricing-table.twig` - Pass restriction flag
- All translation files (.po/.mo) - Updated with new strings
### Complete Directory Structure
```
wc-tier-and-package-prices/
├── assets/
│ ├── css/
│ │ ├── admin.css
│ │ └── frontend.css
│ └── js/
│ ├── admin.js
│ └── frontend.js (UPDATED)
├── includes/
│ ├── class-wc-tpp-admin.php
│ ├── class-wc-tpp-cart.php (UPDATED)
│ ├── class-wc-tpp-frontend.php (UPDATED)
│ ├── class-wc-tpp-product-meta.php (UPDATED)
│ ├── class-wc-tpp-settings.php (UPDATED)
│ └── class-wc-tpp-template-loader.php
├── languages/ (ALL UPDATED)
│ ├── wc-tier-package-prices-de_CH_informal.po/mo
│ ├── wc-tier-package-prices-de_DE.po/mo
│ ├── wc-tier-package-prices-en_US.po/mo
│ └── wc-tier-package-prices.pot
├── templates/
│ ├── admin/
│ │ ├── package-row.twig
│ │ └── tier-row.twig
│ └── frontend/
│ ├── package-pricing-display.twig (UPDATED)
│ ├── pricing-table.twig (UPDATED)
│ └── tier-pricing-table.twig
├── vendor/ (Twig v3.22.2)
├── CHANGELOG.md (UPDATED)
├── composer.json (UPDATED)
└── wc-tier-and-package-prices.php (UPDATED)
```
## Features (Complete List)
### Tier Pricing
- ✅ Quantity-based discount tiers
- ✅ Automatic price calculation
- ✅ Volume discount display
### Package Pricing
- ✅ Fixed-price bundles
- ✅ Custom package labels
- ✅ Multiple package options per product
-**NEW:** Quantity restriction to packages only
### Admin Features
- ✅ WooCommerce Settings integration
- ✅ Easy-to-use product meta boxes
- ✅ Configurable display positions
- ✅ Native WooCommerce UI
-**NEW:** Global restriction setting
-**NEW:** Per-product restriction override
### Frontend Features
- ✅ Beautiful pricing tables (Twig templates)
- ✅ Real-time cart updates
- ✅ Responsive design
- ✅ 3 languages supported
-**NEW:** Package-only selection mode
-**NEW:** Automatic quantity field hiding
-**NEW:** Visual package selection
### Validation & Security
-**NEW:** Client-side JavaScript validation
-**NEW:** Server-side cart validation
-**NEW:** User-friendly error messages
- ✅ WooCommerce HPOS compatible
## Breaking Changes
**None.** This release is fully backward compatible.
The new restriction feature is disabled by default and must be explicitly enabled.
## Migration Notes
### From 1.0.2
- No migration needed
- New settings appear automatically in admin
- Feature is disabled by default
### Settings Location
All settings remain in: **WooCommerce > Settings > Tier & Package Prices**
### Data Preservation
- All existing tier pricing data preserved
- All existing package pricing data preserved
- All product meta data preserved
- No database changes required
## Known Limitations
### Current Version
1. Restriction only works when packages are defined
2. Cannot restrict to tier quantities (only packages)
3. Restriction applies to entire product (no variation-level control)
### Future Enhancements
These features may be added in future versions:
- Variation-level restriction control
- Restrict to tier quantities option
- Minimum/maximum package selection limits
## Support
- **Documentation:** See README.md and CHANGELOG.md
- **Previous Release:** See RELEASE-INFO-1.0.2.md
- **Issues:** https://src.bundespruefstelle.ch/wc-tier-package-prices/issues
- **Author:** Marco Graetsch
## License
GPL v2 or later - https://www.gnu.org/licenses/gpl-2.0.html
---
**Production Ready:** This package includes optimized autoloader and no development dependencies.
**What's Next:** Version 1.1.0 completes the package restriction feature set. Future versions may add variation-level controls and tier quantity restrictions.

View File

@@ -1,272 +0,0 @@
# WooCommerce Tier and Package Prices - Release 1.1.1
**Release Date:** December 21, 2025
**Version:** 1.1.1
**Package Size:** 403 KB
**Git Tag:** v1.1.1
## Download
**File:** `wc-tier-and-package-prices-1.1.1.zip`
### Checksums
**SHA256:**
```
b951f8b7ddd2bad6b3415d4583709fdf88f66aea4eae70110c903757ff53e045
```
**MD5:**
```
51c4f8a7c3ccede2d2005f2fe3ebe44e
```
## What's New in 1.1.1
This is a **patch release** that enhances the package quantity restriction feature introduced in v1.1.0 by preventing cart quantity bypass.
### Security Enhancement
- **Fixed:** Cart quantity bypass vulnerability for package-restricted products
- Customers could previously modify quantities in the cart to bypass package restrictions
- This patch ensures restrictions are enforced throughout the entire purchase flow
### New Features
- **Cart Quantity Field Hiding** - NEW
- Automatic hiding of quantity input field in cart when restrictions are enabled
- Cart displays quantity as read-only text for restricted products
- Prevents manual quantity modification in shopping cart
- Seamless integration with existing restriction settings
### Technical Improvements
- Added `maybe_hide_cart_quantity_input()` method in WC_TPP_Cart class
- Extended `woocommerce_cart_item_quantity` filter hook
- New CSS class: `wc-tpp-cart-quantity` for styled quantity display
- Enhanced cart validation and display consistency
## What's Changed
### Added
- Cart quantity field hiding when package restriction is enabled
- Automatic read-only quantity display in cart for restricted products
### Changed
- Cart quantity input replaced with plain text when restrictions apply
- Enhanced cart display to prevent quantity modification for restricted products
### Fixed
- Cart quantity bypass vulnerability for package-restricted products
## Installation
### New Installation
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.1.zip`
2. Log in to your WordPress admin panel
3. Navigate to **Plugins > Add New > Upload Plugin**
4. Choose the downloaded ZIP file
5. Click **Install Now**
6. After installation, click **Activate Plugin**
7. Go to **WooCommerce > Settings > Tier & Package Prices** to configure
### Upgrade from 1.1.0
This is a **patch release** with a security fix. No configuration changes needed.
**Steps:**
1. Deactivate version 1.1.0
2. Upload and activate version 1.1.1
3. All existing settings and data will be automatically preserved
4. No additional configuration required
### Upgrade from 1.0.x
Safe to upgrade directly. This version includes all features from v1.1.0 plus the cart quantity hiding enhancement.
**Steps:**
1. Deactivate the current version
2. Upload and activate version 1.1.1
3. All existing settings and data will be automatically preserved
4. Review the new package restriction features if desired
### Requirements
- **WordPress:** 6.0 or higher
- **PHP:** 7.4 or higher
- **WooCommerce:** 8.0 or higher
## Complete Package Restriction Feature (v1.1.0 + v1.1.1)
The package quantity restriction feature now provides complete enforcement across all touchpoints:
### Product Page (v1.1.0)
- ✅ Quantity field automatically hidden when restriction enabled
- ✅ "Choose a package size below" notice displayed
- ✅ Visual package selection with highlighted states
- ✅ JavaScript validation prevents form submission without package selection
### Add to Cart Validation (v1.1.0)
- ✅ Server-side validation on add-to-cart
- ✅ User-friendly error messages showing available package sizes
- ✅ Prevents manual quantity manipulation via form fields
### Cart Page (v1.1.1 - NEW)
- ✅ Quantity field hidden/replaced with read-only text
- ✅ Prevents cart quantity modification
- ✅ Consistent restriction enforcement
- ✅ No bypass via cart updates
### Settings
- ✅ Global setting to enable restrictions site-wide
- ✅ Per-product override for individual products
- ✅ Located in: WooCommerce > Settings > Tier & Package Prices
## Use Cases
### Scenario 1: Bulk-Only Sales
Enable restriction globally to sell products only in bulk quantities.
**Example:**
- Package 1: 100 units at $500
- Package 2: 250 units at $1,100
- Package 3: 500 units at $2,000
Customers can only purchase these exact quantities on both product page and in cart.
### Scenario 2: Sample Packs
Create fixed sample packs with no custom quantities.
**Example:**
- Starter Pack: 10 items
- Trial Pack: 25 items
- Full Pack: 50 items
Quantity cannot be changed in cart - customers must return to product page to select a different package.
### Scenario 3: Promotional Bundles
Offer promotional pricing only for specific bundle sizes with no modifications allowed.
**Example:**
- Holiday Bundle: 12 units (seasonal pricing)
- Party Pack: 24 units (bulk discount)
- Wholesale Bundle: 100 units (wholesale pricing)
## Modified Files in 1.1.1
### Core Files Updated
- `wc-tier-and-package-prices.php` - Version updated to 1.1.1
- `composer.json` - Version updated to 1.1.1
- `CHANGELOG.md` - Added v1.1.1 section
### PHP Classes Modified
- `includes/class-wc-tpp-cart.php` - Added `maybe_hide_cart_quantity_input()` method
### Translation Files Updated
- `languages/wc-tier-package-prices.pot` - Version updated to 1.1.1
- `languages/wc-tier-package-prices-en_US.po` - Version updated to 1.1.1
- `languages/wc-tier-package-prices-de_DE.po` - Version updated to 1.1.1
- `languages/wc-tier-package-prices-de_CH_informal.po` - Version updated to 1.1.1
## Complete Feature Set
### Tier Pricing
- ✅ Quantity-based discount tiers
- ✅ Automatic price calculation
- ✅ Volume discount display
### Package Pricing
- ✅ Fixed-price bundles
- ✅ Custom package labels
- ✅ Multiple package options per product
- ✅ Quantity restriction to packages only (v1.1.0)
- ✅ Cart quantity enforcement (v1.1.1 - NEW)
### Admin Features
- ✅ WooCommerce Settings integration
- ✅ Easy-to-use product meta boxes
- ✅ Configurable display positions
- ✅ Native WooCommerce UI
- ✅ Global restriction setting
- ✅ Per-product restriction override
### Frontend Features
- ✅ Beautiful pricing tables (Twig templates)
- ✅ Real-time cart updates
- ✅ Responsive design
- ✅ 3 languages supported
- ✅ Package-only selection mode
- ✅ Automatic quantity field hiding (product page & cart)
- ✅ Visual package selection
- ✅ Read-only cart quantity display (NEW)
### Validation & Security
- ✅ Client-side JavaScript validation
- ✅ Server-side cart validation
- ✅ Cart quantity bypass prevention (NEW)
- ✅ User-friendly error messages
- ✅ WooCommerce HPOS compatible
## Breaking Changes
**None.** This release is fully backward compatible with v1.1.0 and v1.0.x.
## Migration Notes
### From 1.1.0
- No migration needed
- Cart quantity hiding is automatic when restrictions are enabled
- No new settings or configuration required
### From 1.0.x
- All v1.1.0 features included plus cart enhancement
- New restriction features are disabled by default
- Must be explicitly enabled in settings
### Settings Location
All settings remain in: **WooCommerce > Settings > Tier & Package Prices**
### Data Preservation
- All existing tier pricing data preserved
- All existing package pricing data preserved
- All product meta data preserved
- No database changes required
## Known Limitations
### Current Version
1. Restriction only works when packages are defined
2. Cannot restrict to tier quantities (only packages)
3. Restriction applies to entire product (no variation-level control)
4. Cart quantity is read-only text (not a dropdown of package options)
### Future Enhancements
These features may be added in future versions:
- Cart package quantity dropdown selector
- Variation-level restriction control
- Restrict to tier quantities option
- Minimum/maximum package selection limits
## Changelog Summary
### Version History
- **v1.1.1** (2025-12-21) - Cart quantity bypass fix
- **v1.1.0** (2025-12-21) - Package quantity restriction feature
- **v1.0.2** (2025-12-21) - WooCommerce Settings integration
- **v1.0.1** (2025-12-21) - Twig template engine integration
- **v1.0.0** (2025-12-21) - Initial release
## Support
- **Documentation:** See README.md and CHANGELOG.md
- **Previous Release:** See RELEASE-INFO-1.1.0.md
- **Issues:** https://src.bundespruefstelle.ch/wc-tier-package-prices/issues
- **Author:** Marco Graetsch
## License
GPL v2 or later - https://www.gnu.org/licenses/gpl-2.0.html
---
**Production Ready:** This package includes optimized autoloader and no development dependencies.
**Recommended Update:** Version 1.1.1 is recommended for all users of v1.1.0 to ensure complete package restriction enforcement. Users on v1.0.x can safely upgrade to gain both the restriction feature and this security enhancement.

Binary file not shown.

View File

@@ -0,0 +1 @@
81be5283219cfa722f6d382a788e7dc1 releases/wc-tier-and-package-prices-1.1.10.zip

View File

@@ -0,0 +1 @@
2d3b01e61c8a03a8f20bc99b2019ca50fa08ecd68188feb2d2105dfe35d36f0d releases/wc-tier-and-package-prices-1.1.10.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
4a0c0b07b29d4b7046f9d3ff3f091321 releases/wc-tier-and-package-prices-1.1.11.zip

View File

@@ -0,0 +1 @@
3da9423d136a2ff254b61577ba1f84d4c0f0d1e57bae361ac29c90327feeeceb releases/wc-tier-and-package-prices-1.1.11.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
c1c0b5880636686227246be2c37dc42a releases/wc-tier-and-package-prices-1.1.12.zip

View File

@@ -0,0 +1 @@
05b32356d46803dbb7fa17c13a2d8da96f77126746e2895e2f5c6dd0e7b490ff releases/wc-tier-and-package-prices-1.1.12.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
8572eed399554905fbf331d18f0677a0 wc-tier-and-package-prices-1.1.13.zip

View File

@@ -0,0 +1 @@
83e29b2e40dd43e77bd83cd03d4ccc54ef53555b55544eba4d38161101f79f20 wc-tier-and-package-prices-1.1.13.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
e0cc51d1493ed35ab254220d9f46997b wc-tier-and-package-prices-1.1.14.zip

View File

@@ -0,0 +1 @@
8a2ce7438ee49baffdcaaf323b6426d73dd1cf704bea94a80fcce27a42c097ad wc-tier-and-package-prices-1.1.14.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
15fa0e0933c85b23f66940bf43810835 wc-tier-and-package-prices-1.1.15.zip

View File

@@ -0,0 +1 @@
a419579111ad20b127411e1078ca99187156d606381549e6bf147ffc3bd58de1 wc-tier-and-package-prices-1.1.15.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
d30a90715dbcd46a1dfd19f025897530 wc-tier-and-package-prices-1.1.16.zip

View File

@@ -0,0 +1 @@
e2ad36e049a902b8e287154867ef72c0e169766508781e223176a2a753b60915 wc-tier-and-package-prices-1.1.16.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
9adbb9aad13b8d141cfabfdf53643480 wc-tier-and-package-prices-1.1.17.zip

View File

@@ -0,0 +1 @@
985a195bf98d4dbc0a7afa90173efcda472f4c769adf3c833fa6a99ba9d44095 wc-tier-and-package-prices-1.1.17.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
ec4bb1d78a3c27488244b44971916ffd wc-tier-and-package-prices-1.1.18.zip

View File

@@ -0,0 +1 @@
7d942002edd866c2b6f3192ba010fe64058b7433c5ac776a48e9c3c41f4e2fda wc-tier-and-package-prices-1.1.18.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
c61c3a059429d8dacdce71d4acce401e wc-tier-and-package-prices-1.1.19.zip

View File

@@ -0,0 +1 @@
0e8bc4ccd233d388238e800cd0e0a129f9e8da14008e7164db7934a48ca8223a wc-tier-and-package-prices-1.1.19.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
eee69fcf391b3f3df9380306ffb31b1b wc-tier-and-package-prices-1.1.2.zip

View File

@@ -0,0 +1 @@
40ffd29ebc6af635f689472040acd220ae1c8df2f0d852fab4b43ce0fb5fe739 wc-tier-and-package-prices-1.1.2.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
bfdeee75bfe3795c9ab9abfe47f12a41 wc-tier-and-package-prices-1.1.20.zip

View File

@@ -0,0 +1 @@
953859241d15d76ec4783c72bac851ddd69e5a1f7b119ee4f9ebd30c7fabed17 wc-tier-and-package-prices-1.1.20.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
dfec91be7e375b09613ba81cfebbe013 wc-tier-and-package-prices-1.1.3.zip

View File

@@ -0,0 +1 @@
7938542680b71a7b73269c96a4dff78f2222ac8409092011c5e40e97a5e465aa wc-tier-and-package-prices-1.1.3.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
3e5bc2cae17ecb81b729c3fdc979df23 wc-tier-and-package-prices-1.1.4.zip

View File

@@ -0,0 +1 @@
19553b2fed1c6ca20a8168eab8c570cb0302be801322cd41d86cec40b70ff162 wc-tier-and-package-prices-1.1.4.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
e9f8a69e4be107d857d3beb671d5a9fe wc-tier-and-package-prices-1.1.5.zip

View File

@@ -0,0 +1 @@
a13d71f3f65c7cf41613f88d7bcfcb112acfefb800fa6b95932f44a47cf764f3 wc-tier-and-package-prices-1.1.5.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
dbea10acffdc849f9aa387d128cb6d6e wc-tier-and-package-prices-1.1.6.zip

View File

@@ -0,0 +1 @@
730e366764449ac963bc85848ac8a91f654e4b35500ed3132a280ab4f215c80c wc-tier-and-package-prices-1.1.6.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
c593b6fc730133ecaf772f77d5659080 wc-tier-and-package-prices-1.1.7.zip

View File

@@ -0,0 +1 @@
00e7c473a8b0fc23eb1cd52f4b38db030618ed142a9a9fdfd9b1aa4c5849ec70 wc-tier-and-package-prices-1.1.7.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
666e1acad9f349982463b65d0e3e7fa3 wc-tier-and-package-prices-1.1.8.zip

View File

@@ -0,0 +1 @@
2c100d0d100a6fd7bd8f9c9b154d878a675bc795c5fddb19314bc9991b9a60ba wc-tier-and-package-prices-1.1.8.zip

Binary file not shown.

View File

@@ -0,0 +1 @@
7421aceb8d1cc89b7d15b19d68cdfabe wc-tier-and-package-prices-1.1.9.zip

View File

@@ -0,0 +1 @@
8224bf8b9bfc3dc760d77c61700d27c31db1a67b70834d8b6a4581df66fd45bd wc-tier-and-package-prices-1.1.9.zip

View File

@@ -24,5 +24,13 @@
placeholder="{{ 'e.g., 9.99'|__('wc-tier-package-prices') }}"
class="short wc_input_price">
</p>
<p class="form-field">
<label>{{ 'Label (Optional)'|__('wc-tier-package-prices') }}</label>
<input type="text"
name="_wc_tpp_tiers[{{ index|esc_attr }}][label]"
value="{{ tier.label|default('')|esc_attr }}"
placeholder="{{ 'e.g., Wholesale'|__('wc-tier-package-prices') }}"
class="short">
</p>
<button type="button" class="button wc-tpp-remove-tier">{{ 'Remove'|__('wc-tier-package-prices') }}</button>
</div>

View File

@@ -25,7 +25,12 @@
{% set savings_percent = (savings / regular_price) * 100 %}
{% endif %}
<tr data-min-qty="{{ tier.min_qty|esc_attr }}" data-price="{{ tier.price|esc_attr }}">
<td>{{ tier.min_qty|esc_html }}+</td>
<td>
{{ tier.min_qty|esc_html }}+
{% if tier.label is defined and tier.label is not empty %}
<br><small class="wc-tpp-tier-label">{{ tier.label|esc_html }}</small>
{% endif %}
</td>
<td>{{ wc_price(tier.price)|raw }}</td>
<td>
{% if savings > 0 %}

View File

@@ -2,9 +2,9 @@
/**
* Plugin Name: WooCommerce Tier and Package Prices
* Plugin URI: https://src.bundespruefstelle.ch/wc-tier-package-prices
* Plugin URI: https://src.bundespruefstelle.ch/magdev/wc-tier-package-prices
* Description: Add tier pricing and package prices to WooCommerce products with configurable quantities at fixed prices
* Version: 1.1.2
* Version: 1.1.20
* Author: Marco Graetsch
* Author URI: https://src.bundespruefstelle.ch/magdev
* Text Domain: wc-tier-package-prices
@@ -22,14 +22,35 @@ if (!defined('ABSPATH')) {
}
// Define plugin constants
define('WC_TPP_VERSION', '1.1.2');
define('WC_TPP_PLUGIN_DIR', plugin_dir_path(__FILE__));
define('WC_TPP_PLUGIN_URL', plugin_dir_url(__FILE__));
define('WC_TPP_PLUGIN_BASENAME', plugin_basename(__FILE__));
if (!defined('WC_TPP_VERSION')) {
define('WC_TPP_VERSION', '1.1.20');
}
if (!defined('WC_TPP_PLUGIN_DIR')) {
define('WC_TPP_PLUGIN_DIR', plugin_dir_path(__FILE__));
}
if (!defined('WC_TPP_PLUGIN_URL')) {
define('WC_TPP_PLUGIN_URL', plugin_dir_url(__FILE__));
}
if (!defined('WC_TPP_PLUGIN_BASENAME')) {
define('WC_TPP_PLUGIN_BASENAME', plugin_basename(__FILE__));
}
// Load Composer autoloader
require_once WC_TPP_PLUGIN_DIR . 'vendor/autoload.php';
/**
* Display WooCommerce missing notice
*/
if (!function_exists('wc_tpp_woocommerce_missing_notice')) {
function wc_tpp_woocommerce_missing_notice() {
?>
<div class="notice notice-error">
<p><?php _e('WooCommerce Tier and Package Prices requires WooCommerce to be installed and active.', 'wc-tier-package-prices'); ?></p>
</div>
<?php
}
}
/**
* Check if WooCommerce is active
*/
@@ -38,18 +59,11 @@ if (!in_array('woocommerce/woocommerce.php', apply_filters('active_plugins', get
return;
}
function wc_tpp_woocommerce_missing_notice() {
?>
<div class="notice notice-error">
<p><?php _e('WooCommerce Tier and Package Prices requires WooCommerce to be installed and active.', 'wc-tier-package-prices'); ?></p>
</div>
<?php
}
/**
* Main plugin class
*/
class WC_Tier_Package_Prices {
if (!class_exists('WC_Tier_Package_Prices')) {
class WC_Tier_Package_Prices {
private static $instance = null;
@@ -101,11 +115,14 @@ class WC_Tier_Package_Prices {
public function deactivate() {
flush_rewrite_rules();
}
}
}
// Initialize the plugin
function wc_tpp_init() {
if (!function_exists('wc_tpp_init')) {
function wc_tpp_init() {
return WC_Tier_Package_Prices::get_instance();
}
}
add_action('plugins_loaded', 'wc_tpp_init', 11);