Kowal Custom Tab - instalacja i konfiguracja

Wymagania

• Magento 2.4 lub nowsze.
• Dostęp do CLI Magento.
• Composer skonfigurowany do pobierania prywatnych pakietów Kowal.
• Zainstalowany moduł bazowy kowal/base.
• Uprawnienia administratora do panelu Magento.

Instalacja przez Composer

Dodaj repozytorium pakietu:

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

Jeżeli repozytorium wymaga autoryzacji, skonfiguruj token:

composer config --global --auth github-oauth.github.com <YOUR_TOKEN>

Zainstaluj moduł:

composer require kowal/module-customtab

Wykonaj aktualizację Magento:

php bin/magento setup:upgrade

W środowisku produkcyjnym wykonaj kompilację DI oraz wdrożenie statycznych zasobów zgodnie z procesem projektu:

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

Wyczyść cache:

php bin/magento cache:flush

Weryfikacja instalacji

Sprawdź, czy moduł jest aktywny:

php bin/magento module:status Kowal_CustomTab

Jeżeli moduł jest nieaktywny, włącz go:

php bin/magento module:enable Kowal_CustomTab
php bin/magento setup:upgrade
php bin/magento cache:flush

Konfiguracja modułu

W panelu Magento przejdź do:

Stores > Configuration > Kowal > Custom Tab

Ustaw opcję Enable module na Yes, a następnie zapisz konfigurację i wyczyść cache, jeśli Magento o to poprosi.

Zarządzanie zakładkami

W panelu administracyjnym przejdź do:

Kowal > Custom Tabs > Custom Tab

Kliknij Add new CustomTab, aby utworzyć nową zakładkę.

Uzupełnij pola:

• Name - nazwa zakładki widoczna na froncie.
• Field type - typ źródła treści.
• Attribute code - atrybut produktu, z którego ma zostać pobrana treść zakładki.
• Status - aktywność zakładki.
• Sort Order - kolejność wyświetlania zakładki.

Zapisz zakładkę.

Tłumaczenie nazwy zakładki

Domyślna nazwa zakładki jest zapisywana dla store_id = 0.

Aby dodać tłumaczenie dla konkretnego Store View:

1. Otwórz istniejącą zakładkę w edycji.
2. Użyj przełącznika Store View w prawym górnym obszarze formularza.
3. Wybierz Store View, dla którego chcesz zmienić nazwę.
4. Odznacz Use Default Value przy polu Name.
5. Wpisz nazwę zakładki dla wybranej wersji językowej.
6. Zapisz formularz.

Jeżeli Use Default Value pozostaje zaznaczone, moduł użyje wartości domyślnej z store_id = 0.

Działanie na froncie

Moduł dodaje zakładki do sekcji szczegółów produktu. Zakładka pojawia się tylko wtedy, gdy produkt ma uzupełnioną wartość w atrybucie wskazanym w konfiguracji zakładki.

Dla nazwy zakładki moduł stosuje fallback:

1. Nazwa dla bieżącego Store View.
2. Nazwa domyślna z store_id = 0.
3. Wartość z głównej tabeli zakładek, zachowana dla kompatybilności.

Treść zakładki jest filtrowana przez mechanizm CMS Magento, dlatego może zawierać obsługiwane przez Magento znaczniki HTML i widgety.

Aktualizacja istniejącej instalacji

Po aktualizacji modułu do wersji z obsługą wielu języków uruchom:

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

Nowa tabela wartości per Store View zostanie dodana przez deklaratywny schemat Magento. Po pierwszym zapisie istniejącej zakładki jej domyślna nazwa zostanie utrwalona również jako rekord store_id = 0.

Rozwiązywanie problemów

Jeżeli zakładka nie pojawia się na froncie:

• Sprawdź, czy moduł jest włączony w konfiguracji.
• Sprawdź, czy zakładka ma Status ustawiony na Yes.
• Sprawdź, czy produkt ma uzupełnioną wartość w atrybucie wskazanym w polu Attribute code.
• Wyczyść cache Magento.
• Upewnij się, że layout motywu nadal renderuje blok product.info.details.

Jeżeli tłumaczenie nazwy nie pojawia się na froncie:

• Sprawdź, czy edytujesz właściwy Store View.
• Sprawdź, czy Use Default Value jest odznaczone dla pola Name.
• Zapisz zakładkę i wyczyść cache.