Creating product links is far easier when you have a Products Database to draw your data from. It is also, at this time, the only way to add pictures to your dynamic product windows. To start, take a look at the following example XML files:
View / download XML for example store above.
View / download a blank template XML file.
To download the file after opening it, simply choose "Save as" from the File menu. (If you do not see the File menu, press the left Alt key on the keyboard to reveal it.)
The template XML file contains the following properties:
- product_id: This unique identifying code is a string of letters and numbers used to locate the specific product in your database. It is best to decide on a standard convention for these codes beforehand and remain consistent to it throughout the entire database.
- default_variant_product_id: When a product has several variations, this field should contain the product_id of the first variation to display when the dynamic product window is opened.
- master_product_id: All variations of a product should have this field, which contains the product_id of the "parent" product. The parent product any information that all variations have in common, whereas the variations contain only the information that makes them unique.
- name: The name of the product, as it will be displayed to the customer in the dynamic product window.
- color: The color of the product, as listed in the product window. When multiple color variations for a product exist in the database, this is displayed in the drop-down menu customers use to select one of them.
- size: The size of the product, as listed in the product window. When multiple size variations for a product exist in the database, this is displayed in the drop-down menu customers use to select one of them.
- category_name: The category of product (clothes, purses, food, etc.) as displayed to the customer in the dynamic product window.
- description: The item description shown in the dynamic product window.
- short_description: This description, when set, is shown instead of the description. Then, in the dynamic product window, the customer can click "Read more" to see the full description.
- price: The price of the item, which will be shown in the dynamic product window and sent to checkout when the item is added to the shopping cart.
- discount price: When set, the product's normal price in the product window is displayed with red font and a strikethrough. The discounted price is displayed in normal black text next to it.
- discount rate: The rate of product discount.
- normal_image_url: The full path to the image that will be displayed in the dynamic product window.
- zoom_image_url: The full path to the image that will be displayed when "zoomed in" on the picture in the dynamic product window, assuming this is a supported feature of the framework you are using.
- thumb_image_url: The full path to the thumbnail image that will be displayed when browsing through pictures in the dynamic product window, assuming this is a supported feature of the framework you are using.
- brand: The brand name to be displayed in the dynamic product window.
- manufacturer: Manufacturer of the product.
- available_to_sell: Quantity of items you have available for sale.
- age: The age of the item.
- rating: Out of 5 stars, rating to display in the dynamic product window.
How to Upload an XML File
Once you have your XML file prepared, there are two options for uploading it to your Zmags account. First off, you can upload it using the Publicator site itself (see below). Alternately, you can upload it using FTP. (See this article here.) Of the two, uploading via Publicator is likely the easier option:
1) Log into the Zmags Publicator and click "Products" on the left side.
2) Click "Upload Products file" at the top of the page.
3) Click "Browse", select your XML file, and click "Open", followed by "Upload".
4) Wait for the XML file to upload and process. Keep an eye on the 'processing' text in the upper-right corner; if there are any errors, continue to the next section below.
Understanding Upload Errors
If you receive any upload errors, check that the following possible causes are all in order:
1) All tags must be properly closed. If you include a <price> tag in a product, it must be followed shortly thereafter by a </price> tag, which lets the Publicator know you have finished defining your price for that product.
2) All tags must have correct values. <price></price>, for example should contain a decimal number such as "10", "5.55", or "8.30" (without the quotes). Inputs such as "ten" or "five fifty-five" are not valid. For examples of valid inputs for each type of data tag, see Product_Four in the template.xml file, which contains an example of each.
3) Most spécíál cháráctérs (such as those containing accent marks) are not supported. If you run into any errors, try substituting in a standard character instead.
4) Incorrect tags will not prevent the file from uploading, as long as they are properly closed (see #1), but they will be ignored by the Publicator and result in a warning message.