The Synonyms are defined in the %PLUGIN_DIR%/Resources/config/Synonyms.php. The path to this file is saved in the swag_ses_synonym_dir parameter of the container and can be overridden with the default Dependency Injection. See How to override for more information.

The path parameter is afterwards passed to the Swag\EnterpriseSearch\Relevance\SynonymProvider class.

Example

Synonyms.php
<?php declare(strict_types=1);
​
use Swag\EnterpriseSearch\Relevance\SynonymProvider;
​
return [
    SynonymProvider::DEFAULT_KEY => [
        'i-pod, i pod => ipod',
        'universe, cosmos',
    ],
];

The SynonymProvider supports multi languages and a default fallback! For a specific language the language code can be added as an array key, like the following.

Synonyms.php with multi language support
<?php declare(strict_types=1);
​
use Swag\EnterpriseSearch\Relevance\SynonymProvider;
​
return [
    SynonymProvider::DEFAULT_KEY => [
        'i-pod, i pod => ipod',
        'universe, cosmos',
    ],
    'en-GB' => [
        'foozball, foosball',
        'sea biscuit, sea biscit => seabiscuit',
    ],
];

How to override

1. Shopware Configuration

   1. Shopware is based on symfony, so it's possible to override the Service parameters in symfony style.

   2. Parametername swag_ses_synonym_dir

2. Own Plugin 1. Create a plugin​

   1. Add a dependency injection file

   2. Create a file with your synonyms, see Example​

   3. ​Add a parameter to the Dependency Injection File.

services.xml
<parameters>
    <parameter key="swag_ses_synonym_dir">%kernel.project_dir%/MySynonyms.php</parameter>
</parameter>