Sincronizzazione dei contenuti prodotto tra viste e negozi Magento indipendenti

Sono necessari Magento 2, PHP ^8.1, l’estensione cURL, accesso a CLI e al pannello di amministrazione e i moduli Magento Catalog, Store, Ui, Backend e Config. I prodotti sorgente e destinazione devono esistere. I trasferimenti remoti richiedono codici e tipi di attributo compatibili, assegnati ai set di attributi dei prodotti.

Prima dell’installazione, esegui il backup del database e dei file di configurazione, inclusa la chiave di crittografia in app/etc/env.php. Verifica la prima mappatura in un ambiente di test.

Esegui i comandi nella directory principale di Magento dopo aver configurato il repository e l’accesso al pacchetto acquistato:

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

Se utilizzi l’accesso VCS al repository indicato nella documentazione, aggiungilo prima dell’installazione:

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

L’accesso al repository privato richiede autorizzazioni e autenticazione Composer. Non inserire token in script pubblici o nel repository del progetto.

In modalità produzione, compila e distribuisci anche le risorse statiche scegliendo le lingue utilizzate dal negozio:

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

Per aggiornare un’installazione esistente, utilizza composer update kowal/module-product-attribute-copy --with-dependencies, quindi esegui setup:upgrade, i passaggi di produzione necessari e l’aggiornamento della cache. Non sostituire manualmente i file in vendor.

Apri Stores > Configuration > Catalog > Product Attribute Copy.

1. Verifica che Enabled sia impostato su Yes.
2. In Attributes > Allowed Attributes, seleziona i campi consentiti, come name, description, short_description e specifiche selezionate. L’elenco è vuoto per impostazione predefinita: i valori degli attributi non saranno copiati finché non lo compili.
3. Controlla Excluded Attributes. Le esclusioni hanno priorità sull’elenco consentito. Mantieni esclusi i campi tecnici.
4. Imposta Copy After Product Save e Copy on Mapping Save. Per il primo test, disattiva l’esecuzione automatica e copia manualmente.
5. Per le mappature locali, scegli Copy Gallery. Lascia Replace Target Gallery = No per conservare le immagini aggiuntive della destinazione. L’attivazione di replace elimina le voci assenti nella sorgente.
6. In Store Views > Excluded Target Store Views, escludi le viste locali che non devono essere destinazioni di copia.
7. Salva la configurazione. Attivare Log Successful Copies facilita la verifica delle prime operazioni.

Per impostazione predefinita, il modulo e Copy After Product Save sono attivi, Copy on Mapping Save è disattivato, la galleria utilizza merge e la registrazione dei successi è attiva.

Nell’ambito Default Config, apri Remote Magento Stores. Aggiungi una riga distinta per ogni vista remota.

• Name: un nome di connessione riconoscibile.
• Magento Base URL (HTTPS): l’indirizzo di base di Magento, senza /rest, parametri o credenziali.
• Store View Code e Store View ID: il codice di una specifica vista attiva e il relativo ID maggiore di 0. Non utilizzare all o admin.
• Timeout: da 1 a 120 secondi; un campo vuoto equivale a 30 secondi.
• API Bearer Token: un token accettato come Bearer autonomo dall’installazione remota.

Il token deve poter accedere a prodotti (Magento_Catalog::products), definizioni e opzioni degli attributi (Magento_Catalog::attributes_attributes) ed elenco delle viste (Magento_Backend::store). L’esportazione richiede il permesso di salvare i prodotti. Il modulo non rinnova i token scaduti e non supporta firme OAuth 1.0a.

I token sono crittografati e mascherati nel modulo di configurazione. L’identificatore della connessione viene generato automaticamente e conservato durante la modifica. Il negozio remoto non richiede l’installazione di questo modulo. Prima della copia, il modulo verifica la corrispondenza tra codice e ID della vista.

Vai a Catalog > Product Attribute Copy > Mappings e seleziona Add New Mapping.

• Local: scegli prodotto e vista sorgente locali, quindi prodotto e vista di destinazione.
• Remote → Local (import): scegli la connessione, inserisci lo SKU remoto e indica prodotto e vista di destinazione locali.
• Local → Remote (export): indica prodotto e vista sorgente locali, connessione e SKU di un prodotto remoto esistente.

Attiva la mappatura e salvala. Sorgente e destinazione non possono essere lo stesso prodotto nella stessa vista locale. Le mappature duplicate e le viste locali di destinazione escluse vengono bloccate. Le impostazioni della destinazione locale controllano l’importazione; quelle della sorgente locale controllano l’esportazione.

Utilizza Copy Now per una mappatura o Copy Selected per i record selezionati. Controlla i valori di destinazione e i log prima di avviare un lotto più grande.

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 si applica alle mappature locali e all’esportazione dopo il salvataggio del prodotto sorgente locale nel pannello. Esegui le importazioni remote manualmente o tramite CLI. Puoi impostare una pianificazione esterna; il modulo non rileva autonomamente le modifiche nel negozio remoto.

La cronologia è disponibile in Catalog > Product Attribute Copy > Copy Logs. Controlla stato, messaggio, direzione, connessione e SKU remoto.

• Nessun valore copiato: controlla Allowed Attributes, esclusioni, attivazione della mappatura e configurazione della vista locale corretta.
• Errore select/multiselect: confronta le etichette predefinite/admin esatte e univoche delle opzioni in entrambi i negozi.
• Errore API: controlla URL HTTPS, certificato, autorizzazioni e validità del token, SKU remoto e codice e ID della vista.
• Dopo un timeout di esportazione, controlla il prodotto remoto prima di riprovare. Il salvataggio remoto potrebbe essere terminato nonostante l’errore di connessione.
• Dopo un aggiornamento, aggiorna le cache config/layout/block_html e riapri il modulo di mappatura.

La sincronizzazione delle gallerie è esclusivamente locale. Non vengono creati prodotti, definizioni di attributi, opzioni o traduzioni. Non vengono trasferiti gallerie remote, percorsi di immagini, relazioni con categorie o prezzi complessi. Restano validi gli ambiti standard degli attributi Magento; un attributo globale può influire su più viste.