=== GURUALPHA Bulk Product Images Changer for WooCommerce ===
Contributors: gurualpha
Tags: WooCommerce, Bulk Product Images, Product Image Changer, Drag and Drop Uploader, Product Management, Auto Matching
Requires at least: 5.5
Tested up to: 6.6
Requires PHP: 7.2
Stable tag: 2.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Author URI: https://gurualpha.com

A plugin to easily change the images of multiple WooCommerce products in bulk using a drag-and-drop uploader and automated matching based on SKU, Product ID, or Product Title.

== Description ==

Do you have multiple WooCommerce products but dread the time-consuming process of updating their images one by one? **GURUALPHA Bulk Product Images Changer** makes it quick and effortless to change the main images of all your WooCommerce products in bulk.

**Key Features:**
- **Drag and Drop Uploader**: Easily upload and assign product images by simply dragging and dropping them.
- **Auto-Matching**: Automatically matches images to products based on image filenames using selected criteria:
  - **SKU**: Match images by product SKU.
  - **Product ID**: Match images by WooCommerce Product ID.
  - **Product Title**: Match images by product title.
- **Global Matching Method Selection**: Choose your preferred matching method before uploading images to streamline the process.
- **Cumulative Progress Bar**: View the bulk upload progress at the top of the page for better feedback.
- **Upload History**: Keep track of your upload history, including links to updated products and images.
- **Queue Management**: Only three images are uploaded at a time to avoid overloading your server.
- **Error Handling**: Receive clear error messages if uploads fail or matching issues occur.
- **Enhanced Security**: Ensures only authorized users can access and use the plugin.
- **Performance Optimizations**: Efficiently handles large batches of image uploads without impacting site performance.

Perfect for WooCommerce store owners and managers who need a fast way to refresh their product images!

== Installation ==

**Option 1: Install Directly from WordPress Admin Dashboard**

1. Go to your **WordPress Admin Dashboard**.
2. Navigate to **Plugins > Add New**.
3. In the **Search Plugins** box, type "**GURUALPHA Bulk Product Images Changer for WooCommerce**".
4. Locate the plugin in the search results and click **Install Now**.
5. Once installed, click **Activate** to start using the plugin.

**Option 2: Install by Downloading from WordPress.org**

1. Go to the plugin's page on [WordPress.org](https://wordpress.org/plugins/gurualpha-bulk-product-images-changer-for-woocommerce/).
2. Click **Download** to download the plugin’s `.zip` file.
3. Go to your **WordPress Admin Dashboard**.
4. Navigate to **Plugins > Add New**.
5. Click on **Upload Plugin**, choose the downloaded `.zip` file, and click **Install Now**.
6. Click **Activate** to start using the plugin.

== Frequently Asked Questions ==

**Q: How does the plugin identify the correct product for each image?**  
**A:** The plugin uses the image filename to match it with the product based on the selected matching method. Ensure your images are named according to the chosen criterion:
- **SKU**: Use the exact SKU (e.g., `SKU12345.jpg`).
- **Product ID**: Use the numeric Product ID (e.g., `12345.jpg`).
- **Product Title**: Use the exact product title with spaces replacing hyphens or underscores (e.g., `Addison Square Drop 18k Gold Plated Earring.jpg`).

**Q: Can I update gallery images too?**  
**A:** Yes, when uploading images, they can be set as both the main product image and gallery images.

**Q: What file types are supported?**  
**A:** The plugin currently supports JPG, PNG, and GIF file types.

**Q: Does this work with multisite installations?**  
**A:** The plugin is intended for single-site WooCommerce stores at the moment.

**Q: What should I do if images aren't matching correctly by title?**  
**A:** Ensure that your image filenames exactly match the product titles in WooCommerce. Replace hyphens and underscores with spaces and remove any special characters to facilitate accurate matching.

== Screenshots ==

1. **Drag and Drop Uploader**: Easily drag and drop images to upload.
   ![Drag and Drop Uploader for Bulk Product Images](assets/screenshot-1.png)
2. **Bulk Upload Progress Bar**: View upload progress at the top.
   ![Bulk Upload Progress Bar](assets/screenshot-2.png)
3. **Upload History**: View your upload history, including links to products and images.
   ![Upload History with Links](assets/screenshot-3.png)

== Changelog ==

= 2.2.4 =
* **Enhanced Auto-Matching Algorithms**: Improved accuracy in matching images to products based on the selected matching method.
* **Improved Error Handling**: More detailed error messages to assist in troubleshooting upload issues.
* **Optimized Performance**: Enhanced server-side processing to handle larger batches of image uploads efficiently.
* **Security Enhancements**: Strengthened security measures to ensure only authorized users can access plugin functionalities.
* **User Interface Improvements**: Refined UI elements for a more intuitive and seamless user experience.
* **Bug Fixes**: Resolved issues related to progress bar display and upload queue management.

= 2.2.3 =
* **Compatibility Updates**: Ensured compatibility with the latest WooCommerce and WordPress versions.
* **Minor Bug Fixes**: Addressed minor bugs reported by users for smoother operation.

= 2.2.2 =
* **UI Enhancements**: Improved layout and spacing for a cleaner interface.
* **Performance Optimizations**: Reduced server load during bulk uploads.

= 2.2.1 =
* **Added Logging Features**: Implemented detailed logging for upload processes to aid in troubleshooting.
* **Enhanced Security**: Updated nonce verification for improved security during AJAX requests.

= 2.2.0 =
* **Introduced Global Matching Method Selection**: Users can now select a matching method (SKU, Product ID, or Product Title) before uploading images, eliminating the need for manual per-image selection.
* **Auto-Matching Based on Selected Criteria**: Automated the process of associating images with products based on the chosen matching method.
* **Queue Management**: Enhanced the upload queue to handle up to three images simultaneously without overloading the server.

= 1.9.5 =
* Added global matching method selection to automate image-product associations.
* Enhanced error messages for better troubleshooting.
* Improved compatibility with WooCommerce latest versions.

= 1.9.2 =
* Moved the upload progress bar to the top for better visibility.
* Improved spacing for a clean and visually appealing layout.

= 1.9.1 =
* Fixed issue where the progress bar would get stuck during upload.
* Optimized cumulative upload progress calculations for accuracy.

= 1.8.0 =
* Added cumulative upload progress bar for drag-and-drop section.
* Added hover effect on drag-and-drop area for improved user experience.

= 1.7.0 =
* Introduced auto-matching based on SKU, Product ID, or Product Title.
* Streamlined the upload process with a global matching method dropdown.

== Upgrade Notice ==

= 2.2.4 =
Upgrade to version 2.2.4 to benefit from enhanced auto-matching algorithms, improved error handling, optimized performance for large uploads, and strengthened security measures. This update ensures more accurate product-image associations and a smoother bulk upload experience.

= 2.2.0 =
Upgrade to version 2.2.0 to take advantage of the new global matching method selection, automated image-product matching based on your chosen criteria, and improved queue management to handle multiple uploads efficiently.

= 1.9.5 =
Upgrade to version 1.9.5 for automated image-product associations, enhanced error messaging, and better compatibility with the latest WooCommerce versions.

== License ==

This plugin is distributed under the GNU General Public License v2.0. See [GPLv2](https://www.gnu.org/licenses/gpl-2.0.html) for details.
