Integrations / Magento 2

Implement multi-language search in a single store

A step-by-step guide on how to perform a search in several languages simultaneously on a single store view using Algolia’s extension for Magento.

By default, the extension places each store view’s data in a separate index: each store view has a dedicated index in a specific language. For example, searching for Hemd in an English store won’t return any results. To show the correct results when searching for Hemd, customize the extension to merge those indices.

Examples of default records

  • Index name: magento2_products_en

    1
    2
    3
    4
    5
    
    {
      "name": "Shirt"
      "description": "Very nice blue shirt",
      // ... other attributes
    }
    
  • Index name: magento2_products_de

    1
    2
    3
    4
    5
    
    {
      "name": "Hemd"
      "description": "Sehr schönes blaues Hemd",
      // ... other attributes
    }
    
  • Index name: magento2_products_es

    1
    2
    3
    4
    5
    
    {
      "name": "Camisa"
      "description": "Muy bonita camisa azul",
     // ... other attributes
    }
    

The records must contain values in all supported languages to search on one store view in those languages.

Create a record in the extension

  1. Create a custom extension, which lets you listen to the extension’s custom events.
  2. Create an event listener for the algolia_after_create_product_object event, the same way as written in the custom event extension algolia_products_index_before_set_settings.
  3. From the $observer variable passed to the execute() method, fetch:

    • custom_data
    • productObject
    • subProducts
  4. The Algolia record is an array in the custom_data object and can be modified like any other PHP array.
  5. Fetch searchable attributes, such as name, description, or manufacturer, in all other languages and add it to the record in custom_data. Structure the data according to the example record.

Example of an observer’s execute() method

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public function execute(Observer $observer)
{
    /* @var \Magento\Catalog\Model\Product $product */
    $product = $observer->getData('productObject');

    /*
     * Fetch language-specific values based on $product
     */

    $productRecord = $observer->getData('custom_data');

    $originalName = $productRecord['name'];
    $originalDescription = $productRecord['description'];

    $productRecord['name'] = [
        'en' => $originalName,
        'de' => $germanName,
        'es' => $spanishName,
    ];

    $productRecord['description'] = [
        'en' => $originalDescription,
        'de' => $germanDescription,
        'es' => $spanishDescription,
    ];
}

Index settings

If your records are structured like the example record, you don’t need to send specific settings to Algolia because you only need to make parent attributes, such as name, description, or manufacturer, searchable. You can do this in the Magento Admin.

Showcase record

1
2
3
4
5
6
7
8
9
10
11
12
13
{
    "name": {
        "en": "Shirt",
        "de": "Hemd",
        "es": "Camisa"
    },
    "description": {
        "en": "Very nice blue shirt",
        "de": "Sehr schönes blaues Hemd",
        "es": "Muy bonita camisa azul"
    }
    // ... other attributes
}
Did you find this page helpful?