The Image Management screen gives you some control over your product images.
When you upload a product image, you actually end up with three versions of that image:
The original image that you uploaded is the "master image" and the smaller versions that Miva Merchant generates are the resized or child images.
What Miva Merchant is actually doing is checking to see if your master image is:
If your master image is small enough to fit in the bounding box of a thumbnail, the system would not generate any resized versions. It would use the same image for the master image (full-sized), main image (product page, etc.), and thumbnail images. See page 72 for an example of all three image sizes.
Delete Image: Permanently deletes all versions of this image from your store server: master image, main image, and thumbnail.
Delete Resized: Deletes the main image and thumbnail image, but leaves the master image. The resized images will be regenerated the next time that a customer reaches that product page.
You can also delete resized images of a master image in the Details window (double-click on a master image name).
Delete Unreferenced: Delete all master additional images, and their generated resized images, that are not associated with a product. See also Reference Count Column.
Check for Updated Images: Delete all generated resized images where the date of the master image is newer than the date of the resized image. This feature might be useful if you initially upload master images using Miva Merchant, but you later updated the master images using FTP. If you use The Image Picker Dialog Box to upload a master image, resized versions of that image are generated the first time a customer reaches the product page. At a later time, if you used some other method, such as FTP, to update the master image, the master image timestamp would be newer than the timestamps of the generated images. If you click the "Check for Updated Images", Miva Merchant deletes the generated images if the master image is newer. New resized images will be generated the first time a customer reaches the product page with a master image.
Image Column: Click on a master image name to open a details window for that image.
Reference Count Column: "Reference Count" refers to the number of products that are associated with an image.
Example: Use The Image Picker Dialog Box to upload an image of a coffee mug "coffee_mug_generic" and associate it with a coffee mug product. The ref count for the image is now 1. If we associate that same image to another coffee mug product, the ref count for the image is now 2.
The Image Detail dialog box gives you more information about master images and a little more granular control than you get in the Image Management tab.
In the Image Detail dialog box, you can:
By default, Miva Merchant has two template based batch reports:
You can also create your own batch reports for either managing orders or shipments.
You should already have followed the steps to enable the default reports.
Creating a new template based batch report is a two-step process. First you create an empty report, which is easy; then you add the template code that will cause the report to gather and process the information that you want. This may require a significant knowledge of Miva Merchant template code.
Custom fields let you add your own fields to categories, products, customer records, etc. For example, you can add a custom product field, such as MSRP, and display that field on a product page. See page 527 for several examples.
Type: Select the type of custom field that you want to create.
Code: The code uniquely identifies your custom field in the database.
Name: The field name is displayed in the admin interface.
Field Type: Use the field type to select a control or interface for the custom field. Most of these types are familiar and self-explanatory. You can create custom fields with text areas, radio buttons, checkboxes, etc. The one exception is a field type of "Image Upload", which is a bit different from the others. See Example: Adding a Custom Field with Image Upload.
Group: Custom field groups let you organize your custom fields. See Utilities > Custom Field Groups. The Group drop down list will show all of the custom field groups that you have created.
Additional Information: Add "hover text" to custom fields that appear in the admin interface. You might use Additional Information to tell admin users what kind of information they should put in the custom field or how the custom field is used.
Custom Field Groups make it easier to organize and view your custom fields.
In this example we'll create a custom category field that allows us to display or hide categories in the category tree.
3.1. Go to > Catalog > Categories tab > (edit a Category) > Custom Fields tab.
5.1. Go to > User Interface > Settings tab > Category Tree Template tab.
5.2. Add the field. In the Custom Fields section, click on the field named "Display", then click the Select button. (To reduce overhead in the admin interface, only custom fields that have been selected can be referenced in the template code.)
5.3. Edit the template code. In the category tree template code we'll add code to scan the value of the "Display" field for each category. Categories where the Display field contains the string "true" will be shown in the category tree.
5.4. The new code we'll add to the template field is:
Custom Field Value: &mvte:cattree_category:customfield_values:customfields:msrp;
This example shows how to create a custom product field and one example of how such a field can be used.
3.1. Go to > Catalog > Products tab > (edit a product) > Custom Fields tab.
When you edit a product now, you'll see that there is a new tab called "Custom Fields". In this new tab is the custom product field that you created.
4.1. Go to > User Interface > Pages tab > (edit page PROD) > Page tab > Product Display Layout section.
4.2. Click on the custom field ("MSRP" in our example), then click the Select button. (To reduce overhead in the admin interface, only custom fields that have been selected can be referenced in the template code.)
4.3. In the Page tab, click Update.
In our example the custom product field automatically showed up in our on-line store because we had not modified our product page template code. If you have modified your product page template code, you must:
In this example we'll show how to use the Image Upload field type to add content to your store pages that customers can download.
1.1. Go to > Domain Settings > Domain Details tab > Upload Settings section.
1.2. In the Upload Settings section, add "PDF" to the Image Extension Types field:
Create a custom field group called "Manuals".
Create a custom field called "User Manual 01" with a Field Type of "Upload Image".
4.1. There is now a tab called "Manuals", created by our custom field group.
4.2. The Manuals tab contains our custom field: "User Manual 01"
7.1. Click on the custom field.
7.2. Click Select.
7.3. Click Update.
8.1. If you haven't already, click on the link so that you can see the template code.
8.2. Look for the template code:
and change it to:
There are times when you might want to capture information while a customer is shopping in your store and save that information to your store database. For example, you might want to capture the customer's IP address and save it with the order record. In releases before PR8 Update 9, you could capture the information, but to save it to the database you had to use a third party module.
PR8 Update 9 added 16 new read/write template functions that let you attach information that you've captured to different types of records. You can use these functions to save and display a wide variety of data:
In this example, we'll show how to put a drop-down list on the OSEL page (Checkout: Shipping/Payment Selection) and save the customer's selection to the basket record.
Normally, the custom fields that you attach to a basket record are lost when the basket is deleted. However, there is a way to "convert" the information and permanently save it in the database with the customer's order. Baskets are deleted when:
Custom fields are added to a page with the "customfields" item. The customfields item is already enabled on every default page in your store (every page in an "out of the box" store). If you want to use custom fields on a new page that you've created, you have to add the customfields item manually. See Editing Items.
5.1. Go to > User Interface > Pages tab > (edit page OPAY) > Page tab > Header and Footer section.
5.2. Add the code shown in the figure below.
When the customer gets to the Invoice screen (INVC), the basket record is converted to an order record. The basket record, along with any custom basket fields, are deleted. However, if you create custom order fields that have the same names as your custom basket fields, the values in the custom basket fields are written to the custom order fields with the same name, and will be saved with the order record. You can then view the custom fields by editing the record.
Google Analytics is a product from Google that tracks visitor activity in your on-line store. Google Analytics can tell you what pages in your store people have visited, what products customers have purchased, etc. The basic process of working with Google Analytics is:
Follow these steps after you have created your Google Analytics account.
As soon as you install Google Analytics, you'll see two new tabs:
Google Analytics ID: This is your Tracking ID that is created when you set up your Google Analytics account. It has the form: "UA-x x x x x ...- x".
Domain: This field is prepopulated with the domain of your Miva Merchant store. You would almost never need to change the domain field.
See: https://support.google.com/analytics/answer/2790010?hl=en Note that, as of Version 9.0003, Universal mode supports conversion tracking. See: https://support.google.com/adwords/answer/1722054?hl=en
Make sure you have the
IP Anonymization: When you use Google analytics, the code sends customer data from your store to your analytics account. If you enable this option, the last octet of the customer's IP address is set to zeroes before it is sent.
Enhanced Link Attribution: If you selected enhanced link attribution in your Google Analytics account, you must also enable it here. But see also: https://support.google.com/analytics/answer/2558867?hl=en for more information.
Display Advertising Support: If you are using Google display ads, enabling this feature gives you more information about those ads. You view the ad information in your Google Analytics account, but it must be enabled in your Miva Merchant store so that the data will be collected.
But see also: http://www.google.com/ads/displaynetwork/ Policy requirements for Display Advertising https://support.google.com/analytics/answer/2700409?hl=en
Cross Domain Auto Linking: You will only see this field if you set > Utilities > Google Analytics Settings tab > Mode field to either "Universal" or "Universal Enhanced".
Normally, Google analytics cannot track a customer once the customer leaves your store domain. If you want Google analytics to track customers across multiple domains:
Domain Tracking: Google analytics gives you the option of tracking analytic data across domains and subdomains. You have to list your domains and subdomains in your Google analytics account. For example, let's say you have the following domains and subdomains:
Once you configure your Google analytics account, you can use the domain tracking field to select the tracking data you want Miva Merchant to send to Google.
Temporarily Disable Tracking (retains all configuration): If you need to temporarily turn off Google Analytics tracking in your store, click this checkbox, then click the Update button. This disables all Google Analytics tracking in your store, but retains your settings so you can easily turn the feature back on again.
Please see above.
Please see above.
In previous versions of Miva Merchant, this tab was called "Google Analytics Ecommerce Code". This tab only appears if you select "Classic (ga.js)" in the: > Utilities > Google Analytics Settings tab > Mode field.
The shipping estimate feature allows customers to get shipping estimates for their current basket, or for individual products, without having to start the checkout process. You can add this feature to any page in your store, but it's usually added to the Product (PROD) and Basket (BASK) pages.
1.1. Go to > Utilities > Add/Remove Modules tab.
1.2. In the Available Modules section, click on the Install button under Shipping Estimate.
Most store owners add the Shipping Estimate feature to the Basket page (BASK), or the Product page (PROD).
2.1. Go to > User Interface > Pages tab > Edit page BASK or PROD > Page tab > Template field.
2.2. If you are editing the BASK page: We need to add a line of template code that will determine where the Shipping Estimate link will show up in our on-line store page. In our example, we'll modify the template code so that the Shipping Estimate link shows up below the PayPal button
2.2.1. Search for the line in the template field that contains the string "PaypalExButton".
2.2.2. Below the line for the PayPal button, add this code:
2.2.3. Click Update.
2.3. If you are editing the PROD page:
2.3.1. Search for the line:
2.3.2. Replace it with:
2.3.3. Click Update.
3.1. Go to > User Interface > Items tab.
3.2. Search for the item: shipestimate
Note that we are not looking for the item: shipestimate_rates
3.3. Edit the item shipestimate and select the Pages tab.
3.4. Assign shipestimate to page BASK or PROD (or both).
Assuming that you added the Shipping Estimate feature to either page BASK or page PROD: Go to > User Interface > Pages tab > Edit page BASK or PROD > Shipping Estimate tab.
Mode: Set this field to Entire Basket if you are editing the Basket (BASK) page. Set this field to Single Product if you are editing the Product (PROD) page.
Address Fields: Whatever fields you select here will appear in the Shipping Estimate popup in your on-line store.
Results Page: If you set Results Display to "Open in a New Window", use this field to select the page that you want to use to display the shipping estimates.
For example, if you set Results Page to SERT (Shipping Estimate Rates), when the customer clicks on the Calculate Shipping button, a new browser window will open and display the Shipping Estimate Rates page along with the shipping estimates.
Shipping Countries: If you want a list of countries to appear in the Calculate Shipping dialog box:
Notes: Please see Appendix 2: Common Fields in the Admin Interface.
Advanced Mode: Click on the advanced mode to display the template code field that controls the Shipping Estimate popup.