Kowal Custom Tab - installazione e configurazione
Requisiti
- Magento 2.4 o versione successiva.
- Accesso alla CLI Magento.
- Composer configurato per scaricare i pacchetti privati Kowal.
- Modulo 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 (indirizzo e-mail del cliente e token di licenza) dopo l'acquisto. Sono disponibili anche nell'area 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
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 Magento:
php bin/magento setup:upgrade
In ambiente di produzione, esegui la compilazione DI e il deployment delle risorse statiche 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 che il modulo sia 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 sul frontend.Field type - tipo di origine del contenuto.Attribute code - attributo prodotto da cui deve essere recuperato il contenuto della scheda.Status - 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 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 userà il valore predefinito da store_id = 0.
Funzionamento sul frontend
Il modulo aggiunge le schede alla sezione dei dettagli prodotto. La scheda appare 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 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 Magento. Dopo il primo salvataggio di una scheda esistente, il suo nome predefinito verrà salvato anche come record store_id = 0.
Risoluzione dei problemi
Se la scheda non appare sul frontend:
- Controlla che il modulo sia abilitato nella configurazione.
- Controlla che la scheda abbia
Status impostato su Yes. - Controlla che il prodotto abbia un valore compilato nell'attributo indicato nel campo
Attribute code. - Svuota la cache Magento.
- Assicurati che il layout del tema renderizzi ancora il blocco
product.info.details.
Se la traduzione del nome non appare sul frontend:
- Controlla di modificare lo Store View corretto.
- Controlla che
Use Default Value sia deselezionato per il campo Name. - Salva la scheda e svuota la cache.
