DocumentazioneCommerceGuida alla configurazione

Configurare i termini di ricerca

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

In generale, stopwords sono parole comuni che i motori di ricerca filtrano dopo l'elaborazione del testo. In origine, quando lo spazio su disco e la memoria erano estremamente limitati, ogni kilobyte risparmiato significava un miglioramento significativo delle prestazioni. Pertanto, i motori di ricerca hanno ottenuto miglioramenti delle prestazioni ignorando determinate parole e mantenendo piccolo l’indice.

Anche se oggi abbiamo più storage, le prestazioni sono ancora importanti. Elasticsearch e OpenSearch, come altri motori di ricerca, utilizzano ancora i termini di arresto per migliorare le prestazioni.

È necessario gestire le parole non significative utilizzando i file CSV che si trovano nella directory <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords o nella directory <magento_root>/app/code/Magento/Elasticsearch/etc/stopwords/, a seconda di come è stato installato il software Commerce.

Per ulteriori informazioni sull'utilizzo di parole non significative in Elasticsearch e OpenSearch, vedere le risorse seguenti:

Configurare le parole d'arresto

Le parole non significative si trovano nella directory <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords. In Adobe Commerce è disponibile un file CSV contenente i termini per le impostazioni internazionali predefinite e un file aggiuntivo, stopwords.csv, contenente i termini per le impostazioni locali non rappresentate da un altro file CSV.

La durata predefinita per la cache dei file di parole non significative è di 15 minuti.

Modificare le parole non significative per una lingua esistente

Per modificare le parole non significative:

  1. Accedi al tuo server Commerce o passa a proprietario del file system.

  2. Utilizzare un editor di testo per aprire un file di parametri nella directory <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords.

    I file CSV utilizzano la convenzione di denominazione stopwords_<locale_code>.csv. Ad esempio, il nome del file di parole non significative tedesco è stopwords_de_DE.csv.

  3. Aggiungere parole, rimuovere parole o modificare parole nel file.

    (Ogni parola d'arresto in un file inizia su una nuova riga.)

  4. Salva le modifiche e esci dall’editor di testo.

  5. Pulisci la cache di configurazione.

    • Amministratore: Sistema > Strumenti > Gestione cache. Selezionare la casella di controllo Configurazione e fare clic su Aggiorna dall'elenco precedente. Fai clic su Invia per completare l'azione.

    • Riga di comando: come proprietario del file system, immettere il comando seguente:

      code language-bash 
      php <magento_root>/bin/magento cache:clean config

  6. Controlla i risultati cercando i termini nella vetrina.

Creazione di parole non significative per una nuova lingua

Per aggiungere parole non significative per una lingua:

  1. Accedi al tuo server Commerce o passa a proprietario del file system.

  2. Utilizzare un editor di testo per creare un file di parole d'ordine denominato stopwords_<locale_code>.csv nella directory <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords.

    Ad esempio, per creare parole non significative per le impostazioni internazionali italiane, assegnare al file il nome stopwords_it_IT.csv.

  3. Nel file di parametri verificare che ogni indicatore di stato si trovi su una riga separata.

  4. Salva le modifiche e esci dall’editor di testo.

  5. Nella stessa directory, aprire esconfig.xml in un editor di testo.

  6. Aggiungere una riga a esconfig.xml come segue:

    code language-xml 
    <LOCALE_CODE>stopwords_LOCALE_CODE.csv</LOCALE_CODE>

    Ad esempio, per aggiungere un file di parola d'arresto italiano, aggiungete la seguente riga:

    code language-xml 
    <it_IT>stopwords_it_IT.csv</it_IT>

  7. Salvare le modifiche apportate a esconfig.xml e uscire dall'editor di testo.

  8. Pulisci la cache di configurazione.

    • Amministratore: Sistema > Strumenti > Gestione cache. Selezionare la casella di controllo Configurazione e fare clic su Aggiorna dall'elenco precedente. Fai clic su Invia per completare l'azione.

    • Riga di comando: come proprietario del file system, immettere il comando seguente:

      code language-bash 
      php <magento_root>/bin/magento magento cache:clean config

  9. Controlla i risultati cercando i termini nella vetrina.

Cambia la directory di parole d'arresto

In questa sezione viene illustrato come modificare la directory di default dei parametri di arresto da una delle seguenti opzioni:

  • <magento_root>/vendor/magento/module-elasticsearch/etc/stopwords
  • <magento_root>/app/code/Magento/Elasticsearch/etc/stopwords/

La posizione dipende da come è stato installato il software Commerce. Se hai clonato l'archivio GitHub Magento 2, il percorso si trova in app/code. Se è stato installato un archivio compresso o un metapacchetto, il percorso si trova in vendor.

Per modificare la directory:

  1. Come proprietario del file system, aprire l'Elasticsearch di.xml in un editor di testo.

    Se l'archivio è stato clonato, si trova in app/code/Magento/Elasticsearch/etc/di.xml

    Se hai ottenuto un archivio o il metapacchetto, si trova in vendor/magento/module-elasticsearch/etc/di.xml

  2. Modificare il valore di stopwordsDirectory nella directory desiderata:

    code language-xml 
    <type name="Magento\Elasticsearch\SearchAdapter\Query\Preprocessor\Stopwords">
    <arguments>
        <argument name="stopwordsDirectory" xsi:type="string">app/code/Magento/Elasticsearch/etc/stopwords</argument>
    </arguments>
</type>

  3. Salvare le modifiche apportate a di.xml e uscire dall'editor di testo.

Per cambiare la directory dal modulo

  1. Crea un modulo

  2. Nel modulo etc/di.xml aggiungi istruzioni:

    code language-xml 
    <type name="Magento\Elasticsearch\SearchAdapter\Query\Preprocessor\Stopwords">
    <arguments>
       <argument name="stopwordsModule" xsi:type="string">Your_Module</argument>
       <argument name="stopwordsDirectory" xsi:type="string">stopwords</argument>
    </arguments>
</type>

  3. Nel modulo creare la directory etc/stopwords con il file CSV corrispondente.

  4. Salvare le modifiche apportate a di.xml e uscire dall'editor di testo.

recommendation-more-help
386822bd-e32c-40a8-81c2-ed90ad1e198c