You've already forked wc-tier-and-package-prices
Compare commits
3 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| d55ada7924 | |||
| 4ece4dd69e | |||
| 3e06137559 |
@@ -8,7 +8,17 @@
|
||||
"Bash(composer init:*)",
|
||||
"Bash(composer install:*)",
|
||||
"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(rsync:*)",
|
||||
"Bash(zip -r:*)",
|
||||
"Bash(cat:*)",
|
||||
"Bash(git commit -m \"$\\(cat <<''EOF''\nRelease version 1.1.2 - Catalog button modification\n\nEnhanced package quantity restriction enforcement by replacing \"Add to Cart\"\nbuttons with \"View Options\" links on catalog pages for products with\nquantity restrictions. This prevents customers from attempting to add\nrestricted products directly from shop/category pages.\n\nChanges:\n- Added catalog button modification for restricted products\n- Implemented \"View Options\" button with eye icon styling\n- Created has_quantity_restriction\\(\\) helper method\n- Extended CSS loading to all WooCommerce pages\n- Added modify_catalog_add_to_cart_button\\(\\) filter method\n- Updated translations with 2 new strings \\(en_US, de_DE, de_CH_informal\\)\n\n🤖 Generated with [Claude Code]\\(https://claude.com/claude-code\\)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>\nEOF\n\\)\")",
|
||||
"Bash(for po in *.po)",
|
||||
"Bash(do msgfmt -o \"$po%.po.mo\" \"$po\")",
|
||||
"Bash(done)",
|
||||
"Bash(git commit -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\\)\")"
|
||||
]
|
||||
}
|
||||
}
|
||||
|
||||
61
CHANGELOG.md
61
CHANGELOG.md
@@ -5,6 +5,67 @@ All notable changes to WooCommerce Tier and Package Prices will be documented in
|
||||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [1.1.3] - 2025-12-21
|
||||
|
||||
### Fixed
|
||||
- Cart quantity input visibility issue in cart and cart sidebar for restricted products
|
||||
- Enhanced filter priority (999) to ensure quantity hiding runs after other plugins
|
||||
- Mini-cart quantity input now properly hidden for restricted products
|
||||
|
||||
### Added
|
||||
- `woocommerce_widget_cart_item_quantity` filter support for mini-cart
|
||||
- `add_cart_quantity_css()` method for dynamic CSS injection
|
||||
- `data-product-id` attribute to quantity spans for targeted CSS selectors
|
||||
- CSS class `wc-tpp-restricted-qty` for improved targeting
|
||||
|
||||
### Technical
|
||||
- Increased filter priority from 10 to 999 for `woocommerce_cart_item_quantity`
|
||||
- Added `maybe_hide_mini_cart_quantity_input()` method in WC_TPP_Cart class
|
||||
- Dynamic CSS injection via `wp_head` action as fallback
|
||||
- Used both sibling (+) and general sibling (~) CSS selectors for DOM variations
|
||||
|
||||
## [1.1.2] - 2025-12-21
|
||||
|
||||
### Added
|
||||
- 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
|
||||
|
||||
### Technical
|
||||
- Added `has_quantity_restriction()` static 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
|
||||
- CSS classes: `wc-tpp-view-options`, `wc-tpp-cart-quantity`, `wc-tpp-restriction-notice`
|
||||
- Updated `enqueue_scripts()` to load CSS on all WooCommerce pages
|
||||
|
||||
### Translations
|
||||
- Added 2 new translatable strings
|
||||
- Updated all translations (en_US, de_DE, de_CH_informal)
|
||||
- Compiled all .mo files with new strings
|
||||
|
||||
## [1.1.1] - 2025-12-21
|
||||
|
||||
### 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
|
||||
|
||||
### Technical
|
||||
- Added `maybe_hide_cart_quantity_input()` method in WC_TPP_Cart class
|
||||
- Extended `woocommerce_cart_item_quantity` filter hook
|
||||
- CSS class `wc-tpp-cart-quantity` for styled quantity display
|
||||
|
||||
## [1.1.0] - 2025-12-21
|
||||
|
||||
### Added
|
||||
|
||||
@@ -156,6 +156,45 @@
|
||||
font-style: italic;
|
||||
}
|
||||
|
||||
/* Catalog "View Options" button */
|
||||
a.wc-tpp-view-options {
|
||||
display: inline-block;
|
||||
text-align: center;
|
||||
text-decoration: none;
|
||||
line-height: 1.5;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
a.wc-tpp-view-options::before {
|
||||
content: "\f06e";
|
||||
font-family: "dashicons";
|
||||
margin-right: 5px;
|
||||
display: inline-block;
|
||||
font-size: 1.1em;
|
||||
vertical-align: middle;
|
||||
}
|
||||
|
||||
/* Cart quantity display for restricted products */
|
||||
.wc-tpp-cart-quantity {
|
||||
display: inline-block;
|
||||
padding: 5px 10px;
|
||||
background: #f5f5f5;
|
||||
border: 1px solid #ddd;
|
||||
border-radius: 3px;
|
||||
font-weight: 600;
|
||||
}
|
||||
|
||||
/* Restriction notice */
|
||||
.wc-tpp-restriction-notice {
|
||||
padding: 10px 15px;
|
||||
background: #fff3cd;
|
||||
border: 1px solid #ffc107;
|
||||
border-radius: 4px;
|
||||
margin-bottom: 15px;
|
||||
color: #856404;
|
||||
font-size: 0.95em;
|
||||
}
|
||||
|
||||
/* Responsive design */
|
||||
@media (max-width: 768px) {
|
||||
.wc-tpp-packages {
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "magdev/wc-tier-package-prices",
|
||||
"description": "WooCommerce plugin for tier pricing and package prices with Twig templates",
|
||||
"version": "1.1.0",
|
||||
"version": "1.1.3",
|
||||
"type": "wordpress-plugin",
|
||||
"license": "GPL-2.0-or-later",
|
||||
"authors": [
|
||||
|
||||
@@ -14,6 +14,9 @@ class WC_TPP_Cart {
|
||||
add_filter('woocommerce_cart_item_price', array($this, 'display_cart_item_price'), 10, 3);
|
||||
add_filter('woocommerce_cart_item_subtotal', array($this, 'display_cart_item_subtotal'), 10, 3);
|
||||
add_filter('woocommerce_add_to_cart_validation', array($this, 'validate_package_quantity'), 10, 3);
|
||||
add_filter('woocommerce_cart_item_quantity', array($this, 'maybe_hide_cart_quantity_input'), 999, 3);
|
||||
add_filter('woocommerce_widget_cart_item_quantity', array($this, 'maybe_hide_mini_cart_quantity_input'), 999, 3);
|
||||
add_action('wp_head', array($this, 'add_cart_quantity_css'));
|
||||
}
|
||||
|
||||
public function apply_tier_package_pricing($cart) {
|
||||
@@ -137,6 +140,79 @@ class WC_TPP_Cart {
|
||||
|
||||
return $passed;
|
||||
}
|
||||
|
||||
public function maybe_hide_cart_quantity_input($product_quantity, $cart_item_key, $cart_item) {
|
||||
$product_id = $cart_item['product_id'];
|
||||
|
||||
// Check if restriction is enabled globally or for this product
|
||||
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
|
||||
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
|
||||
|
||||
// Get packages for this product
|
||||
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
|
||||
|
||||
// If restriction is enabled and packages exist, show quantity as text only
|
||||
if (($global_restrict || $product_restrict) && !empty($packages)) {
|
||||
return sprintf('<span class="wc-tpp-cart-quantity wc-tpp-restricted-qty" data-product-id="%d">%s</span>',
|
||||
$product_id,
|
||||
$cart_item['quantity']
|
||||
);
|
||||
}
|
||||
|
||||
return $product_quantity;
|
||||
}
|
||||
|
||||
public function maybe_hide_mini_cart_quantity_input($product_quantity, $cart_item, $cart_item_key) {
|
||||
$product_id = $cart_item['product_id'];
|
||||
|
||||
// Check if restriction is enabled globally or for this product
|
||||
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
|
||||
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
|
||||
|
||||
// Get packages for this product
|
||||
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
|
||||
|
||||
// If restriction is enabled and packages exist, show quantity as text only
|
||||
if (($global_restrict || $product_restrict) && !empty($packages)) {
|
||||
return sprintf('<span class="wc-tpp-cart-quantity wc-tpp-restricted-qty" data-product-id="%d">%s ×</span>',
|
||||
$product_id,
|
||||
$cart_item['quantity']
|
||||
);
|
||||
}
|
||||
|
||||
return $product_quantity;
|
||||
}
|
||||
|
||||
public function add_cart_quantity_css() {
|
||||
// Get all cart items and check which products have restrictions
|
||||
if (!WC()->cart) {
|
||||
return;
|
||||
}
|
||||
|
||||
$restricted_products = array();
|
||||
foreach (WC()->cart->get_cart() as $cart_item) {
|
||||
$product_id = $cart_item['product_id'];
|
||||
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
|
||||
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
|
||||
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
|
||||
|
||||
if (($global_restrict || $product_restrict) && !empty($packages)) {
|
||||
$restricted_products[] = $product_id;
|
||||
}
|
||||
}
|
||||
|
||||
if (!empty($restricted_products)) {
|
||||
echo '<style type="text/css">';
|
||||
foreach ($restricted_products as $product_id) {
|
||||
// Hide quantity inputs for restricted products in cart
|
||||
echo '.cart_item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] + .quantity,';
|
||||
echo '.cart_item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] ~ .quantity,';
|
||||
echo '.woocommerce-mini-cart-item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] + .quantity,';
|
||||
echo '.woocommerce-mini-cart-item .wc-tpp-restricted-qty[data-product-id="' . esc_attr($product_id) . '"] ~ .quantity { display: none !important; }';
|
||||
}
|
||||
echo '</style>';
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
new WC_TPP_Cart();
|
||||
|
||||
@@ -15,11 +15,19 @@ class WC_TPP_Frontend {
|
||||
add_action('woocommerce_after_add_to_cart_button', array($this, 'display_pricing_table_after'), 10);
|
||||
add_action('woocommerce_single_product_summary', array($this, 'display_pricing_table_after_price'), 15);
|
||||
add_action('woocommerce_before_add_to_cart_quantity', array($this, 'maybe_hide_quantity_input'));
|
||||
|
||||
// Modify catalog add to cart button for restricted products
|
||||
add_filter('woocommerce_loop_add_to_cart_link', array($this, 'modify_catalog_add_to_cart_button'), 10, 2);
|
||||
}
|
||||
|
||||
public function enqueue_scripts() {
|
||||
if (is_product()) {
|
||||
// Enqueue CSS on all WooCommerce pages (for catalog buttons and cart)
|
||||
if (is_woocommerce() || is_cart() || is_checkout() || is_product()) {
|
||||
wp_enqueue_style('wc-tpp-frontend', WC_TPP_PLUGIN_URL . 'assets/css/frontend.css', array(), WC_TPP_VERSION);
|
||||
}
|
||||
|
||||
// Enqueue JS only on product pages
|
||||
if (is_product()) {
|
||||
wp_enqueue_script('wc-tpp-frontend', WC_TPP_PLUGIN_URL . 'assets/js/frontend.js', array('jquery'), WC_TPP_VERSION, true);
|
||||
|
||||
// Localize script with currency settings
|
||||
@@ -126,6 +134,53 @@ class WC_TPP_Frontend {
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if a product has quantity restrictions enabled
|
||||
*
|
||||
* @param int $product_id Product ID
|
||||
* @return bool
|
||||
*/
|
||||
public static function has_quantity_restriction($product_id) {
|
||||
$global_restrict = get_option('wc_tpp_restrict_package_quantities', 'no') === 'yes';
|
||||
$product_restrict = get_post_meta($product_id, '_wc_tpp_restrict_to_packages', true) === 'yes';
|
||||
$packages = get_post_meta($product_id, '_wc_tpp_packages', true);
|
||||
|
||||
return ($global_restrict || $product_restrict) && !empty($packages);
|
||||
}
|
||||
|
||||
/**
|
||||
* Modify catalog add to cart button for products with quantity restrictions
|
||||
*
|
||||
* @param string $html Add to cart button HTML
|
||||
* @param WC_Product $product Product object
|
||||
* @return string Modified HTML
|
||||
*/
|
||||
public function modify_catalog_add_to_cart_button($html, $product) {
|
||||
if (!$product || !is_a($product, 'WC_Product')) {
|
||||
return $html;
|
||||
}
|
||||
|
||||
$product_id = $product->get_id();
|
||||
|
||||
// Check if product has quantity restrictions
|
||||
if (!self::has_quantity_restriction($product_id)) {
|
||||
return $html;
|
||||
}
|
||||
|
||||
// Replace add to cart button with "View Options" link
|
||||
$product_url = esc_url($product->get_permalink());
|
||||
$button_text = esc_html__('View Options', 'wc-tier-package-prices');
|
||||
|
||||
$new_html = sprintf(
|
||||
'<a href="%s" class="button wc-tpp-view-options product_type_simple" aria-label="%s">%s</a>',
|
||||
$product_url,
|
||||
esc_attr(sprintf(__('View options for %s', 'wc-tier-package-prices'), $product->get_name())),
|
||||
$button_text
|
||||
);
|
||||
|
||||
return $new_html;
|
||||
}
|
||||
}
|
||||
|
||||
new WC_TPP_Frontend();
|
||||
|
||||
Binary file not shown.
@@ -3,7 +3,7 @@
|
||||
# This file is distributed under the GPL v2 or later.
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.0\n"
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.3\n"
|
||||
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
|
||||
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
|
||||
"PO-Revision-Date: 2025-12-21 00:00+0000\n"
|
||||
@@ -235,3 +235,11 @@ msgstr "dieses Produkt"
|
||||
#: includes/class-wc-tpp-cart.php:128
|
||||
msgid "The quantity %1$d is not available for %2$s. Please choose from the available package sizes: %3$s"
|
||||
msgstr "Die Menge %1$d ist für %2$s nicht verfügbar. Bitte wähle aus den verfügbaren Paketgrössen: %3$s"
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:173
|
||||
msgid "View Options"
|
||||
msgstr "Optionen ansehen"
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:178
|
||||
msgid "View options for %s"
|
||||
msgstr "Optionen für %s ansehen"
|
||||
|
||||
Binary file not shown.
@@ -3,7 +3,7 @@
|
||||
# This file is distributed under the GPL v2 or later.
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.0\n"
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.3\n"
|
||||
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
|
||||
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
|
||||
"PO-Revision-Date: 2025-12-21 00:00+0000\n"
|
||||
@@ -235,3 +235,11 @@ msgstr "dieses Produkt"
|
||||
#: includes/class-wc-tpp-cart.php:128
|
||||
msgid "The quantity %1$d is not available for %2$s. Please choose from the available package sizes: %3$s"
|
||||
msgstr "Die Menge %1$d ist für %2$s nicht verfügbar. Bitte wählen Sie aus den verfügbaren Paketgrößen: %3$s"
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:173
|
||||
msgid "View Options"
|
||||
msgstr "Optionen ansehen"
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:178
|
||||
msgid "View options for %s"
|
||||
msgstr "Optionen für %s ansehen"
|
||||
|
||||
Binary file not shown.
@@ -3,7 +3,7 @@
|
||||
# This file is distributed under the GPL v2 or later.
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.0\n"
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.3\n"
|
||||
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
|
||||
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
|
||||
"PO-Revision-Date: 2025-12-21 00:00+0000\n"
|
||||
@@ -235,3 +235,11 @@ msgstr "this product"
|
||||
#: includes/class-wc-tpp-cart.php:128
|
||||
msgid "The quantity %1$d is not available for %2$s. Please choose from the available package sizes: %3$s"
|
||||
msgstr "The quantity %1$d is not available for %2$s. Please choose from the available package sizes: %3$s"
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:173
|
||||
msgid "View Options"
|
||||
msgstr "View Options"
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:178
|
||||
msgid "View options for %s"
|
||||
msgstr "View options for %s"
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
# This file is distributed under the GPL v2 or later.
|
||||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.0\n"
|
||||
"Project-Id-Version: WooCommerce Tier and Package Prices 1.1.3\n"
|
||||
"Report-Msgid-Bugs-To: https://src.bundespruefstelle.ch/wc-tier-package-prices\n"
|
||||
"POT-Creation-Date: 2025-12-21 00:00+0000\n"
|
||||
"MIME-Version: 1.0\n"
|
||||
@@ -222,3 +222,11 @@ msgstr ""
|
||||
#: includes/class-wc-tpp-cart.php:128
|
||||
msgid "The quantity %1$d is not available for %2$s. Please choose from the available package sizes: %3$s"
|
||||
msgstr ""
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:173
|
||||
msgid "View Options"
|
||||
msgstr ""
|
||||
|
||||
#: includes/class-wc-tpp-frontend.php:178
|
||||
msgid "View options for %s"
|
||||
msgstr ""
|
||||
|
||||
345
releases/RELEASE-INFO-1.1.0.md
Normal file
345
releases/RELEASE-INFO-1.1.0.md
Normal file
@@ -0,0 +1,345 @@
|
||||
# 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.
|
||||
272
releases/RELEASE-INFO-1.1.1.md
Normal file
272
releases/RELEASE-INFO-1.1.1.md
Normal file
@@ -0,0 +1,272 @@
|
||||
# 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.
|
||||
304
releases/RELEASE-INFO-1.1.2.md
Normal file
304
releases/RELEASE-INFO-1.1.2.md
Normal file
@@ -0,0 +1,304 @@
|
||||
# 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.
|
||||
BIN
releases/wc-tier-and-package-prices-1.1.0.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.0.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.0.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.0.zip.md5
Normal file
@@ -0,0 +1 @@
|
||||
ef68125c54b0c10f04ba82d48a98b4aa wc-tier-and-package-prices-1.1.0.zip
|
||||
1
releases/wc-tier-and-package-prices-1.1.0.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.0.zip.sha256
Normal file
@@ -0,0 +1 @@
|
||||
da6b462f3dc297b282ed0da258b78fd9f2f82f3e76289c4c8fadd1ac9e02c55b wc-tier-and-package-prices-1.1.0.zip
|
||||
BIN
releases/wc-tier-and-package-prices-1.1.1.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.1.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.1.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.1.zip.md5
Normal file
@@ -0,0 +1 @@
|
||||
51c4f8a7c3ccede2d2005f2fe3ebe44e wc-tier-and-package-prices-1.1.1.zip
|
||||
1
releases/wc-tier-and-package-prices-1.1.1.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.1.zip.sha256
Normal file
@@ -0,0 +1 @@
|
||||
b951f8b7ddd2bad6b3415d4583709fdf88f66aea4eae70110c903757ff53e045 wc-tier-and-package-prices-1.1.1.zip
|
||||
BIN
releases/wc-tier-and-package-prices-1.1.2.zip
Normal file
BIN
releases/wc-tier-and-package-prices-1.1.2.zip
Normal file
Binary file not shown.
1
releases/wc-tier-and-package-prices-1.1.2.zip.md5
Normal file
1
releases/wc-tier-and-package-prices-1.1.2.zip.md5
Normal file
@@ -0,0 +1 @@
|
||||
eee69fcf391b3f3df9380306ffb31b1b wc-tier-and-package-prices-1.1.2.zip
|
||||
1
releases/wc-tier-and-package-prices-1.1.2.zip.sha256
Normal file
1
releases/wc-tier-and-package-prices-1.1.2.zip.sha256
Normal file
@@ -0,0 +1 @@
|
||||
40ffd29ebc6af635f689472040acd220ae1c8df2f0d852fab4b43ce0fb5fe739 wc-tier-and-package-prices-1.1.2.zip
|
||||
@@ -4,7 +4,7 @@
|
||||
* Plugin Name: WooCommerce Tier and Package Prices
|
||||
* Plugin URI: https://src.bundespruefstelle.ch/wc-tier-package-prices
|
||||
* Description: Add tier pricing and package prices to WooCommerce products with configurable quantities at fixed prices
|
||||
* Version: 1.1.0
|
||||
* Version: 1.1.3
|
||||
* Author: Marco Graetsch
|
||||
* Author URI: https://src.bundespruefstelle.ch/magdev
|
||||
* Text Domain: wc-tier-package-prices
|
||||
@@ -22,7 +22,7 @@ if (!defined('ABSPATH')) {
|
||||
}
|
||||
|
||||
// Define plugin constants
|
||||
define('WC_TPP_VERSION', '1.1.0');
|
||||
define('WC_TPP_VERSION', '1.1.3');
|
||||
define('WC_TPP_PLUGIN_DIR', plugin_dir_path(__FILE__));
|
||||
define('WC_TPP_PLUGIN_URL', plugin_dir_url(__FILE__));
|
||||
define('WC_TPP_PLUGIN_BASENAME', plugin_basename(__FILE__));
|
||||
|
||||
Reference in New Issue
Block a user