You are here:  » Product Mapping

Product Mapping

Like Category Mapping, Product Mapping enables you to create a single master product name to be used in place of any number of alternative names that might be found in different feeds. This feature is only really recommended for small, niche sites where the number of products that require mapping is manageable. In addition to being used to used to map products, this featured also enables you to override (or provide your own) custom description, category, brand and image values for mapped products.

Creating a new Product Mapping

  1. Go to Data Management > Product Mapping
  2. Enter the name of a new single master product name that you wish to use and click Add.
  3. Optionally, enter the name of each alternative product name (or sufficient keywords to identify alternatives) into the text box, one per line. You can also specify an exact match by using an equals sign (=) at the start of a line.
  4. Optionally, enter Custom Description, Category, Brand and Image URL fields for the mapped product; which will override merchant provided values at import time.
  5. Click Save to store the new mapping.
  6. The new mapping will not take complete effect until all affected feeds have been imported.

Product Search

A Product Search form is displayed alongside the Alternatives box when configuring a Product Mapping. Enter keyword(s) and click Search to locate matching products. You can then click the « button alongside the search box to add the current search term as a keyword match, and this will apply the mapping to all results shown in the results list.

Alternatively, if the results are too broad, you can select one or more products from the results and click the « button alongside the results list to add the selected products as an exact match. You can also double-click a single item to add that result as an exact match.

Product Meta Data

The Product Mapping interface can also be used to manage arbitrary custom meta data on a per-product basis that would ordinarily need to be provided manually, i.e. not contained within fields available in your feeds*.

To add a custom meta data field, create, edit or add entries to a new $config_productMeta advanced configuration variable array in config.advanced.php. For example, if creating a niche site for laptops and you wish to create a meta data field "screen" for screen size, you would add:

  $config_productMeta["screen"] = "Screen Size";

A text box for entry of the custom value will then be displayed on the configuration page for a product mapping entry. For display purposes, meta data values can be retrieved through the tapestry_productMeta() function. For example, as required in html/product.php:

  <p><strong>Screen Size:</strong><?php print tapestry_productMeta($product_main["name"],"screen"); ?></p>

Alternatively, if the meta data field may only be available for some products, it can be displayed conditionally, for example:

  <?php $screen tapestry_productMeta($product_main["name"],"screen"); ?>
  <?php if ($screen): ?>
    <p><strong>Screen Size:</strong> <?php print $screen?></p>
  <?php endif; ?>

Note: if using Product Mapping solely for the purposes of managing meta data, the Alternatives box may be left empty.

*where meta data not included in the standard field set is available in your feeds, it would normally be more appropriate to add custom fields as documented here