Installation - Shopware 6

First-Time Installation - Shopware 6

First, make sure you have:

• A Shopware account (Mandatory).
• A DooFinder account.
• Get the DooFinder plugin from Shopware's official Extensions (Erweiterungen).

First-time installation: If this is your first time installing the Shopware 6 Plugin, simply follow the step-by-step guide provided above for a smooth installation.

1. To begin the installation process, first log into your Shopware 6 account.

2. You’ll need to install the DooFinder’s official plugin. On the side menu, click on Extensions (Erweiterungen) > Store.

3. Look for “DooFinder” on the top search bar to find the extension on the Shopware 6 official Marketplace.

4. Click on the Add Extension button to open it and begin the installation.

5. Once the panel indicates that you can now open the extension, please go to the left menu in your Shopware account > Extensions > My Extensions.

6. Find “Doofinder” by Doofinder and click on the three dots and click “Open Extension”.

7. Now, follow the instructions shown on the screen. On the pop-up window, please complete the instructions.
• Choose an eCommerce industry that matches your store.
• Link your DooFinder account: If you already have a Doofinder account, press the "log in" button and enter your credentials. Otherwise, press the "sign up" button to create your Doofinder account.

Warning:It is essential to log in with the owner of the Doofinder account; otherwise, the stores may not be recognized.


8. Once logged in on your DooFinder account, go to the module in your Shopware account > Extensions > My Extensions.
9. You’ll find the new Doofinder extension available on the “My Extensions” list. Click on the “Install” button. Please, be patient and wait for the page to load. This activation might take a few moments for Shopware. Make sure the page is fully loaded. Then, continue.


Once installed, enable the toggle and make sure to wait for the page to load. This activation might take a few moments for Shopware. Make sure the page is fully loaded. Then, continue.



10. Wait for the app to install and, once installed, open DooFinder’s plugin from the left-side menu or simply click on the three dots to “Open Extension”.


Now, “DooFinder” is available and visible on the Extensions menu.

11. Click on Extensions > “DooFinder” to open the plugin settings configuration.
12. Go to the module in your Shopware account > Extensions > Doofinder Search and Discovery, you’ll be able to see:
• DooFinder Administration Panel: direct access to your DooFinder Admin Panel.
• Sales Channel: find more information about Shopware’s sales channels here.

13. Now, click on “Create Store” to create a new store that will later be visible on your DooFinder Admin Panel and will allow DooFinder to start a new indexation process. Now, if you already have your sales channels in Shopware, your Stores will be created automatically in your Doofinder Admin Panel. The plugin will automatically create the same number of stores as the one configured on your sales channels on Shopware.
14. Once created, wait for the Product Catalog Indexation process to load.

15. Click on the button “Access Admin Panel” to go back to your DooFinder Admin Panel; find the new store created. On the top blue bar, search for Stores, and click on the name of your store. In this example, we’ll click on “DooFinder Test Extension”.
16. Once inside the new store, Go to Settings > Indices > Check the indexation process.

17. Once loaded, you’ll find that the Shopware Site Key indexation is successfully created. This will ensure that the plugin is successfully installed.

First-Time Installation - Post Installation - Shopware 6

This installation's last step is configuring the plugin in your Shopware backend. To do this, simply go to Extensions > DooFinder on the left-side menu. Or under Extensions > My Extensions > find the DooFinder plugin and click on the three dots to “Open Extension”. From here, you can also Uninstall it if needed.

On this screen you’ll find:

• DooFinder Administration Panel: direct access to your DooFinder Admin Panel.

• Sales Channel: find more information about Shopware's sales channels here.

• DooFinder Settings:

  • DooFinder Script: Activating this option you are inserting the script into your store code. You can manage product visibility from Admin Panel.

  • Update On Save: Enable or disable real-time product synchronization for your store.

  • Custom Fields: Choose to include or exclude custom fields in product indexing.

• Rasterize Image: Select the size of the image to display on the layer or recommendations carousel. Once the size has been chosen, you must reindex the products in Doofinder. Keep in mind that once the size has been changed, you must reindex the products in Doofinder to see the changes.

Plugin Transition - Shopware 6

First, make sure you have:

• A Shopware account (mandatory).
• A Doofinder account.

Transitioning from an existing Plugin:

If you already have a Shopware 6 plugin installed, it’s likely from a third-party provider and will no longer receive support or updates. Since we’ve released an official DooFinder plugin, it’s necessary to transition to this latest version.

To ensure a smooth transition, please keep the third-party plugin installed while installing the Doofinder plugin. The third-party plugin should only be uninstalled as the final step.

With this official plugin, you’ll gain access to direct support from Doofinder and benefit from new features.

1. To begin the installation process, first log into your Shopware 6 account.

2. Go to Extensions > My Extensions. You’ll see the DooFinder by Intedia plugin installed as shown in the image:


You’ll now need to install the DooFinder’s official plugin. On the side menu, click on Extensions (Erweiterungen) > Store.


3. Look for “DooFinder” on the top search bar to find the extension on the Shopware 6 official Marketplace.

4. Click on the “Add Extension” to open it and begin the installation.

5. Once the panel indicates that you can now open the extension, please go to the left menu in your Shopware account > Extensions > My Extensions.

6. Find “Doofinder” by Doofinder and click on the three dots and click “Open Extension”.


Warning:It is essential to log in with the owner of the Doofinder account; otherwise, the stores may not be recognized.

7. Now, follow the instructions shown on the screen. On the pop-up window, please complete the instructions.
• Choose an eCommerce industry that matches your store.
• Link your DooFinder account: If you already have a Doofinder account, press the "log in" button and enter your credentials. Otherwise, press the "sign up" button to create your Doofinder account.

8. Once logged in on your DooFinder account, go to the module in your Shopware account > Extensions > My Extensions.
9. You’ll find the new Doofinder extension available on the “My Extensions” list. Click on the “Install” button. Please, be patient and wait for the page to load. This activation might take a few moments for Shopware. Make sure the page is fully loaded. Then, continue.


Once installed, enable the toggle and make sure to wait for the page to load. This activation might take a few moments for Shopware. Make sure the page is fully loaded. Then, continue.



10. Wait for the app to install and, once installed, open DooFinder’s plugin from the left-side menu or simply click on the three dots to “Open Extension”.


Now, “DooFinder” is available and visible on the Extensions menu.



If the following message is shown on this step, please wait a few seconds and reload the page. Then, continue normally. Remember to use the same URL as configured in your site. For more information, click here.


11. Once inside, the module will open and you’ll be able to see:

• Doofinder Administration Panel: direct access to your DooFinder Admin Panel.
• Sales Channel: find more information about Shopware’s sales channels here.
• Select the DooFinder Store: select the DooFinder store where you want the migration to begin. Remember to migrate each store one by one.
12. Go back to your Doofinder Admin Panel. If you check on your DooFinder Admin Panel, you’ll be able to see your current Store with its Index Feed as “Indexing with URL”. Look at the image below:

13. Go back to your Shopware 6 backend to the DooFinder Plugin configuration, and now click on “Migrate Store”.

14. Once clicked and migrated, wait for the Product Catalog Indexation process to load.


15. Once finished, check if the Indexation is correctly done and migrated. To ensure this, go to your DooFinder Admin Panel > Settings > Indices and you’ll now see “Shopware Site Key” as the indexation data form in your Store.

16. To proceed with the migration, you need to uninstall the DooFinder Plugin by Intedia. To do so, go to Extensions > My Extensions > find the DooFinder Plugin by Intedia.
17. Click on the three dots and select “Uninstall”.

Plugin Transition - Post Installation - Shopware 6

This installation's last step is configuring the plugin in your Shopware backend To do this, simply go to Extensions > DooFinder.

You can also access this screen under Extensions > My Extensions > find the DooFinder plugin and click on the three dots to “Open Extension”. From here, you can also Unistall if needed.

On this screen, you’ll find:

• DooFinder Administration Panel: direct access to your DooFinder Admin Panel.

• Sales Channel: find more information about Shopware's sales channels here.

• DooFinder Settings:

  • DooFinder Script: Activating this option you are inserting the script into your store code. You can manage product visibility from Admin Panel.

  • Update On Save: Enable or disable real-time product synchronization for your store.

  • Custom Fields: Choose to include or exclude custom fields in product indexing.

• Rasterize Image: Select the size of the image to display on the layer or recommendations carousel. Once the size has been chosen, you must reindex the products in Doofinder. Keep in mind that once the size has been changed, you must reindex the products in Doofinder to see the changes.

Layer

If you’ve already contracted Search, the fullscreen Live Layer will be enabled by default, on desktop and mobile. If you want to create a new Layer, see this document Create a Layer.

Also, in your DooFinder Admin Panel, under Store Settings you can check if the CSS selector of your Layer is OK and check the Search Engine languages if you have more than one.