You've already forked wc-tier-and-package-prices
Release version 1.0.1
- Add Twig template engine integration - Migrate all templates to Twig format - Add German (Switzerland, Informal) translation - Improve template organization and security - Add Composer dependency management - Create comprehensive changelog
This commit is contained in:
188
INSTALLATION.md
Normal file
188
INSTALLATION.md
Normal file
@@ -0,0 +1,188 @@
|
||||
# Installation Guide
|
||||
|
||||
## Quick Installation
|
||||
|
||||
### Method 1: WordPress Admin Upload (Recommended)
|
||||
|
||||
1. Download `wc-tier-and-package-prices.zip` from the releases
|
||||
2. Log in to your WordPress admin dashboard
|
||||
3. Navigate to **Plugins > Add New**
|
||||
4. Click **Upload Plugin** button at the top
|
||||
5. Click **Choose File** and select `wc-tier-and-package-prices.zip`
|
||||
6. Click **Install Now**
|
||||
7. After installation, click **Activate Plugin**
|
||||
8. You're done! The plugin is now active.
|
||||
|
||||
### Method 2: Manual FTP Upload
|
||||
|
||||
1. Download `wc-tier-and-package-prices.zip`
|
||||
2. Extract the ZIP file to get the `wc-tier-and-package-prices` folder
|
||||
3. Connect to your server via FTP
|
||||
4. Upload the entire `wc-tier-and-package-prices` folder to `/wp-content/plugins/`
|
||||
5. Go to your WordPress admin dashboard
|
||||
6. Navigate to **Plugins**
|
||||
7. Find "WooCommerce Tier and Package Prices" and click **Activate**
|
||||
|
||||
### Method 3: WP-CLI
|
||||
|
||||
If you have WP-CLI installed:
|
||||
|
||||
```bash
|
||||
wp plugin install wc-tier-and-package-prices.zip --activate
|
||||
```
|
||||
|
||||
## Post-Installation Setup
|
||||
|
||||
### 1. Verify Installation
|
||||
|
||||
After activation, you should see:
|
||||
- A new menu item: **WooCommerce > Tier & Package Prices**
|
||||
- No error messages
|
||||
- Plugin listed in **Plugins** page
|
||||
|
||||
### 2. Configure Global Settings
|
||||
|
||||
1. Go to **WooCommerce > Tier & Package Prices**
|
||||
2. Configure the following options:
|
||||
- **Enable Tier Pricing**: ✓ (checked)
|
||||
- **Enable Package Pricing**: ✓ (checked)
|
||||
- **Display Pricing Table**: ✓ (checked)
|
||||
- **Display Position**: Choose where to show pricing tables
|
||||
- Before Add to Cart (recommended)
|
||||
- After Add to Cart
|
||||
- After Price
|
||||
3. Click **Save Changes**
|
||||
|
||||
### 3. Configure Your First Product
|
||||
|
||||
1. Go to **Products** and edit any product (or create new one)
|
||||
2. Scroll to **Product data** panel
|
||||
3. Click the **General** tab
|
||||
4. Scroll down to find the pricing sections
|
||||
|
||||
#### Add Tier Pricing (Volume Discounts)
|
||||
|
||||
1. Click **Add Tier** button
|
||||
2. Example configuration:
|
||||
- Min Quantity: `10`, Price: `9.50`
|
||||
- Min Quantity: `25`, Price: `8.50`
|
||||
- Min Quantity: `50`, Price: `7.50`
|
||||
3. Click **Update** to save
|
||||
|
||||
#### Add Package Pricing (Fixed Packages)
|
||||
|
||||
1. Click **Add Package** button
|
||||
2. Example configuration:
|
||||
- Quantity: `12`, Price: `99.00`, Label: "Dozen Pack"
|
||||
- Quantity: `24`, Price: `180.00`, Label: "Double Pack"
|
||||
3. Click **Update** to save
|
||||
|
||||
### 4. Test on Frontend
|
||||
|
||||
1. Visit your product page on the frontend
|
||||
2. You should see:
|
||||
- Pricing table showing tiers and/or packages
|
||||
- Price updates when changing quantity
|
||||
- Package selection buttons (if packages configured)
|
||||
3. Add to cart and verify correct pricing
|
||||
|
||||
## Requirements Check
|
||||
|
||||
Before installation, verify:
|
||||
|
||||
- ✓ WordPress 5.8 or higher
|
||||
- ✓ WooCommerce 5.0 or higher installed and activated
|
||||
- ✓ PHP 7.4 or higher
|
||||
- ✓ Write permissions in `/wp-content/plugins/` directory
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Plugin Won't Activate
|
||||
|
||||
**Error: "WooCommerce is required"**
|
||||
- Solution: Install and activate WooCommerce first
|
||||
|
||||
**Error: "Parse error" or "Syntax error"**
|
||||
- Solution: Your PHP version is too old. Upgrade to PHP 7.4 or higher
|
||||
|
||||
### Pricing Tables Not Showing
|
||||
|
||||
1. Check global settings are enabled (**WooCommerce > Tier & Package Prices**)
|
||||
2. Verify you added tiers/packages to the specific product
|
||||
3. Clear browser cache and reload the page
|
||||
4. Check theme compatibility (try default WordPress theme)
|
||||
|
||||
### Prices Not Calculating Correctly
|
||||
|
||||
1. Make sure tiers are sorted by minimum quantity (plugin does this automatically)
|
||||
2. Verify package quantities exactly match what customer selects
|
||||
3. Clear WooCommerce caches (**WooCommerce > Status > Tools > Clear template cache**)
|
||||
|
||||
### Styling Issues
|
||||
|
||||
1. Clear browser cache
|
||||
2. Check if theme has conflicting CSS
|
||||
3. Try adding custom CSS in **Appearance > Customize > Additional CSS**
|
||||
|
||||
## Uninstallation
|
||||
|
||||
To completely remove the plugin:
|
||||
|
||||
1. Go to **Plugins** page
|
||||
2. Deactivate "WooCommerce Tier and Package Prices"
|
||||
3. Click **Delete**
|
||||
4. Confirm deletion
|
||||
|
||||
**Note:** Product meta data (tiers and packages) will be preserved in database even after uninstallation. If you reinstall, your configurations will still be there.
|
||||
|
||||
To completely remove all data:
|
||||
1. Before uninstalling, remove all tiers and packages from products
|
||||
2. Then proceed with uninstallation
|
||||
|
||||
## File Structure After Installation
|
||||
|
||||
Your WordPress installation should have:
|
||||
|
||||
```
|
||||
wp-content/
|
||||
└── plugins/
|
||||
└── wc-tier-and-package-prices/
|
||||
├── wc-tier-and-package-prices.php (main file)
|
||||
├── README.md
|
||||
├── INSTALLATION.md
|
||||
├── USAGE_EXAMPLES.md
|
||||
├── includes/
|
||||
│ ├── class-wc-tpp-admin.php
|
||||
│ ├── class-wc-tpp-cart.php
|
||||
│ ├── class-wc-tpp-frontend.php
|
||||
│ └── class-wc-tpp-product-meta.php
|
||||
└── assets/
|
||||
├── css/
|
||||
│ ├── admin.css
|
||||
│ └── frontend.css
|
||||
└── js/
|
||||
├── admin.js
|
||||
└── frontend.js
|
||||
```
|
||||
|
||||
## Getting Help
|
||||
|
||||
If you encounter issues:
|
||||
|
||||
1. Check this installation guide
|
||||
2. Review the [README.md](README.md) for feature documentation
|
||||
3. Review [USAGE_EXAMPLES.md](USAGE_EXAMPLES.md) for configuration examples
|
||||
4. Check WordPress error logs
|
||||
5. Enable WP_DEBUG to see detailed errors
|
||||
|
||||
## Next Steps
|
||||
|
||||
After successful installation:
|
||||
|
||||
1. Read [USAGE_EXAMPLES.md](USAGE_EXAMPLES.md) for practical examples
|
||||
2. Configure tier pricing on your products
|
||||
3. Test the complete checkout flow
|
||||
4. Customize display settings to match your theme
|
||||
5. Consider creating package deals for popular quantities
|
||||
|
||||
Enjoy your new tier and package pricing capabilities!
|
||||
Reference in New Issue
Block a user