Live zoeken installeren | Handleiding voor Adobe Commerce-ontwikkelaars


Live Search is een set zelfstandige metapakketten die de standaard Magento Open Source- en Adobe Commerce-zoekmogelijkheden vervangt. In dit onderwerp vindt u instructies om het volgende te doen:

Pakket Beschrijving
module-live-search Stelt verkopers in staat hun zoekinstellingen te configureren voor facetten, synoniemen, zoekregels, enz., en biedt toegang tot een alleen-lezen GraphQL-speeltuin om query’s van Adobe Commerce Admin te testen.
module-live-search-adapter Routeert zoekopdrachten van de etalage naar de Live Search-service en geeft de resultaten weer in de etalage.
– Bladeren door categorieën – Routeert verzoeken van de bovenste navigatie van de winkel naar de zoekservice.
– Globaal zoeken – Routeert verzoeken van het snelzoekvak in de rechterbovenhoek van de etalage naar de Live Search-service.
module-live-search-storefront-popover Een pop-over ‘zoeken terwijl u typt’ vervangt de standaard snelle zoekactie en geeft dynamische productsuggesties en miniaturen van de beste zoekresultaten terug.

Voorwaarden

Ondersteunde platforms

  • Adobe Commerce op locatie (EE): 2.4.x
  • Adobe Commerce on Cloud (ECE): 2.4.x

Op dit moment wordt Adobe Commerce voor B2B niet ondersteund.

Voordat je begint

Doe het volgende:

  1. Controleer of cron-taken en indexeerders actief zijn.

  2. Kies de onboarding-methode die aan uw vereisten voldoet en volg de instructies.

    • Methode 1: Installeren zonder Elasticsearch
    • Methode 2: Installeren met Elasticsearch (geen downtime)

Methode 1: Installeren zonder Elasticsearch

Deze introductiemethode wordt aanbevolen bij het installeren van Live Search op een:

  • Nieuwe Commerce-installatie
  • Staging-omgeving

In dit scenario worden storefront-bewerkingen onderbroken terwijl de Live Search-service alle producten in de catalogus indexeert. Tijdens de installatie zijn Live Search-modules ingeschakeld en Elasticsearch-modules uitgeschakeld.

  1. Installeer Adobe Commerce 2.4.x zonder Live Search.

  2. Om de . te downloaden live-search pakket, voert u het volgende uit vanaf de opdrachtregel:

    1

    
    		


    composer require magento/live-search

    Zie voor meer informatie de lijst met Live Search-afhankelijkheden die zijn vastgelegd door Composer.

  3. Voer de volgende opdrachten uit om Elasticsearch en gerelateerde modules uit te schakelen en Live Search te installeren:

    1

    
    		


    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_AdvancedSearch  Magento_InventoryElasticsearch

    
    		

    
    

    


    1

    
    		


    bin/magento setup:upgrade

    Hoewel de gegevens worden geïndexeerd en gesynchroniseerd, zijn de zoek- en bladerbewerkingen in categorieën niet beschikbaar in de etalage. Afhankelijk van de grootte van uw catalogus, kan het proces vanaf de tijd minstens een uur duren cron wordt uitgevoerd om uw gegevens te synchroniseren met Live Search-services.

  4. Controleer of de volgende indexeerders zijn ingesteld op: Update by Schedule:

    • Productfeed
    • Productvariantenfeed
    • Catalogusattributenfeed

  5. Configureer uw API-sleutels om uw catalogusgegevens te synchroniseren met Live Search-services.

  6. Om facetten beschikbaar te maken als filters in de etalage, voegt u de facetten toe die u nodig hebt, afhankelijk van de vereisten.

    Je zou daarna facetten moeten kunnen toevoegen cron voert de kenmerkfeeds uit en exporteert kenmerkmetadata.

  7. Wacht minimaal een uur na cron wordt uitgevoerd om gegevens te synchroniseren. Controleer vervolgens of de gegevens zijn geëxporteerd.

  8. Test de verbinding vanaf de etalage.

Methode 2: Installeren met Elasticsearch

Deze introductiemethode wordt aanbevolen bij het installeren van Live Search om:

  • Een bestaande productie Commerce-installatie

In dit scenario beheert Elasticsearch tijdelijk zoekopdrachten van de storefront, terwijl de Live Search-service alle producten op de achtergrond indexeert, zonder enige onderbreking van de normale storefront-activiteiten. Elasticsearch wordt uitgeschakeld en Live Search ingeschakeld nadat alle catalogusgegevens zijn geïndexeerd en gesynchroniseerd.

  1. Om de . te downloaden live-search pakket, voert u het volgende uit vanaf de opdrachtregel:

    1

    
    		


    composer require magento/live-search

    Zie voor meer informatie de lijst met Live Search-afhankelijkheden die zijn vastgelegd door Composer.

  2. Voer de volgende opdracht uit om tijdelijk de Live Search-modules uit te schakelen die zoekresultaten op de winkelpagina weergeven.

    1

    
    		


    bin/magento module:disable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover

    
    		

    
    

    


    1

    
    		


    bin/magento setup:upgrade

    Elasticsearch blijft zoekopdrachten vanuit de winkel beheren, terwijl de Live Search-service de catalogusgegevens synchroniseert en producten op de achtergrond indexeert.

  3. Controleer of de volgende indexeerders zijn ingesteld op: Update by Schedule:

    • Productfeed
    • Productvariantenfeed
    • Catalogusattributenfeed

  4. Configureer uw API-sleutels om uw catalogusgegevens te synchroniseren met Live Search-services.

  5. Om facetten beschikbaar te maken als filters in de etalage, voegt u de facetten toe die u nodig hebt, afhankelijk van de vereisten.

    Je zou daarna facetten moeten kunnen toevoegen cron voert de product- en kenmerkfeeds uit en exporteert kenmerkmetadata naar Live Search-services.

  6. Wacht minimaal een uur totdat de gegevens zijn geïndexeerd en gesynchroniseerd. Gebruik vervolgens de GraphQL-speeltuin met de standaardquery om het volgende te verifiëren:

    • Het geretourneerde aantal producten ligt in de buurt van wat u verwacht voor de winkelweergave
    • Facet(en) worden geretourneerd

  7. Voer de volgende opdrachten uit om Elasticsearch-modules uit te schakelen, Live Search-modules in te schakelen en setup uit te voeren.

    1

    
    		


    bin/magento module:enable Magento_LiveSearchAdapter Magento_LiveSearchStorefrontPopover

    
    		

    
    

    


    1

    
    		


    bin/magento module:disable Magento_Elasticsearch Magento_Elasticsearch6 Magento_Elasticsearch7 Magento_ElasticsearchCatalogPermissions Magento_AdvancedSearch Magento_InventoryElasticsearch

    
    		

    
    

    


    1

    
    		


    bin/magento setup:upgrade

  8. Test de verbinding vanaf de etalage.

API-sleutels configureren

De Adobe Commerce API-sleutel en de bijbehorende privésleutel zijn vereist om Live Search te verbinden met een installatie van Adobe Commerce. De API-sleutel wordt gegenereerd en bijgehouden in het account van de Adobe Commerce-licentiehouder, die deze kan delen met de ontwikkelaar of SI. De ontwikkelaar kan vervolgens namens de licentiehouder de SaaS-gegevensruimten maken en beheren. Zie Commerce Services in de gebruikershandleiding en configuratiereferentie voor gedetailleerde instructies.

Adobe Commerce-licentiehouder

Zie Commerce Services in de Adobe Commerce-gebruikershandleiding om een ​​API-sleutel en privésleutel te genereren.

Adobe Commerce-ontwikkelaar of SI

De ontwikkelaar of SI configureert de SaaS-gegevensruimte zoals beschreven in het gedeelte Commerce Services van de configuratie. Commerce Services wordt beschikbaar in de zijbalk Beheerdersconfiguratie wanneer een SaaS-module is geïnstalleerd.

Catalogusgegevens synchroniseren

Live Search vereist gesynchroniseerde productgegevens voor zoekbewerkingen en gesynchroniseerde kenmerkgegevens om facetten te configureren. De eerste synchronisatie tussen de productcatalogus en de catalogusservice begint wanneer Live Search voor het eerst wordt aangesloten. Afhankelijk van de installatiemethode en de grootte van de catalogus, kan het tot acht uur duren voordat de gegevens zijn geëxporteerd en geïndexeerd door Live Search. De lijst met gegevens die worden gesynchroniseerd en gedeeld met de catalogusservice is te vinden in het schema, dat is gedefinieerd in:

vendor/magento/module-catalog-data-exporter/etc/et_schema.xml

Exporteren verifiëren

Om te controleren of de catalogusgegevens zijn geëxporteerd vanuit uw Adobe Commerce-instantie en zijn gesynchroniseerd voor Live Search, zoekt u naar vermeldingen in de volgende tabellen:

  • catalog_data_exporter_products
  • catalog_data_exporter_product_attributes

Raadpleeg voor meer hulp de Live search-catalogus niet gesynchroniseerd in de Support Knowledge Base.

Toekomstige productupdates

Na de eerste synchronisatie kan het tot vijftien minuten duren voordat incrementele productupdates beschikbaar zijn voor zoeken in de winkel. Ga voor meer informatie naar Productupdates streamen.

Test de verbinding

Controleer het volgende in de etalage:

  • De Zoekopdracht box geeft de resultaten correct terug
  • Bladeren door categorieën geeft de resultaten correct weer
  • Facet(en) zijn beschikbaar als filters op pagina’s met zoekresultaten

Als alles correct werkt, gefeliciteerd! Live Search is geïnstalleerd, verbonden en klaar voor gebruik.

Als u problemen ondervindt in de etalage, controleer dan de: var/log/system.log bestand voor API-communicatiefouten of fouten aan de servicezijde.

Om Live Search bij te werken, voert u het volgende uit vanaf de opdrachtregel:

1





composer update magento/live-search --with-dependencies

Om bij te werken naar een hoofdversie, zoals van 1.0 naar 2.0, bewerk je de root Composer van het project .json bestand als volgt:

  1. Open de root composer.json bestand en zoek naar magento/live-search.

  2. In de require sectie, werkt u het versienummer als volgt bij:

    1
2
3
4
5

    
    		


    "require": {
   ...
   "magento/live-search": "^2.0",
   ...
 }

  3. Opslaan composer.json. Voer vervolgens het volgende uit vanaf de opdrachtregel:

    1

    
    		


    composer update magento/live-search –-with-dependencies

Ga naar Modules verwijderen om Live Search te verwijderen.

Live Search-afhankelijkheden

De volgende Live Search-afhankelijkheden worden vastgelegd door Composer:

Afhankelijkheid Beschrijving
Modules exporteren De volgende modules verzamelen en synchroniseren catalogusgegevens:
saas-export
module-bundle-product-exporter
module-catalog-data-exporter
module-catalog-inventory-data-exporter
module-catalog-url-rewrite-data-exporter
module-configurable-product-data-exporter
module-data-exporter
module-parent-product-data-exporter
services-connector Vereist om uw verbinding met Commerce Services te configureren.
module-services-id Vereist om uw verbinding met Commerce Services te configureren.
Naar het overzicht

Blijf up to date

Alle artikelen
badges

Let’s connect

We hebben altijd zin in nieuwe en uitdagende projecten. We gaan graag met je in gesprek!

Bel of mail ons

Deze website maakt gebruik van cookies

De website van Magento specialisten Proud Nerds toont media van derde partijen en zij plaatsen cookies als je hiermee instemt. Als je deze cookies niet wilt, kun je dat hier aangeven. Je ziet dan geen media van deze partijen via onze website. Wij plaatsen zelf ook cookies om onze site te verbeteren, deze gegevens worden niet aan derden verstrekt. Lees meer over ons cookiebeleid.

Akkoord Liever niet