DocumentatieCommerceProduct Recommendations Handleiding

Aanpassen

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

Gemaakt voor:

  • Beheerder

Wanneer u de module Product Recommendations installeert, maakt Adobe Commerce de map ProductRecommendationsLayout . Deze map bevat sjabloonbestanden die u kunt aanpassen om de weergave van de aanbevelingen in de winkel te wijzigen. Met name kunt u de volgende sjabloon wijzigen of overschrijven:

<your theme>/Magento_ProductRecommendationsLayout/web/template/recommendations.html

Voor meer informatie over het wijzigen van malplaatjedossiers, verwijs naar aanpassing van het Malplaatjein de Voorste Gids van de Ontwikkelaar.

Als u het bestand recommendations.html wijzigt, moet u de volgende tags in het bestand behouden om ervoor te zorgen dat Adobe Commerce gegevens over aanbevelingen kan verzamelen van uw winkel:

Tag
Gebruiken
<div data-bind="attr : {'data-unit-id' : unitId }"...</div>
Verzamelt weergavegebeurtenissen.
<a data-bind="attr : {'data-sku' : sku, 'data-unit-id'}"...</a>
Verzamelt klikgebeurtenissen.
Nota: als u om het even welke ankermarkeringen toevoegt, moet u deze attributen omvatten.

Naast het bestand recommendations.html bevat de map ProductRecommendationsLayout de volgende submappen:

Map
Doel
layout
Bevat *.xml bestanden voor elk paginatype
templates
Bevat bestanden die scripts ophalen en renderen
web/js
Bevat de JavaScript-bestanden die aanbevelingen voor je winkel opvragen en weergeven
web/template
Bevat de sjabloon voor de module magento/product-recommendations

Positionering van de aanbevolen eenheid

Wanneer u 🔗 creeert een aanbeveling, specificeert u de plaatswaar het op de pagina verschijnt. Een aanbevolen eenheid kan boven of onder aan de hoofdinhoudscontainer worden geplaatst. U kunt deze plaatsing echter aanpassen. Als u een type van de aanbeveling van de Bouwer van de Pagina adviserende inhoud creeert, gebruik de hulpmiddelen van de Bouwer van de Pagina om de aanbeveling op de pagina te plaatsen. Bewerk voor alle andere paginatypen de *.xml -bestanden die worden gegenereerd wanneer de aanbeveling wordt gemaakt.

  1. Ga naar de map layout :

    code language-bash 
    cd `<your theme>/Magento_ProductRecommendationsLayout/layout`

    In de volgende tabel worden de XML-bestanden weergegeven die zich in deze map bevinden:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
    Bestandsnaam Pagina
    catalog_category_view.xml Categorie
    catalog_product_view.xml Productdetails
    checkout_cart_index.xml Kar
    checkout_onepage_success.xml Afhandeling
    cms_index_index.xml Home
    note note
    NOTE
    De bestandsnamen in de map layout kunnen afwijken als uw winkel extensies van derden gebruikt.

  2. Wijzig het bestand catalog_product_view.xml zodat de aanbevolen eenheid na de productafbeelding op de pagina met productdetails wordt weergegeven. Voordat u dit XML-bestand aanpast, bekijkt u het bestand en begrijpt u welke secties u moet wijzigen:

    code language-xml 
    <?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <referenceBlock name="page.wrapper">
        <block class="Magento\Framework\View\Element\Template" before="-" name="product_recommendations_fetcher" template="Magento_ProductRecommendationsStorefront::fetcher.phtml" />
    </referenceBlock>
    <body>
        <referenceBlock name="main.content">
            <block class="Magento\ProductRecommendationsStorefront\Block\Renderer" after="-" name="product_recommendations_product_below_content" template="Magento_ProductRecommendationsStorefront::renderer.phtml">
                <arguments>
                    <argument name="pagePlacement" xsi:type="string">below-main-content</argument>
                </arguments>
            </block>
        </referenceBlock>
    </body>
</page>

    In het bovenstaande fragment geeft het verwijzingsblok main.content aan dat de aanbevolen eenheid ergens ten opzichte van dat element wordt geplaatst. Het element block ervan bevat het kenmerk after="-" , dat aangeeft dat de aanbevolen eenheid op de pagina wordt weergegeven na het blok met de hoofdinhoud.

  3. We wijzigen dit bestand door een ander inhoudsblok op te geven.

    Wijzig het verwijzingsblok name van main.content in product.info.media .

    code language-xml 
    <?xml version="1.0"?>
<page xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View/Layout/etc/page_configuration.xsd">
    <referenceBlock name="page.wrapper">
        <block class="Magento\Framework\View\Element\Template" before="-" name="product_recommendations_fetcher" template="Magento_ProductRecommendationsStorefront::fetcher.phtml" />
    </referenceBlock>
    <body>
        <referenceBlock name="product.info.media">
            <block class="Magento\ProductRecommendationsStorefront\Block\Renderer" after="-" name="product_recommendations_product_below_content" template="Magento_ProductRecommendationsStorefront::renderer.phtml">
                <arguments>
                    <argument name="pagePlacement" xsi:type="string">below-main-content</argument>
                </arguments>
            </block>
        </referenceBlock>
    </body>
</page>

    Deze wijziging leidt ertoe dat uw aanbevolen eenheid wordt weergegeven na de productafbeelding op de pagina met productdetails. Als u de aanbeveling-eenheid vóór product.info.media wilt weergeven, wijzigt u het kenmerk after="-" in before="-" . Het argument pagePlacement is een intern argument dat niet mag worden gewijzigd.

Verwijs naar lay-outoverzichtvoor meer informatie over de types van blokken op de pagina.

Aangepaste productkenmerken

Ontwikkelaars hebben vaak toegang nodig tot aangepaste productkenmerkwaarden in aanbevolen eenheden op winkelcentra, zodat ze visuele behandelingen kunnen toevoegen aan producten die op die kenmerken zijn gebaseerd.

Als uw winkel bijvoorbeeld bepaalde biologische producten verkoopt, hebt u mogelijk een aangepast kenmerk op die producten dat deze aanwijst als Organic = Yes . Mogelijk hebt u toegang tot deze kenmerkwaarde op de winkel nodig, zodat u deze producten een speciale visuele behandeling kunt geven wanneer ze in Recommendations worden weergegeven. Op dezelfde manier staat de toegang tot deze waarden van de douaneproductattributen u toe om producten te badge of douanelogica in de presentatielaag van uw plaats te drijven.

voeg Badge toe

Om ervoor te zorgen is een attribuut van het douaneproduct beschikbaar wanneer u de aanbeveling op de pagina teruggeeft, plaats het Used in Product Listing bezit aan Yes in de pagina van de Attributen van het Productin Admin.

Wanneer deze eigenschap is ingesteld, bevat de JSON-payload een attributes -object dat een array van kenmerkcodes en -waarden bevat. Vervolgens kunt u aangepaste opmaakcodes voor winkels toepassen op basis van deze kenmerkwaarden, zoals speciale visuele behandelingen of badges toevoegen zoals eerder vermeld.

NOTE
Wijzigingen in productkenmerken kunnen maximaal een uur duren voordat ze worden weergegeven in de JSON-payload.
recommendation-more-help
4bf3c55a-3844-4322-a5d2-42b4e56228e5