Smart Autocomplete SearchMagento 1 User Guide

Installation 2Manual Installation 2Where's my Searchanise control panel 3How to reinstall Searchanise from scratch 3Configuration 4Set the Search Box ID 4Product merchandising 4Troubleshooting 6Incompatible extensions 6Make Searchanise work with an incompatible extension 6Integrations 7Searchanise with Yotpo 7Searchanise with stamped.io 8

� of �1 10

InstallationManual Installation1. Download the Searchanise extension package to you local machine via Freegento (extensionkey: http://connect20.magentocommerce.com/community/Simtech_Searchanise).

2. Extract the content of the archive (the folder app with all subfolders and files).

3. Connect to the server where your Magento store is installed via SSH or FTP. Switch to the storeinstallation root directory (the path might look something similar to /var/http/magento/ on aUNIXbased server or C:\magento on Windows).

4. Copy the entire unpacked app folder into your store installation root folder. No existing files arereplaced during this operation.You will need to have the sufficient permissions to add new files to the store installation rootdirectory. If you are not sure how to deal with file permissions, consult with your systemadministrator.

5. Log in to your store admin panel. By default the admin panel is accessible on the URLhttp://your_store_domain/index.php/admin.

6. Go to System → Cache Management:

� of �2 10

7. Click on Flush Cache Storage:

Right after you have performed all the listed actions the Searchanise extension is installed. You canimmediately access the Searchanise admin panel under Catalog → Searchanise.

Your store will be automatically registered in the Searchanise database and a request for the initialsynchronization will be added to the scheduled task queue. The initial indexation of you catalog may takesome time depending on your store size.

Where's my Searchanise control panelThe Searchanise control panel is embedded in your store's admin panel. To enter it, go to your Store's admin panel → Catalog → Searchanise.

How to reinstall Searchanise from scratchWarning: Active Searchanise Pro subscription will be lost after you follow these instructions. Unsubscribe before going forward. Proceed on your own risk!

I you install Searchanise in a store and clone this store's database to another store, the search results willbe messed up. This is why we strongly recommend clean installations for new stores.

Searchanise identifies shops by unique API keys stored in the shops' database. When you clone a shop'sdatabase, you effectively create two Searchanise installations with the same API key, and the search results become mixed.

The proper way to resolve this issue is to uninstall Searchanise, delete database tables that store the APIkeys, and install Searchanise anew.

� of �3 10

1. Uninstall Searchanise via Magento Connect Manager.2. Delete the searchanise_config and searchanise_queue database tables.3. Execute this SQL query:

DELETE FROM core_resource WHERE core_resource.`code` = ‘searchanise_setup’

4. Install Searchanise from Magento Connect Manager.5. In the other Searchanise installation, click Force reindexation.

ConfigurationSet the Search Box IDYou can specify the ID pointing to the search field in the storefront. This is necessary if the value used inyour storefront differs from the default one, which is search.

First, you should know the ID used in your storefront:

1. Go the storefront of your Magento store.2. Click on the search field with the right mouse button, then click on ‘Inspect Element‘ in the context menu.You should see a developer console with a highlighted line, which should look similar to:

< input id =" mysearch " type =" text " name =" q " value ="" class =" inputtext“/>

The value stated in the ‘id’ attribute the one you need (‘mysearch’ in this example).

Now, give this value to Searchanise:1. Go to your Magento store admin panel.2. Go to System → Configuration.3. In the left pane, find SEARCHANISE → Settings and click on it.4. Enter the obtained id value in the field Search input HTML DOM ID.5. Click on Save Config.

Product merchandisingSearchanise supports five types of product merchandising:

! No — no promotion, the product is shown as it is in the search.! Always — the product is always in the top of the search results no matter what the buyer typed.! On Match — the product will be in the top of list if it’s included in the search results.! Keywords — the product will be in the top for particular keywords typed in the search box.! Last — the product will be in the end of list if it’s included in the search results.

To configure your product promotions go to Merchandising tab in the Searchanise control panel. Hereare your current merchandising rules.

Click the Green plus button to create new rule.Find the necessary products using filters.

� of �4 10

Change the product ranking in the search results by choosing one of the promotion options. By default allthe products have No options that means no promotions.

E.g. We’ll make our product “Hill’s Canine Vetessentials Adult” to be always on the first place in thesearch results widgets.

Don’t forget to click Save changes! Next, you need to wait while we’ll reindex the store with new merchandising rule.

Note: “Keywords” option need to enter keywords. This merchandising rule won’t work without them.

� of �5 10

Go to the storefront after the indexation complete, and try to enter any phrase in the search box. The firstproduct in the search results is “Hill’s Canine Vetessentials Adult”.

TroubleshootingIncompatible extensionsSome Magento extensions don't play well with Searchanise:

! SEO Layered Navigation breaks the instant search widget. Use this workaround*.! SEO Suite Ultimate breaks the instant search widget. Use this workaround*.! Lesti::Fpc breaks the instant search widget. Use this workaround*.! Extendware Full Page Cache log you out from the Magento admin panel when you go to Catalog → Searchanise.

Disable Primary cache in the Full Page Cache settings to work around this one.

Note that Searchanise's fulltext search will NOT work with this workaround.

Make Searchanise work with an incompatible extensionToday, we would like to tell you about a workaround in the Searchanise extension for Magento 1.x thatallows you to use Searchanise with an incompatible extension.

An extension can be incompatible with Searchanise if it extends the same classes and duplicates the

� of �6 10

functionality of Searchanise. So far, the AJAXbased and SEOtargeted extensions turn out to be incompatible.

Here is what you should do:

! Disable the "Use Searchanise for fulltext search" setting (System → Configuration → Searchanise → Settings).! Remove the "[count]" part from the "View all" link label translation (Catalog → Searchanise →Translations).! Rename the file "app/code/community/Simtech/Searchanise/etc/config.xml" to “config_without_search.xml_default".! Rename the file "app/code/community/Simtech/Searchanise/etc/config_without_search.xml" to “config.xml".! Flush cache via the Magento admin panel.

Warning: This way, Searchanise will be used only for instant search suggestions, and your customers will not be confused by misleading numbers. Also, the incompatible extension will continue to work fine.

In the future, we will improve the compatibility of our extension, so it will be unnecessary to do that.

Integrations

Searchanise with YotpoBe sure that you have installed Searchanise and Yotpo apps before you start the integration.

1. Get the API key and API Secret from Yotpo.Go to the Yotpo admin page and copy both keys. If you encounter any problems, follow the Yotpo guide.

2. Add the API key and API Secret to the Searchanise app.Insert the keys from the Yotpo admin page into the appropriate fields of the Preferences section in theSearchanise control panel.3. Enable Yotpo review import.Tick the Import product reviews checkbox in the Preferences section of the Searchanise control panel .4. Apply your changesPlease don’t forget to save the settings by clicking Apply Changes.5. Update search results

� of �7 10

Go to the Dashboard section in the Searchanise control panel and click Force reindexation.

After the indexation is complete, you will see Yotpo reviews in the search widgets.

Searchanise updates Yotpo reviews every 12 hours. If you want to update them immediately, then click Force reindexation.

Searchanise with stamped.ioBe sure that you have installed Searchanise and stamped.io apps before you start the integration.

1. Get the Client ID and Secret Key from stamped.io

Go to the https://go.stamped.io/#/app/settings → Api keys tab, and click Show button. Next, copy the Client ID and the Secret Key.

Note: You should log in to the website to get access the keys. Please do it herehttps://go.stamped.io/#/signin, or use the “Dashboard” button in the Stamped.io app panel.

� of �8 10

2. Add keys to the Searchanise app

Open Preferences tab in the Searchanise control panel, and change Reviews Provider value toStamped.io . Than insert Client ID and the Secret Key into the relevant fields, and check your Shopdomain attached to the Stamped.io reviews service.

3. Apply your changes

Please don’t forget to save the settings by clicking Apply Changes.

� of �9 10

4. Update search results

Go to the Dashboard section in the Searchanise control panel and click Force reindexation.

After the indexation is complete, you will see Stamped.io reviews in the search widgets.

Searchanise updates Stamped.io reviews every 12 hours. If you want to update them immediately, clickForce re-indexation.

� of �10 10