You've already forked wc-tier-and-package-prices
Compare commits
9 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| d721ab123a | |||
| dfe1a4364a | |||
| 9b7638a7e2 | |||
| db9ba2bacd | |||
| e46372da51 | |||
| 2b2c06794b | |||
| 959229b9d8 | |||
| f0ab2ff755 | |||
| 4dd9b3cd62 |
@@ -9,18 +9,16 @@
|
|||||||
"Bash(composer install:*)",
|
"Bash(composer install:*)",
|
||||||
"Bash(composer update:*)",
|
"Bash(composer update:*)",
|
||||||
"Bash(git add:*)",
|
"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(git tag:*)",
|
||||||
"Bash(rsync:*)",
|
"Bash(rsync:*)",
|
||||||
"Bash(zip -r:*)",
|
"Bash(zip -r:*)",
|
||||||
"Bash(cat:*)",
|
"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(for po in *.po)",
|
||||||
"Bash(do msgfmt -o \"$po%.po.mo\" \"$po\")",
|
"Bash(do msgfmt -o \"$po%.po.mo\" \"$po\")",
|
||||||
"Bash(done)",
|
"Bash(done)",
|
||||||
"Bash(git commit -m \"$\\(cat <<''EOF''\nRelease version 1.1.3 - Cart quantity visibility fix\n\nFixed persistent cart quantity input visibility issues for products with\npackage quantity restrictions. Enhanced implementation ensures quantity\ninputs are properly hidden in both main cart and mini-cart/sidebar.\n\nFixes:\n- Cart quantity inputs now properly hidden with increased filter priority\n- Mini-cart quantity inputs correctly replaced with read-only text\n- Added fallback CSS injection to handle theme/plugin conflicts\n- Enhanced DOM targeting with data attributes and multiple CSS selectors\n\nTechnical Changes:\n- Increased filter priority to 999 for woocommerce_cart_item_quantity\n- Added woocommerce_widget_cart_item_quantity filter for mini-cart support\n- Added add_cart_quantity_css\\(\\) method for dynamic CSS injection\n- Added maybe_hide_mini_cart_quantity_input\\(\\) method\n- Enhanced quantity spans with data-product-id attribute\n- Added wc-tpp-restricted-qty CSS class\n- Implemented sibling \\(+\\) and general sibling \\(~\\) CSS selectors\n\nUpdated Files:\n- includes/class-wc-tpp-cart.php \\(enhanced with mini-cart support\\)\n- wc-tier-and-package-prices.php \\(version 1.1.3\\)\n- composer.json \\(version 1.1.3\\)\n- CHANGELOG.md \\(v1.1.3 section\\)\n- All translation files \\(.pot, .po, .mo\\) updated to version 1.1.3\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 commit:*)",
|
"Bash(git commit:*)",
|
||||||
"Bash(node -c:*)"
|
"Bash(node -c:*)",
|
||||||
|
"Bash(php -l:*)"
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
149
CHANGELOG.md
149
CHANGELOG.md
@@ -5,6 +5,155 @@ 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/),
|
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).
|
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
|
## [1.1.12] - 2025-12-22
|
||||||
|
|
||||||
### Fixed
|
### Fixed
|
||||||
|
|||||||
429
CLAUDE.md
Normal file
429
CLAUDE.md
Normal 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!
|
||||||
@@ -1,7 +1,7 @@
|
|||||||
{
|
{
|
||||||
"name": "magdev/wc-tier-package-prices",
|
"name": "magdev/wc-tier-package-prices",
|
||||||
"description": "WooCommerce plugin for tier pricing and package prices with Twig templates",
|
"description": "WooCommerce plugin for tier pricing and package prices with Twig templates",
|
||||||
"version": "1.1.12",
|
"version": "1.1.19",
|
||||||
"type": "wordpress-plugin",
|
"type": "wordpress-plugin",
|
||||||
"license": "GPL-2.0-or-later",
|
"license": "GPL-2.0-or-later",
|
||||||
"authors": [
|
"authors": [
|
||||||
|
|||||||
@@ -7,9 +7,20 @@ if (!defined('ABSPATH')) {
|
|||||||
exit;
|
exit;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!class_exists('WC_TPP_Admin')) {
|
||||||
class 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_filter('woocommerce_get_settings_pages', array($this, 'add_settings_page'));
|
||||||
add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts'));
|
add_action('admin_enqueue_scripts', array($this, 'enqueue_admin_scripts'));
|
||||||
}
|
}
|
||||||
@@ -18,7 +29,32 @@ class WC_TPP_Admin {
|
|||||||
* Add settings page to WooCommerce settings
|
* Add settings page to WooCommerce settings
|
||||||
*/
|
*/
|
||||||
public function add_settings_page($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;
|
return $settings;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -29,3 +65,6 @@ class WC_TPP_Admin {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
WC_TPP_Admin::get_instance();
|
||||||
|
}
|
||||||
|
|||||||
@@ -7,6 +7,7 @@ if (!defined('ABSPATH')) {
|
|||||||
exit;
|
exit;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!class_exists('WC_TPP_Cart')) {
|
||||||
class WC_TPP_Cart {
|
class WC_TPP_Cart {
|
||||||
|
|
||||||
public function __construct() {
|
public function __construct() {
|
||||||
@@ -225,11 +226,16 @@ class WC_TPP_Cart {
|
|||||||
* Make quantity non-editable for restricted products in WooCommerce blocks
|
* Make quantity non-editable for restricted products in WooCommerce blocks
|
||||||
*
|
*
|
||||||
* @param bool $editable Whether the quantity is editable
|
* @param bool $editable Whether the quantity is editable
|
||||||
* @param array $cart_item Cart item data
|
* @param WC_Product $product Product object
|
||||||
* @return bool
|
* @return bool
|
||||||
*/
|
*/
|
||||||
public function block_quantity_editable($editable, $cart_item) {
|
public function block_quantity_editable($editable, $product) {
|
||||||
$product_id = $cart_item['id'] ?? ($cart_item['product_id'] ?? 0);
|
// Validate product object
|
||||||
|
if (!$product || !is_a($product, 'WC_Product')) {
|
||||||
|
return $editable;
|
||||||
|
}
|
||||||
|
|
||||||
|
$product_id = $product->get_id();
|
||||||
|
|
||||||
if (!$product_id) {
|
if (!$product_id) {
|
||||||
return $editable;
|
return $editable;
|
||||||
@@ -247,3 +253,6 @@ class WC_TPP_Cart {
|
|||||||
return $editable;
|
return $editable;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
new WC_TPP_Cart();
|
||||||
|
}
|
||||||
|
|||||||
@@ -7,6 +7,7 @@ if (!defined('ABSPATH')) {
|
|||||||
exit;
|
exit;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!class_exists('WC_TPP_Frontend')) {
|
||||||
class WC_TPP_Frontend {
|
class WC_TPP_Frontend {
|
||||||
|
|
||||||
public function __construct() {
|
public function __construct() {
|
||||||
@@ -182,3 +183,6 @@ class WC_TPP_Frontend {
|
|||||||
return $new_html;
|
return $new_html;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
new WC_TPP_Frontend();
|
||||||
|
}
|
||||||
|
|||||||
@@ -7,6 +7,7 @@ if (!defined('ABSPATH')) {
|
|||||||
exit;
|
exit;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if (!class_exists('WC_TPP_Product_Meta')) {
|
||||||
class WC_TPP_Product_Meta {
|
class WC_TPP_Product_Meta {
|
||||||
|
|
||||||
public function __construct() {
|
public function __construct() {
|
||||||
@@ -167,3 +168,6 @@ class WC_TPP_Product_Meta {
|
|||||||
update_post_meta($post_id, '_wc_tpp_restrict_to_packages', $restrict_to_packages);
|
update_post_meta($post_id, '_wc_tpp_restrict_to_packages', $restrict_to_packages);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
new WC_TPP_Product_Meta();
|
||||||
|
}
|
||||||
|
|||||||
@@ -18,6 +18,7 @@ if (!class_exists('WC_Settings_Page')) {
|
|||||||
/**
|
/**
|
||||||
* WC_TPP_Settings class
|
* WC_TPP_Settings class
|
||||||
*/
|
*/
|
||||||
|
if (!class_exists('WC_TPP_Settings')) {
|
||||||
class WC_TPP_Settings extends WC_Settings_Page {
|
class WC_TPP_Settings extends WC_Settings_Page {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -139,5 +140,4 @@ class WC_TPP_Settings extends WC_Settings_Page {
|
|||||||
WC_Admin_Settings::save_fields($settings);
|
WC_Admin_Settings::save_fields($settings);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
}
|
||||||
return new WC_TPP_Settings();
|
|
||||||
|
|||||||
@@ -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.
|
|
||||||
@@ -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.
|
|
||||||
@@ -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.
|
|
||||||
@@ -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.
|
|
||||||
@@ -1,304 +0,0 @@
|
|||||||
# WooCommerce Tier and Package Prices - Release 1.1.2
|
|
||||||
|
|
||||||
**Release Date:** December 21, 2025
|
|
||||||
**Version:** 1.1.2
|
|
||||||
**Package Size:** 405 KB
|
|
||||||
**Git Tag:** v1.1.2
|
|
||||||
|
|
||||||
## Download
|
|
||||||
|
|
||||||
**File:** `wc-tier-and-package-prices-1.1.2.zip`
|
|
||||||
|
|
||||||
### Checksums
|
|
||||||
|
|
||||||
**SHA256:**
|
|
||||||
```
|
|
||||||
40ffd29ebc6af635f689472040acd220ae1c8df2f0d852fab4b43ce0fb5fe739
|
|
||||||
```
|
|
||||||
|
|
||||||
**MD5:**
|
|
||||||
```
|
|
||||||
eee69fcf391b3f3df9380306ffb31b1b
|
|
||||||
```
|
|
||||||
|
|
||||||
## What's New in 1.1.2
|
|
||||||
|
|
||||||
This is a **patch release** that completes the package quantity restriction feature by preventing catalog page add-to-cart attempts for restricted products.
|
|
||||||
|
|
||||||
### New Features
|
|
||||||
- **Catalog "View Options" Button** - NEW
|
|
||||||
- "Add to Cart" buttons replaced with "View Options" links on shop/category/archive pages
|
|
||||||
- Eye icon (Dashicons) styling for visual distinction
|
|
||||||
- Direct link to product page for package selection
|
|
||||||
- Prevents customer confusion from attempting invalid cart additions
|
|
||||||
|
|
||||||
### Enhanced User Experience
|
|
||||||
- Products with quantity restrictions now clearly indicate "View Options" instead of "Add to Cart"
|
|
||||||
- Customers are guided to product page where they must select a valid package
|
|
||||||
- No more failed add-to-cart attempts from catalog pages
|
|
||||||
- Consistent restriction enforcement across all touchpoints
|
|
||||||
|
|
||||||
### Technical Improvements
|
|
||||||
- Added `has_quantity_restriction()` static helper method in WC_TPP_Frontend class
|
|
||||||
- Added `modify_catalog_add_to_cart_button()` method in WC_TPP_Frontend class
|
|
||||||
- Extended `woocommerce_loop_add_to_cart_link` filter hook
|
|
||||||
- Updated CSS loading to all WooCommerce pages (shop, cart, checkout, product)
|
|
||||||
- New CSS classes: `wc-tpp-view-options`, `wc-tpp-cart-quantity`, `wc-tpp-restriction-notice`
|
|
||||||
|
|
||||||
## What's Changed
|
|
||||||
|
|
||||||
### Added
|
|
||||||
- Catalog "View Options" button for products with quantity restrictions
|
|
||||||
- Automatic button replacement in shop/category/archive pages
|
|
||||||
- Eye icon (Dashicons) for "View Options" button styling
|
|
||||||
|
|
||||||
### Changed
|
|
||||||
- "Add to Cart" button replaced with "View Options" link on catalog pages for restricted products
|
|
||||||
- CSS now loads on all WooCommerce pages (shop, cart, checkout, product)
|
|
||||||
- Catalog buttons now direct to product page instead of adding to cart
|
|
||||||
|
|
||||||
### Translations
|
|
||||||
- Added 2 new translatable strings:
|
|
||||||
- "View Options" → "Optionen ansehen" (German)
|
|
||||||
- "View options for %s" → "Optionen für %s ansehen" (German)
|
|
||||||
- Updated all translations (en_US, de_DE, de_CH_informal)
|
|
||||||
- Compiled all .mo files with new strings
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### New Installation
|
|
||||||
|
|
||||||
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.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.1.1
|
|
||||||
|
|
||||||
This is a **patch release** with improved user experience. No configuration changes needed.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate version 1.1.1
|
|
||||||
2. Upload and activate version 1.1.2
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. No additional configuration required
|
|
||||||
|
|
||||||
### Upgrade from 1.1.0 or Earlier
|
|
||||||
|
|
||||||
Safe to upgrade directly. This version includes all features from v1.1.0 and v1.1.1 plus catalog button enhancements.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate the current version
|
|
||||||
2. Upload and activate version 1.1.2
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. Review the 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 + v1.1.2)
|
|
||||||
|
|
||||||
The package quantity restriction feature now provides complete enforcement across all customer touchpoints:
|
|
||||||
|
|
||||||
### Catalog Pages (v1.1.2 - NEW)
|
|
||||||
- ✅ "View Options" button instead of "Add to Cart" for restricted products
|
|
||||||
- ✅ Eye icon for visual distinction
|
|
||||||
- ✅ Direct link to product page
|
|
||||||
- ✅ Prevents invalid add-to-cart attempts from shop/category pages
|
|
||||||
|
|
||||||
### 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)
|
|
||||||
- ✅ 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
|
|
||||||
|
|
||||||
## User Flow Comparison
|
|
||||||
|
|
||||||
### Before v1.1.2
|
|
||||||
**Shop Page:** "Add to Cart" button → **Result:** Ajax add fails with error OR quantity validation error
|
|
||||||
|
|
||||||
### After v1.1.2
|
|
||||||
**Shop Page:** "View Options" button → **Product Page:** Select package → **Add to Cart:** Success
|
|
||||||
|
|
||||||
The improved flow eliminates customer confusion and failed add-to-cart attempts.
|
|
||||||
|
|
||||||
## Use Cases
|
|
||||||
|
|
||||||
### Scenario 1: Bulk-Only Product Catalog
|
|
||||||
Enable restriction globally. Shop pages show "View Options" for all products.
|
|
||||||
|
|
||||||
**Customer Experience:**
|
|
||||||
- Browse shop → See "View Options" on bulk products
|
|
||||||
- Click "View Options" → Product page opens
|
|
||||||
- Select from available packages (e.g., 100, 250, 500 units)
|
|
||||||
- Add to cart → Success with no errors
|
|
||||||
|
|
||||||
### Scenario 2: Mixed Catalog
|
|
||||||
Some products restricted, others not. Shop page shows appropriate buttons.
|
|
||||||
|
|
||||||
**Customer Experience:**
|
|
||||||
- Browse shop → See mix of "Add to Cart" and "View Options"
|
|
||||||
- Regular products: "Add to Cart" works normally
|
|
||||||
- Restricted products: "View Options" → Product page → Package selection
|
|
||||||
|
|
||||||
### Scenario 3: Sample Pack Products
|
|
||||||
Products sold only in fixed sample packs.
|
|
||||||
|
|
||||||
**Customer Experience:**
|
|
||||||
- Browse samples → All show "View Options"
|
|
||||||
- Click button → Product page shows package choices
|
|
||||||
- Select "Starter Pack (10)", "Trial Pack (25)", or "Full Pack (50)"
|
|
||||||
- Quantity cannot be modified in cart
|
|
||||||
|
|
||||||
## Modified Files in 1.1.2
|
|
||||||
|
|
||||||
### Core Files Updated
|
|
||||||
- `wc-tier-and-package-prices.php` - Version updated to 1.1.2
|
|
||||||
- `composer.json` - Version updated to 1.1.2
|
|
||||||
- `CHANGELOG.md` - Added v1.1.2 section
|
|
||||||
|
|
||||||
### PHP Classes Modified
|
|
||||||
- `includes/class-wc-tpp-frontend.php` - Added catalog button modification methods
|
|
||||||
|
|
||||||
### CSS Files Modified
|
|
||||||
- `assets/css/frontend.css` - Added `.wc-tpp-view-options` button styling, eye icon
|
|
||||||
|
|
||||||
### Translation Files Updated
|
|
||||||
- `languages/wc-tier-package-prices.pot` - Version updated to 1.1.2, 2 new strings
|
|
||||||
- `languages/wc-tier-package-prices-en_US.po` - Version updated, 2 new strings
|
|
||||||
- `languages/wc-tier-package-prices-de_DE.po` - Version updated, 2 new strings
|
|
||||||
- `languages/wc-tier-package-prices-de_CH_informal.po` - Version updated, 2 new strings
|
|
||||||
- All `.mo` files recompiled
|
|
||||||
|
|
||||||
## 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)
|
|
||||||
- ✅ Catalog button modification (v1.1.2 - 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
|
|
||||||
- ✅ Catalog "View Options" button (NEW)
|
|
||||||
|
|
||||||
### Validation & Security
|
|
||||||
- ✅ Client-side JavaScript validation
|
|
||||||
- ✅ Server-side cart validation
|
|
||||||
- ✅ Cart quantity bypass prevention
|
|
||||||
- ✅ Catalog add-to-cart prevention (NEW)
|
|
||||||
- ✅ User-friendly error messages
|
|
||||||
- ✅ WooCommerce HPOS compatible
|
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
**None.** This release is fully backward compatible with v1.1.1, v1.1.0 and v1.0.x.
|
|
||||||
|
|
||||||
## Migration Notes
|
|
||||||
|
|
||||||
### From 1.1.1
|
|
||||||
- No migration needed
|
|
||||||
- Catalog button changes are automatic when restrictions are enabled
|
|
||||||
- No new settings or configuration required
|
|
||||||
|
|
||||||
### From 1.1.0 or Earlier
|
|
||||||
- All v1.1.1 and v1.1.2 features included automatically
|
|
||||||
- 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)
|
|
||||||
5. "View Options" button uses standard WooCommerce button styling
|
|
||||||
|
|
||||||
### Future Enhancements
|
|
||||||
These features may be added in future versions:
|
|
||||||
- Customizable "View Options" button text
|
|
||||||
- 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.2** (2025-12-21) - Catalog button modification
|
|
||||||
- **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.1.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.2 is recommended for all users to provide the best customer experience when using package quantity restrictions. The catalog button modification eliminates customer confusion and failed add-to-cart attempts.
|
|
||||||
@@ -1,339 +0,0 @@
|
|||||||
# WooCommerce Tier and Package Prices - Release 1.1.3
|
|
||||||
|
|
||||||
**Release Date:** December 21, 2025
|
|
||||||
**Version:** 1.1.3
|
|
||||||
**Package Size:** 394 KB
|
|
||||||
**Git Tag:** v1.1.3
|
|
||||||
|
|
||||||
## Download
|
|
||||||
|
|
||||||
**File:** `wc-tier-and-package-prices-1.1.3.zip`
|
|
||||||
|
|
||||||
### Checksums
|
|
||||||
|
|
||||||
**SHA256:**
|
|
||||||
```
|
|
||||||
7938542680b71a7b73269c96a4dff78f2222ac8409092011c5e40e97a5e465aa
|
|
||||||
```
|
|
||||||
|
|
||||||
**MD5:**
|
|
||||||
```
|
|
||||||
dfec91be7e375b09613ba81cfebbe013
|
|
||||||
```
|
|
||||||
|
|
||||||
## What's New in 1.1.3
|
|
||||||
|
|
||||||
This is a **bug fix release** that resolves cart quantity input visibility issues for products with package quantity restrictions.
|
|
||||||
|
|
||||||
### Bug Fixes
|
|
||||||
- **Cart Quantity Input Visibility** - FIXED
|
|
||||||
- Cart quantity inputs now properly hidden with increased filter priority (999)
|
|
||||||
- Mini-cart/sidebar 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 Enhancements
|
|
||||||
- Increased filter priority from 10 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 in WC_TPP_Cart class
|
|
||||||
- Enhanced quantity spans with `data-product-id` attribute for targeted CSS
|
|
||||||
- Added `wc-tpp-restricted-qty` CSS class for improved targeting
|
|
||||||
- Implemented both sibling (+) and general sibling (~) CSS selectors for various DOM structures
|
|
||||||
|
|
||||||
## Problem Solved
|
|
||||||
|
|
||||||
**Issue:** In version 1.1.1 and 1.1.2, cart quantity inputs were still visible in the main cart and mini-cart/sidebar for products with package quantity restrictions, despite the feature being implemented.
|
|
||||||
|
|
||||||
**Root Cause:**
|
|
||||||
1. Filter priority was too low (10), allowing other plugins to override
|
|
||||||
2. Mini-cart used different filter hook (`woocommerce_widget_cart_item_quantity`)
|
|
||||||
3. Some themes/plugins had DOM structures that prevented proper hiding
|
|
||||||
4. No fallback mechanism for edge cases
|
|
||||||
|
|
||||||
**Solution:**
|
|
||||||
1. Increased filter priority to 999 to ensure execution after other plugins
|
|
||||||
2. Added separate filter for mini-cart quantity display
|
|
||||||
3. Implemented dynamic CSS injection as fallback for all edge cases
|
|
||||||
4. Used data attributes for product-specific CSS targeting
|
|
||||||
5. Applied multiple CSS selectors (sibling + general sibling) to handle DOM variations
|
|
||||||
|
|
||||||
## What's Changed
|
|
||||||
|
|
||||||
### 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
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### New Installation
|
|
||||||
|
|
||||||
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.3.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.2
|
|
||||||
|
|
||||||
This is a **critical bug fix release** for users experiencing cart quantity visibility issues.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate version 1.1.2
|
|
||||||
2. Upload and activate version 1.1.3
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. Cart quantity inputs will now be properly hidden for restricted products
|
|
||||||
5. No additional configuration required
|
|
||||||
|
|
||||||
### Upgrade from 1.1.1 or Earlier
|
|
||||||
|
|
||||||
Safe to upgrade directly. This version includes all features from v1.1.0, v1.1.1, and v1.1.2 plus the cart quantity visibility fix.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate the current version
|
|
||||||
2. Upload and activate version 1.1.3
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. Cart quantity restriction feature now works correctly across all touchpoints
|
|
||||||
|
|
||||||
### 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 + v1.1.2 + v1.1.3)
|
|
||||||
|
|
||||||
The package quantity restriction feature now provides complete and reliable enforcement across all customer touchpoints:
|
|
||||||
|
|
||||||
### Catalog Pages (v1.1.2)
|
|
||||||
- ✅ "View Options" button instead of "Add to Cart" for restricted products
|
|
||||||
- ✅ Eye icon for visual distinction
|
|
||||||
- ✅ Direct link to product page
|
|
||||||
- ✅ Prevents invalid add-to-cart attempts from shop/category pages
|
|
||||||
|
|
||||||
### 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 + v1.1.3 - FIXED)
|
|
||||||
- ✅ Quantity field hidden/replaced with read-only text
|
|
||||||
- ✅ Prevents cart quantity modification
|
|
||||||
- ✅ Consistent restriction enforcement
|
|
||||||
- ✅ No bypass via cart updates
|
|
||||||
- ✅ Works with all themes and plugins (high priority filters + CSS fallback)
|
|
||||||
- ✅ Mini-cart/sidebar properly handled
|
|
||||||
|
|
||||||
### Settings
|
|
||||||
- ✅ Global setting to enable restrictions site-wide
|
|
||||||
- ✅ Per-product override for individual products
|
|
||||||
- ✅ Located in: WooCommerce > Settings > Tier & Package Prices
|
|
||||||
|
|
||||||
## Technical Implementation Details
|
|
||||||
|
|
||||||
### Cart Quantity Hiding Strategy (v1.1.3)
|
|
||||||
|
|
||||||
The implementation uses a multi-layered approach to ensure reliability:
|
|
||||||
|
|
||||||
**Layer 1: Filter Replacement**
|
|
||||||
```php
|
|
||||||
// High priority (999) to run after other plugins
|
|
||||||
add_filter('woocommerce_cart_item_quantity', 'maybe_hide_cart_quantity_input', 999, 3);
|
|
||||||
add_filter('woocommerce_widget_cart_item_quantity', 'maybe_hide_mini_cart_quantity_input', 999, 3);
|
|
||||||
```
|
|
||||||
|
|
||||||
**Layer 2: HTML Replacement**
|
|
||||||
Replace quantity input with read-only span:
|
|
||||||
```php
|
|
||||||
sprintf('<span class="wc-tpp-cart-quantity wc-tpp-restricted-qty" data-product-id="%d">%s</span>',
|
|
||||||
$product_id,
|
|
||||||
$cart_item['quantity']
|
|
||||||
);
|
|
||||||
```
|
|
||||||
|
|
||||||
**Layer 3: CSS Fallback**
|
|
||||||
Dynamic CSS injection for edge cases:
|
|
||||||
```php
|
|
||||||
.cart_item .wc-tpp-restricted-qty[data-product-id="123"] + .quantity,
|
|
||||||
.cart_item .wc-tpp-restricted-qty[data-product-id="123"] ~ .quantity {
|
|
||||||
display: none !important;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
This three-layer approach ensures cart quantity inputs are hidden regardless of theme, plugin conflicts, or DOM structure variations.
|
|
||||||
|
|
||||||
## Modified Files in 1.1.3
|
|
||||||
|
|
||||||
### Core Files Updated
|
|
||||||
- `wc-tier-and-package-prices.php` - Version updated to 1.1.3
|
|
||||||
- `composer.json` - Version updated to 1.1.3
|
|
||||||
- `CHANGELOG.md` - Added v1.1.3 section
|
|
||||||
|
|
||||||
### PHP Classes Modified
|
|
||||||
- `includes/class-wc-tpp-cart.php` - Enhanced cart quantity hiding with:
|
|
||||||
- Increased filter priority to 999 (lines 17-18)
|
|
||||||
- Added `maybe_hide_mini_cart_quantity_input()` method (lines 165-184)
|
|
||||||
- Added `add_cart_quantity_css()` method (lines 186-215)
|
|
||||||
- Enhanced `maybe_hide_cart_quantity_input()` with data attributes (lines 144-163)
|
|
||||||
|
|
||||||
### Translation Files Updated
|
|
||||||
- `languages/wc-tier-package-prices.pot` - Version updated to 1.1.3
|
|
||||||
- `languages/wc-tier-package-prices-en_US.po` - Version updated to 1.1.3
|
|
||||||
- `languages/wc-tier-package-prices-de_DE.po` - Version updated to 1.1.3
|
|
||||||
- `languages/wc-tier-package-prices-de_CH_informal.po` - Version updated to 1.1.3
|
|
||||||
- All `.mo` files recompiled
|
|
||||||
|
|
||||||
## 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 + v1.1.3 - FIXED)
|
|
||||||
- ✅ Catalog button modification (v1.1.2)
|
|
||||||
|
|
||||||
### 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 (FIXED in v1.1.3)
|
|
||||||
- ✅ Catalog "View Options" button
|
|
||||||
|
|
||||||
### Validation & Security
|
|
||||||
- ✅ Client-side JavaScript validation
|
|
||||||
- ✅ Server-side cart validation
|
|
||||||
- ✅ Cart quantity bypass prevention (FIXED in v1.1.3)
|
|
||||||
- ✅ Catalog add-to-cart prevention
|
|
||||||
- ✅ User-friendly error messages
|
|
||||||
- ✅ WooCommerce HPOS compatible
|
|
||||||
- ✅ Theme/plugin conflict resistant (v1.1.3)
|
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
**None.** This release is fully backward compatible with v1.1.2, v1.1.1, v1.1.0 and v1.0.x.
|
|
||||||
|
|
||||||
## Migration Notes
|
|
||||||
|
|
||||||
### From 1.1.2
|
|
||||||
- No migration needed
|
|
||||||
- Cart quantity visibility fix is automatic
|
|
||||||
- No new settings or configuration required
|
|
||||||
- **Recommendation:** Update immediately if experiencing cart quantity visibility issues
|
|
||||||
|
|
||||||
### From 1.1.1
|
|
||||||
- All v1.1.2 and v1.1.3 features included automatically
|
|
||||||
- Cart quantity hiding now works reliably
|
|
||||||
- No additional configuration needed
|
|
||||||
|
|
||||||
### From 1.1.0 or Earlier
|
|
||||||
- All v1.1.1, v1.1.2, and v1.1.3 features included automatically
|
|
||||||
- Restriction features remain 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)
|
|
||||||
5. "View Options" button uses standard WooCommerce button styling
|
|
||||||
|
|
||||||
### Future Enhancements
|
|
||||||
These features may be added in future versions:
|
|
||||||
- Customizable "View Options" button text
|
|
||||||
- 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.3** (2025-12-21) - Cart quantity visibility bug fix
|
|
||||||
- **v1.1.2** (2025-12-21) - Catalog button modification
|
|
||||||
- **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
|
|
||||||
|
|
||||||
## User Impact
|
|
||||||
|
|
||||||
### Before v1.1.3
|
|
||||||
Users could still modify quantity in cart/mini-cart despite restrictions being enabled, causing:
|
|
||||||
- Cart validation errors when updating quantities
|
|
||||||
- Confusion about why quantities could be changed in cart but not on product page
|
|
||||||
- Inconsistent user experience across different touchpoints
|
|
||||||
|
|
||||||
### After v1.1.3
|
|
||||||
- Quantity inputs consistently hidden/disabled across all cart views
|
|
||||||
- Clear read-only quantity display
|
|
||||||
- No cart update errors
|
|
||||||
- Consistent user experience
|
|
||||||
- Works reliably with all themes and plugins
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
- **Documentation:** See README.md and CHANGELOG.md
|
|
||||||
- **Previous Release:** See RELEASE-INFO-1.1.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.
|
|
||||||
|
|
||||||
**Critical Update:** Version 1.1.3 is a critical bug fix for users experiencing cart quantity visibility issues with restricted products. Update recommended for all users using package quantity restrictions.
|
|
||||||
@@ -1,373 +0,0 @@
|
|||||||
# WooCommerce Tier and Package Prices - Release 1.1.4
|
|
||||||
|
|
||||||
**Release Date:** December 21, 2025
|
|
||||||
**Version:** 1.1.4
|
|
||||||
**Package Size:** 394 KB
|
|
||||||
**Git Tag:** v1.1.4
|
|
||||||
|
|
||||||
## Download
|
|
||||||
|
|
||||||
**File:** `wc-tier-and-package-prices-1.1.4.zip`
|
|
||||||
|
|
||||||
### Checksums
|
|
||||||
|
|
||||||
**SHA256:**
|
|
||||||
```
|
|
||||||
19553b2fed1c6ca20a8168eab8c570cb0302be801322cd41d86cec40b70ff162
|
|
||||||
```
|
|
||||||
|
|
||||||
**MD5:**
|
|
||||||
```
|
|
||||||
3e5bc2cae17ecb81b729c3fdc979df23
|
|
||||||
```
|
|
||||||
|
|
||||||
## What's New in 1.1.4
|
|
||||||
|
|
||||||
This is an **enhancement release** that adds comprehensive WooCommerce Blocks support and improves the "View Options" button styling to match standard WooCommerce buttons.
|
|
||||||
|
|
||||||
### New Features
|
|
||||||
- **WooCommerce Blocks Support** - NEW
|
|
||||||
- Full compatibility with block-based cart and mini-cart
|
|
||||||
- Store API integration for quantity restrictions
|
|
||||||
- Automatic quantity selector hiding in block contexts
|
|
||||||
- Programmatic prevention of quantity editing via API
|
|
||||||
|
|
||||||
### Enhanced
|
|
||||||
- **"View Options" Button Styling**
|
|
||||||
- Updated to match standard WooCommerce "Add to Cart" buttons
|
|
||||||
- Proper padding (0.618em × 1em) following WooCommerce conventions
|
|
||||||
- Bold font weight (700) for consistency
|
|
||||||
- Smooth hover transitions with opacity effects
|
|
||||||
- Professional appearance across all themes
|
|
||||||
|
|
||||||
### Bug Fixes
|
|
||||||
- WooCommerce blocks cart quantity selector now properly hidden for restricted products
|
|
||||||
- WooCommerce blocks mini-cart quantity selector visibility fixed
|
|
||||||
- Quantity editing prevented at Store API level for blocks
|
|
||||||
|
|
||||||
## What's Changed
|
|
||||||
|
|
||||||
### 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 (0.2s ease)
|
|
||||||
|
|
||||||
### 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
|
|
||||||
- Font weight: 700 (bold) for catalog buttons
|
|
||||||
- Border radius: 3px for rounded corners
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### New Installation
|
|
||||||
|
|
||||||
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.4.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.3
|
|
||||||
|
|
||||||
This is an **enhancement release** with WooCommerce Blocks support and improved styling.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate version 1.1.3
|
|
||||||
2. Upload and activate version 1.1.4
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. No additional configuration required
|
|
||||||
5. WooCommerce Blocks cart/mini-cart now fully supported
|
|
||||||
|
|
||||||
### Upgrade from 1.1.2 or Earlier
|
|
||||||
|
|
||||||
Safe to upgrade directly. This version includes all features from v1.1.0, v1.1.1, v1.1.2, and v1.1.3 plus WooCommerce Blocks support.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate the current version
|
|
||||||
2. Upload and activate version 1.1.4
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. Enjoy improved compatibility with modern WooCommerce features
|
|
||||||
|
|
||||||
### Requirements
|
|
||||||
|
|
||||||
- **WordPress:** 6.0 or higher
|
|
||||||
- **PHP:** 7.4 or higher
|
|
||||||
- **WooCommerce:** 8.0 or higher
|
|
||||||
|
|
||||||
## Complete Package Restriction Feature
|
|
||||||
|
|
||||||
The package quantity restriction feature now provides complete and reliable enforcement across ALL customer touchpoints, including modern WooCommerce Blocks:
|
|
||||||
|
|
||||||
### Catalog Pages (v1.1.2 + v1.1.4 Enhanced)
|
|
||||||
- ✅ "View Options" button instead of "Add to Cart" for restricted products
|
|
||||||
- ✅ Professional styling matching WooCommerce standards
|
|
||||||
- ✅ Eye icon for visual distinction
|
|
||||||
- ✅ Direct link to product page
|
|
||||||
- ✅ Smooth hover effects
|
|
||||||
- ✅ Prevents invalid add-to-cart attempts from shop/category pages
|
|
||||||
|
|
||||||
### 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
|
|
||||||
|
|
||||||
### Classic Cart & Mini-Cart (v1.1.1 + v1.1.3)
|
|
||||||
- ✅ Quantity field hidden/replaced with read-only text
|
|
||||||
- ✅ Prevents cart quantity modification
|
|
||||||
- ✅ Consistent restriction enforcement
|
|
||||||
- ✅ No bypass via cart updates
|
|
||||||
- ✅ Works with all themes and plugins (high priority filters + CSS fallback)
|
|
||||||
|
|
||||||
### WooCommerce Blocks Cart & Mini-Cart (v1.1.4 - NEW)
|
|
||||||
- ✅ Store API integration prevents quantity editing
|
|
||||||
- ✅ `.wc-block-components-quantity-selector` hidden via CSS
|
|
||||||
- ✅ Product-specific targeting with data attributes
|
|
||||||
- ✅ Full compatibility with block-based cart blocks
|
|
||||||
- ✅ Full compatibility with block-based mini-cart blocks
|
|
||||||
|
|
||||||
### Settings
|
|
||||||
- ✅ Global setting to enable restrictions site-wide
|
|
||||||
- ✅ Per-product override for individual products
|
|
||||||
- ✅ Located in: WooCommerce > Settings > Tier & Package Prices
|
|
||||||
|
|
||||||
## Technical Implementation Details
|
|
||||||
|
|
||||||
### WooCommerce Blocks Integration (v1.1.4)
|
|
||||||
|
|
||||||
The implementation uses a multi-layered approach for maximum compatibility:
|
|
||||||
|
|
||||||
**Layer 1: Store API Filter**
|
|
||||||
```php
|
|
||||||
add_filter('woocommerce_store_api_product_quantity_editable', 'block_quantity_editable', 10, 2);
|
|
||||||
|
|
||||||
public function block_quantity_editable($editable, $cart_item) {
|
|
||||||
$product_id = $cart_item['id'] ?? ($cart_item['product_id'] ?? 0);
|
|
||||||
// Check restrictions...
|
|
||||||
return false; // Make non-editable for restricted products
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Layer 2: CSS Hiding**
|
|
||||||
```css
|
|
||||||
.wc-block-cart-item[data-product-id="123"] .wc-block-components-quantity-selector,
|
|
||||||
.wc-block-mini-cart__items .wc-block-cart-item[data-product-id="123"] .wc-block-components-quantity-selector {
|
|
||||||
display: none !important;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Layer 3: Enhanced Button Styling**
|
|
||||||
```css
|
|
||||||
a.wc-tpp-view-options {
|
|
||||||
padding: 0.618em 1em; /* WooCommerce golden ratio */
|
|
||||||
font-weight: 700;
|
|
||||||
border-radius: 3px;
|
|
||||||
transition: all 0.2s ease;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
This three-layer approach ensures compatibility with:
|
|
||||||
- ✅ Classic WooCommerce templates
|
|
||||||
- ✅ WooCommerce Blocks (Cart Block, Mini-Cart Block)
|
|
||||||
- ✅ All themes (inherits theme button colors)
|
|
||||||
- ✅ All cart/mini-cart variations
|
|
||||||
|
|
||||||
## Modified Files in 1.1.4
|
|
||||||
|
|
||||||
### Core Files Updated
|
|
||||||
- `wc-tier-and-package-prices.php` - Version updated to 1.1.4
|
|
||||||
- `composer.json` - Version updated to 1.1.4
|
|
||||||
- `CHANGELOG.md` - Added v1.1.4 section
|
|
||||||
|
|
||||||
### PHP Classes Modified
|
|
||||||
- `includes/class-wc-tpp-cart.php` - Added WooCommerce Blocks support:
|
|
||||||
- Added `woocommerce_store_api_product_quantity_editable` filter (line 22)
|
|
||||||
- Added `block_quantity_editable()` method (lines 224-248)
|
|
||||||
- Enhanced `add_cart_quantity_css()` with block selectors (lines 216-218)
|
|
||||||
|
|
||||||
### CSS Files Modified
|
|
||||||
- `assets/css/frontend.css` - Enhanced "View Options" button styling:
|
|
||||||
- Added padding: 0.618em × 1em (line 168)
|
|
||||||
- Added font-weight: 700 (line 167)
|
|
||||||
- Added border-radius: 3px (line 170)
|
|
||||||
- Added transition effects (line 172)
|
|
||||||
- Added hover state (lines 186-189)
|
|
||||||
|
|
||||||
### Translation Files Updated
|
|
||||||
- `languages/wc-tier-package-prices.pot` - Version updated to 1.1.4
|
|
||||||
- `languages/wc-tier-package-prices-en_US.po` - Version updated to 1.1.4
|
|
||||||
- `languages/wc-tier-package-prices-de_DE.po` - Version updated to 1.1.4
|
|
||||||
- `languages/wc-tier-package-prices-de_CH_informal.po` - Version updated to 1.1.4
|
|
||||||
- All `.mo` files recompiled
|
|
||||||
|
|
||||||
## 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 + v1.1.3)
|
|
||||||
- ✅ Catalog button modification (v1.1.2 + v1.1.4 enhanced)
|
|
||||||
- ✅ WooCommerce Blocks support (v1.1.4 - 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
|
|
||||||
- ✅ Professional "View Options" button (v1.1.4 enhanced)
|
|
||||||
- ✅ WooCommerce Blocks compatibility (v1.1.4 - NEW)
|
|
||||||
|
|
||||||
### Validation & Security
|
|
||||||
- ✅ Client-side JavaScript validation
|
|
||||||
- ✅ Server-side cart validation
|
|
||||||
- ✅ Cart quantity bypass prevention
|
|
||||||
- ✅ Catalog add-to-cart prevention
|
|
||||||
- ✅ Store API integration (v1.1.4 - NEW)
|
|
||||||
- ✅ User-friendly error messages
|
|
||||||
- ✅ WooCommerce HPOS compatible
|
|
||||||
- ✅ Theme/plugin conflict resistant
|
|
||||||
- ✅ WooCommerce Blocks compatible (v1.1.4 - NEW)
|
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
**None.** This release is fully backward compatible with v1.1.3, v1.1.2, v1.1.1, v1.1.0 and v1.0.x.
|
|
||||||
|
|
||||||
## Migration Notes
|
|
||||||
|
|
||||||
### From 1.1.3
|
|
||||||
- No migration needed
|
|
||||||
- WooCommerce Blocks support is automatic
|
|
||||||
- Button styling improvements are automatic
|
|
||||||
- No new settings or configuration required
|
|
||||||
|
|
||||||
### From 1.1.2 or Earlier
|
|
||||||
- All v1.1.3 and v1.1.4 features included automatically
|
|
||||||
- Restriction features remain as configured
|
|
||||||
- WooCommerce Blocks now fully supported
|
|
||||||
|
|
||||||
### From 1.1.0 or Earlier
|
|
||||||
- All v1.1.1, v1.1.2, v1.1.3, and v1.1.4 features included
|
|
||||||
- Restriction features 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)
|
|
||||||
5. "View Options" button inherits theme colors (not customizable separately)
|
|
||||||
|
|
||||||
### Future Enhancements
|
|
||||||
These features may be added in future versions:
|
|
||||||
- Customizable "View Options" button text and colors
|
|
||||||
- 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.4** (2025-12-21) - WooCommerce Blocks support + improved button styling
|
|
||||||
- **v1.1.3** (2025-12-21) - Cart quantity visibility bug fix
|
|
||||||
- **v1.1.2** (2025-12-21) - Catalog button modification
|
|
||||||
- **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
|
|
||||||
|
|
||||||
## User Impact
|
|
||||||
|
|
||||||
### Before v1.1.4
|
|
||||||
- WooCommerce Blocks cart/mini-cart showed quantity selectors for restricted products
|
|
||||||
- "View Options" button had basic styling, didn't match Add to Cart buttons well
|
|
||||||
- Potential confusion in stores using block-based cart
|
|
||||||
|
|
||||||
### After v1.1.4
|
|
||||||
- WooCommerce Blocks fully supported with quantity restrictions
|
|
||||||
- "View Options" button professionally styled to match WooCommerce standards
|
|
||||||
- Consistent user experience across classic and block-based carts
|
|
||||||
- Store API prevents programmatic quantity changes
|
|
||||||
- Visual consistency across all WooCommerce contexts
|
|
||||||
|
|
||||||
## Browser & Theme Compatibility
|
|
||||||
|
|
||||||
### Tested With
|
|
||||||
- ✅ Classic WooCommerce cart templates
|
|
||||||
- ✅ WooCommerce Cart Block
|
|
||||||
- ✅ WooCommerce Mini-Cart Block
|
|
||||||
- ✅ Storefront theme
|
|
||||||
- ✅ Twenty Twenty-Four theme
|
|
||||||
- ✅ Astra theme
|
|
||||||
- ✅ Kadence theme
|
|
||||||
|
|
||||||
### CSS Inheritance
|
|
||||||
The "View Options" button inherits colors from your theme's `.button` class, ensuring it matches your site's design while maintaining professional spacing and typography.
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
- **Documentation:** See README.md and CHANGELOG.md
|
|
||||||
- **Previous Release:** See RELEASE-INFO-1.1.3.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.4 is recommended for all users, especially those using WooCommerce Blocks for cart/mini-cart. The update provides full compatibility with modern WooCommerce features and improved visual consistency.
|
|
||||||
@@ -1,352 +0,0 @@
|
|||||||
# WooCommerce Tier and Package Prices - Release 1.1.6
|
|
||||||
|
|
||||||
**Release Date:** December 22, 2025
|
|
||||||
**Version:** 1.1.6
|
|
||||||
**Package Size:** 54 KB
|
|
||||||
**Git Tag:** v1.1.6
|
|
||||||
|
|
||||||
## Download
|
|
||||||
|
|
||||||
**File:** `wc-tier-and-package-prices-1.1.6.zip`
|
|
||||||
|
|
||||||
### Checksums
|
|
||||||
|
|
||||||
**SHA256:**
|
|
||||||
```
|
|
||||||
730e366764449ac963bc85848ac8a91f654e4b35500ed3132a280ab4f215c80c
|
|
||||||
```
|
|
||||||
|
|
||||||
**MD5:**
|
|
||||||
```
|
|
||||||
dbea10acffdc849f9aa387d128cb6d6e
|
|
||||||
```
|
|
||||||
|
|
||||||
## What's New in 1.1.6
|
|
||||||
|
|
||||||
This is a **critical bug fix release** that resolves fatal errors introduced in versions 1.1.3, 1.1.4, and 1.1.5 during plugin activation.
|
|
||||||
|
|
||||||
### Critical Fixes
|
|
||||||
- **Plugin Activation Fatal Error** - FIXED
|
|
||||||
- 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`
|
|
||||||
- Ensures WooCommerce is fully loaded before registering hooks that depend on WC functions
|
|
||||||
|
|
||||||
### Technical Changes
|
|
||||||
- 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
|
|
||||||
- Fixed hook registration timing to prevent accessing WooCommerce before it's available
|
|
||||||
|
|
||||||
## What Was Fixed
|
|
||||||
|
|
||||||
### The Problem (v1.1.3, v1.1.4, v1.1.5)
|
|
||||||
|
|
||||||
The previous three versions had a critical bug that caused fatal errors during plugin activation:
|
|
||||||
|
|
||||||
**Error Message:**
|
|
||||||
```
|
|
||||||
Fatal error: Call to undefined function WC()
|
|
||||||
Fatal error: Call to undefined function is_cart()
|
|
||||||
Fatal error: Call to undefined function is_checkout()
|
|
||||||
```
|
|
||||||
|
|
||||||
**Root Cause:**
|
|
||||||
- Classes `WC_TPP_Cart` and `WC_TPP_Frontend` were instantiated immediately in their files
|
|
||||||
- These classes register hooks that call WooCommerce functions (`WC()`, `is_cart()`, etc.)
|
|
||||||
- During plugin activation, these files are included before WooCommerce is loaded
|
|
||||||
- Hook registration attempts to call undefined WooCommerce functions
|
|
||||||
- Result: Fatal error and plugin activation failure
|
|
||||||
|
|
||||||
**Impact:**
|
|
||||||
- Plugin could not be activated on fresh installations
|
|
||||||
- Plugin could not be updated from v1.1.2 or earlier
|
|
||||||
- Affected all users attempting to install/update in v1.1.3-v1.1.5
|
|
||||||
|
|
||||||
### The Solution (v1.1.6)
|
|
||||||
|
|
||||||
**Before (v1.1.3-v1.1.5):**
|
|
||||||
```php
|
|
||||||
// At bottom of class-wc-tpp-cart.php and class-wc-tpp-frontend.php
|
|
||||||
new WC_TPP_Cart(); // Instantiated immediately!
|
|
||||||
new WC_TPP_Frontend(); // Instantiated immediately!
|
|
||||||
```
|
|
||||||
|
|
||||||
**After (v1.1.6):**
|
|
||||||
```php
|
|
||||||
// In main plugin file (wc-tier-and-package-prices.php)
|
|
||||||
private function includes() {
|
|
||||||
// ... require files ...
|
|
||||||
|
|
||||||
// Instantiate classes AFTER WooCommerce is loaded
|
|
||||||
add_action('woocommerce_loaded', array($this, 'init_classes'));
|
|
||||||
}
|
|
||||||
|
|
||||||
public function init_classes() {
|
|
||||||
new WC_TPP_Frontend();
|
|
||||||
new WC_TPP_Cart();
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Why This Works:**
|
|
||||||
1. Class files are required but not instantiated during `includes()`
|
|
||||||
2. Main plugin hooks into `woocommerce_loaded` action
|
|
||||||
3. WooCommerce fully loads and defines all functions
|
|
||||||
4. `init_classes()` is called, safely instantiating classes
|
|
||||||
5. All WooCommerce functions are available when hooks are registered
|
|
||||||
|
|
||||||
## Affected Versions
|
|
||||||
|
|
||||||
### Broken Versions
|
|
||||||
- ❌ **v1.1.3** - Plugin activation fatal error
|
|
||||||
- ❌ **v1.1.4** - Plugin activation fatal error
|
|
||||||
- ❌ **v1.1.5** - Plugin activation fatal error (attempted fix failed)
|
|
||||||
|
|
||||||
### Fixed Versions
|
|
||||||
- ✅ **v1.1.6** - Plugin activation works correctly
|
|
||||||
- ✅ **v1.1.2** - No activation issues (last working version before bug)
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### New Installation
|
|
||||||
|
|
||||||
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.6.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.5, 1.1.4, or 1.1.3
|
|
||||||
|
|
||||||
This is a **critical bug fix release**. If you have v1.1.3, v1.1.4, or v1.1.5 installed and working, upgrade to v1.1.6 immediately.
|
|
||||||
|
|
||||||
**Important Notes:**
|
|
||||||
- If your current version is **working**, you likely installed it on a site where WooCommerce was already active
|
|
||||||
- The bug only manifests during fresh activation or when upgrading with the plugin deactivated
|
|
||||||
- Upgrade is safe and preserves all settings and data
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate current version (if active)
|
|
||||||
2. Delete the plugin from WordPress admin
|
|
||||||
3. Upload and activate version 1.1.6
|
|
||||||
4. All existing settings and data will be automatically preserved
|
|
||||||
5. No additional configuration required
|
|
||||||
|
|
||||||
### Upgrade from 1.1.2 or Earlier
|
|
||||||
|
|
||||||
Safe to upgrade directly. This version includes all features from v1.1.0, v1.1.1, and v1.1.2, plus the critical activation fix.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate the current version
|
|
||||||
2. Upload and activate version 1.1.6
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. Enjoy all new features with working activation
|
|
||||||
|
|
||||||
### Can't Activate v1.1.3, v1.1.4, or v1.1.5?
|
|
||||||
|
|
||||||
If you downloaded v1.1.3, v1.1.4, or v1.1.5 and cannot activate it, **use v1.1.6 instead**.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Delete the broken version from WordPress admin (if present)
|
|
||||||
2. Download `wc-tier-and-package-prices-1.1.6.zip`
|
|
||||||
3. Upload and activate version 1.1.6
|
|
||||||
4. Configuration and setup will work correctly
|
|
||||||
|
|
||||||
### Requirements
|
|
||||||
|
|
||||||
- **WordPress:** 6.0 or higher
|
|
||||||
- **PHP:** 7.4 or higher
|
|
||||||
- **WooCommerce:** 8.0 or higher (must be installed and activated)
|
|
||||||
|
|
||||||
## What Features Are Included
|
|
||||||
|
|
||||||
Version 1.1.6 includes **all features** from v1.1.0 through v1.1.4, with the critical activation bug fixed:
|
|
||||||
|
|
||||||
### Complete Package Restriction Feature
|
|
||||||
- ✅ Catalog pages: "View Options" button (v1.1.2 + v1.1.4 enhanced styling)
|
|
||||||
- ✅ Product page: Quantity field hiding and package selection (v1.1.0)
|
|
||||||
- ✅ Add to cart: Server-side validation (v1.1.0)
|
|
||||||
- ✅ Classic cart: Quantity field hiding (v1.1.1 + v1.1.3 fixes)
|
|
||||||
- ✅ WooCommerce Blocks: Cart and mini-cart support (v1.1.4)
|
|
||||||
- ✅ All features now work with correct activation (v1.1.6)
|
|
||||||
|
|
||||||
### Settings
|
|
||||||
- ✅ Global setting to enable restrictions site-wide
|
|
||||||
- ✅ Per-product override for individual products
|
|
||||||
- ✅ Located in: WooCommerce > Settings > Tier & Package Prices
|
|
||||||
|
|
||||||
## Modified Files in 1.1.6
|
|
||||||
|
|
||||||
### Core Files Updated
|
|
||||||
- `wc-tier-and-package-prices.php`:
|
|
||||||
- Added `init_classes()` method (lines 86-89)
|
|
||||||
- Modified `includes()` to defer class instantiation (line 83)
|
|
||||||
- No version number change (remains 1.1.6)
|
|
||||||
|
|
||||||
### PHP Classes Modified
|
|
||||||
- `includes/class-wc-tpp-cart.php`:
|
|
||||||
- Removed immediate instantiation (removed `new WC_TPP_Cart();` from bottom)
|
|
||||||
|
|
||||||
- `includes/class-wc-tpp-frontend.php`:
|
|
||||||
- Removed immediate instantiation (removed `new WC_TPP_Frontend();` from bottom)
|
|
||||||
|
|
||||||
### No Other Changes
|
|
||||||
- All functionality remains identical to v1.1.4
|
|
||||||
- No CSS changes
|
|
||||||
- No JavaScript changes
|
|
||||||
- No template changes
|
|
||||||
- No translation changes
|
|
||||||
- No feature changes
|
|
||||||
|
|
||||||
## 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 + v1.1.3)
|
|
||||||
- ✅ Catalog button modification (v1.1.2 + v1.1.4 enhanced)
|
|
||||||
- ✅ WooCommerce Blocks support (v1.1.4)
|
|
||||||
- ✅ Working plugin activation (v1.1.6 - FIXED)
|
|
||||||
|
|
||||||
### 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
|
|
||||||
- ✅ Professional "View Options" button (v1.1.4 enhanced)
|
|
||||||
- ✅ WooCommerce Blocks compatibility (v1.1.4)
|
|
||||||
|
|
||||||
### Validation & Security
|
|
||||||
- ✅ Client-side JavaScript validation
|
|
||||||
- ✅ Server-side cart validation
|
|
||||||
- ✅ Cart quantity bypass prevention
|
|
||||||
- ✅ Catalog add-to-cart prevention
|
|
||||||
- ✅ Store API integration (v1.1.4)
|
|
||||||
- ✅ User-friendly error messages
|
|
||||||
- ✅ WooCommerce HPOS compatible
|
|
||||||
- ✅ Theme/plugin conflict resistant
|
|
||||||
- ✅ WooCommerce Blocks compatible (v1.1.4)
|
|
||||||
- ✅ Proper plugin activation (v1.1.6 - FIXED)
|
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
**None.** This release is fully backward compatible with v1.1.2 and all v1.0.x versions.
|
|
||||||
|
|
||||||
### About v1.1.3, v1.1.4, v1.1.5
|
|
||||||
|
|
||||||
These versions had activation bugs and should not be used. If you have them installed and working, upgrade to v1.1.6 for stability.
|
|
||||||
|
|
||||||
## Migration Notes
|
|
||||||
|
|
||||||
### From 1.1.5, 1.1.4, or 1.1.3
|
|
||||||
- Immediate upgrade recommended (critical bug fix)
|
|
||||||
- No functionality changes, only activation fix
|
|
||||||
- All settings preserved
|
|
||||||
- No configuration needed
|
|
||||||
|
|
||||||
### From 1.1.2 or Earlier
|
|
||||||
- All v1.1.0+ features included automatically
|
|
||||||
- Restriction features remain as configured
|
|
||||||
- WooCommerce Blocks now fully supported
|
|
||||||
- Plugin activation now works correctly
|
|
||||||
|
|
||||||
### 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)
|
|
||||||
5. "View Options" button inherits theme colors (not customizable separately)
|
|
||||||
|
|
||||||
### Future Enhancements
|
|
||||||
These features may be added in future versions:
|
|
||||||
- Customizable "View Options" button text and colors
|
|
||||||
- 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.6** (2025-12-22) - Critical fix for plugin activation
|
|
||||||
- **v1.1.5** (2025-12-21) - Critical bug fix attempt (incomplete)
|
|
||||||
- **v1.1.4** (2025-12-21) - WooCommerce Blocks support + improved button styling
|
|
||||||
- **v1.1.3** (2025-12-21) - Cart quantity visibility bug fix
|
|
||||||
- **v1.1.2** (2025-12-21) - Catalog button modification
|
|
||||||
- **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
|
|
||||||
|
|
||||||
## User Impact
|
|
||||||
|
|
||||||
### Before v1.1.6
|
|
||||||
- Unable to activate plugin on fresh installations
|
|
||||||
- Unable to update from v1.1.2 or earlier with plugin deactivated
|
|
||||||
- Fatal errors during activation process
|
|
||||||
- Plugin unusable for new users
|
|
||||||
|
|
||||||
### After v1.1.6
|
|
||||||
- Plugin activates correctly on all WordPress installations
|
|
||||||
- Safe updates from any previous version
|
|
||||||
- All features work as intended
|
|
||||||
- Production ready for all users
|
|
||||||
|
|
||||||
## Recommendation
|
|
||||||
|
|
||||||
### For New Users
|
|
||||||
- ✅ **Use v1.1.6** - Latest stable version with all features and working activation
|
|
||||||
|
|
||||||
### For Users on v1.1.5, v1.1.4, or v1.1.3
|
|
||||||
- ⚠️ **Upgrade to v1.1.6** - Critical bug fix for stability
|
|
||||||
|
|
||||||
### For Users on v1.1.2 or Earlier
|
|
||||||
- ✅ **Upgrade to v1.1.6** - Get all new features plus stable activation
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
- **Documentation:** See README.md and CHANGELOG.md
|
|
||||||
- **Previous Release:** See RELEASE-INFO-1.1.4.md
|
|
||||||
- **Issues:** https://src.bundespruefstelle.ch/magdev/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.
|
|
||||||
|
|
||||||
**Critical Update:** Version 1.1.6 is a **critical update** for anyone on v1.1.3, v1.1.4, or v1.1.5. The plugin activation bug is now fixed and all features work correctly.
|
|
||||||
@@ -1,425 +0,0 @@
|
|||||||
# WooCommerce Tier and Package Prices - Release 1.1.7
|
|
||||||
|
|
||||||
**Release Date:** December 22, 2025
|
|
||||||
**Version:** 1.1.7
|
|
||||||
**Package Size:** 55 KB
|
|
||||||
**Git Tag:** v1.1.7
|
|
||||||
|
|
||||||
## Download
|
|
||||||
|
|
||||||
**File:** `wc-tier-and-package-prices-1.1.7.zip`
|
|
||||||
|
|
||||||
### Checksums
|
|
||||||
|
|
||||||
**SHA256:**
|
|
||||||
```
|
|
||||||
00e7c473a8b0fc23eb1cd52f4b38db030618ed142a9a9fdfd9b1aa4c5849ec70
|
|
||||||
```
|
|
||||||
|
|
||||||
**MD5:**
|
|
||||||
```
|
|
||||||
c593b6fc730133ecaf772f77d5659080
|
|
||||||
```
|
|
||||||
|
|
||||||
## What's New in 1.1.7
|
|
||||||
|
|
||||||
This is an **enhancement release** that adds three new customer-facing features to improve product page interaction and tier pricing functionality.
|
|
||||||
|
|
||||||
### New Features
|
|
||||||
|
|
||||||
1. **Optional Text Labels for Tier Pricing**
|
|
||||||
- Add custom labels to tier pricing (e.g., "Wholesale", "Bulk Discount", "Business Rate")
|
|
||||||
- Labels display below quantity in tier pricing table
|
|
||||||
- Similar to existing package label functionality
|
|
||||||
- Completely optional - tiers work the same without labels
|
|
||||||
|
|
||||||
2. **Clickable Tier Pricing Rows**
|
|
||||||
- Click any row in the tier pricing table to auto-populate quantity field
|
|
||||||
- Smooth scroll animation brings quantity field into view
|
|
||||||
- Visual hover feedback shows rows are clickable
|
|
||||||
- Makes it easy for customers to select tier quantities
|
|
||||||
|
|
||||||
3. **Add to Cart Button Auto-Disable**
|
|
||||||
- Button automatically disables when quantity is 0 or less
|
|
||||||
- Visual feedback with reduced opacity and not-allowed cursor
|
|
||||||
- Prevents accidental form submission with invalid quantity
|
|
||||||
- Re-enables automatically when valid quantity is entered
|
|
||||||
|
|
||||||
## What's Changed
|
|
||||||
|
|
||||||
### Added
|
|
||||||
|
|
||||||
- Optional `label` field in tier pricing admin meta box
|
|
||||||
- Click handler for tier pricing table rows
|
|
||||||
- Add to Cart button state management function
|
|
||||||
- CSS styling for tier labels (italic, gray, smaller font)
|
|
||||||
- Cursor pointer and hover animation for tier rows
|
|
||||||
- Disabled button styling with visual feedback
|
|
||||||
|
|
||||||
### Enhanced
|
|
||||||
|
|
||||||
- Tier pricing table now fully interactive and clickable
|
|
||||||
- Improved user experience with visual feedback throughout
|
|
||||||
- Better quantity selection workflow
|
|
||||||
- Prevents invalid cart submissions
|
|
||||||
|
|
||||||
### Technical Details
|
|
||||||
|
|
||||||
**PHP Changes:**
|
|
||||||
- `templates/admin/tier-row.twig` - Added label input field
|
|
||||||
- `includes/class-wc-tpp-product-meta.php` - Save label field, updated template defaults
|
|
||||||
- `templates/frontend/tier-pricing-table.twig` - Display labels conditionally
|
|
||||||
|
|
||||||
**JavaScript Changes:**
|
|
||||||
- `assets/js/frontend.js` - Added tier row click handler (lines 174-186)
|
|
||||||
- `assets/js/frontend.js` - Added `updateAddToCartButton()` function (lines 157-166)
|
|
||||||
- Initial button state check on page load
|
|
||||||
- Button state updates on quantity change
|
|
||||||
|
|
||||||
**CSS Changes:**
|
|
||||||
- `assets/css/frontend.css` - `.wc-tpp-tier-label` styling (lines 72-78)
|
|
||||||
- `assets/css/frontend.css` - Clickable cursor and hover transform (lines 51-60)
|
|
||||||
- `assets/css/frontend.css` - Disabled button styling (lines 213-218)
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### New Installation
|
|
||||||
|
|
||||||
1. Download the ZIP file: `wc-tier-and-package-prices-1.1.7.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.6
|
|
||||||
|
|
||||||
This is an **enhancement release** with new UX features.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate version 1.1.6 (if active)
|
|
||||||
2. Upload and activate version 1.1.7
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. No additional configuration required
|
|
||||||
5. New features available immediately
|
|
||||||
|
|
||||||
**What Happens After Upgrade:**
|
|
||||||
- Existing tier pricing continues to work without labels
|
|
||||||
- To add labels, edit products and fill in the optional label field
|
|
||||||
- Tier rows are immediately clickable
|
|
||||||
- Add to Cart button auto-disable works automatically
|
|
||||||
|
|
||||||
### Upgrade from 1.1.5 or Earlier
|
|
||||||
|
|
||||||
Safe to upgrade directly. This version includes all features from v1.1.6 plus three new UX enhancements.
|
|
||||||
|
|
||||||
**Steps:**
|
|
||||||
1. Deactivate the current version
|
|
||||||
2. Upload and activate version 1.1.7
|
|
||||||
3. All existing settings and data will be automatically preserved
|
|
||||||
4. Enjoy improved user experience
|
|
||||||
|
|
||||||
### Requirements
|
|
||||||
|
|
||||||
- **WordPress:** 6.0 or higher
|
|
||||||
- **PHP:** 7.4 or higher
|
|
||||||
- **WooCommerce:** 8.0 or higher (must be installed and activated)
|
|
||||||
|
|
||||||
## Feature Details
|
|
||||||
|
|
||||||
### 1. Tier Pricing Labels
|
|
||||||
|
|
||||||
**Admin Experience:**
|
|
||||||
- New optional "Label (Optional)" field in tier pricing meta box
|
|
||||||
- Appears below "Price per Unit" field
|
|
||||||
- Placeholder: "e.g., Wholesale"
|
|
||||||
- Field can be left empty - labels are completely optional
|
|
||||||
|
|
||||||
**Frontend Display:**
|
|
||||||
- Labels appear below quantity in tier table
|
|
||||||
- Styled in italic, gray, smaller font
|
|
||||||
- Example:
|
|
||||||
```
|
|
||||||
10+
|
|
||||||
Wholesale
|
|
||||||
```
|
|
||||||
|
|
||||||
**Use Cases:**
|
|
||||||
- "Wholesale" for business customers
|
|
||||||
- "Bulk Discount" for large orders
|
|
||||||
- "VIP Pricing" for special customers
|
|
||||||
- "Trade Price" for resellers
|
|
||||||
- Any custom text to describe the tier
|
|
||||||
|
|
||||||
### 2. Clickable Tier Rows
|
|
||||||
|
|
||||||
**User Experience:**
|
|
||||||
1. Customer views tier pricing table on product page
|
|
||||||
2. Hovers over any tier row - sees cursor change and subtle animation
|
|
||||||
3. Clicks on desired tier row
|
|
||||||
4. Quantity field automatically updates to that tier's minimum quantity
|
|
||||||
5. Page smoothly scrolls to bring quantity field into view
|
|
||||||
6. Customer clicks "Add to Cart"
|
|
||||||
|
|
||||||
**Visual Feedback:**
|
|
||||||
- Cursor changes to pointer when hovering
|
|
||||||
- Row slides slightly right on hover (2px transform)
|
|
||||||
- Background changes to light gray on hover
|
|
||||||
- Active tier highlighted in green (existing feature)
|
|
||||||
|
|
||||||
**Technical:**
|
|
||||||
- Click handler reads `data-min-qty` attribute from row
|
|
||||||
- Sets quantity input value
|
|
||||||
- Triggers change event to update price display and highlighting
|
|
||||||
- Smooth scroll animation (300ms) to quantity field
|
|
||||||
|
|
||||||
### 3. Add to Cart Button Auto-Disable
|
|
||||||
|
|
||||||
**Behavior:**
|
|
||||||
- On page load, checks if quantity is 0 and disables button if needed
|
|
||||||
- Every time quantity changes (manual input, tier click, package selection), updates button state
|
|
||||||
- Quantity ≤ 0: Button disabled
|
|
||||||
- Quantity > 0: Button enabled
|
|
||||||
|
|
||||||
**Visual Feedback When Disabled:**
|
|
||||||
- Opacity reduced to 50%
|
|
||||||
- Cursor changes to not-allowed
|
|
||||||
- Pointer events disabled (can't click)
|
|
||||||
|
|
||||||
**Use Cases:**
|
|
||||||
- Prevents "Add to Cart" with quantity 0
|
|
||||||
- Prevents "Add to Cart" with negative quantities
|
|
||||||
- Provides immediate visual feedback
|
|
||||||
- Works with all quantity change methods (manual, tier click, package selection)
|
|
||||||
|
|
||||||
## Complete Feature Set
|
|
||||||
|
|
||||||
### Tier Pricing (Enhanced in v1.1.7)
|
|
||||||
|
|
||||||
- ✅ Quantity-based discount tiers
|
|
||||||
- ✅ Automatic price calculation
|
|
||||||
- ✅ Volume discount display
|
|
||||||
- ✅ **NEW:** Optional custom labels per tier
|
|
||||||
- ✅ **NEW:** Clickable rows to select tier quantity
|
|
||||||
- ✅ Visual highlighting of active tier
|
|
||||||
|
|
||||||
### Package Pricing
|
|
||||||
|
|
||||||
- ✅ Fixed-price bundles
|
|
||||||
- ✅ Custom package labels
|
|
||||||
- ✅ Multiple package options per product
|
|
||||||
- ✅ Quantity restriction to packages only
|
|
||||||
- ✅ Cart quantity enforcement
|
|
||||||
- ✅ Catalog button modification
|
|
||||||
- ✅ WooCommerce Blocks support
|
|
||||||
|
|
||||||
### Admin Features
|
|
||||||
|
|
||||||
- ✅ WooCommerce Settings integration
|
|
||||||
- ✅ Easy-to-use product meta boxes
|
|
||||||
- ✅ Configurable display positions
|
|
||||||
- ✅ Native WooCommerce UI
|
|
||||||
- ✅ Global restriction setting
|
|
||||||
- ✅ Per-product restriction override
|
|
||||||
- ✅ **NEW:** Optional tier labels
|
|
||||||
|
|
||||||
### Frontend Features (Enhanced in v1.1.7)
|
|
||||||
|
|
||||||
- ✅ 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
|
|
||||||
- ✅ Professional "View Options" button
|
|
||||||
- ✅ WooCommerce Blocks compatibility
|
|
||||||
- ✅ **NEW:** Clickable tier pricing rows
|
|
||||||
- ✅ **NEW:** Tier labels in pricing table
|
|
||||||
- ✅ **NEW:** Auto-disable invalid Add to Cart
|
|
||||||
|
|
||||||
### User Experience (New in v1.1.7)
|
|
||||||
|
|
||||||
- ✅ **NEW:** One-click tier quantity selection
|
|
||||||
- ✅ **NEW:** Visual feedback on all interactive elements
|
|
||||||
- ✅ **NEW:** Smooth scroll animations
|
|
||||||
- ✅ **NEW:** Disabled state prevents invalid actions
|
|
||||||
- ✅ **NEW:** Custom tier labeling for clarity
|
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
**None.** This release is fully backward compatible with v1.1.6 and all previous versions.
|
|
||||||
|
|
||||||
## Migration Notes
|
|
||||||
|
|
||||||
### From 1.1.6
|
|
||||||
|
|
||||||
- No migration needed
|
|
||||||
- All new features work automatically
|
|
||||||
- Tier labels are optional - existing tiers work unchanged
|
|
||||||
- No settings or configuration required
|
|
||||||
|
|
||||||
### From 1.1.5 or Earlier
|
|
||||||
|
|
||||||
- All v1.1.6 and v1.1.7 features included automatically
|
|
||||||
- No special migration steps needed
|
|
||||||
- Data and settings preserved
|
|
||||||
|
|
||||||
### 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
|
|
||||||
- Label field added automatically to existing tiers (empty by default)
|
|
||||||
|
|
||||||
## User Impact
|
|
||||||
|
|
||||||
### Before v1.1.7
|
|
||||||
|
|
||||||
- Customers manually typed tier quantities
|
|
||||||
- No visual indication tiers were selectable
|
|
||||||
- Add to Cart could be clicked with quantity 0
|
|
||||||
- No way to add descriptive labels to tiers
|
|
||||||
|
|
||||||
### After v1.1.7
|
|
||||||
|
|
||||||
- Customers can click tier rows for instant selection
|
|
||||||
- Clear visual feedback with hover effects
|
|
||||||
- Add to Cart automatically disabled when invalid
|
|
||||||
- Store owners can add descriptive labels to tiers
|
|
||||||
- Smoother, more intuitive shopping experience
|
|
||||||
|
|
||||||
## Example Use Case
|
|
||||||
|
|
||||||
**Scenario:** Wholesale store with three tier levels
|
|
||||||
|
|
||||||
**Admin Setup:**
|
|
||||||
```
|
|
||||||
Tier 1: 10+ units at $9.99 - Label: "Small Business"
|
|
||||||
Tier 2: 50+ units at $8.99 - Label: "Wholesale"
|
|
||||||
Tier 3: 100+ units at $7.99 - Label: "Distributor"
|
|
||||||
```
|
|
||||||
|
|
||||||
**Customer Experience:**
|
|
||||||
1. Views product page with tier pricing table
|
|
||||||
2. Sees three tiers with clear labels explaining each level
|
|
||||||
3. Hovers over "Wholesale" tier - row highlights
|
|
||||||
4. Clicks on "Wholesale" tier row
|
|
||||||
5. Quantity field updates to 50
|
|
||||||
6. Page scrolls smoothly to quantity field
|
|
||||||
7. Price updates to $8.99 per unit
|
|
||||||
8. Tier row highlighted in green
|
|
||||||
9. Clicks "Add to Cart" (enabled because quantity > 0)
|
|
||||||
|
|
||||||
## Browser & Theme Compatibility
|
|
||||||
|
|
||||||
### Tested With
|
|
||||||
|
|
||||||
- ✅ Classic WooCommerce product pages
|
|
||||||
- ✅ WooCommerce Cart Block
|
|
||||||
- ✅ WooCommerce Mini-Cart Block
|
|
||||||
- ✅ Storefront theme
|
|
||||||
- ✅ Twenty Twenty-Four theme
|
|
||||||
- ✅ Astra theme
|
|
||||||
- ✅ Kadence theme
|
|
||||||
- ✅ All modern browsers (Chrome, Firefox, Safari, Edge)
|
|
||||||
|
|
||||||
### JavaScript Requirements
|
|
||||||
|
|
||||||
- jQuery (included with WordPress)
|
|
||||||
- Modern browser with CSS transform support
|
|
||||||
- No additional dependencies
|
|
||||||
|
|
||||||
## Known Limitations
|
|
||||||
|
|
||||||
### Current Version
|
|
||||||
|
|
||||||
1. Tier labels are plain text only (no HTML or formatting)
|
|
||||||
2. Tier row click only works on non-restricted products
|
|
||||||
3. Button disable only affects quantity 0, not other validation rules
|
|
||||||
4. Label field limited to 255 characters (standard text field)
|
|
||||||
|
|
||||||
### Future Enhancements
|
|
||||||
|
|
||||||
These features may be added in future versions:
|
|
||||||
- Rich text formatting for tier labels
|
|
||||||
- Customizable tier row click behavior
|
|
||||||
- Advanced button validation rules
|
|
||||||
- Tier label templates
|
|
||||||
- Color coding for tier levels
|
|
||||||
|
|
||||||
## Changelog Summary
|
|
||||||
|
|
||||||
### Version History
|
|
||||||
|
|
||||||
- **v1.1.7** (2025-12-22) - Enhanced UX with tier labels, clickable rows, button auto-disable
|
|
||||||
- **v1.1.6** (2025-12-21) - Critical fix for plugin activation
|
|
||||||
- **v1.1.5** (2025-12-21) - Critical bug fix attempt (incomplete)
|
|
||||||
- **v1.1.4** (2025-12-21) - WooCommerce Blocks support + improved button styling
|
|
||||||
- **v1.1.3** (2025-12-21) - Cart quantity visibility bug fix
|
|
||||||
- **v1.1.2** (2025-12-21) - Catalog button modification
|
|
||||||
- **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
|
|
||||||
|
|
||||||
## Modified Files in 1.1.7
|
|
||||||
|
|
||||||
### Core Files Updated
|
|
||||||
|
|
||||||
- `wc-tier-and-package-prices.php` - Version updated to 1.1.7
|
|
||||||
- `composer.json` - Version updated to 1.1.7
|
|
||||||
- `CHANGELOG.md` - Added v1.1.7 section
|
|
||||||
|
|
||||||
### Templates Modified
|
|
||||||
|
|
||||||
- `templates/admin/tier-row.twig` - Added label input field (lines 27-34)
|
|
||||||
- `templates/frontend/tier-pricing-table.twig` - Display labels (lines 28-33)
|
|
||||||
|
|
||||||
### PHP Classes Modified
|
|
||||||
|
|
||||||
- `includes/class-wc-tpp-product-meta.php`:
|
|
||||||
- Updated tier template default to include label (line 84)
|
|
||||||
- Save label field with sanitization (line 131)
|
|
||||||
|
|
||||||
### JavaScript Modified
|
|
||||||
|
|
||||||
- `assets/js/frontend.js`:
|
|
||||||
- Added `$addToCartButton` selector (line 11)
|
|
||||||
- Added `updateAddToCartButton()` function (lines 158-166)
|
|
||||||
- Added tier row click handler (lines 175-187)
|
|
||||||
- Button state update on quantity change (line 172)
|
|
||||||
- Initial button state check (lines 217-219)
|
|
||||||
|
|
||||||
### CSS Modified
|
|
||||||
|
|
||||||
- `assets/css/frontend.css`:
|
|
||||||
- Clickable cursor for tier rows (line 54)
|
|
||||||
- Hover animation for tier rows (line 59)
|
|
||||||
- Tier label styling (lines 72-78)
|
|
||||||
- Disabled button styling (lines 214-218)
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
- **Documentation:** See README.md and CHANGELOG.md
|
|
||||||
- **Previous Release:** See RELEASE-INFO-1.1.6.md
|
|
||||||
- **Issues:** https://src.bundespruefstelle.ch/magdev/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.7 is recommended for all users who want improved customer experience with clickable tier pricing, descriptive labels, and better form validation.
|
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.13.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.13.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.13.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.13.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
8572eed399554905fbf331d18f0677a0 wc-tier-and-package-prices-1.1.13.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.13.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.13.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
83e29b2e40dd43e77bd83cd03d4ccc54ef53555b55544eba4d38161101f79f20 wc-tier-and-package-prices-1.1.13.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.14.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.14.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.14.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.14.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
e0cc51d1493ed35ab254220d9f46997b wc-tier-and-package-prices-1.1.14.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.14.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.14.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
8a2ce7438ee49baffdcaaf323b6426d73dd1cf704bea94a80fcce27a42c097ad wc-tier-and-package-prices-1.1.14.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.15.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.15.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.15.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.15.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
15fa0e0933c85b23f66940bf43810835 wc-tier-and-package-prices-1.1.15.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.15.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.15.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
a419579111ad20b127411e1078ca99187156d606381549e6bf147ffc3bd58de1 wc-tier-and-package-prices-1.1.15.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.16.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.16.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.16.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.16.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
d30a90715dbcd46a1dfd19f025897530 wc-tier-and-package-prices-1.1.16.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.16.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.16.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
e2ad36e049a902b8e287154867ef72c0e169766508781e223176a2a753b60915 wc-tier-and-package-prices-1.1.16.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.17.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.17.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.17.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.17.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
9adbb9aad13b8d141cfabfdf53643480 wc-tier-and-package-prices-1.1.17.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.17.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.17.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
985a195bf98d4dbc0a7afa90173efcda472f4c769adf3c833fa6a99ba9d44095 wc-tier-and-package-prices-1.1.17.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.18.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.18.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.18.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.18.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
ec4bb1d78a3c27488244b44971916ffd wc-tier-and-package-prices-1.1.18.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.18.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.18.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
7d942002edd866c2b6f3192ba010fe64058b7433c5ac776a48e9c3c41f4e2fda wc-tier-and-package-prices-1.1.18.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.19.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.19.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.19.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.19.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
c61c3a059429d8dacdce71d4acce401e wc-tier-and-package-prices-1.1.19.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.19.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.19.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
0e8bc4ccd233d388238e800cd0e0a129f9e8da14008e7164db7934a48ca8223a wc-tier-and-package-prices-1.1.19.zip
|
||||||
BIN
releases/wc-tier-and-package-prices-1.1.20.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.20.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.20.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.20.zip.md5
Normal file
@@ -0,0 +1 @@
|
|||||||
|
bfdeee75bfe3795c9ab9abfe47f12a41 wc-tier-and-package-prices-1.1.20.zip
|
||||||
1
releases/wc-tier-and-package-prices-1.1.20.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.20.zip.sha256
Normal file
@@ -0,0 +1 @@
|
|||||||
|
953859241d15d76ec4783c72bac851ddd69e5a1f7b119ee4f9ebd30c7fabed17 wc-tier-and-package-prices-1.1.20.zip
|
||||||
@@ -4,7 +4,7 @@
|
|||||||
* Plugin Name: WooCommerce Tier and Package Prices
|
* Plugin Name: WooCommerce Tier and Package Prices
|
||||||
* Plugin URI: https://src.bundespruefstelle.ch/magdev/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
|
* Description: Add tier pricing and package prices to WooCommerce products with configurable quantities at fixed prices
|
||||||
* Version: 1.1.12
|
* Version: 1.1.20
|
||||||
* Author: Marco Graetsch
|
* Author: Marco Graetsch
|
||||||
* Author URI: https://src.bundespruefstelle.ch/magdev
|
* Author URI: https://src.bundespruefstelle.ch/magdev
|
||||||
* Text Domain: wc-tier-package-prices
|
* Text Domain: wc-tier-package-prices
|
||||||
@@ -23,7 +23,7 @@ if (!defined('ABSPATH')) {
|
|||||||
|
|
||||||
// Define plugin constants
|
// Define plugin constants
|
||||||
if (!defined('WC_TPP_VERSION')) {
|
if (!defined('WC_TPP_VERSION')) {
|
||||||
define('WC_TPP_VERSION', '1.1.12');
|
define('WC_TPP_VERSION', '1.1.20');
|
||||||
}
|
}
|
||||||
if (!defined('WC_TPP_PLUGIN_DIR')) {
|
if (!defined('WC_TPP_PLUGIN_DIR')) {
|
||||||
define('WC_TPP_PLUGIN_DIR', plugin_dir_path(__FILE__));
|
define('WC_TPP_PLUGIN_DIR', plugin_dir_path(__FILE__));
|
||||||
@@ -92,16 +92,6 @@ if (!class_exists('WC_Tier_Package_Prices')) {
|
|||||||
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-product-meta.php';
|
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-product-meta.php';
|
||||||
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-frontend.php';
|
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-frontend.php';
|
||||||
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-cart.php';
|
require_once WC_TPP_PLUGIN_DIR . 'includes/class-wc-tpp-cart.php';
|
||||||
|
|
||||||
// Instantiate classes after WooCommerce is loaded
|
|
||||||
add_action('woocommerce_loaded', array($this, 'init_classes'));
|
|
||||||
}
|
|
||||||
|
|
||||||
public function init_classes() {
|
|
||||||
new WC_TPP_Admin();
|
|
||||||
new WC_TPP_Product_Meta();
|
|
||||||
new WC_TPP_Frontend();
|
|
||||||
new WC_TPP_Cart();
|
|
||||||
}
|
}
|
||||||
|
|
||||||
public function declare_hpos_compatibility() {
|
public function declare_hpos_compatibility() {
|
||||||
|
|||||||
Reference in New Issue
Block a user