Synchronizacja treści produktów między widokami i niezależnymi sklepami Magento
- Kompatybilność
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
- Obsługa przez AI (MCP)
- Nie
Opis / Synchronizacja treści produktów między widokami i niezależnymi sklepami Magento
MAGENTO 2 · ATRYBUTY · STORE VIEW · REST API
Aktualizuj treści produktów w kilku sklepach bez przepisywania danych
Prowadzisz sklep B2B, detaliczny lub kilka niezależnych instalacji Magento? Każda zmiana opisu oznacza powtarzanie tych samych czynności w kolejnych panelach. Kowal Product Attribute Copy pozwala przekazywać wybrane wartości atrybutów między istniejącymi produktami, korzystając z zapisanych mapowań.
Przygotowujesz treść w wybranym miejscu, wskazujesz zakres kopiowania i uruchamiasz aktualizację. Zespół łatwiej utrzymuje spójne opisy i parametry, zachowując kontrolę nad tym, które dane mają być wspólne.
Jedna treść. Wiele miejsc sprzedaży.
01 · Wybierasz dane
Określasz atrybuty, które mają być wspólne dla produktów.
02 · Zapisujesz mapowania
Łączysz produkty lokalne lub wskazujesz zdalne SKU i połączenie.
03 · Uruchamiasz kopiowanie
Pojedynczo, masowo, z CLI lub po zapisie lokalnego produktu źródłowego.
Trzy kierunki kopiowania
- Lokalnie: między produktami i widokami sklepów w jednej instalacji Magento 2.
- Import ze zdalnego Magento: z produktu w innym sklepie do lokalnego produktu i widoku.
- Eksport do zdalnego Magento: z lokalnego produktu do istniejącego produktu na innym serwerze.
Produkty mogą mieć różne SKU. Zapisane połączenie wskazuje zdalny widok sklepu, a mapowanie łączy lokalny produkt z konkretnym zdalnym SKU. Zdalny sklep korzysta ze standardowego REST API Magento i nie wymaga instalacji tego modułu.
Wybierasz dane, które mają być wspólne
W konfiguracji wskazujesz dozwolone atrybuty, na przykład nazwę, opis, krótki opis i wybrane parametry techniczne. Wykluczenia ograniczają zakres kopiowania. Pola techniczne, takie jak SKU, cena, status, widoczność i stany magazynowe, pozostają poza zakresem kopiowania.
Opcje select i multiselect w wymianie zdalnej są dopasowywane po dokładnie zgodnych, unikalnych etykietach domyślnych/admin. Różne ID opcji nie wymagają ich ręcznego ujednolicania. Brak lub niejednoznaczność dopasowania przerywa mapowanie przed zapisem.
Od pojedynczej zmiany do aktualizacji wielu produktów
- Uruchamiaj pojedyncze mapowania przez Copy Now lub zaznaczone rekordy przez Copy Selected.
- Włącz kopiowanie po zapisie mapowania, jeśli odpowiada to Twojemu procesowi.
- Automatycznie uruchamiaj mapowania lokalne i eksport po zapisie lokalnego produktu źródłowego w panelu.
- Korzystaj z CLI do operacji ręcznych lub własnego zewnętrznego harmonogramu. Import zdalny uruchamiasz ręcznie albo przez CLI.
- Sprawdzaj wyniki, kierunek operacji, połączenie i zdalne SKU w historii kopiowania.
Synchronizacja galerii w jednej instalacji
Dla mapowań lokalnych tryb merge dodaje brakujące zdjęcia i aktualizuje metadane pasujących wpisów. Tryb replace dodatkowo usuwa z galerii docelowej wpisy nieobecne w źródle. Wymiana przez API nie przenosi galerii ani plików zdjęć.
Połączenia zdalne pod kontrolą
Konfigurujesz adres HTTPS, kod i ID zdalnego widoku, token Bearer oraz limit czasu żądania. Tokeny są szyfrowane i maskowane w formularzu. Moduł weryfikuje certyfikat HTTPS oraz zgodność kodu i ID widoku sklepu.
Wymagania i zakres działania
Pakiet kowal/module-product-attribute-copy, moduł Kowal_ProductAttributeCopy, wersja 1.1.4. Wymagania pakietu: Magento 2, PHP ^8.1 i rozszerzenie cURL. Produkty oraz zgodne definicje i przypisania atrybutów muszą istnieć po obu stronach.
Moduł nie tworzy produktów, atrybutów, opcji ani tłumaczeń. Nie przenosi zdalnych galerii, relacji kategorii ani złożonych cen. Zakres atrybutu pozostaje zgodny z Magento: zmiana wartości globalnej może objąć także inne widoki. Zgodność niestandardowych backendów atrybutów wymaga testu w docelowym sklepie.
Wybierz grupę produktów ze wspólnymi treściami i skonfiguruj pierwsze mapowanie, aby uprościć kolejną aktualizację katalogu.
Instrukcja Instalacji modułu
Instalacja i konfiguracja Kowal Product Attribute Copy 1.1.4
Przejdź od instalacji pakietu do pierwszego mapowania. Poniższe kroki obejmują konfigurację lokalną oraz połączenia ze zdalnym Magento.
1. Wymagania i przygotowanie
Wymagane są Magento 2, PHP ^8.1, rozszerzenie cURL, dostęp do CLI i panelu administratora oraz moduły Magento Catalog, Store, Ui, Backend i Config. Produkty źródłowe i docelowe muszą istnieć. Przy wymianie zdalnej wymagane są zgodne kody i typy atrybutów oraz ich przypisanie do zestawów produktów.
Przed instalacją wykonaj kopię bazy i plików konfiguracji, w tym klucza szyfrowania z app/etc/env.php. Pierwsze mapowanie sprawdź na środowisku testowym.
2. Instalacja przez Composer
Uruchom polecenia w katalogu głównym Magento, po skonfigurowaniu repozytorium i dostępu do zakupionego pakietu:
composer require kowal/module-product-attribute-copy
bin/magento module:enable Kowal_ProductAttributeCopy
bin/magento setup:upgrade
Jeżeli korzystasz z dostępu VCS do repozytorium wskazanego w dokumentacji, dodaj je przed instalacją:
composer config repositories.kowal.product.attribute.copy vcs https://github.com/kowalco/module-product-attr-copy
Dostęp do prywatnego repozytorium wymaga uprawnień i uwierzytelnienia Composer. Nie umieszczaj tokenów w publicznych skryptach ani repozytorium projektu.
W trybie produkcyjnym wykonaj również kompilację i wdrożenie zasobów, dobierając języki do sklepu:
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
Przy aktualizacji istniejącej instalacji użyj composer update kowal/module-product-attribute-copy --with-dependencies, a następnie wykonaj setup:upgrade, wymagane kroki produkcyjne i odświeżenie cache. Nie podmieniaj ręcznie plików w vendor.
3. Konfiguracja podstawowa
Otwórz Stores > Configuration > Catalog > Product Attribute Copy.
- Sprawdź, czy Enabled ma wartość Yes.
- W Attributes > Allowed Attributes zaznacz dozwolone pola, np.
name,description,short_descriptioni wybrane parametry. Domyślnie lista jest pusta: bez jej uzupełnienia wartości atrybutów nie będą kopiowane. - Sprawdź Excluded Attributes. Wykluczenia mają pierwszeństwo przed listą dozwoloną. Zachowaj wyłączenia pól technicznych.
- Ustal Copy After Product Save oraz Copy on Mapping Save. Przy pierwszym teście wyłącz automatyczne uruchamianie i wykonaj kopię ręcznie.
- Dla mapowań lokalnych wybierz Copy Gallery. Pozostaw Replace Target Gallery = No, jeśli dodatkowe zdjęcia celu mają zostać zachowane. Włączenie replace usuwa wpisy nieobecne w źródle.
- W Store Views > Excluded Target Store Views wyklucz lokalne widoki, które nie powinny być celem kopiowania.
- Zapisz konfigurację. Włączone Log Successful Copies ułatwi weryfikację pierwszych operacji.
Domyślnie moduł i Copy After Product Save są włączone, Copy on Mapping Save jest wyłączone, galeria działa w trybie merge, a logowanie sukcesów jest aktywne.
4. Połączenie ze zdalnym Magento
W zakresie Default Config otwórz Remote Magento Stores. Dodaj osobny wiersz dla każdego zdalnego widoku.
- Name: czytelna nazwa połączenia.
- Magento Base URL (HTTPS): bazowy adres Magento, bez
/rest, parametrów i danych logowania. - Store View Code i Store View ID: kod konkretnego aktywnego widoku oraz odpowiadające mu ID większe od 0. Nie używaj kodów all ani admin.
- Timeout: od 1 do 120 sekund; puste pole oznacza 30 sekund.
- API Bearer Token: token akceptowany jako samodzielny Bearer przez zdalną instalację.
Token wymaga dostępu do produktów (Magento_Catalog::products), definicji i opcji atrybutów (Magento_Catalog::attributes_attributes) oraz listy widoków (Magento_Backend::store). Eksport wymaga możliwości zapisu produktów. Moduł nie odnawia wygasłych tokenów i nie obsługuje podpisów OAuth 1.0a.
Tokeny są szyfrowane i maskowane w formularzu. Identyfikator połączenia powstaje automatycznie i jest zachowywany przy edycji. Zdalny sklep nie wymaga instalacji tego modułu. Moduł sprawdza zgodność kodu i ID widoku przed kopiowaniem.
5. Utworzenie mapowania
Przejdź do Catalog > Product Attribute Copy > Mappings i wybierz Add New Mapping.
- Local: wybierz lokalny produkt i widok źródłowy oraz produkt i widok docelowy.
- Remote → Local (import): wybierz połączenie, wpisz zdalne SKU oraz wskaż lokalny produkt i widok docelowy.
- Local → Remote (export): wskaż lokalny produkt i widok źródłowy, połączenie oraz SKU istniejącego produktu zdalnego.
Ustaw mapowanie jako aktywne i zapisz. Źródło i cel nie mogą być tym samym produktem w tym samym lokalnym widoku. Duplikaty mapowań i wykluczone lokalne widoki docelowe są blokowane. Ustawienia lokalnego celu sterują importem, a lokalnego źródła — eksportem.
6. Uruchamianie i automatyzacja
Wykonaj Copy Now dla jednego mapowania lub Copy Selected dla zaznaczonych rekordów. Sprawdź wartości celu i logi przed uruchomieniem większej partii.
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 dotyczy mapowań lokalnych i eksportu po zapisie lokalnego produktu źródłowego w panelu. Import zdalny wykonuj ręcznie albo przez CLI. Harmonogram można zorganizować zewnętrznie; moduł nie wykrywa sam zmian w zdalnym sklepie.
7. Kontrola wyników i ograniczenia
Historia jest dostępna w Catalog > Product Attribute Copy > Copy Logs. Sprawdź status, komunikat, kierunek, połączenie i zdalne SKU.
- Brak kopiowanych wartości: sprawdź Allowed Attributes, wykluczenia, aktywność mapowania i konfigurację właściwego lokalnego widoku.
- Błąd select/multiselect: porównaj dokładne i unikalne etykiety domyślne/admin opcji w obu sklepach.
- Błąd API: sprawdź URL HTTPS, certyfikat, uprawnienia i ważność tokenu, zdalne SKU oraz kod i ID widoku.
- Po timeout eksportu sprawdź stan zdalnego produktu przed ponowieniem. Zdalny zapis mógł się zakończyć mimo błędu połączenia.
- Po aktualizacji odśwież cache config/layout/block_html i ponownie otwórz formularz mapowania.
Synchronizacja galerii jest wyłącznie lokalna. Nie są tworzone produkty, definicje atrybutów, opcje ani tłumaczenia. Zdalne galerie, ścieżki obrazów, relacje kategorii i złożone ceny nie są przenoszone. Standardowy zakres atrybutów Magento nadal obowiązuje; atrybut globalny może wpływać na wiele widoków.