You've already forked wc-tier-and-package-prices
magdev
e0a32821ee
Added comprehensive package quantity restriction functionality that allows limiting product purchases to predefined package sizes only. Features: - Global setting to enable package quantity restrictions - Per-product override for quantity restrictions - Automatic hiding of quantity input field when restricted - Frontend validation with package selection UI - Server-side cart validation - User-friendly error messages - Complete translations for all supported languages 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
199 lines
6.1 KiB
Markdown
199 lines
6.1 KiB
Markdown
# 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.
|