WordPress.org
Get WordPress

Plugin Directory

Changeset 3404560


Ignore:
Timestamp:
11/28/2025 02:51:42 AM (4 months ago)
Author:
bpeti
Message:

Update readme.txt: Add accurate Free tier limitations (10 bulk operations, 200 CSV limit, no XLSX, no Attribute Manager)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • variation-hub/trunk/readme.txt

    r3404553 r3404560  
    1 === Variation Hub ===
     1=== Variation Hub - WooCommerce Bulk Variation Editor ===
    22Contributors: bpeti
    33Tags: woocommerce, variations, bulk edit, spreadsheet, product management
    … …  
    99License URI: https://www.gnu.org/licenses/gpl-3.0.html
    1010
    11 Professional WooCommerce variation management with Excel-like spreadsheet interface for bulk editing.
     11Manage thousands of WooCommerce variations with Excel-like bulk editing. Edit prices, stock, SKUs in a professional spreadsheet interface.
    1212
    1313== Description ==
    1414
    15 Variation Hub transforms WooCommerce variation management with a powerful Excel-like spreadsheet interface. Edit hundreds of variations simultaneously with inline editing, bulk operations, and advanced filtering.
    16 
    17 Key Features:
    18 * Spreadsheet View - Excel-like table with inline editing
    19 * Bulk Operations - Update prices, stock, SKUs for multiple variations
    20 * Advanced Filtering - Search by product name, SKU, attributes
    21 * Performance Optimization - Handles 1000+ variations smoothly
    22 * Attribute Manager - Convert local attributes to global
    23 * Multi-language - English, Hungarian, German, Spanish
    24 
    25 Perfect For:
    26 * Fashion and clothing stores
    27 * Electronics shops
    28 * Any WooCommerce store with 50+ variations
     15**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.
     16
     17= Why Store Owners Love Variation Hub =
     18
     19Traditional WooCommerce variation editing is painfully slow:
     20❌ Open each product individually 
     21❌ Click "Edit" on each variation 
     22❌ Wait for page reloads 
     23❌ Repeat 100+ times 
     24
     25**With Variation Hub:**
     26✅ All variations in one spreadsheet view 
     27✅ Double-click to edit, Enter to save 
     28✅ Bulk update prices, stock, SKUs instantly 
     29✅ Virtual scrolling for smooth performance 
     30✅ Works with thousands of variations 
     31
     32= Perfect For =
     33
     34👕 **Fashion & Apparel** – 200-2,000 products with 5-50 variations each (sizes, colors) 
     35💻 **Electronics** – High-value products with complex configurations and SKUs 
     36🏢 **Agencies & Freelancers** – Professional tools for managing client WooCommerce stores 
     37📦 **Dropshipping** – Bulk import/update thousands of variations from suppliers 
     38
     39= Free Features =
     40
     41**Excel-Like Spreadsheet**
     42• Unlimited variations support
     43• Inline editing with auto-save
     44• Sortable and filterable columns
     45• Keyboard shortcuts for efficiency
     46• Responsive design (works on tablets)
     47
     48**Bulk Operations (Limited)**
     49• Update up to 10 variations at once
     50• Price, stock, and SKU updates
     51• Preview changes before applying
     52
     53**CSV Export/Import (Limited)**
     54• Export up to 200 variations to CSV
     55• Import up to 200 variations from CSV
     56• Excel-compatible CSV format
     57• Data validation
     58
     59**Performance Caching**
     60• Virtual scrolling for large datasets
     61• Intelligent caching system
     62• Smooth performance even on shared hosting
     63• Background sync doesn't slow admin
     64• Zero impact on frontend speed
     65
     66**Smart Filtering**
     67• Search by product name, SKU, category
     68• Filter by stock status (in stock, out of stock, low stock)
     69• Attribute-based filtering (color, size, etc.)
     70• Instant search results
     71
     72**Community Support**
     73• WordPress.org support forum
     74• Documentation and guides
     75• Regular updates
     76
     77= Pro Features ($29/year) =
     78
     79[**Upgrade to Pro**](https://bytebays.com/checkout.php) – Everything in Free, plus:
     80
     81**Unlimited Bulk Operations**
     82• No 10-variation limit – update hundreds at once
     83• Update prices by percentage or fixed amount
     84• Stock level formulas and patterns
     85• Advanced preview panel
     86
     87**SKU Pattern Generator**
     88• Generate SKUs from patterns (e.g., SHIRT-{COLOR}-{SIZE})
     89• Automatic SKU creation for new variations
     90• Batch SKU updates with validation
     91
     92**Attribute Manager & Converter** (Pro Only)
     93• Convert local attributes to global with one click
     94• Fix attribute chaos automatically
     95• Bulk attribute operations
     96
     97**Unlimited CSV + XLSX Export/Import**
     98• No 200-row limit – export/import thousands
     99• XLSX (native Excel) support
     100• CSV export/import for unlimited variations
     101• Advanced data validation and error handling
     102
     103**Priority Email Support**
     104• 24-hour response time (business days)
     105• Direct email: info@bytebays.com
     106• Setup assistance
     107• Feature request priority
     108
     109**30-day money-back guarantee** – no questions asked.
     110
     111👉 [**Get Pro for $29/year**](https://bytebays.com/checkout.php) | [**Learn More**](https://bytebays.com/variation-hub/)
     112
     113= Save Hours Every Week =
     114
     115**Real Time Savings:**
     116• Seasonal pricing update (500 variations): 2 minutes vs. 4 hours manually
     117• Stock adjustment (300 variations): 30 seconds vs. 2 hours manually
     118• SKU standardization (200 variations): 1 minute vs. 3 hours manually
     119
     120= Multi-Language Support =
     121
     122Interface available in:
     123• English 🇺🇸
     124• Hungarian 🇭🇺
     125• German 🇩🇪
     126• Spanish 🇪🇸
     127• French 🇫🇷
     128
     129Compatible with WPML, Polylang, and TranslatePress.
     130
     131= Technical Highlights =
     132
     133• **WooCommerce HPOS Compatible** – Works with High-Performance Order Storage
     134• **React 18 + TypeScript** – Modern, fast UI
     135• **Virtual Scrolling** – Handle thousands of variations smoothly
     136• **Custom Database Caching** – Optimized queries for performance
     137• **GPL Licensed** – 100% open source
    29138
    30139== Installation ==
    31140
    32 1. Upload plugin files to /wp-content/plugins/variation-hub/
    33 2. Activate through Plugins menu
    34 3. Navigate to Products > Variation Hub
    35 4. Start managing your variations
    36 
    37 Minimum Requirements:
    38 * WordPress 6.0+
    39 * WooCommerce 6.0+
    40 * PHP 8.1+
    41 * MySQL 5.7+
    42 
    43 == Source Code & Build Instructions ==
    44 
    45 This plugin includes human-readable source code for all compiled assets.
    46 
    47 **Source Code Location:**
    48 * React/TypeScript source: `assets/src/`
    49 * Build configuration: `vite.config.ts`, `tsconfig.json`, `package.json`
    50 * All source files are included in the plugin distribution
    51 
    52 **Build Instructions:**
    53 
    54 1. Install dependencies:
    55 ```
    56 npm install
    57 ```
    58 
    59 2. Development mode (hot reload):
    60 ```
    61 npm run dev
    62 ```
    63 
    64 3. Production build:
    65 ```
    66 npm run build
    67 ```
    68 
    69 The compiled output is generated in `assets/` directory and includes:
    70 * `assets/main.js` - Minified React application
    71 * `assets/assets/*.css` - Compiled stylesheets
    72 
    73 **Build Tools Used:**
    74 * Vite 5.0+ - Build tool and dev server
    75 * TypeScript 5.3+ - Type checking
    76 * React 18.3+ - UI framework
    77 * Tailwind CSS 3.4+ - Styling
    78 * AG Grid Community 31+ - Data grid
    79 
    80 All source code is open source and available for review, modification, and redistribution under the GPLv3 license.
     141= From WordPress Admin =
     142
     1431. Navigate to **Plugins → Add New**
     1442. Search for "Variation Hub"
     1453. Click **Install Now**, then **Activate**
     1464. Go to **WooCommerce → Variation Hub**
     1475. Start editing variations! 🎉
     148
     149= Manual Installation =
     150
     1511. Download the plugin from [WordPress.org](https://wordpress.org/plugins/variation-hub/)
     1522. Upload the `variation-hub.zip` file via **Plugins → Add New → Upload Plugin**
     1533. Click **Install Now**, then **Activate**
     1544. Go to **WooCommerce → Variation Hub**
     155
     156= After Activation =
     157
     158**First Steps:**
     159• Click **Variation Hub** in the WooCommerce menu
     160• You'll see all your product variations in one table
     161• Try inline editing: double-click any cell to edit
     162• Use filters to narrow down variations (product, category, stock status)
     163
     164**Pro Setup:**
     165• Get your license key from [ByteBays.com](https://bytebays.com/checkout.php)
     166• Go to **Variation Hub → Settings → License**
     167• Enter your license key and click **Activate**
     168• Pro features unlock instantly (no restart needed)
     169
     170Need help? Post in our [support forum](https://wordpress.org/support/plugin/variation-hub/).
    81171
    82172== Frequently Asked Questions ==
    83173
    84 = Does this work with variable products? =
    85 
    86 Yes! Designed specifically for WooCommerce variable products.
    87 
    88 = Can I undo bulk changes? =
    89 
    90 Preview changes before applying. Regular backups recommended.
    91 
    92 = Is there a variation limit? =
    93 
    94 Free version supports 1,000 variations.
    95 
    96 = Does it work with multilingual sites? =
    97 
    98 Yes, compatible with WPML and Polylang.
    99 
    100 = Does it support WooCommerce HPOS? =
    101 
    102 Yes, fully compatible with HPOS.
     174= What's the difference between Free and Pro? =
     175
     176**Free ($0/forever):**
     177• Unlimited variations in Excel-like spreadsheet
     178• Inline editing with auto-save
     179• Bulk operations (up to 10 variations at once)
     180• CSV export/import (up to 200 rows)
     181• Smart filtering and search
     182• Performance caching
     183• Community support via WordPress.org forum
     184
     185**Pro ($29/year):**
     186Everything in Free, plus:
     187• Unlimited bulk operations (no 10-variation limit)
     188• Unlimited CSV/XLSX export/import (no 200-row limit)
     189• XLSX (native Excel) support
     190• SKU pattern generator (e.g., SHIRT-{COLOR}-{SIZE})
     191• Attribute manager & converter (local → global)
     192• Priority email support (24h response)
     193• 30-day money-back guarantee
     194
     195[Get Pro for $29/year →](https://bytebays.com/checkout.php)
     196
     197= How many variations can it handle? =
     198
     199**Free & Pro:** Tested with **10,000+ variations** without performance issues.
     200
     201**Performance Note:** On shared hosting, response time may increase with 2,000+ variations. For best results with large catalogs:
     202• Use managed WordPress hosting or VPS
     203• Enable WooCommerce HPOS (High-Performance Order Storage)
     204• Activate Variation Hub's performance caching (included in Free)
     205
     206Virtual scrolling loads only visible rows, so even 10,000 variations feel fast.
     207
     208= Does it work with my theme? =
     209
     210**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.
     211
     212**Tested with:**
     213• Astra, GeneratePress, Kadence (lightweight themes)
     214• Divi, Elementor (page builders)
     215• Storefront, Flatsome (WooCommerce themes)
     216
     217If you experience any theme conflicts, please report them on our [support forum](https://wordpress.org/support/plugin/variation-hub/).
     218
     219= Can I try Pro before buying? =
     220
     221We don't offer a trial, but we have a **30-day money-back guarantee** – no questions asked.
     222
     223**How to evaluate Pro:**
     2241. Use the free version first (see if you like the interface)
     2252. Upgrade to Pro [$29/year](https://bytebays.com/checkout.php)
     2263. If not satisfied, request a refund within 30 days (email: info@bytebays.com)
     227
     228= How do bulk operations work? =
     229
     230**Inline Editing (Free & Pro):**
     231• Double-click any cell (price, stock, SKU)
     232• Type the new value
     233• Press Enter to save
     234• Works on unlimited variations (one at a time)
     235
     236**Bulk Panel (Free - Limited to 10 variations):**
     237• Select up to 10 variations with checkboxes
     238• Operations available:
     239  - Update prices (set fixed value)
     240  - Adjust stock quantities
     241  - Modify SKUs
     242• Preview changes before applying
     243
     244**Advanced Bulk Panel (Pro - Unlimited):**
     245• Select unlimited variations (hundreds or thousands)
     246• Advanced operations:
     247  - Increase/decrease prices by percentage (e.g., +20% sale, -15% clearance)
     248  - Stock formulas and patterns
     249  - Generate SKUs from patterns (e.g., SHIRT-{COLOR}-{SIZE})
     250  - Bulk attribute updates
     251• Preview changes before applying
     252
     253= Can I use this on multiple sites? =
     254
     255**Free version:** Install on unlimited sites (GPL licensed).
     256
     257**Pro license:** One license = **one site**.
     258
     259**Multi-site licensing:** Volume licensing options are coming soon – [join our mailing list](https://bytebays.com/variation-hub/#contact) to be notified!
     260
     261Perfect for agencies managing multiple client stores.
     262
     263= Does it affect my store's speed? =
     264
     265**No!** Variation Hub runs only in the WordPress admin area. Your customers won't notice any difference.
     266
     267**Technical Details:**
     268• **Frontend:** Zero impact – no scripts or styles loaded
     269• **Admin:** Loads only on the Variation Hub page (not on other WP admin pages)
     270• **Background Sync:** Uses Action Scheduler (WooCommerce's queue system) for non-blocking updates
     271• **Database:** Custom indexes and transient caching for fast queries
     272
     273**Performance Benchmarks:**
     274• 1,000 variations: 1.2s load time
     275• 5,000 variations: 3.8s load time (with caching)
     276• 10,000 variations: 7.2s load time (Pro with advanced caching)
     277
     278*Tested on: Hetzner Cloud VPS (4 vCPU, 8GB RAM), PHP 8.2, WooCommerce 9.4*
     279
     280= What if I have a problem? =
     281
     282**Free Users:**
     283• Post on the [WordPress.org support forum](https://wordpress.org/support/plugin/variation-hub/)
     284• We monitor the forum daily (response time: 24-48 hours)
     285
     286**Pro Users:**
     287• Priority email support: info@bytebays.com
     288• 24-hour response time (business days)
     289• Setup assistance & troubleshooting
     290
     291**Critical Bugs:**
     292• Reported publicly on GitHub: [github.com/bytebays/variation-hub](https://github.com/bytebays/variation-hub)
     293• Security issues: Email privately to info@bytebays.com
     294
     295= Is it GDPR compliant? =
     296
     297**Yes!** Variation Hub does not:
     298❌ Track users or store analytics 
     299❌ Set cookies 
     300❌ Send data to external servers (except for Pro license validation) 
     301❌ Store personal customer data 
     302
     303**License Validation (Pro only):**
     304• Pro license checks connect to ByteBays.com API
     305• Only sends: license key, domain, WordPress version
     306• No personal data or customer info is transmitted
     307
     308**WooCommerce Data:**
     309• All variation data stays in your WordPress database
     310• No external API calls for product/order data
     311
     312[Read our Privacy Policy →](https://bytebays.com/terms.php#privacy)
     313
     314= Can I translate the plugin? =
     315
     316**Yes!** The plugin is translation-ready with full i18n support.
     317
     318**Built-in Languages:**
     319• English (en_US) – Default
     320• Hungarian (hu_HU) – 100% translated
     321• German (de_DE) – Coming soon
     322• Spanish (es_ES) – Coming soon
     323• French (fr_FR) – Coming soon
     324
     325**How to Translate:**
     3261. Download `.pot` file from `/languages/variation-hub.pot`
     3272. Use Poedit or Loco Translate plugin
     3283. Create `.po` and `.mo` files for your language
     3294. Submit translations to our [GitHub repo](https://github.com/bytebays/variation-hub) – we'll include them in future releases!
     330
     331**Translation Plugins:**
     332• WPML – Fully compatible
     333• Polylang – Fully compatible
     334• TranslatePress – Fully compatible
     335
     336= What's next on the roadmap? =
     337
     338**Upcoming Features (2025):**
     339• 📊 Excel XLSX import (Pro)
     340• 🔍 Advanced search with regex support
     341• 🏷️ Variation templates (duplicate variations faster)
     342• 📈 Performance analytics (identify slow variations)
     343• 🔗 Attribute relationship management (auto-suggest color/size combos)
     344
     345**Feature Requests:**
     346Vote for features or suggest new ones in our [support forum](https://wordpress.org/support/plugin/variation-hub/) or email info@bytebays.com.
     347
     348Pro users' requests get **priority** in development planning!
     349
     350= Can I use this on multiple sites? =
     351
     352**Free version:** Yes, unlimited sites (GPL license).
     353
     354**Pro license:** 1 license = 1 site.
     355
     356**Multi-site licensing:** Volume licensing options are coming soon – [join our mailing list](https://bytebays.com/variation-hub/#contact) to be notified!
     357
     358= Do you offer refunds? =
     359
     360Yes! **30-day money-back guarantee** on all Pro licenses. No questions asked. Just email info@bytebays.com within 30 days of purchase.
     361
     362= How do I get support? =
     363
     364**Free version:**
     365• [WordPress.org Support Forum](https://wordpress.org/support/plugin/variation-hub/)
     366
     367**Pro version:**
     368• Priority email: info@bytebays.com
     369• 24-hour response time (business days)
     370• Setup assistance
    103371
    104372== Screenshots ==
    105373
    106 1. Spreadsheet view with inline editing
    107 2. Bulk operations panel
    108 3. Advanced filters
    109 4. Attribute manager
    110 5. SKU generator
     3741. **Spreadsheet View** – Excel-like interface with inline editing. Click any cell to edit, changes save instantly.
     3752. **Bulk Operations Panel** – Update prices, stock, SKUs for multiple variations. Preview changes before applying.
     3763. **Advanced Filters** – Search by product name, SKU, category, stock status. Filter by attributes (color, size, etc.).
     3774. **Attribute Manager** – Convert local attributes to global. Manage variation attributes efficiently.
     3785. **Pro Upgrade Prompt** – Clear upgrade path shown when hitting free tier limits (10 bulk operations).
    111379
    112380== Changelog ==
    113381
     382= 1.0.0 - 2025-11-28 =
     383
     384**Initial Release**
     385
     386✨ **Features:**
     387• Excel-like spreadsheet view with inline editing
     388• Bulk operations (price, stock, SKU updates)
     389• Advanced filtering and search
     390• CSV export/import (200 rows in free version)
     391• Custom database caching (500 variations/second sync)
     392• Attribute manager (local → global conversion)
     393• WooCommerce HPOS compatibility
     394• Multi-language support (EN, HU, DE, ES, FR)
     395• Pro licensing system
     396
     397⚡ **Performance:**
     398• Lazy loading for large datasets
     399• Background cache synchronization
     400• Optimized SQL queries (prepared statements)
     401• Handles 1,000+ variations smoothly
     402
     403🔒 **Security:**
     404• Capability checks on all endpoints
     405• Nonce verification
     406• Input sanitization & output escaping
     407• WordPress Coding Standards compliant
     408
     409== Upgrade Notice ==
     410
    114411= 1.0.0 =
    115 * Initial release
    116 * Spreadsheet view with infinite scroll
    117 * Inline editing
    118 * Bulk operations
    119 * Advanced filtering
    120 * Multi-language support
    121 * WooCommerce HPOS compatibility
    122 
    123 == Upgrade Notice ==
    124 
    125 = 1.0.0 =
    126 Initial release. Backup your database before installing.
     412**NEW:** Initial release of Variation Hub. Backup your database before installing any new plugin. Test on staging environment first for production sites.
    127413
    128414== External Services ==
    129415
    130 This plugin connects to ByteBays License API for license activation and validation.
    131 
    132 **Service:** ByteBays License Management System
    133 **Purpose:** Activate and validate plugin licenses for Pro features
    134 **Data Sent:**
    135 * License key (provided by user)
    136 * Domain name (your WordPress site domain)
    137 * Site URL and Home URL
    138 * WordPress version, WooCommerce version, Plugin version
    139 * Timestamp of activation/validation requests
     416Variation Hub **Free version does NOT connect to external services.** All data stays on your WordPress server.
     417
     418**Pro License Activation (Optional):**
     419
     420If you purchase a Pro license, the plugin connects to **ByteBays License API** for activation and validation ONLY.
     421
     422**Service:** ByteBays License Management System 
     423**URL:** https://bytebays.com/ (license validation API)
     424**Purpose:** Validate license keys and unlock Pro features 
     425
     426**Data Sent:**
     427• License key (provided by you after purchase)
     428• Your site domain (e.g., example.com)
     429• WordPress version, WooCommerce version, Plugin version
     430• Activation timestamp
    140431
    141432**When Data is Sent:**
    142 * When you activate a Pro license in plugin settings
    143 * Daily automatic validation (background process)
    144 * When you deactivate a license
    145 * Security incident reports (if license tampering detected)
    146 
    147 **Third-Party Service Provider:** ByteBays (https://bytebays.com)
    148 **Terms of Service:** https://bytebays.com/terms.php
    149 **Privacy Policy:** https://bytebays.com/terms.php#privacy
    150 
    151 The free version does NOT communicate with external services. License API is only used when you purchase and activate a Pro license.
    152 
    153 == Development ==
    154 
    155 **Source Code & Build Instructions:**
    156 
    157 This plugin includes full uncompiled source code to comply with WordPress.org guidelines (Guideline #4: Code must be mostly human readable).
    158 
    159 **Source files included in plugin:**
    160 * `assets/src/` - React 18.3+ components (TypeScript 5.3+)
    161 * `package.json` - npm dependencies configuration
    162 * `vite.config.ts` - Vite 5.0+ build tool configuration
    163 * `tsconfig.json` - TypeScript compiler settings
    164 * `tailwind.config.js` - Tailwind CSS configuration
    165 
    166 **Technologies used:**
    167 * React 18.3+ with TypeScript 5.3+ (strict mode)
    168 * Vite 5.0+ (build tool, development server)
    169 * AG Grid Community 31+ (Excel-like spreadsheet interface)
    170 * TanStack Query v5 (data fetching and caching)
    171 * Tailwind CSS 3.4+ (utility-first styling)
    172 * i18next (internationalization)
    173 
    174 **To build from source:**
    175 1. Navigate to plugin directory
    176 2. Install dependencies: `npm install`
    177 3. Build production assets: `npm run build`
    178 4. Output: `assets/main.js` and `assets/assets/main-[hash].css`
    179 
    180 **Development Server (hot reload):**
    181 ```
    182 npm run dev
    183 ```
    184 Server runs on port 5173 with hot module replacement.
    185 
    186 **Contact:**
    187 For source code questions or build support, contact: info@bytebays.com
     433• When you activate a Pro license (Settings > License)
     434• Daily automatic validation (background cron)
     435• When you deactivate a license
     436
     437**Privacy:**
     438• No tracking or analytics
     439• No personal data collected
     440• Terms: https://bytebays.com/terms.php
     441• Privacy: https://bytebays.com/terms.php#privacy
     442
     443**Opt-Out:**
     444• Don't activate a Pro license (use free version)
     445• Deactivate license anytime (Settings > License)
     446
     447Free version users: **Zero external connections.**
Note: See TracChangeset for help on using the changeset viewer.