Kowal Custom Tab - installatie en configuratie

Vereisten

• Magento 2.4 of nieuwer.
• Toegang tot Magento CLI.
• Composer geconfigureerd voor het downloaden van private Kowal-pakketten.
• Geïnstalleerde basismodule kowal/base.
• Beheerdersrechten voor het Magento-paneel.

Installatie via Composer

Voeg de pakketrepository toe:

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

Als de repository autorisatie vereist, configureer dan de token:

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

Installeer de module:

composer require kowal/module-customtab

Voer de Magento-update uit:

php bin/magento setup:upgrade

Voer in een productieomgeving de DI-compilatie en de deployment van statische assets uit volgens het projectproces:

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

Leeg de cache:

php bin/magento cache:flush

Installatie verifiëren

Controleer of de module actief is:

php bin/magento module:status Kowal_CustomTab

Als de module inactief is, schakel deze dan in:

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

Moduleconfiguratie

Ga in het Magento-paneel naar:

Stores > Configuration > Kowal > Custom Tab

Zet de optie Enable module op Yes, sla vervolgens de configuratie op en leeg de cache als Magento daarom vraagt.

Tabbladen beheren

Ga in het beheerpaneel naar:

Kowal > Custom Tabs > Custom Tab

Klik op Add new CustomTab om een nieuw tabblad aan te maken.

Vul de velden in:

• Name - naam van het tabblad die zichtbaar is aan de frontend.
• Field type - type inhoudsbron.
• Attribute code - productattribuut waaruit de inhoud van het tabblad moet worden opgehaald.
• Status - activiteit van het tabblad.
• Sort Order - weergavevolgorde van het tabblad.

Sla het tabblad op.

Tabbladnaam vertalen

De standaardnaam van het tabblad wordt opgeslagen voor store_id = 0.

Om een vertaling voor een specifieke Store View toe te voegen:

1. Open een bestaand tabblad om het te bewerken.
2. Gebruik de Store View-schakelaar rechtsboven in het formulier.
3. Selecteer de Store View waarvoor u de naam wilt wijzigen.
4. Schakel Use Default Value uit bij het veld Name.
5. Voer de tabbladnaam in voor de geselecteerde taalversie.
6. Sla het formulier op.

Als Use Default Value aangevinkt blijft, gebruikt de module de standaardwaarde uit store_id = 0.

Werking aan de frontend

De module voegt tabbladen toe aan de sectie met productdetails. Het tabblad verschijnt alleen wanneer het product een ingevulde waarde heeft in het attribuut dat in de tabbladconfiguratie is aangegeven.

Voor de tabbladnaam gebruikt de module een fallback:

1. Naam voor de huidige Store View.
2. Standaardnaam uit store_id = 0.
3. Waarde uit de hoofdtabel met tabbladen, behouden voor compatibiliteit.

De inhoud van het tabblad wordt gefilterd door het Magento CMS-mechanisme en kan daarom door Magento ondersteunde HTML-tags en widgets bevatten.

Bestaande installatie bijwerken

Voer na het bijwerken van de module naar een versie met ondersteuning voor meerdere talen het volgende uit:

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

De nieuwe tabel met waarden per Store View wordt toegevoegd door het declaratieve schema van Magento. Na de eerste opslag van een bestaand tabblad wordt de standaardnaam ervan ook vastgelegd als record store_id = 0.

Problemen oplossen

Als het tabblad niet aan de frontend verschijnt:

• Controleer of de module is ingeschakeld in de configuratie.
• Controleer of het tabblad Status heeft ingesteld op Yes.
• Controleer of het product een ingevulde waarde heeft in het attribuut dat is aangegeven in het veld Attribute code.
• Leeg de Magento-cache.
• Zorg ervoor dat de layout van het thema nog steeds het blok product.info.details rendert.

Als de vertaling van de naam niet aan de frontend verschijnt:

• Controleer of u de juiste Store View bewerkt.
• Controleer of Use Default Value is uitgeschakeld voor het veld Name.
• Sla het tabblad op en leeg de cache.