Sincronizarea conținutului produselor între vizualizări și magazine Magento independente

Sunt necesare Magento 2, PHP ^8.1, extensia cURL, acces la CLI și panoul de administrare și modulele Magento Catalog, Store, Ui, Backend și Config. Produsele sursă și destinație trebuie să existe. Transferurile la distanță necesită coduri și tipuri de atribute compatibile, atribuite seturilor de atribute ale produselor.

Înainte de instalare, creează o copie de siguranță a bazei de date și a fișierelor de configurare, inclusiv cheia de criptare din app/etc/env.php. Testează prima mapare într-un mediu de testare.

Execută comenzile în directorul rădăcină Magento după configurarea depozitului și a accesului la pachetul achiziționat:

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

Dacă utilizezi acces VCS la depozitul indicat în documentație, adaugă-l înainte de instalare:

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

Accesul la depozitul privat necesită permisiuni și autentificare Composer. Nu include tokenuri în scripturi publice sau în depozitul proiectului.

În modul de producție, efectuează și compilarea și implementarea resurselor statice, alegând limbile utilizate de magazin:

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

Pentru actualizarea unei instalări existente, folosește composer update kowal/module-product-attribute-copy --with-dependencies, apoi execută setup:upgrade, pașii de producție necesari și reîmprospătarea cache-ului. Nu înlocui manual fișierele din vendor.

Deschide Stores > Configuration > Catalog > Product Attribute Copy.

1. Verifică dacă Enabled are valoarea Yes.
2. În Attributes > Allowed Attributes, selectează câmpurile permise, de exemplu name, description, short_description și anumite specificații. Lista este goală implicit: valorile atributelor nu sunt copiate până când nu o completezi.
3. Verifică Excluded Attributes. Excluderile au prioritate față de lista permisă. Păstrează excluderile câmpurilor tehnice.
4. Stabilește Copy After Product Save și Copy on Mapping Save. La primul test, dezactivează execuția automată și copiază manual.
5. Pentru mapările locale, alege Copy Gallery. Păstrează Replace Target Gallery = No dacă dorești să păstrezi imaginile suplimentare din destinație. Activarea replace elimină intrările absente din sursă.
6. În Store Views > Excluded Target Store Views, exclude vizualizările locale care nu trebuie să fie destinații de copiere.
7. Salvează configurarea. Activarea Log Successful Copies facilitează verificarea primelor operațiuni.

Implicit, modulul și Copy After Product Save sunt activate, Copy on Mapping Save este dezactivat, galeria utilizează merge, iar jurnalizarea operațiunilor reușite este activă.

În domeniul Default Config, deschide Remote Magento Stores. Adaugă un rând separat pentru fiecare vizualizare la distanță.

• Name: un nume de conexiune ușor de recunoscut.
• Magento Base URL (HTTPS): adresa de bază Magento, fără /rest, parametri sau date de autentificare.
• Store View Code și Store View ID: codul unei anumite vizualizări active și ID-ul corespunzător mai mare decât 0. Nu utiliza all sau admin.
• Timeout: de la 1 la 120 de secunde; un câmp gol înseamnă 30 de secunde.
• API Bearer Token: un token acceptat ca Bearer independent de instalarea la distanță.

Tokenul necesită acces la produse (Magento_Catalog::products), definiții și opțiuni ale atributelor (Magento_Catalog::attributes_attributes) și lista vizualizărilor (Magento_Backend::store). Exportul necesită dreptul de a salva produse. Modulul nu reînnoiește tokenuri expirate și nu acceptă semnături OAuth 1.0a.

Tokenurile sunt criptate și mascate în formular. Identificatorul conexiunii este generat automat și păstrat la editare. Magazinul la distanță nu necesită instalarea acestui modul. Înainte de copiere, modulul verifică dacă se potrivesc codul și ID-ul vizualizării.

Accesează Catalog > Product Attribute Copy > Mappings și selectează Add New Mapping.

• Local: alege produsul și vizualizarea sursă locale, apoi produsul și vizualizarea destinație.
• Remote → Local (import): alege conexiunea, introdu SKU-ul la distanță și indică produsul și vizualizarea destinație locale.
• Local → Remote (export): indică produsul și vizualizarea sursă locale, conexiunea și SKU-ul unui produs existent la distanță.

Activează maparea și salvează. Sursa și destinația nu pot fi același produs în aceeași vizualizare locală. Mapările duplicate și vizualizările locale de destinație excluse sunt blocate. Setările destinației locale controlează importul, iar cele ale sursei locale controlează exportul.

Folosește Copy Now pentru o mapare sau Copy Selected pentru înregistrările selectate. Verifică valorile destinație și jurnalele înainte de a porni un lot mai mare.

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 se aplică mapărilor locale și exportului după salvarea produsului sursă local în panou. Execută importul la distanță manual sau prin CLI. Poți organiza o programare externă; modulul nu detectează singur modificările din magazinul la distanță.

Istoricul este disponibil în Catalog > Product Attribute Copy > Copy Logs. Verifică starea, mesajul, direcția, conexiunea și SKU-ul la distanță.

• Nu sunt copiate valori: verifică Allowed Attributes, excluderile, dacă maparea este activă și configurarea vizualizării locale corespunzătoare.
• Eroare select/multiselect: compară etichetele implicite/admin exacte și unice ale opțiunilor din ambele magazine.
• Eroare API: verifică URL-ul HTTPS, certificatul, permisiunile și valabilitatea tokenului, SKU-ul la distanță și codul și ID-ul vizualizării.
• După expirarea timpului de export, verifică produsul la distanță înainte de a reîncerca. Este posibil ca salvarea la distanță să se fi finalizat în ciuda erorii de conexiune.
• După actualizare, reîmprospătează cache-urile config/layout/block_html și redeschide formularul de mapare.

Sincronizarea galeriilor este exclusiv locală. Nu sunt create produse, definiții de atribute, opțiuni sau traduceri. Nu sunt transferate galerii la distanță, căi de imagini, relații cu categorii sau prețuri complexe. Domeniile standard ale atributelor Magento rămân valabile; un atribut global poate afecta mai multe vizualizări.