Kowal Product Info - istruzioni di installazione e configurazione

Requisiti

• Magento 2 con modulo Magento_Catalog attivo.
• Accesso alla console del server.
• Permessi per eseguire i comandi bin/magento.
• Accesso amministratore al pannello Magento.

Installazione tramite Composer

1. Aggiungi il repository del modulo:

composer config repositories.product.info vcs https://github.com/kowalco/product-info

2. Se il repository è privato, aggiungi il token GitHub:

composer config --global --auth github-oauth.github.com 

3. Installa il modulo:

composer require kowal/module-productinfo

4. Attiva il modulo:

php bin/magento module:enable Kowal_ProductInfo

5. Esegui l’aggiornamento del database:

php bin/magento setup:upgrade

Questo comando aggiungerà:

• l’attributo prodotto kowal_product_info_display,
• le tabelle kowal_productinfo_icon_group e kowal_productinfo_icon.

6. In modalità produzione, ricompila DI e asset statici:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy

7. Pulisci la cache:

php bin/magento cache:flush

Installazione manuale

1. Copia il modulo nella directory:

app/code/Kowal/ProductInfo

2. Esegui:

php bin/magento module:enable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush

3. In modalità produzione, esegui inoltre:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy

Configurazione globale

Pannello di amministrazione:

Stores > Configuration > Kowal > Product info

Impostazioni

La sezione Ustawienia controlla il blocco di icone di base.

• Wlacz - attiva o disattiva il blocco di base nella scheda prodotto.
• Naglowek nad ikonami - titolo visibile sopra il set di icone di base.

Informazioni 1-7

Le sezioni da Informacja 1 a Informacja 7 definiscono il set di icone di base.

Per ogni informazione è possibile impostare:

• Ikona - file SVG, PNG, JPG, JPEG, GIF o WEBP,
• Naglowek - testo visibile accanto all’icona,
• Tresc - contenuto del tooltip.

Il blocco di base viene visualizzato nella scheda prodotto nel layout esistente del modulo.

Gruppi dinamici di icone

La sezione Dynamiczne grupy ikon controlla la nuova funzione di assegnazione dei gruppi di icone ai prodotti.

• Wlacz dynamiczne grupy na karcie produktu - attiva il rendering dei gruppi dinamici sulla PDP.
• Maksymalna liczba grup na produkcie - limite dei gruppi visualizzati in una singola scheda prodotto; 0 indica nessun limite.

Configurazione per prodotto

Nel modulo del prodotto è disponibile l’attributo:

Obecny blok ikon Product Info

Opzioni:

• Dziedzicz z konfiguracji - il prodotto utilizza l’impostazione globale Wlacz.
• Wlacz na tym produkcie - il blocco di icone di base viene mostrato anche quando è disattivato a livello globale.
• Wylacz na tym produkcie - il blocco di icone di base viene nascosto anche quando è attivato a livello globale.

Questa impostazione riguarda solo il blocco di icone di base. I gruppi dinamici sono gestiti separatamente.

Gestione dei gruppi dinamici di icone

Pannello di amministrazione:

Kowal > Product Info > Grupy ikon

Aggiunta di un gruppo

1. Fai clic su Dodaj grupe ikon.
2. Imposta Status.
3. Inserisci Nazwa techniczna.
4. Facoltativamente, inserisci Naglowek na karcie produktu.
5. Facoltativamente, inserisci Tooltip grupy.
6. Imposta Priorytet; un valore più basso indica una posizione più alta nella scheda prodotto.
7. Seleziona Store View; All Store Views indica tutte le viste negozio.
8. Seleziona Typ dopasowania.
9. Completa SKU o ID kategorii, in base al tipo di corrispondenza selezionato.
10. Aggiungi le icone nella sezione Ikony w grupie.
11. Salva il gruppo.

Tipi di corrispondenza

• SKU lub kategoria - il gruppo apparirà se il prodotto corrisponde per SKU oppure per categoria.
• Tylko SKU - il gruppo apparirà solo per i prodotti con gli SKU indicati.
• Tylko kategoria - il gruppo apparirà solo per i prodotti assegnati alle categorie indicate.

SKU e ID categoria possono essere inseriti separati da virgole oppure con ogni valore su una nuova riga.

Configurazione delle icone nel gruppo

Per ogni icona è possibile impostare:

• Status,
• Sort order,
• Tytul,
• Plik ikony,
• Sciezka lub URL ikony,
• Tooltip,
• Usun ikone.

Il file icona caricato sovrascrive il percorso o l’URL inserito manualmente per la riga specifica.

Widget CMS/Page Builder

Il modulo mette a disposizione il widget:

Product Info

Il widget visualizza il set di informazioni di base dalla configurazione globale in un layout orizzontale. I gruppi dinamici di icone sono destinati alle schede prodotto e non vengono renderizzati di default nei widget CMS.

Test dopo la configurazione

Dopo l’installazione e la configurazione, verifica:

1. Un prodotto con impostazione Dziedzicz z konfiguracji.
2. Un prodotto con impostazione Wlacz na tym produkcie.
3. Un prodotto con impostazione Wylacz na tym produkcie.
4. Un prodotto assegnato alla categoria utilizzata nel gruppo dinamico.
5. Un prodotto con uno SKU specifico utilizzato nel gruppo dinamico.
6. Un prodotto senza corrispondenza con alcun gruppo dinamico.
7. I tooltip del blocco di base e dei gruppi dinamici.
8. La correttezza delle icone dopo la pulizia della cache.

Cache e implementazione delle modifiche

Dopo aver modificato la configurazione, i gruppi di icone o i file icona, è consigliato pulire la cache:

php bin/magento cache:flush

Dopo modifiche ai file LESS, JS o ai template in modalità produzione, è necessario ricompilare gli asset statici:

php bin/magento setup:static-content:deployphp bin/magento cache:flush

Disinstallazione

Disattiva il modulo:

php bin/magento module:disable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush

La rimozione dei dati dal database non viene eseguita automaticamente dai comandi sopra indicati. Prima di eliminare manualmente le tabelle e l’attributo prodotto, esegui una copia del database.