Bulk Product Image Updater for WooCommerce

A WordPress plugin that allows you to bulk update WooCommerce product featured images using a CSV file.

Features

• Bulk Update: Update multiple product images at once via CSV upload
• Image Download: Automatically downloads and adds images to WordPress media library
• URL Mapping: Maps products by their URLs for accurate identification
• Progress Tracking: Real-time progress updates during bulk processing
• Detailed Results: Comprehensive success/failure reporting
• Error Logging: Detailed log file for troubleshooting

Requirements

• WordPress 5.0 or higher
• WooCommerce plugin installed and activated
• PHP 7.2 or higher

Installation

1. Download the plugin folder
2. Upload the bulk-product-image-updater folder to /wp-content/plugins/
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Navigate to Tools > Bulk Image Updater to use the plugin

File Structure

bulk-product-image-updater/
├── bulk-product-image-updater.php  (Main plugin file)
├── css/
│   └── style.css                    (Admin interface styles)
├── js/
│   └── script.js                    (AJAX handling and UI updates)
└── README.md                        (This file)

Usage

1. Prepare Your CSV File

Create a CSV file with two columns (no headers needed):

• Column A: Product URL (full URL to your WooCommerce product)
• Column B: Image URL (full URL to the new featured image)

Example CSV:

https://yoursite.com/product/blue-shirt,https://example.com/images/blue-shirt.jpg
https://yoursite.com/product/red-pants,https://example.com/images/red-pants.jpg
https://yoursite.com/product/green-hat,https://example.com/images/green-hat.jpg

2. Upload and Process

1. Go to Tools > Bulk Image Updater in your WordPress admin
2. Click "Choose File" and select your CSV file
3. Choose whether to download images to media library (recommended: checked)
4. Click "Process Updates"
5. Wait for the process to complete
6. Review the results summary and detailed report

3. Review Results

The plugin provides:

• Summary Statistics: Total processed, successful, and failed updates
• Detailed Table: Row-by-row results with status and messages
• Progress Log: Real-time activity log with timestamps

Options

Download Images to Media Library

• Checked (Recommended): Images are downloaded and stored in your WordPress media library
• Unchecked: Uses external image URLs directly (not recommended for production)

CSV Format Details

Valid Product URL Formats:

• https://yoursite.com/product/product-slug
• https://yoursite.com/shop/product-slug (if using custom base)
• Any valid product permalink from your WooCommerce store

Valid Image URL Formats:

• https://example.com/image.jpg
• https://cdn.example.com/images/product.png
• Any publicly accessible image URL (JPG, PNG, GIF, WebP)

Important Notes:

• Product URLs must match exactly with your WooCommerce product permalinks
• Image URLs must be publicly accessible
• The plugin identifies products by URL, so ensure URLs are correct
• No headers should be included in the CSV file

Troubleshooting

Products Not Found

• Verify the product URL is correct and matches your site's permalink structure
• Check if the product exists and is published
• Ensure WooCommerce is activated

Image Download Failures

• Verify the image URL is publicly accessible
• Check if the image format is supported (JPG, PNG, GIF, WebP)
• Ensure your server has internet access to download external images
• Check file size limits in your hosting configuration

Permission Errors

• Ensure your WordPress upload directory is writable
• Check PHP file upload limits
• Verify user has 'manage_options' capability

Check Log File

The plugin creates a log file at: /wp-content/uploads/bulk-image-update-log.txt

This log contains detailed information about each operation and can help diagnose issues.

Security

• Uses WordPress nonces for CSRF protection
• Requires admin capabilities to access
• Validates file types and AJAX requests
• Sanitizes all user inputs

Support

For issues or questions:

1. Check the log file for detailed error messages
2. Verify your CSV format matches the examples
3. Ensure WooCommerce and WordPress are up to date
4. Test with a small batch first (2-3 products)

Changelog

Version 1.0.0

• Initial release
• CSV upload functionality
• Bulk image update processing
• Progress tracking
• Detailed reporting
• Error logging

License

GPL v2 or later

Credits

Developed for WooCommerce product management