Produktinhalte zwischen Store Views und unabhängigen Magento-Shops synchronisieren

Erforderlich sind Magento 2, PHP ^8.1, die cURL-Erweiterung, CLI- und Adminzugriff sowie die Magento-Module Catalog, Store, Ui, Backend und Config. Quell- und Zielprodukte müssen vorhanden sein. Remote-Übertragungen erfordern kompatible Attributcodes und -typen sowie deren Zuweisung zu den Attributsets der Produkte.

Sichern Sie vor der Installation Datenbank und Konfigurationsdateien einschließlich des Verschlüsselungsschlüssels in app/etc/env.php. Prüfen Sie die erste Zuordnung in einer Testumgebung.

Führen Sie die Befehle im Magento-Hauptverzeichnis aus, nachdem Repository und Zugriff auf das gekaufte Paket eingerichtet wurden:

composer require kowal/module-product-attribute-copy
bin/magento module:enable Kowal_ProductAttributeCopy
bin/magento setup:upgrade

Falls Sie VCS-Zugriff auf das in der Dokumentation genannte Repository nutzen, fügen Sie es vor der Installation hinzu:

composer config repositories.kowal.product.attribute.copy vcs https://github.com/kowalco/module-product-attr-copy

Der Zugriff auf das private Repository erfordert Berechtigungen und Composer-Authentifizierung. Speichern Sie Tokens nicht in öffentlichen Skripten oder im Projekt-Repository.

Im Produktionsmodus kompilieren und deployen Sie zusätzlich statische Dateien mit den für Ihren Shop passenden Sprachen:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy pl_PL en_US
bin/magento cache:flush
bin/magento module:status Kowal_ProductAttributeCopy

Für Aktualisierungen einer vorhandenen Installation verwenden Sie composer update kowal/module-product-attribute-copy --with-dependencies. Führen Sie anschließend setup:upgrade, die erforderlichen Produktionsschritte und die Cache-Aktualisierung aus. Ersetzen Sie Dateien in vendor nicht manuell.

Öffnen Sie Stores > Configuration > Catalog > Product Attribute Copy.

1. Prüfen Sie, ob Enabled auf Yes steht.
2. Wählen Sie unter Attributes > Allowed Attributes zulässige Felder, etwa name, description, short_description und ausgewählte technische Daten. Die Liste ist standardmäßig leer: Ohne Einträge werden keine Attributwerte kopiert.
3. Prüfen Sie Excluded Attributes. Ausschlüsse haben Vorrang vor der Liste zulässiger Attribute. Lassen Sie technische Felder ausgeschlossen.
4. Legen Sie Copy After Product Save und Copy on Mapping Save fest. Deaktivieren Sie beim ersten Test automatische Ausführung und kopieren Sie manuell.
5. Wählen Sie für lokale Zuordnungen Copy Gallery. Belassen Sie Replace Target Gallery = No, wenn zusätzliche Zielbilder erhalten bleiben sollen. replace entfernt Einträge, die in der Quelle fehlen.
6. Schließen Sie unter Store Views > Excluded Target Store Views lokale Ansichten aus, die keine Kopierziele sein sollen.
7. Speichern Sie die Konfiguration. Log Successful Copies erleichtert die Prüfung der ersten Vorgänge.

Standardmäßig sind das Modul und Copy After Product Save aktiviert, Copy on Mapping Save ist deaktiviert, die Galerie nutzt merge, und erfolgreiche Vorgänge werden protokolliert.

Öffnen Sie im Bereich Default Config die Einstellung Remote Magento Stores. Fügen Sie für jeden entfernten Store View eine eigene Zeile hinzu.

• Name: ein verständlicher Verbindungsname.
• Magento Base URL (HTTPS): Magento-Basisadresse ohne /rest, Parameter oder Zugangsdaten.
• Store View Code und Store View ID: Code einer bestimmten aktiven Ansicht und ihre zugehörige ID größer als 0. Verwenden Sie weder all noch admin.
• Timeout: 1 bis 120 Sekunden; ein leeres Feld entspricht 30 Sekunden.
• API Bearer Token: ein Token, das die entfernte Installation als eigenständigen Bearer-Token akzeptiert.

Das Token benötigt Zugriff auf Produkte (Magento_Catalog::products), Attributdefinitionen und Optionen (Magento_Catalog::attributes_attributes) sowie die Store-View-Liste (Magento_Backend::store). Exporte erfordern Schreibzugriff auf Produkte. Das Modul erneuert keine abgelaufenen Tokens und unterstützt keine OAuth-1.0a-Signaturen.

Tokens werden verschlüsselt und im Formular maskiert. Die Verbindungskennung wird automatisch erzeugt und bei Änderungen beibehalten. Im entfernten Shop muss dieses Modul nicht installiert sein. Vor dem Kopieren prüft das Modul, ob Code und ID des Store Views übereinstimmen.

Öffnen Sie Catalog > Product Attribute Copy > Mappings und wählen Sie Add New Mapping.

• Local: Wählen Sie lokales Quellprodukt und Quellansicht sowie Zielprodukt und Zielansicht.
• Remote → Local (import): Wählen Sie die Verbindung, geben Sie die Remote-SKU ein und bestimmen Sie lokales Zielprodukt und Zielansicht.
• Local → Remote (export): Wählen Sie lokales Quellprodukt und Quellansicht, Verbindung und SKU eines vorhandenen entfernten Produkts.

Aktivieren und speichern Sie die Zuordnung. Quelle und Ziel dürfen nicht dasselbe Produkt in derselben lokalen Ansicht sein. Doppelte Zuordnungen und ausgeschlossene lokale Zielansichten werden blockiert. Einstellungen des lokalen Ziels steuern den Import, Einstellungen der lokalen Quelle den Export.

Starten Sie Copy Now für eine Zuordnung oder Copy Selected für ausgewählte Datensätze. Prüfen Sie Zielwerte und Protokolle vor größeren Stapeln.

bin/magento kowal:product-attribute-copy:mapping:list
bin/magento kowal:product-attribute-copy:mapping:list --active-only
bin/magento kowal:product-attribute-copy:copy --mapping-id=1
bin/magento kowal:product-attribute-copy:copy --mapping-id=1 --mapping-id=2
bin/magento kowal:product-attribute-copy:copy --all

Copy After Product Save gilt für lokale Zuordnungen und Exporte nach dem Speichern des lokalen Quellprodukts im Adminbereich. Remote-Importe führen Sie manuell oder per CLI aus. Eine Zeitsteuerung lässt sich extern einrichten; das Modul erkennt Änderungen im entfernten Shop nicht selbstständig.

Den Verlauf finden Sie unter Catalog > Product Attribute Copy > Copy Logs. Prüfen Sie Status, Meldung, Richtung, Verbindung und Remote-SKU.

• Keine kopierten Werte: Prüfen Sie Allowed Attributes, Ausschlüsse, aktive Zuordnung und Konfiguration der richtigen lokalen Ansicht.
• select-/multiselect-Fehler: Vergleichen Sie die exakten, eindeutigen Standard-/Admin-Bezeichnungen der Optionen in beiden Shops.
• API-Fehler: Prüfen Sie HTTPS-URL, Zertifikat, Tokenberechtigungen und -gültigkeit, Remote-SKU sowie Store-View-Code und -ID.
• Prüfen Sie nach einem Export-Timeout das entfernte Produkt vor einem erneuten Versuch. Der Schreibvorgang kann trotz Verbindungsfehler abgeschlossen sein.
• Aktualisieren Sie nach einem Update die Caches config/layout/block_html und öffnen Sie das Zuordnungsformular erneut.

Galeriesynchronisierung ist ausschließlich lokal. Produkte, Attributdefinitionen, Optionen und Übersetzungen werden nicht erstellt. Entfernte Galerien, Bildpfade, Kategoriebeziehungen und komplexe Preise werden nicht übertragen. Die Magento-Attributbereiche gelten weiterhin; ein globales Attribut kann mehrere Ansichten beeinflussen.