X-Cart:CloudSearch

From X-Cart 4 Classic
Revision as of 17:28, 30 August 2013 by Dohtur (talk | contribs)
Jump to: navigation, search
X-Cart 4.1or above

The following article describes the features of X-Cart's CloudSearch module as provided by version 1.2.0. It may be used as a user guide for CloudSearch module versions earlier and later than 1.2.0, but please be aware that not all the described features may be available in your specific version. You can find out the version of the CloudSearch module installed at your store in the file VERSION.CLOUD_SEARCH in your X-Cart installation directory.


Overview

CloudSearch is a SaaS solution that integrates with X-Cart to enable dynamic, real-time product search in an X-Cart based store. CloudSearch is very fast: typing a search query produces search results immediately, without loading a new page. Searching with CloudSearch is an incremental process: the search begins as soon as the user types in the second character of the search string and goes on progressively as long as the user continues typing; a list of suggestions and search hits is generated after each key press allowing the user to adjust his or her search strategy in real time.

As its name suggests, CloudSearch runs on our company's cloud infrastructure. On the store's website, there is just a small widget needed to make CloudSearch work for customers.

Since X-Cart version 4.5.3, the CloudSearch widget is included into X-Cart code.

On X-Cart versions 4.1.0-4.5.2, CloudSearch can be enabled by installing the CloudSearch integration module. The module is distributed free of charge to existing X-Cart store owners.

CloudSearch service is provided on subscription basis.

Key benefits of using CloudSearch in X-Cart:

  • Search as you type (Incremental search)
    Search results start to be displayed instantly and are refined as the user continues typing.
  • If it is on your site, it will be found
    Search through categories, manufacturers and static pages + product attributes such as product name, description, SKU, product options, extra fields, category and manufacturer.
  • Amazingly fast and relevant search results
    Based on Apache Solr, the industry leading open source enterprise search platform, CloudSearch recognizes word forms and provides other advanced full-text search capabilities. The CloudSearch widget in your store interacts directly with our cloud without increasing load on your server.
  • Proven to increase your conversion rate

And more:

  • Search hit highlighting: Search results show the exact portions of text where the word or phrase matching the search query occurs, with the words matching the query emphasized by background highlighting.
  • Real-time suggestions: The user can stop short of typing the entire word or phrase at any moment and just choose one of the suggested options.
  • Automatic spelling corrections: Even if a word has been misspelled, the customer can still find the product by using a closely related option from the presented list.
  • Search statistics/analytics: Find out what your store visitors searched for, what searh terms were the most popular and what popular queries returned no results.
  • Multi language support: CloudSearch works with non-English languages, too. We have clients successfully running CloudSearch with French, Greek, Slovenian and other languages.
  • SaaS architecture: High performance and feature updates are available automatically without the need to upgrade your client software.
  • Sleek Ajax GUI widget.
  • CSS-based layout that can be tweaked to fit any design.
  • Compatible with major browsers: Internet Explorer 7 or later, Chrome, Safari (including iOS), Firefox.
  • 30 day free trial period.
  • Subscription-based plans.


How it works

For each store connected to CloudSearch service we maintain an index of searchable data. The data is pulled from the store using the API provided by the CloudSearch connector module installed in the store. On our servers, the data is indexed (specially prepared for more efficient storage and searching), after which it can be yielded as search results in response to requests coming from the search widget. That is to say, a piece of data can be found by CloudSearch only if it is contained in the index. X-Cart's products, pages, categories and manufacturers (collectively, these are referred to as "items") are pulled from your store via the above mentioned API three times a day (every eight hours). This accounts for the 8 hours' delay between the time you update information on your site and the moment that this information becomes searchable via CloudSearch.

When a visitor of your store types text in the search field, the CloudSeach widget almost instantly displays a list of search results below the search field. This includes a list of suggestions (popular search queries beginning with the characters the user has typed) and a list of products whose name or description matches the search query. The search results are sorted by relevance, with the most relevant results appearing at the top of the list.

By hovering the mouse over any item in the product search results list, the user can obtain more information about the item: a small fly-out panel displays the product's thumbnail image, name, price and a portion of the product description. Search hits are highlighted both in the product names and product descriptions so the user can quickly see all occurences of the string he or she has typed.

CS-Screen1.png


The widget can display up to 3 suggestions and up to 10 product names at a time. If the search returns more results than the widget can display, the link See more results for "<search_string>" is provided at the bottom of the widget. This link can be used to access the 'Search results' page with all the search results for the search query. Please note that at present the results displayed by the 'Search results' page are delivered by standard X-Cart search, not CloudSearch; due to the use of a different search algorithm, these results may differ from the ones displayed by the widget.

CloudSearch offers great search accuracy and flexibility: it can find not only words, but partial words, word forms, upper or lowercase, etc.

CS-Screen3PartialWordMatch.png


If a user makes a spelling mistake while typing a search query, CloudSearch will try to offer corrections so the user can still find what he or she is looking for.

CS-SpellingCorrection.png


CloudSearch integration module system requirements

To be able to successfully install and use the CloudSearch integration module, you must have a working copy of X-Cart 4.1.0 or later already installed on your server.

Note: If you do not remember the version of X-Cart on which your store is based, you can look it up in the Environment info section of the Summary page in X-Cart Admin area.

Important: Your site needs to be available from the Internet to be indexed by our server.

Installation and removal

The instructions below provide guidance for installing the CloudSearch integration module. The same instructions are valid for installing CloudSearch module updates by existing CloudSearch users.

To install the CloudSearch integration module/module update:

  1. Obtain a distribution package for the module by downloading it from the File Area section of your X-Cart Account, or use this direct link: http://cloudsearch.x-cart.com/static/cloudsearch-xcart.tgz.
    You will find the following packages:
    cloudsearch-xcart-4.1.x-4.3.x.zip (tgz)
    cloudsearch-xcart-4.4.x-4.6.x.zip (tgz)
    Please choose the package depending on the version of your installed copy of X-Cart.
  2. Copy the distribution package to the X-Cart root directory on your server or hosting account.
    • If you use a Windows-based server or a UNIX-based server without terminal access:
    a) Extract the contents of the archive with the CloudSearch integration module files to a directory on your system using your favorite compression program (WinZIP or any other archiver that supports TAR files).
    b) Use an FTP client to upload all the files extracted from the archive (retaining the directory structure) to the X-Cart root directory on your server or hosting account.
    • If you use a UNIX-based server with terminal access:
    a) Use an FTP client to upload the archive with the CloudSearch integration module distribution package to the X-Cart root directory on your server or hosting account.
    b) Decompress the package by typing a command like the following at the command prompt:
    tar -xzvf cloudsearch-xcart-4.4.x-4.6.x.tgz
    Important: Make sure that you maintain the directory structure while unpacking and uploading the distribution package; otherwise, some critical files can be overwritten!
  3. In a web browser, run the installation script at httр://www.example.com/install-cloudsearch.php, replacing www.example.com with the actual domain name of your X-Cart based store.
  4. Enter the Auth code, accept the License Agreement and click the Next button.
  5. The installation script copies the files and activates the module. Click the Next button to continue.
  6. The installation script generates a new system fingerprint. Click the Next button to complete the installation.
  7. Use the CUSTOMER AREA link to go to the Customer area and try CloudSearch.

To uninstall the CloudSearch integration module:

  1. In a web browser, run the installation script at httр://www.example.com/install-cloudsearch.php, replacing www.example.com with the actual domain name of your X-Cart based store.
  2. Choose the Uninstall the module option, enter the Auth code, accept the License Agreement and click the Next button.
  3. Once the installation script has removed the CloudSearch integration module files and deactivated the module, click the Next button to complete the uninstallation.
  4. On the Uninstallation complete screen, click Next to leave the Wizard.
    Important: After you have uninstalled the CloudSearch integration module, be sure to remove the CloudSearch integration module distribution package from your web directory as well.

Enabling the CloudSearch integration module in X-Cart

After the CloudSearch integration module installation has been completed, the module needs to be enabled in your store.

To enable the CloudSearch integration module:

  1. In the X-Cart Admin area, go to the Modules section (Settings menu -> Modules).
  2. Locate the entry for 'CloudSearch' module.
    Note: In X-Cart versions 4.6 and later, the CloudSearch module would be found on the 'Built-in and installed modules' tab under the 'User experience' tag.
  3. X-Cart versions 4.6 and later: Select the Enable check box to the left of the module name.
    X-Cart versions prior to 4.6: Select the check box to the left of the module name and click the Apply changes button.
    The module will be activated.

The module does not require any additional configuration and will work out of the box.

Important: To enable communication with CloudSearch service, please ensure that your store site is accessible from the Internet. CloudSearch does not work for test stores running on localhost.


To access the CloudSearch module dashboard, use the Configure link next to the module name:

Cloudsearch configure.png