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 di base installato kowal/base.
• Permessi di amministratore per il pannello Magento.

Installazione tramite Composer

Aggiungi il repository del pacchetto:

composer config repositories.custom.tab vcs https://github.com/kowalco/magento-2-custom-tab

Se il repository richiede autorizzazione, configura il token:

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

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 deploy 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 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 tab

Nel pannello di amministrazione vai a:

Kowal > Custom Tabs > Custom Tab

Fai clic su Add new CustomTab per creare una nuova tab.

Compila i campi:

• Name - nome della tab visibile sul frontend.
• Field type - tipo di sorgente del contenuto.
• Attribute code - attributo del prodotto da cui deve essere recuperato il contenuto della tab.
• Status - stato di attivazione della tab.
• Sort Order - ordine di visualizzazione della tab.

Salva la tab.

Traduzione del nome della tab

Il nome predefinito della tab viene salvato per store_id = 0.

Per aggiungere una traduzione per uno specifico Store View:

1. Apri in modifica una tab esistente.
2. Usa il selettore Store View nell'area in alto a destra del form.
3. Seleziona lo Store View per cui desideri modificare il nome.
4. Deseleziona Use Default Value accanto al campo Name.
5. Inserisci il nome della tab per la versione linguistica selezionata.
6. Salva il form.

Se Use Default Value rimane selezionato, il modulo utilizzerà il valore predefinito da store_id = 0.

Funzionamento sul frontend

Il modulo aggiunge le tab alla sezione dei dettagli prodotto. La tab viene visualizzata solo quando il prodotto ha un valore compilato nell'attributo indicato nella configurazione della tab.

Per il nome della tab il modulo applica il fallback:

1. Nome per lo Store View corrente.
2. Nome predefinito da store_id = 0.
3. Valore dalla tabella principale delle tab, mantenuto per compatibilità.

Il contenuto della tab 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 alla versione con supporto multilingua, esegui:

php bin/magento setup:upgradephp bin/magento cache:flush

La nuova tabella dei valori per Store View verrà aggiunta tramite lo schema dichiarativo di Magento. Dopo il primo salvataggio di una tab esistente, il suo nome predefinito verrà salvato anche come record store_id = 0.

Risoluzione dei problemi

Se la tab non viene visualizzata sul frontend:

• Controlla che il modulo sia abilitato nella configurazione.
• Controlla che la tab 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 viene visualizzata sul frontend:

• Controlla di modificare lo Store View corretto.
• Controlla che Use Default Value sia deselezionato per il campo Name.
• Salva la tab e svuota la cache.