Custom Product Image Upload for WooCommerce

Complete Documentation & User Guide

v1.1.0

🔍 No matching content found

Try searching with different keywords

Plugin Overview

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.

Perfect For:

Print-on-demand stores (custom t-shirts, mugs, posters)
Photography services (photo printing, canvas prints)
Design agencies (client artwork upload)
Custom manufacturing (personalized products)
Any business requiring customer-provided images

What's New in Version 1.1.0

Enterprise Security: Multi-layer security implementation
Security Monitoring: Real-time logging and statistics dashboard
Advanced Admin Interface: 6-tab interface with Import/Export
Enhanced File Validation: Double MIME type validation
User Activity Tracking: Monitor upload patterns

Core Features

Image Upload & Processing

Multi-Product Configuration

User Interface & Experience

WooCommerce Integration

Enterprise-Grade Security

Security Monitoring & Logging

Installation Guide

Automatic Installation (Recommended)

Manual Installation

Important: Make sure WooCommerce is installed and activated before installing this plugin. The plugin requires WooCommerce 5.0 or higher to function properly.

Installation Guide

Initial Setup Process

Step 1: Access Plugin Settings

After activation, navigate toCustom Image Upload in your WordPress admin menu. You’ll see a modern 6-tab interface:

Default Settings– Global configuration
Add Configuration – Per-product setup
Bulk Operations – Multiple product management
Existing Configurations – Review and edit
Import/Export – Backup and restore
Security Logs– Monitoring and analytics

Step 2: Configure Default Settings

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

Step 3: Set Up Products

Use the Add Configuration tab to set up individual products with specific requirements:

Select products using the searchable dropdown
Configure image count limits
Set file size restrictions
Choose allowed file types
Customize button appearance
Save configuration

Important: Make sure WooCommerce is installed and activated before installing this plugin. The plugin requires WooCommerce 5.0 or higher to function properly..

Admin Interface Guide

Tab 1: Default Settings

Configure global fallback settings for all products without specific configurations.

Tab 2: Add Configuration

Set up individual product configurations with specific requirements.

Tab 3: Bulk Operations

Efficiently manage multiple products with shared settings.

Tab 4: Existing Configurations

Review, edit, and manage all configured products.

Tab 5: Import/Export

Backup and restore plugin configurations.

Tab 6: Security Logs

Monitor upload activity and security events.

Security Features

File Validation

Upload Security

Access Control

Monitoring & Logging

Security Best Practices:

Usage Guide

For Store Administrators

Daily Management Tasks

Monitor Upload Activity: Check the Security Logs tab for upload statistics and any issues
Review Orders: View uploaded images in WooCommerce order screens
Manage Configurations: Add, edit, or remove product configurations as needed
Performance Monitoring: Track upload success rates and user behavior

Advanced Management

For Customers (Frontend Experience)

Upload Process

Visit Product Page: Navigate to a product with image upload enabled
Upload Images: Click the upload button to open the modal interface
Select Files: Choose images from device (supports multiple files)
Crop Images: Use the built-in cropping tool to adjust images
Preview: Review all uploaded images before finalizing
Add to Cart: Complete the process – images are saved with the order

Customer Benefits:

System Requirements

Server Requirements

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.

Development & Customization

WordPress Hooks & Filters

The plugin provides comprehensive hooks for developers to customize functionality

Action Hooks

// 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);

Filter Hooks

// 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);

CSS Customization

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.

Troubleshooting Guide

Common Issues & Solutions

Upload button not appearing on product pages

Possible causes:

Product not configured for image upload
WooCommerce not activated
Theme compatibility issues
JavaScript conflicts

Solutions:

Check if the product is configured in the admin panel
Verify WooCommerce is active and updated
Test with a default theme (Twenty Twenty-Three)
Check browser console for JavaScript errors
Deactivate other plugins temporarily to identify conflicts

File upload fails with security error

Common causes:

Unsupported file format
File size exceeds limits
Corrupted image file
Server security restrictions

Solutions:

1. Verify file format is supported (JPG, JPEG, PNG, GIF, WebP)
2. Check file size against configured limits
3. Try uploading a different image
4. Review security logs for detailed error information
5. Contact hosting provider if server restrictions are suspected

Images not displaying in cart or orders

Troubleshooting steps:

Verify images were successfully uploaded (check security logs)
Ensure WooCommerce cart and order integration is working
Check file permissions in upload directory
Clear any caching plugins or CDN cache
Verify HPOS compatibility if using High-Performance Order Storage

Cropping interface not loading

Possible solutions:

Clear browser cache and cookies
Check if Cropper.js library is loading properly
Verify no JavaScript conflicts with other plugins
Ensure proper file permissions for plugin assets
Test with browser developer tools to identify errors

Performance Optimization

Debug Mode: Enable WordPress debug mode (WP_DEBUG = true) in wp-config.php to get detailed error information when troubleshooting issues..

Frequently Asked Questions

How many images can customers upload per product?

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.

What file formats are supported?

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.

Can I set different upload requirements for different products?

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.

How does the security monitoring work?

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.

Is the plugin compatible with HPOS (High-Performance Order Storage)?

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.

Can I backup and restore plugin settings?

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut elit tellus, luctus nec ullamcorper mattis, pulvinar dapibus leo.

Does the plugin work with my theme?

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.

What happens to uploaded images when I uninstall the plugin?

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.

Version History & Changelog

Version 1.1.0 (Latest) - Enterprise Security Update

🚀 Major Features Added:

Enterprise Security:Comprehensive multi-layer security implementation
Security Monitoring:Real-time logging, statistics dashboard, and audit trails
Advanced Admin Interface: 6-tab interface with Import/Export and Security Logs
Secure Upload Class: Dedicated class for enterprise-grade file validation
Content Security Scanning: Detection of executable code and malicious patterns

🔒 Security Enhancements:

Enhanced File Validation: Double MIME type validation with finfo_file() and exif_imagetype()
Path Traversal Protection: Comprehensive filename and path security
Execution Prevention: .htaccess protection and non-executable permissions
Security Logs Management: Detailed logging with automatic cleanu

⚙️ Advanced Features:

Enhanced File Validation: Double MIME type validation with finfo_file() and exif_imagetype()
Path Traversal Protection: Comprehensive filename and path security
Execution Prevention: .htaccess protection and non-executable permissions
Security Logs Management: Detailed logging with automatic cleanu

Version 1.1.0 - Multi-Product Configuration

✨ New Features:

Multi-Product Configurations: Per-product image count, size, and file type settings
Tabbed Admin UI: Modern interface with Default Settings, Add Configuration, Bulk Operations, and Existing Configurations tabs
Searchable Product Selection: Select2-powered search by name, ID, or SKU
Bulk Operations: Apply settings to multiple products simultaneously

🎨 UI/UX Improvements:

Frontend Improvements: Enhanced upload/crop flow with modal interface
Cart/Order Integration: Thumbnails in cart and order views
Responsive Design: Better mobile experience

⚡ Technical Enhancements:

HPOS Compatibility: Full compatibility with WooCommerce High-Performance Order Storage
Settings Export/Import: Backup and restore configurations
Uninstall Options: User-controlled data retention during uninstallation

Version 1.0.0 - Initial Release

🎉 Initial Features:

Basic image upload functionality on product pages
Cropping capabilities with built-in Cropper.js integration
Admin settings panel for basic configuration
WooCommerce integration for cart and order management
Secure file handling with WordPress standards
Mobile-responsive upload interface

Roadmap - Upcoming Features

🚧 Under Development:

Usage Guide

📚 Documentation

Comprehensive setup guides, tutorials, and technical documentation.

💬 Professional Support

Get help from our expert team for installation, configuration, and troubleshooting.
Contact Support Team ⟶

🌐 Company Website

Learn more about our products, services, and latest updates.
Visit Nowdigiverse⟶

🛡️ Security Issues

Report security vulnerabilities through responsible disclosure.
Report Security Issue⟶

Support Guidelines

Before Contacting Support:

Check this documentation for solutions
Review the FAQ section
Try the troubleshooting steps
Test with default WordPress theme
Disable other plugins temporarily

When Contacting Support, Please Include:

📧 Contact Information

Support Email:hello@nowdigiverse.com
Website: https://nowdigiverse.com/
Response Time: Within 24-48 hours (business days)

Community & Contributions

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.