integration_documentation:direct_integration
Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
integration_documentation:direct_integration [2019/06/11 14:42] sarah [Overview] |
integration_documentation:direct_integration [2019/12/12 17:32] florian |
||
---|---|---|---|
Line 9: | Line 9: | ||
------ | ------ | ||
- | === Search result container === | + | ==== Implementing the FINDOLOGIC snippet ==== |
+ | |||
+ | You can find the snippet for your channel in the [[https://secure.findologic.com/login.symfony/web/app.php/smartsuggest/edit|FINDOLOGIC customer login]]. Please add this snippet in the ''<head>''-section of your source code. | ||
+ | |||
+ | <note>Please note that the usage of Google Tag Manager will disable the flickerfree-functionality of the snippet as the scripts are getting loaded too late.</note> | ||
+ | |||
+ | ------ | ||
+ | |||
+ | ==== Search result container ==== | ||
To ensure proper functionality, the FINDOLOGIC Direct Integration must have access to the main container of the shop. To do so, it is necessary to add the class ''fl-result'' to the corresponding, pre-existing container. | To ensure proper functionality, the FINDOLOGIC Direct Integration must have access to the main container of the shop. To do so, it is necessary to add the class ''fl-result'' to the corresponding, pre-existing container. | ||
Line 18: | Line 26: | ||
---- | ---- | ||
- | === Navigation container === | + | ==== 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]]. | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== 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}} | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ==== Navigation container ==== | ||
For using FINDOLOGIC on category pages you have to provide the ''cat_url''s in a valid manner. [[xml_export_documentation:xml_format#cat_url_examples|See our documentation about ''cat_urls'']] for more information. | For using FINDOLOGIC on category pages you have to provide the ''cat_url''s in a valid manner. [[xml_export_documentation:xml_format#cat_url_examples|See our documentation about ''cat_urls'']] for more information. | ||
Line 27: | Line 79: | ||
---- | ---- | ||
+ | |||
+ | ==== Inserting content after FINDOLOGIC rendering ==== | ||
+ | |||
+ | In case of frequent updates to a product’s or category’s specific information (e.g. availability, price, promotion banners etc.), it is possible to load this data dynamically via scripts on the shop’s side, after FINDOLOGIC results are fully rendered. | ||
+ | |||
+ | If needed, FINDOLOGIC will send an event (such as „findologicFinish“) after results rendering. In further consequence any code may be executed by setting up a respective event-listener. | ||
+ | |||
+ | Recommended implementation: | ||
+ | |||
+ | <code php> | ||
+ | |||
+ | document.addEventListener("findologicFinished", afterFindo); | ||
+ | function afterFindo() { | ||
+ | // „Shop’s script“ | ||
+ | } | ||
+ | |||
+ | </code> | ||
+ | |||