Kowal Product Info - istruzioni di installazione e configurazione

Requisiti

• Magento 2 con il moduloMagento_Catalog.
• Accesso alla console del server.
• Autorizzazioni per eseguire i comandibin/magento.
• Accesso amministratore al pannello Magento.

Installazione tramite Composer

1. Aggiungi il repository del modulo:

I dati di accesso al repository Composer, ovvero l indirizzo e-mail del cliente e il token di licenza, saranno inviati via e-mail dopo l acquisto. Sono disponibili anche nel pannello cliente dopo l accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di Magento.

composer config repositories.kowal composer https://repo.kowal.store

composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"

composer require kowal/module-productinfo

php bin/magento module:enable Kowal_ProductInfo

php bin/magento setup:upgrade

Questo comando aggiungerà:

• l’attributo prodottokowal_product_info_display,
• le tabellekowal_productinfo_icon_groupekowal_productinfo_icon.

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

php bin/magento cache:flush

Installazione manuale

1. Copia il modulo nella directory:

app/code/Kowal/ProductInfo

php bin/magento module:enable Kowal_ProductInfo
php bin/magento setup:upgrade
php bin/magento cache:flush

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

Configurazione globale

Pannello di amministrazione:

Stores > Configuration > Kowal > Product info

Impostazioni

La sezioneUstawieniacontrolla il blocco di icone di base.

• Wlacz- abilita o disabilita il blocco di base nella scheda prodotto.
• Naglowek nad ikonami- intestazione visibile sopra il set di icone di base.

Informazioni 1-7

Le sezioni daInformacja 1inInformacja 7definiscono 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 di icone dinamici

La sezioneDynamiczne grupy ikoncontrolla la nuova funzione di assegnazione dei gruppi di icone ai prodotti.

• Wlacz dynamiczne grupy na karcie produktu- abilita il rendering dei gruppi dinamici sulla PDP.
• Maksymalna liczba grup na produkcie- limite dei gruppi visualizzati su una singola scheda prodotto;0indica 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 globaleWlacz.
• Wlacz na tym produkcie- il blocco di icone di base viene mostrato anche quando è disabilitato a livello globale.
• Wylacz na tym produkcie- il blocco di icone di base viene nascosto anche quando è abilitato a livello globale.

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

Gestione dei gruppi di icone dinamici

Pannello di amministrazione:

Kowal > Product Info > Grupy ikon

Aggiunta di un gruppo

1. CliccaDodaj grupe ikon.
2. ImpostaStatus.
3. InserisciNazwa techniczna.
4. Facoltativamente, inserisciNaglowek na karcie produktu.
5. Facoltativamente, inserisciTooltip grupy.
6. ImpostaPriorytet; un valore più basso indica una posizione più alta nella scheda prodotto.
7. SelezionaStore View;All Store Viewsindica tutte le viste negozio.
8. SelezionaTyp dopasowania.
9. CompilaSKUoID kategorii, in base al tipo di corrispondenza selezionato.
10. Aggiungi le icone nella sezioneIkony w grupie.
11. Salva il gruppo.

Tipi di corrispondenza

• SKU lub kategoria- il gruppo verrà visualizzato se il prodotto corrisponde per SKU o per categoria.
• Tylko SKU- il gruppo verrà visualizzato solo per i prodotti con gli SKU indicati.
• Tylko kategoria- il gruppo verrà visualizzato 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 fornisce il widget:

Product Info

Il widget visualizza il set di informazioni di base dalla configurazione globale in un layout orizzontale. I gruppi di icone dinamici 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 l’impostazioneDziedzicz z konfiguracji.
2. Un prodotto con l’impostazioneWlacz na tym produkcie.
3. Un prodotto con l’impostazioneWylacz na tym produkcie.
4. Un prodotto assegnato alla categoria utilizzata in un gruppo dinamico.
5. Un prodotto con uno SKU specifico utilizzato in un 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 lo svuotamento della cache.

Cache e distribuzione delle modifiche

Dopo aver modificato la configurazione, i gruppi di icone o i file delle icone, è consigliabile svuotare 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:deploy
php bin/magento cache:flush

Disinstallazione

Disabilita il modulo:

php bin/magento module:disable Kowal_ProductInfo
php bin/magento setup:upgrade
php 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 un backup del database.