Kowal Custom Tab - Installation und Konfiguration
Anforderungen
- Magento 2.4 oder neuer.
- Zugriff auf die Magento CLI.
- Composer ist für das Herunterladen privater Kowal-Pakete konfiguriert.
- Installiertes Basismodul
kowal/base. - Administratorrechte für das Magento-Admin-Panel.
Installation über Composer
Fügen Sie das Paket-Repository hinzu:
Die Zugangsdaten für das Composer-Repository, also die E-Mail-Adresse des Kunden und der Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind nach der Anmeldung auf kowal.store auch im Kundenkonto verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Hauptverzeichnis aus.
composer config repositories.kowal composer https://repo.kowal.store
Konfigurieren Sie die Zugangsdaten für das Composer-Repository von Kowal:
composer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'
Installieren Sie das Modul:
composer require kowal/module-customtab
Führen Sie das Magento-Upgrade aus:
php bin/magento setup:upgrade
Führen Sie in der Produktionsumgebung die DI-Kompilierung und Bereitstellung statischer Ressourcen gemäß dem Prozess Ihres Projekts aus:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Leeren Sie den Cache:
php bin/magento cache:flush
Installation überprüfen
Prüfen Sie, ob das Modul aktiviert ist:
php bin/magento module:status Kowal_CustomTab
Wenn das Modul deaktiviert ist, aktivieren Sie es:
php bin/magento module:enable Kowal_CustomTabphp bin/magento setup:upgradephp bin/magento cache:flush
Modulkonfiguration
Gehen Sie im Magento-Admin-Panel zu:
Stores > Configuration > Kowal > Custom Tab
Setzen Sie die Option Enable module auf Yes. Speichern Sie anschließend die Konfiguration und leeren Sie den Cache, wenn Magento Sie dazu auffordert.
Tabs verwalten
Gehen Sie im Admin-Panel zu:
Kowal > Custom Tabs > Custom Tab
Klicken Sie auf Add new CustomTab, um einen neuen Tab zu erstellen.
Füllen Sie die folgenden Felder aus:
Name - Bezeichnung des Tabs, die im Frontend angezeigt wird.Field type - Typ der Inhaltsquelle.Attribute code - Produktattribut, aus dem der Tab-Inhalt übernommen werden soll.Status - Aktivierungsstatus des Tabs.Sort Order - Anzeigereihenfolge des Tabs.
Speichern Sie den Tab.
Tab-Bezeichnung übersetzen
Die standardmäßige Tab-Bezeichnung wird für store_id = 0 gespeichert.
So fügen Sie eine Übersetzung für einen bestimmten Store View hinzu:
- Öffnen Sie einen vorhandenen Tab zur Bearbeitung.
- Verwenden Sie den Store-View-Umschalter oben rechts im Formular.
- Wählen Sie den Store View aus, für den Sie die Bezeichnung ändern möchten.
- Deaktivieren Sie
Use Default Value beim Feld Name. - Geben Sie die Tab-Bezeichnung für die ausgewählte Sprachversion ein.
- Speichern Sie das Formular.
Wenn Use Default Value aktiviert bleibt, verwendet das Modul den Standardwert aus store_id = 0.
Funktionsweise im Frontend
Das Modul fügt Tabs zum Bereich mit den Produktdetails hinzu. Ein Tab wird nur angezeigt, wenn für das Produkt im in der Tab-Konfiguration angegebenen Attribut ein Wert hinterlegt ist.
Für die Tab-Bezeichnung verwendet das Modul folgenden Fallback:
- Bezeichnung für den aktuellen Store View.
- Standardbezeichnung aus
store_id = 0. - Wert aus der Haupttabelle der Tabs, der aus Kompatibilitätsgründen beibehalten wird.
Der Tab-Inhalt wird durch den CMS-Mechanismus von Magento gefiltert und kann daher von Magento unterstützte HTML-Tags und Widgets enthalten.
Vorhandene Installation aktualisieren
Führen Sie nach dem Update des Moduls auf eine Version mit Unterstützung für mehrere Sprachen Folgendes aus:
php bin/magento setup:upgradephp bin/magento cache:flush
Die neue Tabelle mit Werten je Store View wird über das deklarative Schema von Magento hinzugefügt. Nach dem ersten Speichern eines vorhandenen Tabs wird dessen Standardbezeichnung auch als Datensatz für store_id = 0 gespeichert.
Fehlerbehebung
Wenn ein Tab im Frontend nicht angezeigt wird:
- Prüfen Sie, ob das Modul in der Konfiguration aktiviert ist.
- Prüfen Sie, ob
Status für den Tab auf Yes gesetzt ist. - Prüfen Sie, ob für das Produkt im unter
Attribute code angegebenen Attribut ein Wert hinterlegt ist. - Leeren Sie den Magento-Cache.
- Stellen Sie sicher, dass das Theme-Layout weiterhin den Block
product.info.details rendert.
Wenn die übersetzte Bezeichnung im Frontend nicht angezeigt wird:
- Prüfen Sie, ob Sie den richtigen Store View bearbeiten.
- Prüfen Sie, ob
Use Default Value für das Feld Name deaktiviert ist. - Speichern Sie den Tab und leeren Sie den Cache.
