Mapping of data to WooCommerce

Fixed Product Fields in WooCommerce

The first tab when entering a WooCommerce configuration is called "Product Data". Here you find the fixed product fields in WooCommerce that feed® supports for data linking.

1. Select the "Product Data" tab
2. Data fields from WooCommerce are grouped by data types shown highlighted above each group: Selection (data registers), Date time, Text, Float (decimal numbers), Checkbox, and Integer (whole numbers).
3. Click on the link iconto activate and select which data field you want to link
4. Select the desired data type and field from feed® to map to WooCommerce for data synchronization.  
   Note: Here you must choose a field from feed that is compatible with the data type that is in WooCommerce. It is currently possible to select data fields of the wrong data type, but you will then get an error message when the feed® server validates the field.
   
   SKU: Item number is normally Product number in feed, but other fields can also be used. If the field is blank during transfer, you will get error messages on synchronization.
   
   Status is common for activating/deactivating visibility in WooCommerce. The default value when nothing is set is Publish, which makes the product visible to the end user. If you need to be able to deactivate and reactivate products in WooCommerce from feed, use Status. Status is controlled by data register in feed.
   Available options are:

• Publish
• Draft
• Private
• Pending Important: If you have Base/variant products in feed that need to be synchronized, avoid using draft status, use private or pending as alternatives. Draft will not only remove visibility on the variant for the end user, but will also make the variant invisible on the WooCommerce admin page.  

Automated mapping:

If you have the same attribute name and values in feed and WooCommerce this icon will try to find and map the attributes on the current tab automatically. 

It will not remove a current mapping, only apply mapping attributes that has not been completed. 

You should double check if the mapping is correct using this, but it could in some instances save you some time on the mapping.  

Product Images

The second tab is for mapping "product images" for products in feed® to WooCommerce. Here you can choose which images on a product should be exported based on media role and, if desired, format.
All images on a product with the specified media role will be exported to Woo in the order they appear in feed®. The first image among the selected media roles in feed® becomes the main image in WooCommerce, and the rest become product images.
If you don't specify a desired format, the original image in feed® is exported.

Categories

The third tab is for mapping structure folders in feed® to available categories retrieved from WooCommerce.

On the left side is feed®'s folder structure for the associated WooCommerce structure.
On the right side are available categories retrieved from WooCommerce. 

1. Click on the chain to activate a category for mapping and choose the correct category in WooCommerce on the right side. Unmapped categories will sync products to WooCommerce, but they will be placed in the uncategorized folder until a mapping is done. A product can be in multiple folders; the product is only exported once during a sync, but then with a list of categories.
   
   
2. If the WooCommerce category order is not as it is in WooCommerce, activate Category sorting number by going into the categories in WooCommerce and drag and drop (using this icon) one of the categories to another position. Then set it back again. This activates sorting, and you can sync basic data from WooCommerce to feed again to get the correct Woocommerce category order.  This makes mapping much easier.  
   * If you add more folders/categories later on, remember to add them in feed and WooCommerce and then enter the Woo module mapping and press the "Retrieve basic data from WooCommerce" in order to get these new folders/categories available for mapping.  
   
   
3. If the WooCommerce template support category description you can add this from feed by pressing this icon. Type in the text or write or paste in an HTML text for formatting.

Relations

The fourth tab allows you to link relations in feed® to "Upsell" or "Cross-sell" relations in WooCommerce.
Here, you choose the desired WooCommerce relation, "Upsell" or "Cross-sell", by clicking on the "chain" icon and searching for and selecting the corresponding feed® relation to be used.

Products that are defined as related products in feed® with the chosen relation will then also be related with the chosen WooCommerce relation, provided that the related products are also exported to WooCommerce.

Note! Defining a product as a relation does not mean that the related product will be exported to WooCommerce; you must also include these products in the WooCommerce export structure.

In feed® you can create as many relations as you like, but WooCommerce only has 2 relations in the standard setup. 

Relations in feed is manually selected products attached to a relation.
This is not mandatory to set up in the Woo Module.
A WooCommerce developer can for example create sales logic that automatically presents products that is often purchased together with a product or, similar products in the same category.   

Product Attributes

The fifth tab allows you to link data register attributes from feed® to defined product attributes in WooCommerce with their associated terms.

Attributes in WooCommerce can let you link variants of a product by selectioncriteria. Such criteria could be size, color, a technical difference between products like voltage, or any other applicable difference you might need to have.

On the left side is a list of product attributes in WooCommerce. By clicking on the "chain" icon and selecting the desired attribute of type data register in feed®, these are linked and you get the opportunity to link terms for the corresponding attribute in WooCommerce to data register lines in feed®.

(tip: If you want to see which attribute values are in WooCommerce for an attribute, you can link any data register from feed and click on the arrow next to the trash can. This will let you expand the field values from WooCommerce and you don't have to log into WooCommerce to see this. Then you can easily create a data register in feed in another window and connect it to an attribute that is linked in the mapping.)

A value in feed® can only be linked to one term in WooCommerce, but you can link multiple values in feed® to the same term if you have a higher level of detail in feed®.

If you add new attributes in feed and WooCommerce on a later stage you need to click on the icon in the top right corner to import these new attributes in the woo config. 

Automated mapping:

If you have large amount of attributes in WooCommerce, it can be time consuming mapping these attributes with the corresponding feed attributes. 

If you have the same attribute name and values in feed and WooCommerce this icon will try to find and map the attributes on the current tab automatically. 

It will not remove any current mapping, only apply mapping attributes that has not been completed. 

You should double check if the mapping is correct using this, but it could in some instances save you some time on the mapping.  

Base / Variant

In this sixth tab, you set up which product attributes in WooCommerce you want to be selection variables for choosing the desired variant of the product. Remember to first map the desired product attributes as described above.

Base/variant products (WooCommerce term: "variable products") are products with specified variations of the same product. An example of a base/variant product can be a Jacket that have 4 different sizes and 3 different colors (12 variations in total)

The selection criteria on a product must be set up so it leaves the customer with only one product to put in their shopping chart after they have done their selection.

If you don't have any Base/variant products in feed, and don't have any need for this type of products, then ignore this tab. 

It's possible to create different selection variables for base products belonging to different product groups, but it's important to first define which selection variables should be used if the base product doesn't have a product group, or if the product group hasn't defined its own variables.

1. Click the "Create default values" button
2. Click the "chain" icon to indicate that you're selecting standard selection variables
3. Click on the "Product attributes" dropdown list to see a list of available attributes that can be chosen as selection attributes. Choose the desired selection attribute, repeat this step until you have selected all desired selection variables that should be standard for base and variant products
4. If desired, you can override default values for a product group by adding one or more product groups and defining specific selection variables for these in the same way as above. Click on "Product group" and select the desired group you want, then click on "Add product group" to add a different selection criteria to that group. Follow steps 2 - 3 to add variables.

Variant filter

The seventh tab allows you to limit which variants of a base product should be exported to WooCommerce.

By default, all variants are exported to WooCommerce. If this is not desirable, it's possible to limit this here.

You can choose between 2 different methods to restrict which variants are exported. You can either choose to only export variants with selected product statuses OR you can choose an attribute of type "Checkbox" that indicates whether a variant should be exported or not.

If you choose to use an attribute, only variants that have set the chosen attribute to "true" (checked) will be exported.

1. Click on "Create variant filter"
2. Choose "Attribute" or "Product statuses" as the desired filter
3. Select desired statuses or attribute; if you choose statuses, it's possible to select multiple. Important: If a product changes status or attribute after it has been synchronized to WooCommerce, the synchronization will break, but the product will still be visible. Therefore, use this option with caution and only on values that should not change after the product has been synchronized.

Important: If a product changes status or attribute after it has been synchronized to WooCommerce, the synchronization between feed and WooCommerce on this product will stop synchronize, but the product will remain visible in WooCommerce.
Therefore, use this option with caution and only on values that should not change after the product has been synchronized.

Metadata

The eighth tab under connections is for custom metadata fields you want to display on a product in WooCommerce. 
These data needs programmatic placement logic in a WooCommerce template, or a plugin that support to list the data in the WooCommerce template. 

You can map in all kinds of data fields from feed that you need as extra metadata in WooCommerce. If WooCommerce has extra plugins that expect metadata fields, these can be defined here if you know the expected metadata key that the plugin expects, or you can discuss this with your WooCommerce developer.

1. Here you enter the desired metadata key
2. Choose which type of data field in feed® you want to map in. ETIM class/attribute is only available for those who have this module activated.
3. Search or select the desired feed data field to link to the metadata key.
4. If it is a text field with several language options you need to specify what language field in feed the data should be collected from.
5. Repeat 1 - 4 for each metadata field you want to create. 

Note: All products that have data in the associated fields will have these metadata fields created in WooCommerce. If they don't have data in the associated field from feed®, the metadata field will not be created in WooCommerce for the relevant product. 

Important: Even though the information is synchronized to WooCommerce, it will not automatically be visible unless there is a match on the metadata key in the display template being used. Metadata keys are clarified with the WooCommerce responsible / WooCommerce Partner during integration.

Custom Product Attributes

Custom product attributes appear under Additional Information for the product (if the template supports this). WooCommerce has limited support for information on variants, so entries here are only shown from what is in feed on Base and individual products.
The mapping process is the same as for Metadata, but the difference is that the information appears in WooCommerce without programming or extra plugins, as long as the WooCommerce template supports it. You cannot then choose where the data ends up or the design of how it is presented.