wc-tier-and-package-prices/releases/RELEASE-INFO-1.1.4.md

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

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

.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

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.