This Version is Out of Date
You can find the updated Miva 10 Reference Guide here
In older releases of Miva Merchant, before PR8, a product could have two images: one thumbnail image, and one full-size image. You generally used the thumbnail images in Search and Category pages, and displayed the full-size image when a customer viewed a Product page.
In PR8, Miva Merchant introduced Additional Images. With Additional Images you could have multiple images for any product. When the customer viewed a Product page, they could look at multiple thumbnails, click on any one of them to see an image that fit the product pane, and even click on that image to see the full-size (or Master) image.
When Additional Images were introduced, we started referring to the old "one thumbnail, one full-size" as "Legacy" product images.
In Version 9, Additional Images are just called "Images". The idea is that, Additional Images are so much more useful than the old legacy stuff, we hope people will use Additional Images by default.
The old PR7 "one thumbnail, one full-size" legacy image features are still available in Version 9: > Catalog > Products > Edit Product > Product tab > Add/Edit Product > Product tab > Legacy Images Section.
There are several ways to upload images to your store in Version 9:
Use FTP to upload images to your store server. Technically, you can store images anywhere on
your server, but the Miva Merchant software only knows about the default graphics directory. For
example, if you only have one store, your default graphics directory usually looks like this:
2.1. Go to > Utilities > Image Management.
2.2. In the Image Management tab, click Check for Updated Images. The Miva Merchant software will scan your store's default graphics directory.
You can add a legacy style thumbnail or full-sized image to a product page in your store by editing the product and using the "Thumbnail Image" and "Full-sized Image" fields.
This is an older way of uploading product images. It is still supported and is described in the Add/Edit Product > Product tab > Legacy Images Section. However, a better way to add product images to your store is with the Edit Product > Images tab.
There are several ways to work with Images:
The Image Picker dialog box has several functions, but it's mainly used to attach images to your products. To open the Image Picker dialog box:
|Clear||You can click on an image to select it in the Image Picker dialog box. Selected images will show a white checkmark in a blue circle. If you want to "unselect" images, click the Clear button.|
Use the Delete button to permanently delete images from your server.
For example, if your default graphics directory is: graphics/00000001/
The path to an image in a directory above the default directory might look like this: ..tmp_images/my_shirt.gif
The path to an image in a directory below the default directory might look like this: graphics/00000001/tmp_images/my_shirt.gif
|Show All / Show Selected||If you have one or more images selected, click Show Selected to show only those selected images. Click Show All to show all of the images in the default image directory on your server.|
|Assign an Image to an Image Type||
To assign an Image Type:
This method is appropriate if you want to add multiple images to a few products, one product at a time. However, you might want follow these steps to get a simple introduction to using Images and Image Types.
The Image Picker Dialog Box does several things. In our example, we'll use it to upload images from our local machine to the store server.
You'll return to the Edit Product > Images tab. You can see that the image you selected is now associated with your product. You can associate the same images with multiple products.
In our example, we added two images for our shirt; one for the front and one for the back.
Note that you can change the size of this boundary box. See: > User Interface > Pages tab > Edit page PROD > Product Display Layout Image Dimensions section > Resize to fit within bounding box.
This is the most efficient method to add multiple images to hundreds, or thousands, of products. However, you can only use Images with the Import Feature if you also create Image Types.
Create your Image Types. For this example we created Image Types of "Front" and "Back".
Give your product images names that will make managing them easy. For example, if we were going to upload images for hundreds of t-shirts we might call the images: surfer_shirt_white_front.jpg, surfer_shirt_white_back.jpg, etc.
3.1. Go to > Utilities > Add/Remove Modules tab > Available Modules section.
3.2. In the box "Product Image Custom Fields", click the Install button.
4.1. Select > Data Management > Import Settings tab.
4.2. Click on Add/Update Products from CSV.
4.3. Click on either CSV Template or XLS Template.
4.4. The file "import.csv" or "import.xml" will download to your local machine, and you can open it in a spreadsheet program. This file has all of the columns that you need to add new products to your store, and associate one or more images with each product.
The columns in the spreadsheet will look familiar to you if you've created at least one product in your store. Each row is a product. You can also see that there is a column in the spreadsheet for every Image Type that you've created. You can use the Image Type columns to add images for every product, but there's two things to remember:
The settings in the Edit Import dialog box are explained fully in section Saving Import Options. Please read that section carefully, because the options that you choose in this dialog box have a important effect on how data is added to your store, and the Import feature has no "Undo". In our example we're going to use the spreadsheet to "Add New Products Only". When you have selected the appropriate options, click the Save button.
The system will process your data file as soon as you select it. The system will log various messages, such as the number of records that were processed, created, or skipped, along with success or failure messages, to the Import dialog box. When your data file has been processed, all of your products, and product images, have been added to your store and can be seen by customers.
Note: The supported image upload types are .gif, .jpg, .jpeg, .jpe, .xbm, .png & .pdf