To begin the installation process, you need to go to your Doofinder Admin panel to create your store. If this is a first-time installation, a pop-will appear to enter the following information, if not, click on your store name and 'Create Store':
1.Type the URL of your Shopware store.
2.Enter the platform you are using. In this case select Shopware from the dropdown menu.
3.Click on the corresponding Shopware version button to download the Doofinder plugin to your Shopware account. For this guide, we will click on "Install Doofinder Extension for Shopware 5".
You will be redirected to Shopware to download the free plugin. Once there, click on the green button and finish the process.
4.Now, go to your Shopware backend, Settings > Plugin Manager to install and activate Doofinder plugin.
Within the option's menu, the plugin can be found in Installed, Uninstalled or Deactivated, depending on whether it is the first time you do this installation.
Once found, click on the 'pencil' icon and activate the plugin.
Two pop-up windows will appear next, and you need to select YES:
- Clear cache - YES
- Compile themes - YES
5.Now, you have to go back to your Doofinder admin panel to proceed with the installation. As the plugin is installed and active in Shopware, Doofinder will recognize it and so you can now click "Continue".
6.Type a name and select the language, currency and sector for your store. Then, continue.
Product Feed Generation
7.First select the .XML file format and without saving go back to your Shopware backoffice to generate this file.
8.Within your Shopware backoffice, go to Marketing > Produktexport > Doofinder Feed and click on the 'thunderbolt'.
9.A new browser window will open with the feed URL. Please copy the URL and paste it into your doofinder admin where it says 'Enter the URL of your feed...'.
Note: When a feed isn’t generated completely, it is caused either by reaching the PHP memory_limit or the max_execution_time. Please check the memory_limit on your server, a limit of 1G or 2G is recommended.
10.Remember to write your CSS selector to activate the layer. You can find more information on how to choose your CSS selector here.
Click on create, and the following message will be displayed:
Please close the window and go back to your Shopware backend.
Doofinder Plugin Configuration
The last step in this installation is to configure the plugin in your Shopware backend. To do this, simply go to Einstellungen > Plug-in Manager > Installiert > DooFinder - Boosting Site Search, click on the pencil icon and go to the 'Konfiguration' tab.
Here, be sure to add:
- HashId: Search Engine’s Hash ID can be found in the Doofinder Admin Panel. Click on Search Engines, view all, and Hash ID will be visible next to the name of your Search Engine.
- API Key: Your API key can be found in the Doofinder Admin Panel. Click on your profile Icon (in the header) and then on API Tokens.
- Integration type: DooFinder Live Layer – I'm DooFinder Admin konfiguriert.
- Store ID: It is the identifier code of your store, also referred as 'Installation ID'. You can find it in your store settings.
You are now ready to go!