Bulk Product Image Updater for WooCommerce v2.0

A WordPress plugin that allows you to bulk update WooCommerce product featured images using either a simple ZIP file upload (recommended) or CSV file.

🎯 What's New in v2.0

• ZIP Upload Method: The easiest way! Just name your images with product slugs and upload a ZIP file
• Customizable Prefix: Set your own prefix to avoid conflicts with existing images
• Dual Methods: Choose between ZIP upload (simple) or CSV upload (advanced)
• Improved UI: Tabbed interface with better instructions and examples

Features

• ZIP Upload (NEW): Upload a ZIP file with images named by product slug with custom prefix
• CSV Upload: Traditional method with product URLs and image URLs
• Automatic Matching: Maps images to products by slug or URL
• Image Download: Automatically downloads and adds images to WordPress media library
• Progress Tracking: Real-time progress updates during bulk processing
• Detailed Results: Comprehensive success/failure reporting
• Error Logging: Detailed log file for troubleshooting
• Customizable Prefix: Set your own prefix to prevent conflicts

Requirements

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

Installation

1. Download the plugin ZIP file
2. Upload via WordPress Admin → Plugins → Add New → Upload Plugin
3. Activate the plugin
4. Navigate to Tools → Bulk Image Updater

Method 1: ZIP Upload (Recommended) 🚀

This is the easiest and fastest method for non-technical users!

Step-by-Step Guide:

1. Set Your Prefix (One-time setup)

• Go to Tools → Bulk Image Updater
• In the Settings section, you'll see the default prefix: bulk-up-
• You can change this to any prefix you want (e.g., new-img-, update-, etc.)
• Click "Save Prefix"

2. Rename Your Images

Your product images must be named using this format:

[prefix][product-slug].[extension]

Examples:

• Product URL: https://yoursite.com/product/blue-cotton-shirt
• Product Slug: blue-cotton-shirt
• Image Name: bulk-up-blue-cotton-shirt.jpg

More Examples:

Product: fre-sweet-12-mg-nicotine-pouch
Image:   bulk-up-fre-sweet-12-mg-nicotine-pouch.jpg

Product: leather-wallet-brown
Image:   bulk-up-leather-wallet-brown.png

Product: samsung-galaxy-s23
Image:   bulk-up-samsung-galaxy-s23.jpg

3. Create ZIP File

• Put all your renamed images in a folder
• Right-click the folder and select "Compress" or "Send to → Compressed folder"
• You now have a ZIP file ready to upload!

4. Upload and Process

• Go to Tools → Bulk Image Updater
• Click the "📦 ZIP Upload" tab
• Click "Choose File" and select your ZIP file
• Click "🚀 Process ZIP Upload"
• Wait for completion and review results!

Finding Product Slugs

Method 1 - From Product URL:

URL: https://yoursite.com/product/blue-cotton-shirt
Slug: blue-cotton-shirt (the last part after /product/)

Method 2 - From WordPress Admin:

1. Go to Products → All Products
2. Click on a product to edit
3. Look at the permalink below the title
4. The slug is the last part of the URL

Method 3 - Export All Slugs:

1. Go to Products → All Products
2. Use a plugin like "WP All Export" to export product slugs
3. Or use WooCommerce's built-in export (Products → Export)

Method 2: CSV Upload (Advanced)

For users who need more control or are updating images from external URLs.

CSV Format:

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

• Column A: Product URL
• Column B: Image URL

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://cdn.example.com/green-hat.png

Steps:

1. Prepare your CSV file
2. Go to Tools → Bulk Image Updater
3. Click the "📄 CSV Upload" tab
4. Upload your CSV file
5. Check "Download images to media library" (recommended)
6. Click "Process CSV Updates"

Why Use a Prefix?

The prefix (like bulk-up-) helps:

• Avoid conflicts with existing images that might have similar names
• Identify which images were uploaded via bulk update
• Organize your media library better
• Prevent accidentally overwriting existing featured images

Troubleshooting

Products Not Found

Problem: Plugin says "Product not found for slug: xyz"

Solutions:

• Verify the product exists and is published
• Check if the slug is correct (go to the product edit page and look at permalink)
• Make sure you're using the exact slug (case-sensitive in some systems)
• Verify WooCommerce is activated

Images Not Uploading from ZIP

Problem: ZIP uploads but images don't process

Solutions:

• Check if image names have the correct prefix
• Verify image formats are supported (JPG, PNG, GIF, WebP)
• Make sure ZIP file isn't corrupted
• Check file size limits in your hosting configuration

Prefix Mismatch

Problem: All images fail with "Image does not have required prefix"

Solutions:

• Check the prefix in Settings matches your image filenames
• Make sure there are no extra spaces in the prefix or filenames
• Verify image names start exactly with the prefix (case-sensitive)

Permission Errors

Solutions:

• Ensure your WordPress upload directory is writable
• Check PHP file upload limits in php.ini
• Verify user has 'manage_options' capability
• Contact your hosting provider if issues persist

Large File Uploads

If you're uploading many images or large files:

• Increase PHP upload_max_filesize and post_max_size
• Increase PHP max_execution_time
• Split large batches into smaller ZIP files

Check Log File

The plugin creates a detailed log at:

/wp-content/uploads/bulk-image-update-log.txt

This log contains information about each operation and helps diagnose issues.

Tips for Best Results

1. Test First: Start with 2-3 products to verify everything works
2. Backup: Always backup your database before bulk operations
3. Image Optimization: Optimize images before uploading for better site performance
4. Naming Convention: Be consistent with your naming (all lowercase, hyphens instead of spaces)
5. Check Slugs: Double-check product slugs before renaming hundreds of images
6. Batch Processing: For thousands of products, split into batches of 100-200

Batch Processing Example

For 500 products, create multiple ZIP files:

• batch-1.zip - Products 1-100
• batch-2.zip - Products 101-200
• batch-3.zip - Products 201-300
• etc.

Upload and process each batch separately.

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)
└── README.md                        (This file)

Changelog

Version 2.0.0

• Added ZIP upload method with slug matching
• Added customizable prefix settings
• Added tabbed interface for method selection
• Improved UI with better instructions and examples
• Enhanced error reporting for ZIP method
• Better visual feedback and progress tracking

Version 1.0.0

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

Support

For issues:

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

Frequently Asked Questions

Q: Can I use this with variable products? A: Yes, but it updates the main product image, not variation images.

Q: What happens to the old featured image? A: It remains in your media library but is no longer the featured image.

Q: Can I undo the changes? A: Not automatically, but the old images are still in your media library.

Q: How do I find all my product slugs quickly? A: Export products using WooCommerce or use a product export plugin.

Q: Does this work with product variations? A: This updates main product images. For variation images, you'd need a different approach.

Q: Can I use this to update product gallery images? A: Currently only featured images. Gallery images would require plugin modification.

License

GPL v2 or later

Credits

Developed for easy WooCommerce product image management