Automatische verwandte Produkte für Magento 2
Magento-Module nach klaren Regeln
Du kaufst das Modul einmalig, ohne Domain-Beschränkungen
Kostenlose Installation und Updates über Composer
Partnerprogramm
Technischer Support für Magento
Klare Lizenzierungsregeln für Magento-Module
Sicherheit des Magento-Modul-Codes
Erstellen Sie intelligente Produktempfehlungen in Magento 2, ohne sich auf starre Beziehungen wie related, upsell und cross-sell zu beschränken.
Kowal_RelatedProductsProfiles ist ein Modul, mit dem Sie eigene Empfehlungsszenarien auf Basis von Profilen, Produktattributen, Aktivierungsbedingungen, Zielfiltern und einer flexiblen Einbindung im Shop-Layout gestalten können. So sind Empfehlungen keine statische Liste mehr, sondern werden zu einem Bestandteil der Verkaufsstrategie Ihres Shops.
Verwandeln Sie einfache Produktlisten in echte Verkaufsszenarien
Im Standard von Magento sind verwandte Produkte oft zu einfach, um anspruchsvollere Implementierungen abzubilden. Ein Shop möchte auf der Produktseite andere Produkte anzeigen als im Warenkorb oder im Checkout. Manchmal soll eine Liste nur für ausgewählte Kundengruppen, nur während einer saisonalen Kampagne oder nur dann funktionieren, wenn ein Produkt bestimmte Katalogbedingungen erfüllt.
Dieses Modul wurde genau für solche Anwendungsfälle entwickelt.
Anstatt Produkte manuell miteinander zu verknüpfen, erstellen Sie ein Empfehlungsprofil. Das Profil legt fest:
- wo es funktionieren soll,
- für welches Produkt es aktiviert werden soll,
- wie Zielprodukte ausgewählt werden,
- wie sie eingegrenzt und sortiert werden,
- wie sie aussehen sollen,
- wo sie gerendert werden sollen,
- und ob sie native Magento-Listen speisen sollen.
Ein Tool, viele Einsatzorte
Das Modul funktioniert in den wichtigsten Bereichen des Shops:
- auf der Produktseite,
- im Warenkorb,
- im Checkout,
- in nativen Blöcken
Related Products, - in nativen Blöcken
Upsell Products, - in nativen Blöcken
Crosssell Products.
Das bedeutet, dass ein Profil Teil mehrerer unterschiedlicher Merchandising-Szenarien werden kann und das Implementierungsteam nicht für jede Stelle im Shop eine eigene Logik erstellen muss.
Profile, die sich an Ihren Katalog anpassen
Die größte Stärke des Moduls besteht darin, dass Empfehlungen nicht nur manuell, sondern auch dynamisch auf Basis von Produktattributen erstellt werden können.
Sie können Profile erstellen, die:
- Produkte aus derselben Kollektion auswählen,
- Produkte mit derselben Grafik finden,
- Produkte aus derselben Kategorie anzeigen,
- eine andere Produktbasis bewerben, die mit dem angesehenen Produkt verbunden ist,
- das Ergebnis auf bestimmte Produkttypen eingrenzen,
- nur für ausgewählte Store Views und Kundengruppen funktionieren.
Ein Beispiel?
Ein Kunde sieht sich einen Rashguard mit der Grafik HALLOWEEN 25 an. Das Profil kann automatisch Produkte mit derselben Grafik in anderen Produktlinien finden, zum Beispiel Shorts, Leggings oder Accessoires. Ein anderes Profil kann wiederum dasselbe Produkt als Kontext im Warenkorb nutzen und dem Kunden vorschlagen, die Bestellung um Produkte aus einer ausgewählten Sortimentsbasis zu ergänzen.
Erstellen Sie Empfehlungen auf Basis von Bedingungen, nicht von Ausnahmen
Jedes Profil kann eigene Einstellungen haben für:
Activation Conditions,Matching Rules,Target Product Filters,- Sortierung,
- Produktlimits,
- Rendering-Variante,
- zeitlichen Aktivitätsbereich.
In der Praxis bietet das enorme Freiheit.
Sie können ein Profil erstellen, das nur für Produkte mit dem Attribut brand = Nike ausgelöst wird, nur im B2C-Shop, nur für Einzelhandelskunden und nur während einer bestimmten Kampagne. Sie können auch ein Profil erstellen, das ein Produkt aus dem Warenkorb als Bezugspunkt verwendet und Zubehör auf Basis gemeinsamer Katalogmerkmale vorschlägt.
Das ist keine einfache Produktliste mehr. Es ist eine regelbasierte Empfehlungs-Engine, die sich an das tatsächliche Verkaufsmodell des Shops anpassen lässt.
Wählen Sie, welches Produkt als Kontext dienen soll
Auf der Produktseite ist das aktuelle Produkt der Kontext. Im Warenkorb und Checkout ist diese Antwort jedoch nicht immer offensichtlich. Deshalb können Sie im Modul die Context Strategy festlegen, also die Art und Weise, wie das Kontextprodukt ausgewählt wird.
Sie können entscheiden, dass Profile basieren sollen auf:
- dem ersten Produkt im Warenkorb,
- dem zuletzt hinzugefügten Produkt,
- dem Produkt mit dem höchsten Preis.
Diese Flexibilität macht in Projekten einen großen Unterschied, in denen der Kunde mehrere unterschiedliche Produkte in den Warenkorb legt und die Empfehlungen einer konkreten Geschäftslogik folgen müssen.
Separate Szenarien für Produktseite, Warenkorb und Checkout
Was auf der PDP gut funktioniert, ist im Warenkorb nicht immer sinnvoll. Das Modul ermöglicht es, diese Szenarien zu trennen, ohne mehrere separate Erweiterungen einzusetzen.
Auf der Produktseite können Sie eine Liste von Produkten aus derselben Kollektion oder mit derselben Stilrichtung anzeigen. Im Warenkorb können Sie Zubehör bewerben, das den Bestellwert erhöht. Im Checkout können Sie eine vereinfachte, zurückhaltendere Produktliste vorbereiten, die Cross-Sell unterstützt.
All das innerhalb eines einzigen Profilsystems.
Speisen Sie native Magento-Listen: append oder replace
Nicht jeder Shop möchte sofort auf native Magento-Mechanismen verzichten. Deshalb unterstützt das Modul die Integration mit:
Related Products,Upsell Products,Crosssell Products.
Jedes Profil kann in einem von zwei Modi arbeiten:
append
behält native Produkte bei und ergänzt sie um die Ergebnisse des Moduls,replace
ersetzt die native Liste vollständig durch Produkte aus dem Profil.
Das ist eine sehr praktische Lösung für Implementierungen. Sie können mit einer leichten Erweiterung der vorhandenen Magento-Listen beginnen und erst später zur vollständigen Steuerung der Empfehlungen über Profile wechseln.
Rendern Sie dort, wo Sie es wirklich möchten
Ein großer Vorteil des Moduls ist die Möglichkeit, den Rendering-Ort über XML-Felder zu steuern, die dem Profil zugewiesen sind.
Anstatt das Modul an ein starres Layout anzupassen, können Sie die Liste genau dort einbinden, wo das Projekt sie benötigt:
- unter der Produktbeschreibung,
- unter dem Preis,
- unter dem Kaufformular,
- in einem zusätzlichen Bereich,
- in einem eigenen Theme-Container,
- an einer Stelle, die sich aus einem benutzerdefinierten Frontend-Layout ergibt.
Das ist besonders wichtig in Shops, die auf umfangreichen oder stark modifizierten Themes basieren. Das Modul zwingt Sie nicht zu einem einzigen Layout. Sie entscheiden, wo und wie das Profil eingebunden werden soll.
Drei Präsentationsvarianten im Frontend
Das Modul endet nicht bei der Logik zur Produktauswahl. Es ermöglicht auch, die Darstellung der Liste an den Charakter der Seite und die Art der Implementierung anzupassen.
Verfügbare Varianten:
Grid,Slider,Compact.
Sie können dieselbe Empfehlungs-Engine also sowohl für einen umfangreichen Bereich auf der Produktseite als auch für eine kompakte Liste im Warenkorb oder ein kompakteres Modul im Checkout verwenden.
Hinzu kommt die Kontrolle über Ansichtselemente:
- Produktname,
- Preis,
- regulärer Preis,
- Kurzbeschreibung,
- Button zum Hinzufügen zum Warenkorb,
- Bildrolle.
Das Erstellen neuer Profile ist übersichtlich und skalierbar
Das Modul wurde so entwickelt, dass ein Implementierungs- oder Agenturteam weitere Szenarien entwickeln kann, ohne die gesamte Lösung neu aufzubauen.
Beim Erstellen eines neuen Profils konfigurieren Sie:
- grundlegende administrative Informationen,
- Placements und Wirkungsbereich,
- Store Views und Kundengruppen,
- Kontextstrategie,
- Aktivitätszeitraum,
- Aktivierungsbedingungen,
- Matching-Regeln,
- Filter für Zielprodukte,
- Sortierung und Darstellungsweise,
- Integration mit nativen Magento-Listen,
- Einbindung über XML.
Das bedeutet, dass ein weiteres Merchandising-Szenario nicht sofort ein weiteres Custom-Modul erfordert. Sehr oft reicht ein weiteres Profil aus.
Praxisnahe Anwendungsbeispiele
1. Dieselbe Grafik, andere Produktbasis
Der Kunde sieht sich ein Produkt aus einer bestimmten Linie an. Das Modul sucht auf Basis der Matching Rules nach Produkten mit derselben Grafik, aber aus anderen Sortimentsfamilien. Das ist ein sehr gutes Szenario für Lifestyle-, Sport- und Fashion-Marken.
2. Cross-Sell auf Basis eines Produkts im Warenkorb
Der Kunde hat bereits ein ausgewähltes Produkt im Warenkorb. Das Profil nutzt es als Kontext und wählt Zubehör aus, das zum Kauf passt, aber nicht manuell als nativer Cross-Sell verknüpft ist.
3. Zeitlich begrenzte Kampagne
Benötigen Sie Empfehlungen, die nur während einer bestimmten Verkaufsaktion funktionieren? Es reicht aus, ein Profil mit From Date und To Date zu konfigurieren, ohne zusätzliche Logik zu erstellen.
4. Ersetzen nativer Upsells
Wenn die standardmäßigen Magento-Upsells zu vereinfacht sind, kann ein Profil diese Rolle übernehmen und im Modus replace arbeiten, wodurch eine deutlich präzisere Produktzuordnung möglich wird.
5. Integration mit einem benutzerdefinierten Theme
Dank XML-Feldern kann die Liste genau dort eingebunden werden, wo es das Frontend des Projekts erfordert, ohne eine weitere dedizierte Layout-Erweiterung zu erstellen.
Für wen ist dieses Modul geeignet
Kowal_RelatedProductsProfiles ist besonders wertvoll für:
- Magento 2 Implementierungsagenturen,
- Softwarehäuser, die e-commerce-Shops entwickeln,
- Merchants, die die Empfehlungslogik von manuell gepflegten Beziehungen unabhängiger machen möchten,
- Projekte mit umfangreichem Katalog und vielen geschäftlichen Attributen,
- Shops, die benutzerdefinierte Themes und komplexe Layouts verwenden.
Was Sie gewinnen
Mit dem Kauf des Moduls erhalten Sie nicht nur eine weitere Produktliste, sondern ein Tool zur Gestaltung eigener Empfehlungsszenarien in Magento 2.
Diese Lösung:
- erhöht die Flexibilität der Implementierung,
- strukturiert die Merchandising-Logik,
- reduziert den Bedarf, weitere Ausnahmen im Code zu schreiben,
- nutzt Katalogattribute besser,
- ermöglicht die Weiterentwicklung des Shops, ohne den gesamten Empfehlungsmechanismus neu aufzubauen.
Wenn die standardmäßigen related, upsell und cross-sell für Ihr Projekt zu eingeschränkt sind, bietet Kowal_RelatedProductsProfiles eine Steuerungsebene, die Magento standardmäßig einfach nicht hat.
Installation und Konfiguration des Moduls
Dieses Dokument beschreibt die Installation des Moduls Kowal_RelatedProductsProfiles sowie die grundlegende Konfiguration eines Produktempfehlungsprofils im Magento-Panel.
Anforderungen
- Magento 2 mit Unterstützung für Composer-Module.
- PHP passend zum Projekt:
^8.1,^8.2oder^8.3. - Installiertes Basismodul
kowal/base, da das Administrationsmenü die StrukturKowal.co > Modulesverwendet. - Administrativer Zugriff auf die Magento CLI.
Installation über Composer
- Fügen Sie das Modul-Repository hinzu:
composer config repositories.related.products.profiles vcs https://github.com/kowalco/related-bestsellers- Wenn das Repository privat ist, fügen Sie ein GitHub-Token hinzu:
composer config --global --auth github-oauth.github.com - Installieren Sie das Modul:
composer require kowal/module-related-products-profiles- Aktivieren Sie das Modul:
php bin/magento module:enable Kowal_RelatedProductsProfiles- Führen Sie das Datenbank-Update aus:
php bin/magento setup:upgradeWährend setup:upgrade erstellt das Modul die Profiltabelle und führt einen Data Patch mit drei Beispielprofilen aus: related, crossel, upsell. Der Patch überschreibt keine bestehenden Profile mit denselben Codes.
- Erstellen Sie im Produktionsmodus die Dependency Injection neu:
php bin/magento setup:di:compile- Leeren Sie den Cache:
php bin/magento cache:flushGrundlegende globale Konfiguration
Gehen Sie zu:
Stores > Configuration > Kowal > Related Product Profiles
Legen Sie fest:
Enable Frontend Output:YesEnable Debug Logging:Noin Produktion,Yesnur zur Diagnose der Profilfunktion
Speichern Sie die Konfiguration und leeren Sie den Cache, falls Magento Sie dazu auffordert.
Administratorberechtigungen
Das Modul fügt ACL-Ressourcen für Profile und Konfiguration hinzu.
Zugriff auf die Profilliste:
Kowal > Modules > Related Product Profiles > Profiles
Zugriff auf die Konfiguration:
Stores > Settings > Configuration > Related Product Profiles Configuration
Für einen Demo-Benutzer, der nur Profile verwalten soll, vergeben Sie die Berechtigung Profiles. Wenn der Benutzer auch die globale Aktivierung des Moduls ändern soll, vergeben Sie ihm zusätzlich die Konfigurationsressource.
Wo Profile verwaltet werden
Die Profilliste befindet sich im Menü:
Kowal.co > Modules > Related Product Profiles > Profiles
In der Liste können Sie ein neues Profil hinzufügen, ein bestehendes bearbeiten oder ein Profil löschen.
Beispielkonfiguration eines Related Products-Profils
Das folgende Beispiel erstellt ein Profil, das den nativen Magento-Block Related Products auf der Produktseite ersetzt. Die Produkte werden nach derselben attribute_set_id ausgewählt, also aus demselben Attributsatz wie das vom Kunden angesehene Produkt.
1. Profil erstellen
Gehen Sie zu:
Kowal.co > Modules > Related Product Profiles > Profiles
Klicken Sie auf Add New Profile.
2. Bereich General
Legen Sie fest:
Name:Related ProductsCode:relatedIs Active: aktiviertSort Order:0Placements: wählen SieProduct PageStore Views: wählen SieAll Store ViewsCustomer Groups: wählen SieAll Customer GroupsContext Strategy:First matching itemFrom Date: leerTo Date: leer
Hinweise:
- Für die Produktseite ist der Kontext immer das aktuell angesehene Produkt.
Context Strategyhat vor allem für Warenkorb und Checkout praktische Bedeutung.Codemuss eindeutig sein.
3. Bereich Activation Conditions
Fügen Sie eine Bedingung hinzu:
| Attributcode | Operator | Wert |
|---|---|---|
status | Equals | 1 |
Bedeutung:
- Das Profil wird nur gestartet, wenn das Kontextprodukt aktiv ist.
- Wenn die Bedingung nicht erfüllt wird, wird das gesamte Profil übersprungen.
4. Bereich Matching Rules
Fügen Sie eine Regel hinzu:
| Quellattribut | Zielattribut | Operator | Erforderlich | Richtlinie für leere Werte | Standardwert |
|---|---|---|---|---|---|
attribute_set_id | attribute_set_id | Equals | aktiviert | Skip Rule | leer |
Bedeutung:
- Das Modul übernimmt
attribute_set_idaus dem aktuellen Produkt. - Anschließend findet es Produkte mit derselben
attribute_set_id. Requiredbedeutet, dass das Zielprodukt diese Regel erfüllen muss.
Alternative Regelbeispiele:
brand->brand, OperatorEquals: Produkte derselben Marke.category_ids->category_ids, OperatorCategory Intersects: Produkte aus mindestens einer gemeinsamen Kategorie.color->color, OperatorEquals: Produkte mit derselben Farbe.
5. Bereich Target Product Filters
Fügen Sie einen Filter hinzu:
| Attributcode | Operator | Wert |
|---|---|---|
status | Equals | 1 |
Bedeutung:
- Aus den Ergebnissen werden nur aktive Produkte angezeigt.
Optional können Sie einen Sichtbarkeitsfilter hinzufügen:
| Attributcode | Operator | Wert |
|---|---|---|
visibility | In List | 2,3,4 |
6. Bereich Sorting & Display
Legen Sie fest:
Sort Attribute:entity_idSort Direction:DESCSecondary Sort Attribute: leerSecondary Sort Direction:NoneTitle:Related ProductsSubtitle: leerProducts Limit:8Template Variant:SliderImage Role:category_page_gridShow Price: aktiviertShow Old Price: nicht aktiviertShow Add To Cart: aktiviertShow Product Name: aktiviertShow Short Description: nicht aktiviertShow Badges: nicht aktiviertHide If Empty: aktiviertExclude Current Product: aktiviertExclude Quote Products: aktiviertExclude Out Of Stock: aktiviert
Bedeutung der wichtigsten Felder:
Template Variantsteuert das Aussehen der Liste:Grid,SlideroderCompact.Products Limitbegrenzt die Anzahl der Produkte in den Ergebnissen.Exclude Current Productverhindert, dass das aktuell angesehene Produkt in den Ergebnissen angezeigt wird.Exclude Out Of Stockentfernt nicht verfügbare Produkte.
7. Bereich Native Magento Lists
Für Related Products legen Sie fest:
- Checkbox
Related Products: aktiviert Mode:ReplacePosition:Magento default position
Bedeutung:
- Das Aktivieren der Checkbox bedeutet, dass das Modul den nativen Magento-Block
Related Productsübernimmt. Replacebedeutet, dass im übernommenen Block nur Produkte aus dem Profil angezeigt werden.Appendbedeutet, dass das Modul native Magento-Produkte plus Produkte aus dem Profil anzeigt.Positionermöglicht es, den Block an eine andere Stelle der Produktseite zu verschieben.
Beispielpositionen:
Magento default position: belässt den Block an der vom Magento-Theme festgelegten Stelle.sidebar.additional: verschiebt den Block in die zusätzliche Sidebar.sidebar.main: verschiebt den Block in die Haupt-Sidebar.content: verschiebt den Block in den Hauptinhalt der Seite.content.aside: verschiebt den Block in den seitlichen Content-Bereich.product.info.main: verschiebt den Block in die Hauptspalte der Produktinformationen.product.info.media: verschiebt den Block in den Bereich der Produktgalerie.product.info.details: verschiebt den Block in den Bereich der Produktdetails oder Tabs.
Wenn der ausgewählte Container im aktuellen Theme nicht existiert, belässt Magento den Block an der Standardposition.
Für Upsell Products und Crosssell Products bleiben die Checkboxen in diesem Beispiel deaktiviert.
8. Bereich Layout XML
Lassen Sie für dieses Beispiel die Felder leer:
Product Page XML: leerEdit Cart XML: leerCheckout XML: leer
Sie müssen kein XML hinzufügen, wenn Sie den Bereich Native Magento Lists verwenden. XML ist dann nützlich, wenn das Profil als zusätzlicher Modulblock außerhalb nativer Magento-Listen gerendert werden soll.
9. Profil speichern
Klicken Sie auf:
Save Profile, um zu speichern und zur Profilliste zurückzukehrenSave and Continue, um zu speichern und im Formular zu bleiben
Leeren Sie nach dem Speichern den Magento-Cache, wenn das Ergebnis im Frontend nicht sofort sichtbar ist.
Beispielkonfiguration von Upsell in der Sidebar
Wenn Sie Upsell Products nach sidebar.additional verschieben möchten:
- Wählen Sie in
PlacementsProduct Page. - Aktivieren Sie in
Native Magento ListsUpsell Products. - Legen Sie
Modefest:Append, wenn Sie native Magento-Upsells plus Produkte des Profils anzeigen möchten.Replace, wenn Sie nur Produkte des Profils anzeigen möchten.
- Legen Sie
Positionfest:Additional sidebar - sidebar.additional. - Wählen Sie
Template Variant: In der Regel passtCompactgut zur Sidebar.
Beispielkonfiguration von Crosssell im Warenkorb
Für Crosssell:
- Wählen Sie in
PlacementsEdit Cart. - Aktivieren Sie in
Native Magento ListsCrosssell Products. - Legen Sie
Modefest: meistensReplace. Positionist für Crosssell nicht verfügbar, da die Positionierung aktuell nur Blöcke auf der Produktseite betrifft.
Diagnose
Wenn das Profil keine Produkte anzeigt:
- Prüfen Sie, ob das Modul in der Konfiguration aktiviert ist.
- Prüfen Sie, ob beim Profil
Is Activeaktiviert ist. - Prüfen Sie, ob
Placementszu der Stelle passt, an der Sie das Profil testen. - Prüfen Sie die Bedingungen in
Activation Conditions. - Prüfen Sie, ob das Kontextprodukt die Attributwerte besitzt, die in
Matching Rulesverwendet werden. - Deaktivieren Sie vorübergehend
Exclude Out Of Stock, wenn Sie mit Produkten ohne Lagerbestände testen. - Aktivieren Sie
Enable Debug Loggingnur für die Dauer der Diagnose.
Befehle nach der Bereitstellung von Änderungen
Führen Sie nach der Aktualisierung des Moduls aus:
php bin/magento setup:upgradephp bin/magento cache:flushFühren Sie im Produktionsmodus zusätzlich aus:
php bin/magento setup:di:compileVersion: 1.1.22
22.05.2026
Hinzugefügt
- Data Patch zur Installation von Beispielprofildaten mit drei Standardprofilen hinzugefügt:
relatedcrosselupsell
- Positionsverwaltung für native Produktseiten-Blöcke für Related- und Upsell-Blöcke hinzugefügt.
- Admin-Dropdowns für Positionen von Related- und Upsell-Blöcken hinzugefügt.
- Unterstützte Positionsziele auf Produktseiten hinzugefügt:
contentcontent.asidesidebar.mainsidebar.additionalproduct.info.mainproduct.info.mediaproduct.info.details
- Profilfelder
related_block_positionundupsell_block_positionhinzugefügt.
Geändert
- Die native Magento-Injektion für Related, Upsell und Crosssell ersetzt jetzt die Ausgabe des nativen Blocks durch die vom Modul gerenderte Ausgabe, wenn die entsprechende Checkbox aktiviert ist.
- Der Modus
Appendrendert jetzt native Magento-Produkte plus Profilprodukte innerhalb der Modulausgabe. - Der Modus
Replacerendert jetzt nur Profilprodukte innerhalb der Modulausgabe. - Related Products verwendet standardmäßig den Modus
replace. - Admin-Aktionsbuttons für Profile wurden in Magento-typischer Reihenfolge an den oberen Rand des Formulars verschoben:
- Zurück
- Löschen
- Speichern und fortfahren
- Profil speichern
- Die Admin-ACL- und Menüintegration wurde an die Menüstruktur von
Kowal_Baseangepasst:Kowal.co > Modules > Related Product Profiles > Profiles- die Konfiguration bleibt in der Magento Stores-Konfiguration.
Behoben
- Doppelte Storefront-Ausgabe verhindert, wenn ein Profil durch den Ersatz einer nativen Magento-Liste verarbeitet wird.
- Sichtbarkeit des Menüeintrags Profiles für eingeschränkte Admin-Rollen behoben, indem Menü- und ACL-Ressourcen mit dem Kowal-Modulbaum verknüpft wurden.
- Native Magento-Listenprodukte für den Modus
Appendbeibehalten und gleichzeitig Rekursion während der Sammlung nativer Elemente vermieden.















