Versions Compared

Old Version 4

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Lana Starchuk (Deactivated)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article you will find:

Table of Contents

 


...

Overview

This document describes the process of installing the Magento Plugin on commercial or Enterprise version of Magento. The plugin will help you get your site up and running with Hawk SearchHawksearch. Hawk Search Hawksearch is a SaaS application that offers advanced search capabilities to e-commerce and publishing websites. Hawk Search Hawksearch has been installed on a number of e-commerce websites that are built on Magento Platform (Community & Enterprise).

The document will describe in detail the process of installing the plugin on your Magento (community or enterprise version) instance and get Hawk Search Hawksearch up and running on your ecommerce site.

...

There are currently two separate Magento Extensions available for Hawk. These two extensions can be installed separately and can work independently.

  1. Hawk Search Hawksearch Data Export: This plugin will allow you to set up the data feeds for Hawk Search Hawksearch export. These feeds will conform to the guidelines provided in the Hawk Search Hawksearch Data Feed Guidelines.
    NOTE: For additional details regarding the files and file formats please reference the Data Feed Guidelines document
  2. Hawk Search Hawksearch Proxy Hybrid Integration (front end): This plugin will allow you to set up the search page on your Magento site using the Proxy Hybrid integration method. This will cover installation of the search ahead feature on the search textbox as well as the search page.
    NOTE: Please reference the Hawk SearchHawksearch- Hybrid Proxy Integration guide (this document) for details regarding the Hybrid Proxy implementation

...

NOTE: The plugin is not currently available in the Magento market place. Please talk to your sales representative on Hawk Search Hawksearch for receiving the code for the plugin.

...

Step 3: Once authorized you will then be taken to the Magento Connect Manager page as shown in screenshot below.  This is where you will need to upload the compressed file (with .tgz extension) provided to you by your Hawk Search Hawksearch Project Manager.

Step 4: If everything has been installed successfully and you do not run into any issues you should see a message clarifying that the package was installed successfully on the Magento Instance.

Package installed:
 community HawkSearch  community Hawksearch_Proxy x.x.x
Cleaning cache..

...

NOTE: If you see any errors installing the plugin please reach out to your Hawk Search Hawksearch Project Manager or email support@hawksearchsupport@hawksearch.com. 

Manual Installation

If you do not wish to use the Magento Connect Manager, you can install the module manually with the following steps:

  • Backup your store database and web directory
  • Disable compilation if enabled.
  • Unzip the data feed plugin on your computer. Your Hawk Search Hawksearch account manager will provide you with the HawkSearchHawksearch_Proxy-[version].tgz file.
  • Use your FTP client to upload the “app” and “hawksearch” directories from the unzipped module to your store root.
  • Logout and Login again from the Magento admin (to clear the ACL).
  • Refresh your magneto cache.
  • Re-enable compilation if desired.

...

Configuration

Configuration of the Hawk Search Hawksearch Proxy module is configuration scope dependent. The tracking URLs and category synchronization job settings are set at the default scope, and the behavior settings are set at the store view level.

...

On landing on the default configuration page you should now see the Hawk Search Hawksearch Configuration options on the Left Navigation area. Depending on plugins installed (Data Export, Hybrid Proxy or both) you will see one or both of the options under the Hawk Search Hawksearch area. Select the HawkProxy Settings tab.

  1. General tab
    1. The version number is reported.
  2. Proxy Module Settings
    1. Hawksearch Tracking URL (Development)
      This parameter controls the test site URL to point to for Hawk Search Hawksearch test environment (http://test.hawksearch.net)
    2. Hawksearch Tracking URL (Production)
      This parameter controls the production site URL to point to for Hawk Search Hawksearch production environment (http://managedashboard-na.hawksearch.com)
  3. Synchronization Settings 
    1. Synchronize
      If you are powering the category pages on your Magento site through Hawk SearchHawksearch, this button will launch a background process that will send basic category data (such as the URL and category ID) to the Hawk Search Hawksearch engine for each managed store view. Categories can be managed individually or globally, see Store View configuration below. Note this does not include product data or product/category associations; use the Hawk Search Hawksearch Data Feed module to synchronize product data.
    2. Enable Cron Sync
      This setting allows you to enable the cron job to synchronize categories on a regular basis.
    3. Cron Expression
      This setting allows you to specify the cron expression to control the schedule for running the synchronization task. Enter a standard 5 part cron expression. See https://en.wikipedia.org/wiki/Cron for more information about cron expressions. Note that the job cannot be scheduled to run more frequently than hourly (Sample for running daily at 2AM: 0 2 * * *).
    4. Cron Email
      This setting allows you to specify an email address that an email should go out to, once Categories have been synchronizes successfully via the cron job.

...

    1. Engine Name
      This is the engine name to connect to on the Hawk Search Hawksearch site. This will be provided by your Hawk Search Hawksearch project/account manager
    2. Hawksearch API Key
      This is the API key that is used by the module to connect to Hawk Search Hawksearch Rest API to generate the landing pages. This will be provided by your Hawk Search Hawksearch project/account manager
    3. Order Tracking Key
      This is the identifier used to uniquely identify your account in the image pixel that is added to the order confirmation page on the site to track orders and generate appropriate reports in Hawk SearchHawksearch. This will be provided by your Hawk Search Hawksearch project/account manager.
    4. Run Mode
      This indicates if the plugin is currently connected to the staging account or the production account.
    5. Manage Categories
      This setting indicates if categories are managed through Hawk SearchHawksearch. Set to “Yes” to allow the Hawk Search Hawksearch Proxy module to manage your category landing pages.
    6. Manage All Categories
      This setting indicates if all categories are managed through Hawk SearchHawksearch. If set to “Yes”, Hawk Search Hawksearch landing pages will be used for all categories. If set to “No”, only categories with the “Hawksearch Landing Page” setting set to “Yes” will be managed (set via the Magento “Manage Categories” section on the “General” tab).
    7. Manage Search
      This setting indicates that the search is being powered through Hawk SearchHawksearch. See “The Search Box Auto Suggest” below.
    8. Search box HTML ID’s
      This setting should match the Id of the text box for search that is currently used on the header of your Magento site. If your pages use more than one search box, enter the HTML ID’s of each box you wish to attach to the Hawk Search Hawksearch Auto Suggest tool.
    9. Add Custom URL route for search (In development now). Set to “No” for production installations.
    10. Custom search route (in development now).
    11. Use Category URL Suffix (in development now).

...

Layout Changes

The Hawk Search Hawksearch Proxy module does not alter any existing templates in your store. You may need to alter your existing templates to produce an optimum customer experience.

...

The standard Magneto mini search form has a basic auto suggest tool attached to it in the template file. If you are using the Hawk Search Hawksearch Auto Suggest tool, please remove the Magento Auto Suggest tool from your search form with the following steps:

  1. Locate the search form template in Magento (named “form.mini.phtml” by default). This file is usually found in your themes template folder in “catalogsearch/form.mini.phtml”. If you are not sure which package/theme your store is using, you can follow the following directions to activate “Template Path Hints” and find the exact path to the file.
    1. In the Magento admin, go to System::Configuration.
    2. Change the Configuration Scope to the store view you are using Hawk Search Hawksearch auto suggest with (Note that you must choose a website or store view scope. Path hints cannot be activated globally).
    3. Select Advanced::Developer (usually the last item on the left).
    4. Under the “Debug” tab, set “Template Path Hints” to “Yes”.
    5. Save the configuration.
    6. Clear the Magento cache.
    7. Reload a frontend page that has the search box.
    8. Locate the search box on the page, it should have a small red box above it with the relative path to the “form.mini.phtml” file. This path is relative to your sites “app/design/” folder.
    9. Return to the admin configuration and deactivate the “Template Path Hints”.

  2. Open the “form.mini.phtml” file identified above for editing, and remove the JavaScript lines related to activating the native auto suggest:

    Code Block
     <script type="text/javascript">                                                                    
    //<![CDATA[
        var searchForm = new Varien.searchForm('search_mini_form', 'search', '');
        searchForm.initAutocomplete('<?php echo $catalogSearchHelper->getSuggestUrl() ?>', 'search_autocomplete');
    //]]>
    </script>