xml_export_documentation:xml_2_format
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
xml_export_documentation:xml_2_format [2023/04/20 10:52] tobi |
xml_export_documentation:xml_2_format [2023/07/13 09:16] (current) rihad [Using variants in search results] |
||
---|---|---|---|
Line 43: | Line 43: | ||
^**''<[[#descriptions]]>''**| Detailed article description | Yes | No | Yes | | ^**''<[[#descriptions]]>''**| Detailed article description | Yes | No | Yes | | ||
^**''<[[#prices]]>''**| Current article price including taxes | Yes | Yes | **filterable only** | | ^**''<[[#prices]]>''**| Current article price including taxes | Yes | Yes | **filterable only** | | ||
- | ^**''<[[#overriddenPrices]]>''**| Current article price including taxes | No | No | No | | + | ^**''<[[#overriddenPrices]]>''**| Strike-through price including taxes | No | No | No | |
^**''<[[#urls]]>''**| URL to the article page, must be absolute | Yes | Yes | No | | ^**''<[[#urls]]>''**| URL to the article page, must be absolute | Yes | Yes | No | | ||
^**''<[[#images]]>''**| URL to the article image, must be absolute. | Yes | No | No | | ^**''<[[#images]]>''**| URL to the article image, must be absolute. | Yes | No | No | | ||
Line 55: | Line 55: | ||
^**''<[[#attributes]]>''**| Article categories and attributes. Will be filters | Yes | Yes| Yes, **also filterable** | | ^**''<[[#attributes]]>''**| Article categories and attributes. Will be filters | Yes | Yes| Yes, **also filterable** | | ||
^**''<[[#properties]]>''**| Additional information of article to be shown on search result listing | Yes | Yes | No | | ^**''<[[#properties]]>''**| Additional information of article to be shown on search result listing | Yes | Yes | No | | ||
+ | ^**''<[[#using_variants_in_search_results|variants]]>''**| Product variants | Yes | Yes | No | | ||
^ | [[#attributes_and_properties_in_xml-feed|Attributes and properties in XML-feed]] | | ^ | [[#attributes_and_properties_in_xml-feed|Attributes and properties in XML-feed]] | | ||
- | ^ | [[#using_properties_for_product_variants_in_search_results|Using properties for product variants in search results]] | | ||
- | |||
---- | ---- | ||
Line 246: | Line 245: | ||
<note tip>**Using our export toolkit?** | <note tip>**Using our export toolkit?** | ||
- | Creating an url element with [[https://github.com/findologic/libflexport/wiki#url|libflexport]].</note> | + | Creating an overriddenPrice element with [[https://github.com/findologic/libflexport/wiki#overriddenPrice|libflexport]].</note> |
---- | ---- | ||
Line 352: | Line 351: | ||
| | ||
- | === Using <usergroups> to set the visibility of single information relevant for a returned item === | + | === Using usergroups to set the visibility of single information relevant for a returned item === |
- | * By using the ''<usergroups>''-tag you can set specific images, keywords, price etc. | + | * By using the ''usergroups'' attribute you can set specific images, keywords, price etc. |
- | * By using the ''<usergroup>'' attribute within XML tags, you can set specific item information for given ''<usergroups>''. | + | * By using the ''usergroup'' attribute within XML tags, you can set specific item information for given ''usergroups''. |
- | * If no ''<usergroup>'' is requested the default (non-usergroup) value is used for all tags. Therefore default (non-usergroup) tags are required for all elements in the data feed. | + | * If no ''usergroup'' is requested the default (non-usergroup) value is used for all tags. Therefore default (non-usergroup) tags are required for all elements in the data feed. |
- | * If a ''<usergroup>'' is requested the usergroup-specific value is used for all tags. | + | * If a ''usergroup'' is requested the usergroup-specific value is used for all tags. |
* **Example:** If the usergrouphash=" employee " is used -> ''<name usergroup="employee "><![CDATA[Internal product title]]></name>'' the name set for this usergroup is used. | * **Example:** If the usergrouphash=" employee " is used -> ''<name usergroup="employee "><![CDATA[Internal product title]]></name>'' the name set for this usergroup is used. | ||
* If an item has no usergroup-specific value for a tag then the default (non-usergroup) value is used. | * If an item has no usergroup-specific value for a tag then the default (non-usergroup) value is used. | ||
Line 368: | Line 367: | ||
=== Recommendation === | === Recommendation === | ||
- | * In case of more than 128 ''<usergroups>'', please contact [[mailto:support@findologic.com|support@findologic.com]], in order to adjust default settings. | + | * In case of more than 128 ''<groups>'', please contact [[mailto:support@findologic.com|support@findologic.com]], in order to adjust default settings. |
* To avoid potential misunderstandings, preferably use alphanumeric values for usergroups (e.g. ''18plus'', ''B2B''). | * To avoid potential misunderstandings, preferably use alphanumeric values for usergroups (e.g. ''18plus'', ''B2B''). | ||
Line 374: | Line 373: | ||
<note tip>**Using our export toolkit?** | <note tip>**Using our export toolkit?** | ||
- | Creating an ''<usergroup>'' element with [[https://github.com/findologic/libflexport/wiki#usergroup|libflexport]].</note> | + | Creating an ''<group>'' element with [[https://github.com/findologic/libflexport/wiki#group|libflexport]].</note> |
==== bonuses ==== | ==== bonuses ==== | ||
Line 487: | Line 486: | ||
<note tip>**Using our export toolkit?** | <note tip>**Using our export toolkit?** | ||
- | Creating a sort element with [[https://github.com/findologic/libflexport/wiki#sort|libflexport]].</note> | + | Creating a visibility element with [[https://github.com/findologic/libflexport/wiki#visibility|libflexport]].</note> |
---- | ---- | ||
Line 655: | Line 654: | ||
{{:integration_documentation:xml_schema:attr_prop.png?1140|}} | {{:integration_documentation:xml_schema:attr_prop.png?1140|}} | ||
- | |||
- | |||
- | ---- | ||
- | |||
- | ==== Using properties for product variants in search results ==== | ||
- | |||
- | If you want to show different variations (colors, sizes etc.) of a certain product in your shop and you want to display those variants in specific product-cards on the search result page, it can be realized by following the steps described below (example for colors): | ||
- | |||
- | **Functionality:** | ||
- | - All color-variants displayed for parent (master)-product. | ||
- | - While hovering over the variant picture - appropriate image should be displayed. | ||
- | - By click on a color-variant or on an image the page of the product with the right color should be opened. | ||
- | |||
- | **1.**{{:integration_documentation:xml_schema:1.1.png?200|}} | ||
- | **2.**{{:integration_documentation:xml_schema:3.1.1.png?200|}} | ||
- | **3.**{{:integration_documentation:xml_schema:4.1.1.png?515|}} | ||
- | |||
- | **How the XML should look like:** | ||
- | |||
- | You have to provide an appropriate property (for example "variants") for every parent-product by using a JSON-string. Here is an example of this property: | ||
- | |||
- | <code xml> | ||
- | [...] | ||
- | <allProperties> | ||
- | <properties> | ||
- | <property> | ||
- | <key>variants</key> | ||
- | <value><![CDATA[ | ||
- | { | ||
- | "Mud" : { | ||
- | "VariantIconPic" : "https://www.shop.com/media/jacket_mud_variant_icon.jpg", | ||
- | "productPic" : "https://www.shop.com/media/jacket_mud_variant_pic.jpg", | ||
- | "productUrl" : "https://www.shop.com/jacket_mud" | ||
- | }, | ||
- | "Black" : { | ||
- | "VariantIconPic" : "https://www.shop.com/media/jacket_black_variant_icon.jpg", | ||
- | "productPic" : "https://www.shop.com/media/jacket_black_variant_pic.jpg", | ||
- | "productUrl" : "https://www.shop.com/jacket_black" | ||
- | }, | ||
- | "Red" : { | ||
- | "VariantIconPic" : "https://www.shop.com/media/jacket_red_variant_icon.jpg", | ||
- | "productPic" : "https://www.shop.com/media/jacket_red_variant_pic.jpg", | ||
- | "productUrl" : "https://www.shop.com/jacket_red" | ||
- | }, | ||
- | "Navy" : { | ||
- | "VariantIconPic" : "https://www.shop.com/media/jacket_navy_variant_icon.jpg", | ||
- | "productPic" : "https://www.shop.com/media/jacket_navy_variant_pic.jpg", | ||
- | "productUrl" : "https://www.shop.com/jacket_navy" | ||
- | } | ||
- | } | ||
- | ]]></value> | ||
- | </property> | ||
- | </properties> | ||
- | </allProperties> | ||
- | [...] | ||
- | </code> | ||
- | |||
---- | ---- | ||
Line 735: | Line 677: | ||
* attributes, required | * attributes, required | ||
* name, optional | * name, optional | ||
- | * price, optional. In case it is not set, the parent price will be used as default. | + | * price, optional. (In case it is not set, the parent price will be used as default.) |
* groups, optional. | * groups, optional. | ||
* overriddenPrice, optional | * overriddenPrice, optional | ||
* properties, optional | * properties, optional | ||
+ | * urls, optional | ||
+ | * images, optional | ||
+ | |||
<note important>No other fields are allowed.</note> | <note important>No other fields are allowed.</note> | ||
Line 744: | Line 689: | ||
<note tip>Currently it is not possible to use variants and usergroups together. | <note tip>Currently it is not possible to use variants and usergroups together. | ||
Variants only work without usergroups. But using groups is still possible. So filtering by group is working fine.</note> | Variants only work without usergroups. But using groups is still possible. So filtering by group is working fine.</note> | ||
+ | |||
+ | <note tip>**Using our export toolkit?** | ||
+ | |||
+ | Creating a variant element with [[https://github.com/findologic/libflexport/wiki#variants|libflexport]].</note> | ||
+ | |||
==== Example XML ==== | ==== Example XML ==== | ||