=== Variation Hub - WooCommerce Bulk Variation Editor ===
Contributors: bpeti
Tags: woocommerce, variations, bulk edit, spreadsheet, product management
Requires at least: 6.0
Tested up to: 6.8
Stable tag: 1.0.0
Requires PHP: 8.1
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Manage thousands of WooCommerce variations with Excel-like bulk editing. Edit prices, stock, SKUs in a professional spreadsheet interface.

== Description ==

**Stop wasting hours managing WooCommerce variations.** Variation Hub brings Excel spreadsheet power to your product variations – edit hundreds of variations simultaneously with inline editing and bulk operations.

= Why Store Owners Love Variation Hub =

Traditional WooCommerce variation editing is painfully slow:
❌ Open each product individually  
❌ Click "Edit" on each variation  
❌ Wait for page reloads  
❌ Repeat 100+ times  

**With Variation Hub:**
✅ All variations in one spreadsheet view  
✅ Double-click to edit, Enter to save  
✅ Bulk update prices, stock, SKUs instantly  
✅ Virtual scrolling for smooth performance  
✅ Works with thousands of variations  

= Perfect For =

👕 **Fashion & Apparel** – 200-2,000 products with 5-50 variations each (sizes, colors)  
💻 **Electronics** – High-value products with complex configurations and SKUs  
🏢 **Agencies & Freelancers** – Professional tools for managing client WooCommerce stores  
📦 **Dropshipping** – Bulk import/update thousands of variations from suppliers  

= Free Features =

**Excel-Like Spreadsheet**
• Unlimited variations support
• Inline editing with auto-save
• Sortable and filterable columns
• Keyboard shortcuts for efficiency
• Responsive design (works on tablets)

**Bulk Operations (Limited)**
• Update up to 10 variations at once
• Price, stock, and SKU updates
• Preview changes before applying

**CSV Export/Import (Limited)**
• Export up to 200 variations to CSV
• Import up to 200 variations from CSV
• Excel-compatible CSV format
• Data validation

**Performance Caching**
• Virtual scrolling for large datasets
• Intelligent caching system
• Smooth performance even on shared hosting
• Background sync doesn't slow admin
• Zero impact on frontend speed

**Smart Filtering**
• Search by product name, SKU, category
• Filter by stock status (in stock, out of stock, low stock)
• Attribute-based filtering (color, size, etc.)
• Instant search results

**Community Support**
• WordPress.org support forum
• Documentation and guides
• Regular updates

= Pro Features ($29/year) =

[**Upgrade to Pro**](https://bytebays.com/checkout.php) – Everything in Free, plus:

**Unlimited Bulk Operations**
• No 10-variation limit – update hundreds at once
• Update prices by percentage or fixed amount
• Stock level formulas and patterns
• Advanced preview panel

**SKU Pattern Generator**
• Generate SKUs from patterns (e.g., SHIRT-{COLOR}-{SIZE})
• Automatic SKU creation for new variations
• Batch SKU updates with validation

**Attribute Manager & Converter** (Pro Only)
• Convert local attributes to global with one click
• Fix attribute chaos automatically
• Bulk attribute operations

**Unlimited CSV + XLSX Export/Import**
• No 200-row limit – export/import thousands
• XLSX (native Excel) support
• CSV export/import for unlimited variations
• Advanced data validation and error handling

**Priority Email Support**
• 24-hour response time (business days)
• Direct email: info@bytebays.com
• Setup assistance
• Feature request priority

**30-day money-back guarantee** – no questions asked.

👉 [**Get Pro for $29/year**](https://bytebays.com/checkout.php) | [**Learn More**](https://bytebays.com/variation-hub/)

= Save Hours Every Week =

**Real Time Savings:**
• Seasonal pricing update (500 variations): 2 minutes vs. 4 hours manually
• Stock adjustment (300 variations): 30 seconds vs. 2 hours manually
• SKU standardization (200 variations): 1 minute vs. 3 hours manually

= Multi-Language Support =

Interface available in:
• English 🇺🇸
• Hungarian 🇭🇺
• German 🇩🇪
• Spanish 🇪🇸
• French 🇫🇷

Compatible with WPML, Polylang, and TranslatePress.

= Technical Highlights =

• **WooCommerce HPOS Compatible** – Works with High-Performance Order Storage
• **React 18 + TypeScript** – Modern, fast UI
• **Virtual Scrolling** – Handle thousands of variations smoothly
• **Custom Database Caching** – Optimized queries for performance
• **GPL Licensed** – 100% open source

== Installation ==

= From WordPress Admin =

1. Navigate to **Plugins → Add New**
2. Search for "Variation Hub"
3. Click **Install Now**, then **Activate**
4. Go to **WooCommerce → Variation Hub**
5. Start editing variations! 🎉

= Manual Installation =

1. Download the plugin from [WordPress.org](https://wordpress.org/plugins/variation-hub/)
2. Upload the `variation-hub.zip` file via **Plugins → Add New → Upload Plugin**
3. Click **Install Now**, then **Activate**
4. Go to **WooCommerce → Variation Hub**

= After Activation =

**First Steps:**
• Click **Variation Hub** in the WooCommerce menu
• You'll see all your product variations in one table
• Try inline editing: double-click any cell to edit
• Use filters to narrow down variations (product, category, stock status)

**Pro Setup:**
• Get your license key from [ByteBays.com](https://bytebays.com/checkout.php)
• Go to **Variation Hub → Settings → License**
• Enter your license key and click **Activate**
• Pro features unlock instantly (no restart needed)

Need help? Post in our [support forum](https://wordpress.org/support/plugin/variation-hub/).

== Frequently Asked Questions ==

= What's the difference between Free and Pro? =

**Free ($0/forever):**
• Unlimited variations in Excel-like spreadsheet
• Inline editing with auto-save
• Bulk operations (up to 10 variations at once)
• CSV export/import (up to 200 rows)
• Smart filtering and search
• Performance caching
• Community support via WordPress.org forum

**Pro ($29/year):**
Everything in Free, plus:
• Unlimited bulk operations (no 10-variation limit)
• Unlimited CSV/XLSX export/import (no 200-row limit)
• XLSX (native Excel) support
• SKU pattern generator (e.g., SHIRT-{COLOR}-{SIZE})
• Attribute manager & converter (local → global)
• Priority email support (24h response)
• 30-day money-back guarantee

[Get Pro for $29/year →](https://bytebays.com/checkout.php)

= How many variations can it handle? =

**Free & Pro:** Tested with **10,000+ variations** without performance issues.

**Performance Note:** On shared hosting, response time may increase with 2,000+ variations. For best results with large catalogs:
• Use managed WordPress hosting or VPS
• Enable WooCommerce HPOS (High-Performance Order Storage)
• Activate Variation Hub's performance caching (included in Free)

Virtual scrolling loads only visible rows, so even 10,000 variations feel fast.

= Does it work with my theme? =

**Yes!** Variation Hub works with any WordPress theme. It's a self-contained React app that runs in the WordPress admin area – no frontend conflicts.

**Tested with:**
• Astra, GeneratePress, Kadence (lightweight themes)
• Divi, Elementor (page builders)
• Storefront, Flatsome (WooCommerce themes)

If you experience any theme conflicts, please report them on our [support forum](https://wordpress.org/support/plugin/variation-hub/).

= Can I try Pro before buying? =

We don't offer a trial, but we have a **30-day money-back guarantee** – no questions asked.

**How to evaluate Pro:**
1. Use the free version first (see if you like the interface)
2. Upgrade to Pro [$29/year](https://bytebays.com/checkout.php)
3. If not satisfied, request a refund within 30 days (email: info@bytebays.com)

= How do bulk operations work? =

**Inline Editing (Free & Pro):**
• Double-click any cell (price, stock, SKU)
• Type the new value
• Press Enter to save
• Works on unlimited variations (one at a time)

**Bulk Panel (Free - Limited to 10 variations):**
• Select up to 10 variations with checkboxes
• Operations available:
  - Update prices (set fixed value)
  - Adjust stock quantities
  - Modify SKUs
• Preview changes before applying

**Advanced Bulk Panel (Pro - Unlimited):**
• Select unlimited variations (hundreds or thousands)
• Advanced operations:
  - Increase/decrease prices by percentage (e.g., +20% sale, -15% clearance)
  - Stock formulas and patterns
  - Generate SKUs from patterns (e.g., SHIRT-{COLOR}-{SIZE})
  - Bulk attribute updates
• Preview changes before applying

= Can I use this on multiple sites? =

**Free version:** Install on unlimited sites (GPL licensed).

**Pro license:** One license = **one site**.

**Multi-site licensing:** Volume licensing options are coming soon – [join our mailing list](https://bytebays.com/variation-hub/#contact) to be notified!

Perfect for agencies managing multiple client stores.

= Does it affect my store's speed? =

**No!** Variation Hub runs only in the WordPress admin area. Your customers won't notice any difference.

**Technical Details:**
• **Frontend:** Zero impact – no scripts or styles loaded
• **Admin:** Loads only on the Variation Hub page (not on other WP admin pages)
• **Background Sync:** Uses Action Scheduler (WooCommerce's queue system) for non-blocking updates
• **Database:** Custom indexes and transient caching for fast queries

**Performance Benchmarks:**
• Handles 1,000+ variations smoothly on most hosting
• Works with 5,000-10,000 variations on quality hosting
• Virtual scrolling ensures fast performance even with large datasets

= What if I have a problem? =

**Free Users:**
• Post on the [WordPress.org support forum](https://wordpress.org/support/plugin/variation-hub/)
• We monitor the forum daily (response time: 24-48 hours)

**Pro Users:**
• Priority email support: info@bytebays.com
• 24-hour response time (business days)
• Setup assistance & troubleshooting

**Critical Bugs:**
• Report on the [WordPress.org support forum](https://wordpress.org/support/plugin/variation-hub/)
• Security issues: Email privately to info@bytebays.com

= Is it GDPR compliant? =

**Yes!** Variation Hub does not:
❌ Track users or store analytics  
❌ Set cookies  
❌ Send data to external servers (except for Pro license validation)  
❌ Store personal customer data  

**License Validation (Pro only):**
• Pro license checks connect to ByteBays.com API
• Only sends: license key, domain, WordPress version
• No personal data or customer info is transmitted

**WooCommerce Data:**
• All variation data stays in your WordPress database
• No external API calls for product/order data

[Read our Privacy Policy →](https://bytebays.com/terms.php#privacy)

= Can I translate the plugin? =

**Yes!** The plugin is translation-ready with full i18n support.

**Built-in Languages (100% Translated):**
• English (en_US)
• Hungarian (hu_HU)
• German (de_DE)
• Spanish (es_ES)
• French (fr_FR)

**How to Translate:**
1. Download `.pot` file from `/languages/variation-hub.pot`
2. Use Poedit or Loco Translate plugin
3. Create `.po` and `.mo` files for your language
4. Share translations via our [support forum](https://wordpress.org/support/plugin/variation-hub/) – we'll include them in future releases!

**Translation Plugins:**
• WPML – Fully compatible
• Polylang – Fully compatible
• TranslatePress – Fully compatible

= What's next on the roadmap? =

**Upcoming Features (2025):**
• 📊 Excel XLSX import (Pro)
• 🔍 Advanced search with regex support
• 🏷️ Variation templates (duplicate variations faster)
• 📈 Performance analytics (identify slow variations)
• 🔗 Attribute relationship management (auto-suggest color/size combos)

**Feature Requests:**
Vote for features or suggest new ones in our [support forum](https://wordpress.org/support/plugin/variation-hub/) or email info@bytebays.com.

Pro users' requests get **priority** in development planning!

= Do you offer refunds? =

Yes! **30-day money-back guarantee** on all Pro licenses. No questions asked. Just email info@bytebays.com within 30 days of purchase.

= How do I get support? =

**Free version:**
• [WordPress.org Support Forum](https://wordpress.org/support/plugin/variation-hub/)

**Pro version:**
• Priority email: info@bytebays.com
• 24-hour response time (business days)
• Setup assistance

== Screenshots ==

1. **Spreadsheet View** – Excel-like interface with inline editing. Click any cell to edit, changes save instantly.
2. **Bulk Operations Panel** – Update prices, stock, SKUs for multiple variations. Preview changes before applying.
3. **Advanced Filters** – Search by product name, SKU, category, stock status. Filter by attributes (color, size, etc.).
4. **Attribute Manager** – Convert local attributes to global. Manage variation attributes efficiently.
5. **Pro Upgrade Prompt** – Clear upgrade path shown when hitting free tier limits (10 bulk operations).

== Changelog ==

= 1.0.0 - 2025-11-28 =

**Initial Release**

✨ **Features:**
• Excel-like spreadsheet view with inline editing
• Bulk operations (price, stock, SKU updates)
• Advanced filtering and search
• CSV export/import (200 rows in free version)
• Custom database caching (500 variations/second sync)
• Attribute manager (local → global conversion)
• WooCommerce HPOS compatibility
• Multi-language support (EN, HU, DE, ES, FR)
• Pro licensing system

⚡ **Performance:**
• Lazy loading for large datasets
• Background cache synchronization
• Optimized SQL queries (prepared statements)
• Handles 1,000+ variations smoothly

🔒 **Security:**
• Capability checks on all endpoints
• Nonce verification
• Input sanitization & output escaping
• WordPress Coding Standards compliant

== Upgrade Notice ==

= 1.0.0 =
**NEW:** Initial release of Variation Hub. Backup your database before installing any new plugin. Test on staging environment first for production sites.

== External Services ==

Variation Hub **Free version does NOT connect to external services.** All data stays on your WordPress server.

**Pro License Activation (Optional):**

If you purchase a Pro license, the plugin connects to **ByteBays License API** for activation and validation ONLY.

**Service:** ByteBays License Management System  
**URL:** https://bytebays.com/ (license validation API)
**Purpose:** Validate license keys and unlock Pro features  

**Data Sent:**
• License key (provided by you after purchase)
• Your site domain (e.g., example.com)
• WordPress version, WooCommerce version, Plugin version
• Activation timestamp

**When Data is Sent:**
• When you activate a Pro license (Settings > License)
• Daily automatic validation (background cron)
• When you deactivate a license

**Privacy:**
• No tracking or analytics
• No personal data collected
• Terms: https://bytebays.com/terms.php
• Privacy: https://bytebays.com/terms.php#privacy

**Opt-Out:**
• Don't activate a Pro license (use free version)
• Deactivate license anytime (Settings > License)

Free version users: **Zero external connections.**
