# 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.
