Kowal Custom Tab - instalare și configurare

Cerințe

• Magento 2.4 sau mai nou.
• Acces la CLI Magento.
• Composer configurat pentru descărcarea pachetelor private Kowal.
• Modulul de bază kowal/base instalat.
• Permisiuni de administrator pentru panoul Magento.

Instalare prin Composer

Adăugați repozitoriul pachetului:

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

Dacă repozitoriul necesită autorizare, configurați tokenul:

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

Instalați modulul:

composer require kowal/module-customtab

Rulați actualizarea Magento:

php bin/magento setup:upgrade

În mediul de producție, rulați compilarea DI și implementarea resurselor statice conform procesului proiectului:

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

Curățați cache-ul:

php bin/magento cache:flush

Verificarea instalării

Verificați dacă modulul este activ:

php bin/magento module:status Kowal_CustomTab

Dacă modulul este inactiv, activați-l:

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

Configurarea modulului

În panoul Magento, accesați:

Stores > Configuration > Kowal > Custom Tab

Setați opțiunea Enable module la Yes, apoi salvați configurația și curățați cache-ul dacă Magento solicită acest lucru.

Gestionarea filelor

În panoul administrativ, accesați:

Kowal > Custom Tabs > Custom Tab

Faceți clic pe Add new CustomTab pentru a crea o filă nouă.

Completați câmpurile:

• Name - numele filei vizibil pe frontend.
• Field type - tipul sursei de conținut.
• Attribute code - atributul produsului din care urmează să fie preluat conținutul filei.
• Status - activitatea filei.
• Sort Order - ordinea de afișare a filei.

Salvați fila.

Traducerea numelui filei

Numele implicit al filei este salvat pentru store_id = 0.

Pentru a adăuga o traducere pentru un anumit Store View:

1. Deschideți fila existentă pentru editare.
2. Folosiți comutatorul Store View din zona din dreapta sus a formularului.
3. Selectați Store View pentru care doriți să modificați numele.
4. Debifați Use Default Value la câmpul Name.
5. Introduceți numele filei pentru versiunea lingvistică selectată.
6. Salvați formularul.

Dacă Use Default Value rămâne bifat, modulul va folosi valoarea implicită din store_id = 0.

Funcționarea pe frontend

Modulul adaugă file în secțiunea de detalii ale produsului. Fila apare doar atunci când produsul are completată o valoare în atributul indicat în configurația filei.

Pentru numele filei, modulul aplică fallback:

1. Numele pentru Store View curent.
2. Numele implicit din store_id = 0.
3. Valoarea din tabelul principal al filelor, păstrată pentru compatibilitate.

Conținutul filei este filtrat de mecanismul CMS Magento, de aceea poate conține taguri HTML și widgeturi acceptate de Magento.

Actualizarea unei instalări existente

După actualizarea modulului la versiunea cu suport pentru mai multe limbi, rulați:

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

Noua tabelă de valori per Store View va fi adăugată de schema declarativă Magento. După prima salvare a filei existente, numele său implicit va fi persistat și ca înregistrare store_id = 0.

Soluționarea problemelor

Dacă fila nu apare pe frontend:

• Verificați dacă modulul este activat în configurație.
• Verificați dacă fila are Status setat la Yes.
• Verificați dacă produsul are completată o valoare în atributul indicat în câmpul Attribute code.
• Curățați cache-ul Magento.
• Asigurați-vă că layoutul temei redă în continuare blocul product.info.details.

Dacă traducerea numelui nu apare pe frontend:

• Verificați dacă editați Store View corect.
• Verificați dacă Use Default Value este debifat pentru câmpul Name.
• Salvați fila și curățați cache-ul.