User Guide - Auto Image Upload

Introduction

The Image Upload extension, brought to you by Naxa Digital, has been constructed to supplement Magento’s lack of image uploading functionality. With this extension, you will be able to upload images in bulk without the need of a CSV spreadsheet.

How it Works

The extension utilises a specific naming convention that allows it to identify the product associated with the image, and upload accordingly. The naming convention is:

<sku><underscore><number>.<file-extension>

Here are a few example:

  1. MGP5411_1.jpg

  2. MGP5411_2.jpg

  3. ERF9012_2.jpg

  4. ERF9012_3.png

  5. LMI-12-1_1.jpg

  6. LMI-12-1_2.png

  7. LMI-12-1_3.jpg

The SKU associated with the image, must go first in the naming of the file, followed by an underscore, then followed by a number. The number following the underscore, determines the position of the image, the numbering starts at 1, NOT ZERO (0). Images with _1, will be used as the main, small and thumbnail image for that product. If the product already has a main, small and thumbnail image, those settings will be moved to the newly uploaded image.

Lets take a look at the above examples:

Examples 1 and 2; the extension will evaluate the file names to determine the SKU is MGP5411. It will attach the images to that product, further to that, it will set the first image (_1) as the main, small and thumbnail for that product.

Examples 3 and 4; the extension will evaluate the file names to determine the SKU is ERF9012. It will attach the images to that product, however since there is no _1 image uploaded, the main, small and thumbnail images will remain set as they are.

Examples 5, 6 and 7; the extension will evaluate the file names to determine the SKU is LMI-12-1. It will attach the images to that product, further to that, it will set the first image (_1) as the main, small and thumbnail for that product.

Configuration

To configure the extension, go to Admin Panel → Naxa → Image Upload. This will take you to the settings page:

Archive Directory: This is where you set the path of the images you would like to import. If no path is set in this field, it will look at the default import folder.

Success Directory: Once an image is uploaded, it is then moved to a different location so that it does not re-import on subsequent uploads; specify this directory here, otherwise the extension will attempt to create a folder in web root /pub/media/import/success. If permissions are not correct, the folder may not be created, hence the images will not be moved after import.

Upload: If you want to manually execute the import, simply click this button.