License https://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0)

Elasticsearch should be installed and at least the master node started. For set up instructions read elasticsearch documentation.

"require": {
        ...
        "pocketphp/elasticsearch" : "*",
        ...
    },
    ...
    "repositories": [
            ...
            {
                "type": "vcs",
                "url": "[email protected]:ctasca/magento-elasticsearch-module.git"
            },
            ...
        ],

Elasticsearch module works in latest Magento versions, including 1.9.0.1 with rwd design package.

Download latest tagged version on Github

After download, extract the package and merge the following folders to your Magento installation:

• app
• js

composer.json file and magetest directory are not needed.

1. In system configuration: POCKETPHP/Elasticsearch section
2. Within 'Catalog' section, in 'Catalog Search' tab you should be able to select 'Elasticsearch' as Search Engine
3. When viewing a product in 'Manage Products' you should see an 'Elasticsearch' attribute group

Remember to log out from Admin Panel before trying to access Elasticsearch section.

The following configutation sections are available:

1. Host Settings
2. Authentication Settings
3. Suggestions Settings
4. Search Settings
5. Mapping
6. Index Settings
7. Developer Settings

• Host - The primary Elasticsearch host
• Port - The primary Elasticsearch host port number
• Additional Hosts - Comma separated Elasticsearch Additional Hosts. Can be IP + Port, Just IP, Domain + Port, Just Domain Examples: 192.168.1.2:9201, 192.168.1.2, mydomain.server.com:9201, mydomain2.server.com

• Enable Authentication - Enables authentication when connecting to elasticsearch server/servers. For this to work Elasticsearch needs to be configured to support authentication. If used in production, it is advisable to set up a reverse proxy to secure elasticsearch cluster.

• Auth Plugin - The auth plugin to perform authentications. Currently only Jetty plugin is supported.

• User
• Password
• Authentication Type - The auth type to use. Accepts four different options: Basic, Digets, NTLM, Any

For installation and configuration of Jetty plugin refer to elasticsearch-jetty repository

• Size - Set search suggestions max size. Defauls to 10.
• Fuzzy Queries? - The completion suggester also supports fuzzy queries - this means, customers can actually have a typo in their searches and still get results back.
• Fuzziness - Set search suggestions fuzziness. Increase fuzziness to increase suggestions for mispelled terms.

• Searched Fields CSV - Comma separated list of fields used when performing searches. If left blank '_all' will be used. It is possible to boost a particular field by adding '^n' to the field name (where n is a number). For example name^5, desciption^10 will make description more relevant than name.
• Search Query - Dropdown. Search query executed when performing searches. Default is 'Query String'

• Lowercase Exapnded Fields - Boolean value. Default is 'No'.
• Use Dis Max - Boolean value. Should the queries be combined using dis_max. Default is 'Yes'

• Ignore Term Frequency - Boolean value. Should term frequency be ignored. Defaults to 'No'.
• Max Query Terms - Integer value. The maximum number of query terms that will be included in any generated query. Defaults to 25.
• Fuzziness - The minimum similarity of the term variants. Defaults to AUTO. See the section called “Fuzziness in elasticsearch documentation.
• Prefix Length - Length of required common prefix on variant terms. Defaults to 0.
• Boost - Sets the boost value of the query. Defaults to 1.0.
• Analyzer - Optional. The analyser that will be used to analyse the text. Defaults to the analyser associated with the field.

• Analyzed Fields CSV - Comma separated value of fields to be analysed with corresponding analyser type. Example: title:snowball,description:snowball,name:standard. Warning! Analysing filterable attributes should be avoided. These are automatically set to 'not_analyzed' for correct faceting in layered navigation during indexing.

• Number of Shards - Number of shards. Default is 5.
• Number of Replicas - Number of replicas. Default is 0.

To enable Elasticsearch in Magento, go to System Configuration, Catalog, Catalog Search and choose Elasticsearch as Search Engine. After enabling the engine, rebuild Catalog product fulltext search index in Index Management.

Each product has an Elasticsearch Attributes group. This group mainly focus on the Completion Suggester API of Elasticsearch.

Attributes within the group:

• Name Suggest Input - You can procide a comma separated list of terms you want that product returned in search suggestion's lists. It basically provides a tagging system for the name of the product. For example you may want touch screen phones products tagged with the words 'touch' and 'smartphone' to achieve better suggestion results.
• Name Suggest Weight - The boost value for suggestion terms for a product.
• Remove Category Names Suggestions? - If set to 'Yes' product's category names are removed from name_suggest value during indexing. By default during indexing process, category names for product are added to name suggest input value.
• Remove Product Name Suggestions? - If set to 'Yes' split product's name is removed from name_suggest value during indexing. By default during indexing process the product name is split into words and added to name suggest input value. Set to 'No' to remove.
• Remove Short Description Suggestions? - If set to 'Yes' product's short description is removed from name_suggest value during indexing. By default during indexing the short desciption of a product is added as a single value to name suggest value. Set to 'No' to remove.

Note: the output of suggestions is always the name of the product

Have you ever noticed searching for 'mens' in default Magento store with sample data returns high hill shoes?

Here are two screenshots, 'mens' search performed with Magento default search and with Elasticserach