Plugin Configuration Manual
- Go to extension.
- Upload the zip file of the plugin.
- Install and Activate the “Wizzy Search&Filters” plugin.
- After activating the plugin, you can see the “Wizzy search configuration.” in the Extension.
- Go to settings.
- Go to Extensions.
- Go to Wizzy search configuration.
How to configure the “Store Credentials”:
Go to the https://app.wizzy.ai/login and create account.
From API key user will get the details.
This configuration is used to check the credentials of the unique Store ID, Store secret, and API key.
Go to Store Id:
Store ID uniquely identifies the store on Wizzy.
For Testing It will be fixed and You will have to add the Store Id from the Wizzy’s dashboard API keys: 6efxxxxxxxxxxxxxxxxxxxxxxxxxxae
Go to Store secret:
Store Secret is a unique secret code to communicate with Wizzy.
For Testing It will be fixed and You can add the Store secret from the Wizzy's dashboard API keys: 794xxxxxxxxxxxxxxxxxxxxxxxxxxx4fe
Go to API Key:
You can add the API key from Wizzy’s dashboard API key.
After adding all store credentials, save the details.
Check Credentials Button:
By clicking on this button, the admin can check if the entered credentials are right or not.
Video:Watch here
How to configure the “General configuration”:
Enable Sync:
The enable sync can be either active or inactive, if it’s set as ‘Inactive’ the products from the store won’t get synced with Wizzy’s server and the search results page won’t have the latest details of the listed products. So if you’re using Wizzy as a search, ‘Enable sync’ switch must be always ON.
Example:
If there are 500 products in the store and the enable sync is on, all 500 products will be displayed while searching and on the dashboard but if admin adds 200 more products and the enable sync is off then that 200 products will not get displayed while searching & on dashboard as the sync switch is off.
You can sync the products from the wizzy search & filter module.
Enable Analytics:
By default, it is on but you can choose to enable/disable it as per the store’s requirements. It is highly recommended to keep this enabled to monitor the search behavior of the visitors.
- If you keep the switch ON and search the products or any keyword in the frontend, the searched keywords will display on wizzy's analytics.
- If you keep the switch OFF and search any products in the frontend, the searched keywords will not show in wizzy’s analytics.
Enable AutoComplete:
Enable/ Disable autocomplete functionality is for showing store’s search views.
If you keep this switch on, the two fields will show:
- Instant Search Form Submission Behaviour
- Category Click Behaviour (From Autocomplete)
Instant Search Form Submission Behaviour:
- Replace Columns on Same Page (Recommended): If you search from any page, you will get the search results on the same page.
- Redirect Page: If you search products from any page, you will get the search results directly.
Category Click Behaviour (From Autocomplete):
- Hit Search with Category Keyword (Preferred): For Hit search keyword After search the products on search dropdown when we click on the any side category, its products will show by search.
- Open category page: If you select the open category & after searching the product & click on the side category the only category & its product will show.
Video:Watch here
If you keep the Enable Autocomplete switch off, these two fields will show:
- Instant Search Behaviour
- Instant Search Form Submission Behaviour
1. Instant Search Behaviour:
- Search As You Type: When you type any product’s keyword the products will be auto searched and shown in search results.
- On Form Submission: When you search any product and enter, that time the search results will show.
2. Instant Search Form Submission Behaviour:
For Replace Columns on Same Page (Recommended) and Redirect Page it will work as the above mentioned information.
Video:Watch here
How to configure the “Search Result Page Configurations”:
General:
DOM Selector:
If you’re using any standard/default theme of Magento 2 then you don’t necessarily need to change this.
For a Custom theme, you might need to change it to the appropriate value. If you’re not the developer/maintainer of the store, for Shopware the Dom Selector is “.container-main”.
URL Endpoint:
The search URL endpoint is to display search results.
If the main domain has pointed to the public folder then the user has to add the /public/search. So after the main domain, the admin has to add the remaining folder pointing structure.
Products Per Page:
It is used to set the number of products to be displayed on the search result page. It cannot be more than 50 as per wizzy’s documentation.
Display Add to Cart button:
- If you keep this switch ON, the add to cart button will show on products at the search result page.
- If you keep this switch OFF, the add to cart button will not show on the products.
Display Add to Wishlist button:
- If you keep this switch ON, the wishlist option will show on products in the search result page.
- If you keep this switch OFF, the wishlist option will not show on products in the search result page.
Video:Watch here
How to configure “Pagination”:
Pagination Type:
- Infinite Scroll
- Numbered Pagination
Infinite Scroll:
When the user scrolls down the page, they can see more products by scrolling without doing any interaction on the page.
Infinite Scroll Offset (Desktop):
- You keep value 10 from the backend and search the product. First you will see the products (per page value) and after scrolling down, you will see the more products with the loader.
- You keep the value 1000 from the configuration and search the product, you will see the products and after scrolling down you will see the products without interaction.
Infinite Scroll Offset (Mobile): The infinite scroll will work the same as the desktop.
Numbered Pagination:
If you select the numbered pagination, you will see the end of the page numbers are displayed to navigate between different search result pages along with the next/previous button.
In mobile devices, Wizzy only displays the Load More button for Paginated scroll.
Add Move to Top Widget:
After enabling this switch, the down to top arrow button will show on the right bottom corner and by clicking that it will directly move to the top.
Video:Watch here
How to configure the “Facets”:
By using this admin can add filters on the search page sidebar navigation.
Category Rendering Method:
- Linear List
- Hierarchical
Linear List: It will display Facets (Filters) in linear format.
Hierarchical: It will display Facets (Filters) in hierarchical format.
Hierarchical method will work on categories only & when this method is selected in frontend, the only category name will show without the checkbox.
Left Facets Collapsible: On this switch display All Facets with Collapsible accordion.
Left Facets Default Behavior: This sets the default behavior of left facets. It can be either opened or collapsed.
First Left Facet Default Behavior: This sets the default behavior of the first left facet. It can be either opened or collapsed.
Video:
Sorts:
You can add the different sorting dropdown from sort and the sorting will show on the search page.
Video:Watch here
Swatches:
Swatches are nothing but different product variations.
By default, Wizzy adds Colors and Sizes on installation. You can add/remove it according to your store’s requirements.
You can add the swatches by “Add swatches” button and different properties will show in the dropdown.
In Shopware, swatches are considered as properties so it should be added from Catalogs > Properties.
Video:Watch here
How to configure Auto Complete Menu:
Suggestions Count: It is used to set the number of suggestions to display in the autocomplete menu. This count includes a count of categories.
By default, its value is 10 but you can change it up to 20 as per the Wizzy’s Documentation.
Alignment:
The position of the category of autocomplete menu will change left or right whichever you selected.
If you have a search input box on the right side of the page, the menu alignment should be right.
Categories Title:
Use this to change the title of the category type of the suggestions.
It will display on the autocomplete menu (search suggestion).
Others Title:
You can put the relevant naming convention according to your requirement in the other title and it will show in the search suggestion dropdown.
Brands Title:
If you are selling products of multiple brands, these will be displayed in the Autocomplete dropdown under the categories.
Video:Watch here
Top Products:
Suggest Top Products: If you keep this switch ON the two options will show:
- Top Products Title
- Number of products to display
Top Products Title: Here you can make a custom heading for your products that are being displayed in the Autocomplete Dropdown.
Number of products to display: You can input the number of products you want to show in the search dropdown. This number must be less than or equal to 10.
Video:Watch here