Modern shipping calculation plugin that computes shipping costs as a percentage of cart value with advanced filtering options.
- WordPress: 6.8 or higher
- WooCommerce: 10.0 or higher (automatically enforced by WordPress)
- PHP: 8.3 or higher
- Database: MySQL 8.0+ or MariaDB 10.6+
Note: WordPress will prevent installation and activation of this plugin if WooCommerce is not installed or active, thanks to the
Requires Pluginsheader.
- Modern PHP Architecture: Built with PHP 8.3+ features (enums, readonly properties, match expressions)
- HPOS Compatible: Full support for WooCommerce High-Performance Order Storage
- Zero Dependencies: No jQuery, no external libraries - pure vanilla JavaScript
- Advanced Filtering: Include/exclude digital products and specific categories
- Real-time Preview: Live calculation preview in admin interface
- Performance Optimized: Intelligent caching system with automatic invalidation
- Comprehensive Logging: Detailed debug logging with performance metrics
- Security First: CSRF protection, input validation, rate limiting, XSS protection
- Upload plugin files to
/wp-content/plugins/woo-percentage-shipping/ - Activate through Plugins → Installed Plugins
- Configure settings at WooCommerce → Percentage Shipping
- Add shipping method to your WooCommerce shipping zones
This plugin supports automatic updates directly from GitHub releases:
- WordPress Dashboard: Updates appear automatically in Plugins → Installed Plugins
- One-Click Updates: Update directly from the WordPress admin interface
- Version Notifications: Get notified when new versions are available
- Download: Get the latest release from GitHub
- Upload: Replace the plugin files or use WordPress admin upload
- ZIP Installation: Install via Plugins → Add New → Upload Plugin
Important: When downloading from GitHub, the ZIP file contains a folder with the version number (e.g.,
Woo-Percentage-Shipping-1.4.0). After extracting, rename the folder towoo-percentage-shippingbefore uploading to WordPress.
- GitHub Updater Plugin: Install the GitHub Updater plugin for enhanced GitHub integration
- Built-in Updater: The plugin includes a built-in update checker that monitors GitHub releases
- Manual Installation: Download and install releases manually as needed
- Enable Plugin: Toggle shipping calculation on/off
- Shipping Percentage: Percentage of cart value (0-100%)
- Minimum Fee: Lowest shipping cost regardless of percentage
- Maximum Fee: Highest shipping cost cap (0 = unlimited)
- Include Digital Products: Calculate shipping for virtual/downloadable items
- Excluded Categories: Remove specific product categories from calculation
- Debug Mode: Enable detailed logging for troubleshooting
- Cart Analysis: Scans all products in customer cart
- Product Filtering: Applies your inclusion/exclusion rules
- Percentage Calculation: Computes shipping as percentage of filtered total
- Fee Limits: Applies minimum/maximum constraints
- Shipping Rate: Adds calculated rate to WooCommerce checkout
- Intelligent Caching: Results cached for 1 hour with automatic invalidation
- Rate Limiting: AJAX requests limited to prevent abuse
- Memory Optimization: Efficient data structures and cleanup routines
- Database Optimization: Minimal queries with proper indexing
- CSRF Protection: Nonce verification on all forms
- Input Sanitization: All user inputs validated and sanitized
- XSS Prevention: Proper output escaping throughout
- Capability Checks: Admin access restricted to authorized users
- Rate Limiting: AJAX requests throttled per user
- Security Headers: HTTP security headers implemented
Enable debug mode to access detailed logs:
- Location: WooCommerce → Status → Logs
- Filter: Select "wc-percentage-shipping" source
- Information: Calculation details, performance metrics, error tracking
- Modular Design: Separate classes for validation, calculation, caching, logging
- Type Safety: Full PHP 8.3 type declarations
- Error Handling: Comprehensive exception handling with graceful degradation
- Testing: PHPUnit test suite with 90%+ coverage
- PSR-12 Compliance: Modern PHP coding standards
- Documentation: Comprehensive inline documentation
- Performance: Optimized for speed and memory usage
- Maintainability: Clean, readable, and extensible codebase
Bug Fixes & Cleanup
- FIXED: PHP fatal errors related to undefined methods
- FIXED: Removed all duplicate method definitions
- FIXED: Added all missing rendering methods
- IMPROVED: Clean code structure with no duplicate methods
- IMPROVED: Verified PHP syntax is correct
- IMPROVED: All admin interface tabs now working properly
Enhanced Update Cache Clearing
- FIXED: More aggressive cache clearing to prevent version inconsistencies
- FIXED: Clear all update-related transients including site transients
- IMPROVED: Force WordPress to re-check for updates with wp_update_plugins()
- IMPROVED: Clear plugin cache groups for complete refresh
- IMPROVED: Prevent showing old versions as available updates
WordPress Update Cache Fix
- FIXED: WordPress update cache now properly shows latest version
- FIXED: Enhanced cache clearing mechanism
- IMPROVED: Automatic cache clearing on plugin activation
- IMPROVED: More robust update detection system
Code Cleanup & Branding
- REMOVED: All Yoast references from code and documentation
- IMPROVED: Renamed to "Modern Vertical Sidebar Interface"
- IMPROVED: Clean, independent branding without external references
- IMPROVED: Updated all comments and documentation
Modern Vertical Sidebar Interface
- NEW: Complete admin interface redesign with modern vertical sidebar
- NEW: Search functionality with Ctrl+K shortcut
- NEW: Expandable navigation sections with clean organization
- NEW: WordPress form-table styling for professional appearance
- IMPROVED: Better user experience with smooth animations
- IMPROVED: Mobile-responsive design with collapsible sidebar
- IMPROVED: Keyboard shortcuts and accessibility enhancements
Major Feature Update - All Advanced Features
- NEW: Extended product filtering (tags, attributes, SKUs, stock status)
- NEW: Flexible calculation methods (per-product, tiered pricing, tax-inclusive)
- NEW: Advanced pricing options (free shipping threshold, flat rate addition, weekend surcharges)
- NEW: Customer group pricing for B2B scenarios
- NEW: Comprehensive analytics and performance metrics
- NEW: Settings backup and restore functionality
- NEW: Enhanced admin interface with 7 organized tabs
- IMPROVED: Better product filtering with multiple criteria
- IMPROVED: Professional pricing options for complex scenarios
- IMPROVED: Real-time statistics and performance monitoring
- FIXED: Updater class loading issue resolved
- FIXED: "Class not found" error on plugin activation
- IMPROVED: Auto-update functionality now works correctly
- NEW: Complete modern settings page redesign
- NEW: Tab-based interface (General, Advanced, Performance, Security)
- NEW: Live preview with real-time calculation updates
- NEW: Quick actions (Clear Cache, Export Settings, View Logs)
- NEW: Modern toggle switches and enhanced form controls
- NEW: Responsive design with mobile-first approach
- NEW: Enhanced accessibility with ARIA labels and keyboard shortcuts
- NEW: Sidebar widgets (Live Preview, System Info, Quick Links)
- IMPROVED: Better user experience with visual feedback and animations
- IMPROVED: Modern CSS Grid and Flexbox layout
- IMPROVED: Enhanced JavaScript with modern Fetch API
- BREAKING: Minimum PHP version raised to 8.3
- BREAKING: Minimum WordPress version raised to 6.8
- BREAKING: Minimum WooCommerce version raised to 10.0
- Enhanced HPOS compatibility with latest WooCommerce features
- Improved performance with advanced caching strategies
- Enhanced security with additional rate limiting and validation
- Modernized codebase with latest PHP 8.3 features
- Comprehensive error handling and logging system
- Zero-dependency architecture with vanilla JavaScript
- Added modular architecture with separate validator, calculator, and cache classes
- Implemented comprehensive testing framework
- Enhanced admin interface with real-time preview
- Added performance monitoring and logging
- Improved security with rate limiting and enhanced validation
- Issues: GitHub Issues
- Documentation: Development Guide
- Logs: Check WooCommerce → Status → Logs for debugging
GPL v2 or later - Full License Text