Kowal Custom Tab - instalare și configurare
Cerințe
- Magento 2.4 sau o versiune mai nouă.
- Acces la CLI Magento.
- Composer configurat pentru descărcarea pachetelor private Kowal.
- Modulul de bază
kowal/base instalat. - Drepturi de administrator pentru panoul Magento.
Instalare prin Composer
Adaugă repository-ul pachetului:
Datele de acces la repository-ul Composer (adresa de e-mail a clientului și tokenul de licență) le vei primi prin e-mail după achiziție. Sunt disponibile și în panoul clientului după autentificarea pe kowal.store. Înlocuiește TWOJ_EMAIL_KLIENTA cu adresa de e-mail a contului tău, iar TWOJ_TOKEN cu tokenul primit. Execută comenzile în directorul rădăcină Magento.
composer config repositories.kowal composer https://repo.kowal.store
Configurează datele de acces la repository-ul Composer Kowal:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Instalează modulul:
composer require kowal/module-customtab
Efectuează actualizarea Magento:
php bin/magento setup:upgrade
În mediul de producție, efectuează compilarea DI și deploymentul resurselor statice conform procesului proiectului:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Golește cache-ul:
php bin/magento cache:flush
Verificarea instalării
Verifică dacă modulul este activ:
php bin/magento module:status Kowal_CustomTab
Dacă modulul este inactiv, activează-l:
php bin/magento module:enable Kowal_CustomTabphp bin/magento setup:upgradephp bin/magento cache:flush
Configurarea modulului
În panoul Magento, mergi la:
Stores > Configuration > Kowal > Custom Tab
Setează opțiunea Enable module pe Yes, apoi salvează configurația și golește cache-ul dacă Magento solicită acest lucru.
Gestionarea filelor
În panoul de administrare, mergi la:
Kowal > Custom Tabs > Custom Tab
Apasă Add new CustomTab pentru a crea o filă nouă.
Completează câmpurile:
Name - denumirea filei vizibilă pe frontend.Field type - tipul sursei de conținut.Attribute code - atributul produsului din care va fi preluat conținutul filei.Status - activitatea filei.Sort Order - ordinea de afișare a filei.
Salvează fila.
Traducerea denumirii filei
Denumirea implicită a filei este salvată pentru store_id = 0.
Pentru a adăuga o traducere pentru un anumit Store View:
- Deschide fila existentă în modul de editare.
- Folosește comutatorul Store View din zona dreapta sus a formularului.
- Alege Store View pentru care vrei să modifici denumirea.
- Debifează
Use Default Value la câmpul Name. - Introdu denumirea filei pentru versiunea lingvistică aleasă.
- Salvează 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 configurarea filei.
Pentru denumirea filei, modulul folosește fallback:
- Denumirea pentru Store View curent.
- Denumirea implicită din
store_id = 0. - Valoarea din tabelul principal al filelor, păstrată pentru compatibilitate.
Conținutul filei este filtrat prin 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, rulează:
php bin/magento setup:upgradephp bin/magento cache:flush
Noul tabel de valori per Store View va fi adăugat prin schema declarativă Magento. După prima salvare a unei file existente, denumirea sa implicită va fi persistată și ca înregistrare store_id = 0.
Depanare
Dacă fila nu apare pe frontend:
- Verifică dacă modulul este activat în configurație.
- Verifică dacă fila are
Status setat pe Yes. - Verifică dacă produsul are completată o valoare în atributul indicat în câmpul
Attribute code. - Golește cache-ul Magento.
- Asigură-te că layoutul temei continuă să randeze blocul
product.info.details.
Dacă traducerea denumirii nu apare pe frontend:
- Verifică dacă editezi Store View corect.
- Verifică dacă
Use Default Value este debifat pentru câmpul Name. - Salvează fila și golește cache-ul.
