integration_documentation:shopware
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:shopware [2020/06/16 14:50] amil |
integration_documentation:shopware [2020/10/06 06:52] daniel |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ===== Integration with Shopware Plugin ===== | + | ===== Integration with Shopware 5 Plugin ===== |
| - | + | ||
| - | ---- | + | |
| - | + | ||
| - | <note>[[https://store.shopware.com/fin1848466805161f/findologic-suche-navigation.html|You can download our plugin for Shopware in the Shopware store]]</note> | + | |
| - | + | ||
| - | ---- | + | |
| - | + | ||
| - | ==== General ==== | + | |
| - | + | ||
| - | The Findologic Shopware plugin needs to be implemented in the shop to export products and the relevant data for successful implementation of Findologic search. Besides product export, the plugin also injects the main Findologic snippet and automatically handles the implementation of the API or the Direct Integration. | + | |
| - | + | ||
| - | The plugin is going through all the shop's data, finding valid products to export. In order to be exported, following conditions must be met: | + | |
| - | + | ||
| - | * product must be set to active | + | |
| - | * active category must be set | + | |
| - | * product is visible in standard search and on product detail site | + | |
| - | + | ||
| - | ---- | + | |
| + | ==== Download from Shopware store ==== | ||
| + | * [[https://store.shopware.com/en/fin1848466805161f/findologic-search-navigation-platform.html|Findologic - Search & Navigation Platform]] | ||
| ==== Installation ==== | ==== Installation ==== | ||
| - | The Findologic plugin installation procedure is basically the same as for any other Shopware 5 plugin. It can be summed up in a few simple steps: | + | Install the plugin via the Shopware store or the plugin manager in the Shopware backend. |
| - | + | ||
| - | <note important>Before you install a new Findologic plugin, please remove any other old Findologic plugin.</note> | + | |
| - | + | ||
| - | * The Findologic plugin needs to be downloaded and installed via the Shopware store (see link above) or the Plugin Manager in the Shopware backend. | + | |
| - | + | ||
| - | {{:integration_documentation:direct_integration:shopware_di_1.png|}} | + | |
| - | + | ||
| - | * In the left side menu, click on “Installed”. | + | |
| - | + | ||
| - | {{:integration_documentation:direct_integration:shopware_di_2.png|}} | + | |
| - | + | ||
| - | * The plugin should be listed in the uninstalled plugins. | + | |
| - | * Click on the green circle to install it. | + | |
| - | + | ||
| - | {{:integration_documentation:direct_integration:shopware_di_3.png|}} | + | |
| - | + | ||
| - | * Then you will be prompted to clear the cache. Click “Yes”. | + | |
| - | + | ||
| - | {{:integration_documentation:direct_integration:shopware_di_4.png|}} | + | |
| - | + | ||
| - | * Then click on the “Activate” button. | + | |
| - | {{:integration_documentation:direct_integration:shopware_di_5.png|}} | ||
| - | * In the “Configuration” tab you have to: | + | * **Shopkey:** Enter the shopkey provided by Findologic - **required** |
| - | * Enter the shopkey provided by Findologic. | + | * **Active:** Activate to enable Findologic search for your shop - **required** |
| - | * Enter the CSS classes, which specify the containers where the content of Findologic is loaded into. Find more information about this topic [[https://docs.findologic.com/doku.php?id=integration_documentation:direct_integration|here]]. | + | * **Active on category pages:** Activate Findologic on navigation pages - for API integration. |
| + | * **Test mode:** This button is shown when the Findologic integration is still in staging mode. Clicking the button will redirect you to the shop frontend, where Findologic can be tested. Please be aware that a successful product export must happen before the test mode can be used. | ||
| + | * **CSS class for search/navigation:** In case different Html container should be used for Direct Integration, see [[https://docs.findologic.com/doku.php?id=integration_documentation:direct_integration|documentation]]. | ||
| + | * **Integration (read only):** This field is set automatically and shows the used integration, either Direct Integration or API. | ||
| - | {{:integration_documentation:plugins:shpwarepluginconfig.png|}} | ||
| - | * After you fill in this form, click “Save”. | + | ==== Configure search word length ==== |
| - | <note important>Shopkey must be entered in valid format or error will be shown</note> | ||
| * In order for the //category// and the //vendor// block of the Findologic Smart Suggest to work properly it is necessary to set the minimal allowed length of the search word to 0. | * In order for the //category// and the //vendor// block of the Findologic Smart Suggest to work properly it is necessary to set the minimal allowed length of the search word to 0. | ||
| Line 61: | Line 24: | ||
| - | * Finally, the cache of the shop must be cleared. | + | * Clear Shopware cache. |
| ---- | ---- | ||
| Line 74: | Line 37: | ||
| * start → <NUMBER> that should not be lower than zero | * start → <NUMBER> that should not be lower than zero | ||
| * count → <NUMBER> that should not be lower than zero | * count → <NUMBER> that should not be lower than zero | ||
| + | |||
| + | This export url has to be set in the Findologic Account [[https://account.findologic.com/#/app/search-navigation/import-export|Settings]], see [[customer_account:import-export|documentation]]. | ||
| + | |||
| + | If you have troubles with the export please contact us at [[support@findologic.com|support@findologic.com]]. | ||
| The generated XML is validated against our predefined [[https://raw.githubusercontent.com/FINDOLOGIC/xml-export/master/src/main/resources/findologic.xsd|XSD scheme]] and built with our export library [[https://github.com/findologic/libflexport|libflexport]]. | The generated XML is validated against our predefined [[https://raw.githubusercontent.com/FINDOLOGIC/xml-export/master/src/main/resources/findologic.xsd|XSD scheme]] and built with our export library [[https://github.com/findologic/libflexport|libflexport]]. | ||
| Line 116: | Line 83: | ||
| ---- | ---- | ||
| + | |||
| + | The plugin is going through all the shop's data, finding valid products to export. In order to be exported, following conditions must be met: | ||
| + | |||
| + | * product must be set to active | ||
| + | * active category must be set | ||
| + | * product is visible in standard search and on product detail site | ||
| + | |||
| ==== Troubleshooting ==== | ==== Troubleshooting ==== | ||