integration_documentation:navigation
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
integration_documentation:navigation [2019/11/13 12:59] amil |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ===== FINDOLOGIC Navigation ===== | ||
- | The FINDOLOGIC navigation allows you to use the FINDOLOGIC filters on category pages. \\ | ||
- | You will also have all the benefits of the Direct Integration and you can use our merchandising feature [[customer_account:product_pushing|product pushing]]. | ||
- | |||
- | ---- | ||
- | ==== Integration ==== | ||
- | <note>This section deals with how to integrate FINDOLOGIC Navigation in shop software that is not yet supported from a technical perspective. To integrate FINDOLOGIC in a system that is already supported, please refer to the documentation on embedding FINDOLOGIC in your shop system.</note> | ||
- | |||
- | The call to Navigation is made as usual via the FINDOLOGIC interface in the two variants of HTML and XML: | ||
- | |||
- | * HTML: | ||
- | |||
- | <code> | ||
- | http://<ServiceURL>/selector.php?shopkey=<SHOPKEY> | ||
- | </code> | ||
- | |||
- | * XML: | ||
- | |||
- | <code> | ||
- | http://<ServiceURL>/ps/xml_2.0/selector.php?shopkey=<SHOPKEY> | ||
- | </code> | ||
- | |||
- | For the available request parameters, please refer to the [[https://docs.findologic.com/doku.php?id=integration_documentation:request|documentation of search parameters]]. In addition, filters can be preselected so they cannot be deselected by the customer. In this way, Navigation can start directly in a desired category (via the category navigation in the shop) or for a vendor. For this purpose, replace attrib with selected, otherwise this parameter will function exactly like attrib. | ||
- | |||
- | |||
- | ====Procedure==== | ||
- | |||
- | **Query of filters** | ||
- | In the first step, the available filters are queried and the preselected category is submitted via the selected parameter. | ||
- | |||
- | <note important>At this point, the results are generated not by FINDOLOGIC but by the shop, since FINDOLOGIC does not yet offer any benefit; therefore, query with count=0 | ||
- | </note> | ||
- | |||
- | Example of a call in the "Fashion" category: | ||
- | <code>http://<Service-URL>/selector.php?shopkey=ABCD&selected[cat][]=Mode&count=0 | ||
- | </code> | ||
- | |||
- | The structure of requests to FINDOLOGIC is documented in detail here. Please ensure that you also provide the FINDOLOGIC required parameters with each call. | ||
- | |||
- | <note important>Especially ensure that the IP of the requesting end customer is also supplied so that queries can be recognised by bots. | ||
- | </note> | ||
- | |||
- | **Output of filters** | ||
- | |||
- | The filters are output in the shop at the corresponding location. The output is executed in the module in the shop. | ||
- | |||
- | The customer can now select a FINDOLOGIC filter with which the FINDOLOGIC results can be obtained in the next step. | ||
- | |||
- | **Query of results** | ||
- | |||
- | The customer has selected a filter. This is now transmitted to FINDOLOGIC | ||
- | |||
- | Example of preselected category "Fashion" and attribute "Color=blue": | ||
- | <code>http://<Service-URL>/selector.php?shopkey=ABCD&selected[cat][]=Mode&attrib[Color][]=blue | ||
- | </code> | ||
- | |||
- | ====Excluding search engines==== | ||
- | |||
- | This cannot be executed via robots.txt since otherwise the first call of the crawler would still call the FINDOLOGIC service. It must therefore be determined whether a call is being made by a crawler and in this case whether the delivery of the filters was prevented. | ||
- | ---- | ||
- | ==== Use the navigation in your shop ==== | ||
- | |||
- | If you want to use FINDOLOGIC in your category pages with Direct Integration, the requirements are as described below. | ||
- | |||
- | **Export:** | ||
- | |||
- | * Make sure to export the correct ''cat_urls'' in the attributes, matching the FINDOLOGIC [[xml_export_documentation:xml_format#attributes|XML]] or [[csv_export_documentation:csv_format#attributes|CSV]] export scheme. | ||
- | ** | ||
- | Shop frontend:** | ||
- | |||
- | * The container for the filters with the id "fl-filters". | ||
- | * The container for the navigation results when choosing a filter wit the id "fl-searchresults". | ||
- | * See [[integration_documentation:direct_integration:|our documentation]] about Direct Integration for more information on this topic. | ||
- | |||
- | **FINDOLOGIC:** | ||
- | |||
- | * The navigation needs to be integrated by FINDOLOGIC. | ||
- | |||
- | ---- | ||
- | |||
- | ==== Visualisation ==== | ||
- | |||
- | - The FINDOLOGIC filters will be placed in the filter container, if the ''cat_url'' is correct. | ||
- | - The products will still be provided by the shop. | ||
- | - When selecting a filter, the products will be provided by FINDOLOGIC via JavaScript and will be placed in the products container. | ||
- | |||
- | ----- | ||
- | |||
- | **1.** {{ integration_documentation:nav1_1.png }} | ||
- | **2. & 3.** {{ integration_documentation:nav1_2.png }} | ||
- | |||
- | If you have any questions regarding the navigation, or you are not sure how to integrate the navigation in your shop, please contact our technical support [[support@findologic.com]]. | ||
- | |||
- | {{tag>Navigation Nav Selector}} |