Kowal Custom Tab - installazione e configurazione
Requisiti
- Magento 2.4 o versione successiva.
- Accesso alla CLI Magento.
- Composer configurato per scaricare pacchetti privati Kowal.
- Modulo di base
kowal/base installato. - Permessi di amministratore per il pannello Magento.
Installazione tramite Composer
Aggiungi il repository del pacchetto:
Riceverai via e-mail i dati di accesso al repository Composer, ovvero l’indirizzo e-mail del cliente e il token di licenza, dopo l’acquisto. Sono disponibili anche nell’area cliente dopo aver effettuato 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
Configura i dati di accesso al repository Composer Kowal:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Installa il modulo:
composer require kowal/module-customtab
Esegui l’aggiornamento di Magento:
php bin/magento setup:upgrade
In ambiente di produzione, esegui la compilazione DI e il deployment degli asset statici secondo il processo del progetto:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Svuota la cache:
php bin/magento cache:flush
Verifica dell’installazione
Controlla se il modulo è attivo:
php bin/magento module:status Kowal_CustomTab
Se il modulo non è attivo, abilitalo:
php bin/magento module:enable Kowal_CustomTabphp bin/magento setup:upgradephp bin/magento cache:flush
Configurazione del modulo
Nel pannello Magento vai a:
Stores > Configuration > Kowal > Custom Tab
Imposta l’opzione Enable module su Yes, quindi salva la configurazione e svuota la cache se Magento lo richiede.
Gestione delle schede
Nel pannello di amministrazione vai a:
Kowal > Custom Tabs > Custom Tab
Fai clic su Add new CustomTab per creare una nuova scheda.
Compila i campi:
Name - nome della scheda visibile nel frontend.Field type - tipo di sorgente del contenuto.Attribute code - attributo del prodotto da cui deve essere recuperato il contenuto della scheda.Status - stato di attività della scheda.Sort Order - ordine di visualizzazione della scheda.
Salva la scheda.
Traduzione del nome della scheda
Il nome predefinito della scheda viene salvato per store_id = 0.
Per aggiungere una traduzione per uno Store View specifico:
- Apri una scheda esistente in modalità modifica.
- Usa il selettore Store View nell’area in alto a destra del modulo.
- Seleziona lo Store View per cui vuoi modificare il nome.
- Deseleziona
Use Default Value accanto al campo Name. - Inserisci il nome della scheda per la versione linguistica selezionata.
- Salva il modulo.
Se Use Default Value rimane selezionato, il modulo utilizzerà il valore predefinito da store_id = 0.
Funzionamento nel frontend
Il modulo aggiunge schede alla sezione dei dettagli prodotto. La scheda viene visualizzata solo quando il prodotto ha un valore compilato nell’attributo indicato nella configurazione della scheda.
Per il nome della scheda, il modulo applica il fallback:
- Nome per lo Store View corrente.
- Nome predefinito da
store_id = 0. - Valore dalla tabella principale delle schede, mantenuto per compatibilità.
Il contenuto della scheda viene filtrato dal meccanismo CMS di Magento, quindi può contenere tag HTML e widget supportati da Magento.
Aggiornamento di un’installazione esistente
Dopo aver aggiornato il modulo a una versione con supporto multilingua, esegui:
php bin/magento setup:upgradephp bin/magento cache:flush
La nuova tabella dei valori per Store View verrà aggiunta dallo schema dichiarativo di Magento. Dopo il primo salvataggio di una scheda esistente, anche il suo nome predefinito verrà registrato come record store_id = 0.
Risoluzione dei problemi
Se la scheda non viene visualizzata nel frontend:
- Controlla se il modulo è abilitato nella configurazione.
- Controlla se la scheda ha
Status impostato su Yes. - Controlla se il prodotto ha un valore compilato nell’attributo indicato nel campo
Attribute code. - Svuota la cache Magento.
- Assicurati che il layout del tema continui a renderizzare il blocco
product.info.details.
Se la traduzione del nome non viene visualizzata nel frontend:
- Controlla se stai modificando lo Store View corretto.
- Controlla se
Use Default Value è deselezionato per il campo Name. - Salva la scheda e svuota la cache.
