Complete Documentation & User Guide
v1.1.0
Custom Product Image Upload for WooCommerce is a comprehensive WordPress plugin that allows customers to upload and crop custom images for WooCommerce products before adding them to cart. The plugin features enterprise-grade security, multi-product configurations, bulk operations, modern tabbed admin UI, and comprehensive monitoring capabilities.
Important: Make sure WooCommerce is installed and activated before installing this plugin. The plugin requires WooCommerce 5.0 or higher to function properly.
After activation, navigate toCustom Image Upload in your WordPress admin menu. You’ll see a modern 6-tab interface:
Start with the Default Settings tab to establish global defaults:
Default Configuration Options: • Maximum Images: 1 to Unlimited per product • Max File Size: 1 MB to Unlimited • Allowed File Types: JPG, JPEG, PNG, GIF, WebP • Button Text: Customizable • Button Colors: Brand matching
Use the Add Configuration tab to set up individual products with specific requirements:
Important: Make sure WooCommerce is installed and activated before installing this plugin. The plugin requires WooCommerce 5.0 or higher to function properly..
Configure global fallback settings for all products without specific configurations.
Set up individual product configurations with specific requirements.
Efficiently manage multiple products with shared settings.
Review, edit, and manage all configured products.
Backup and restore plugin configurations.
Monitor upload activity and security events.
Compatibility Testing:The plugin has been thoroughly tested across multiple WordPress themes including Twenty Twenty-One, Twenty Twenty-Two, Twenty Twenty-Three, and Storefront. It’s designed to work with any properly coded WordPress theme.
The plugin provides comprehensive hooks for developers to customize functionality
// Before the upload field is displayed do_action(‘cpiu_before_upload_field’, $product_id); // After the upload field is displayed do_action(‘cpiu_after_upload_field’, $product_id); // When an upload is successful do_action(‘cpiu_upload_success’, $file_path, $product_id, $user_id); // When an upload fails do_action(‘cpiu_upload_error’, $error_message, $product_id, $user_id); // Before cropping modal is shown do_action(‘cpiu_before_crop_modal’, $product_id); // After cropping modal is closed do_action(‘cpiu_after_crop_modal’, $product_id);
// Modify allowed file types add_filter(‘cpiu_allowed_file_types’, function($types) { $types[] = ‘svg’; // Add SVG support return $types; }); // Modify maximum file size add_filter(‘cpiu_max_file_size’, function($size, $product_id) { return $size * 2; // Double the size limit }, 10, 2); // Modify upload directory path add_filter(‘cpiu_upload_directory’, function($directory) { return ‘/custom/upload/path/’; }); // Add custom security validation add_filter(‘cpiu_security_validation’, function($result, $file_path, $product_id) { // Add your custom validation logic return $result; }, 10, 3);
Extensive CSS classes are available for styling customization:
// Listen for upload start document.addEventListener(‘cpiu:upload:start’, function(event) { console.log(‘Upload started for product:’, event.detail.productId); }); // Monitor upload progress document.addEventListener(‘cpiu:upload:progress’, function(event) { console.log(‘Upload progress:’, event.detail.progress + ‘%’); }); // Handle upload completion document.addEventListener(‘cpiu:upload:complete’, function(event) { console.log(‘Upload completed:’, event.detail.fileInfo); }); // Listen for cropping events document.addEventListener(‘cpiu:crop:start’, function(event) { console.log(‘Cropping started’); }); document.addEventListener(‘cpiu:crop:complete’, function(event) { console.log(‘Cropping completed:’, event.detail.cropData); });
Important: When customizing the plugin, always use hooks and filters instead of modifying core plugin files. This ensures your customizations survive plugin updates.
Debug Mode: Enable WordPress debug mode (WP_DEBUG = true) in wp-config.php to get detailed error information when troubleshooting issues..
The plugin supports unlimited images per product. You can configure different limits for different products using the per-product settings in the admin interface. Global defaults can be set in the Default Settings tab.
The plugin supports JPG, JPEG, PNG, GIF, and WebP formats with comprehensive MIME type validation. You can configure which formats are allowed globally or per-product through the admin interface.
Yes! The plugin includes comprehensive per-product configuration allowing you to set individual image count limits, file size restrictions, allowed formats, and even custom button styling for each product.
The plugin includes enterprise-grade security with real-time monitoring, detailed logging of all upload attempts, threat detection, and comprehensive audit trails. All security information is accessible through the Security Logs tab in the admin interface.
Yes, the plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS) and all modern WooCommerce features. Uploaded images integrate seamlessly with the new order storage system.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.
The plugin is designed to work with any properly coded WordPress theme. It has been tested with popular themes including Twenty Twenty-One, Twenty Twenty-Two, Twenty Twenty-Three, and Storefront. The interface adapts to your theme’s styling.
During uninstallation, you’ll be presented with options to either keep your data (recommended for temporary uninstall) or delete all plugin data. You can also export your settings before deletion for backup purposes.
Comprehensive setup guides, tutorials, and technical documentation.
Get help from our expert team for installation, configuration, and troubleshooting.
Contact Support Team ⟶
Learn more about our products, services, and latest updates.
Visit Nowdigiverse⟶
Report security vulnerabilities through responsible disclosure.
Report Security Issue⟶
We welcome contributions and feedback from the WordPress community. The plugin follows WordPress coding standards and includes comprehensive hooks for developers to extend functionality.
Contributing: For security-related contributions, please follow responsible disclosure practices. General contributions and feature requests are welcome through our support channels.
We are committed to understanding your requirements and crafting a tailored solution that aligns with your goals.
Enter your details and someone from our team will reach out to find a time to connect with you.
