Product Tabs – Dokumentation

Überblick

SynerProductTabs bietet zwei Tab-Typen in einem Plugin:

Globaler Tab – erscheint auf jeder Produktdetailseite (konfigurierbar pro Sales Channel)
Produktindividueller Tab – erscheint nur, wenn am Produkt Daten in den Custom Fields syner_product_tab_title oder syner_product_tab_content eingetragen sind

Verhältnis zu Global Tabs: SynerProductTabs enthält alle Funktionen von YorgGlobalTabs plus den produktindividuellen Tab. Die beiden Plugins überschreiben dasselbe Template – es sollte immer nur eines aktiv sein.

Systemanforderungen

Komponente	Mindestversion	Empfohlen
Shopware	6.6.0	6.7.x
PHP	8.2	8.3
Datenbank	MySQL 8.0 / MariaDB 10.6	–
Composer	2.x	–

Installation

Option A – Shopware Store

Im Shopware-Admin Erweiterungen → Store öffnen
Nach SynerProductTabs suchen
Kaufen / Installieren klicken
Unter Erweiterungen → Meine Erweiterungen aktivieren

Option B – ZIP-Upload

Admin: Erweiterungen → Meine Erweiterungen → Plugin hochladen
SynerProductTabs.zip auswählen und hochladen
Plugin aktivieren, Cache leeren bestätigen

Option C – CLI

cd /var/www/shopware/custom/plugins
unzip SynerProductTabs.zip
chown -R www-data:www-data SynerProductTabs/
php bin/console plugin:refresh
php bin/console plugin:install --activate SynerProductTabs
php bin/console cache:clear

Was passiert bei der Aktivierung? Das Plugin legt automatisch das Custom-Field-Set syner_product_tab und zwei Custom Fields (syner_product_tab_title, syner_product_tab_content) in der Shopware-Datenbank an.

Globalen Tab konfigurieren

Öffne die Plugin-Konfiguration über Erweiterungen → Meine Erweiterungen → SynerProductTabs → Konfiguration.

SystemConfig-Schlüssel	Typ	Standard	Beschreibung
SynerProductTabs.config.globalTabActive	bool	false	Globalen Tab aktivieren / deaktivieren
SynerProductTabs.config.globalTabTitle	string	Details	Tab-Bezeichnung in der Storefront
SynerProductTabs.config.globalTabContent	html	leer	HTML-Inhalt des globalen Tabs

Sales-Channel-spezifisch: Im Konfigurationsformular oben rechts den gewünschten Sales Channel wählen – so lassen sich verschiedene Inhalte und Sprachen pro Kanal setzen.

Produktindividuellen Tab verwenden

Der produktindividuelle Tab wird direkt am Produkt konfiguriert – kein Entwicklerwissen nötig:

Produkt im Admin öffnen (Katalog → Produkte)
Zum Tab Zusatzfelder scrollen
Abschnitt Produkt-Tab aufklappen
Tab-Bezeichnung und Tab-Inhalt ausfüllen
Speichern – der Tab erscheint sofort in der Storefront

Wenn beide Felder leer bleiben, wird kein Tab angezeigt – das Produkt ist damit nicht beeinträchtigt.

Custom Fields Referenz

Custom Field	Typ	Übersetzbar	Beschreibung
syner_product_tab_title	text	Ja	Tab-Bezeichnung für dieses Produkt
syner_product_tab_content	html	Ja	HTML-Inhalt des produktindividuellen Tabs

Beide Felder sind als translated: true konfiguriert. Im Produkt-Formular oben links die Sprache wechseln, um sprachspezifische Inhalte zu pflegen.

CSS-Klassen

.syner-global-tab    /* Wrapper des globalen Tabs */
.syner-product-tab   /* Wrapper des produktindividuellen Tabs */

Varianten-Unterstützung

Custom Fields werden in Shopware pro Produktvariante gespeichert:

Wenn eine Variante eigene Werte hat, werden diese angezeigt
Wenn eine Variante keine eigenen Werte hat, greifen die Werte des Elternprodukts
Der globale Tab ist nicht varianten-spezifisch – er gilt für alle Produkte des Sales Channels

FAQ

Kann ich mehr als einen produktindividuellen Tab pro Produkt anlegen?

Version 1.0 unterstützt einen produktindividuellen Tab. Mehrere Tabs sind für eine zukünftige Version geplant. Als Workaround kann der HTML-Inhalt mit Überschriften strukturiert werden.

Muss ich nach Konfigurationsänderungen den Cache leeren?

Nein – Shopware invalidiert bei Plugin-Konfigurationsänderungen automatisch. Bei Custom-Field-Änderungen am Produkt ist kein Cache-Leeren nötig.

Funktioniert das Plugin mit dem LUMA Theme?

Das YorgLuma-Theme enthält eine eigene Tab-Implementierung (Custom Fields mit Präfix yorg_). Wenn LUMA aktiv ist, hat es eine höhere Priorität in der Template-Kette. LUMA-Nutzer sollten die theme-eigene Tab-Funktionalität verwenden.

Was passiert beim Deinstallieren?

Shopware fragt, ob Nutzerdaten gelöscht werden sollen. Bei "Ja" werden das Custom-Field-Set, beide Custom Fields und alle Produktdaten entfernt. Bei "Nein" bleiben alle Daten erhalten.

Changelog

v1.0.0 – Erstveröffentlichung

Globaler Tab per Plugin-Konfiguration (Sales-Channel-spezifisch)
Produktindividueller Tab über Custom Fields
Übersetzbare Custom Fields
Auto-Hide wenn Custom Fields leer
Saubere Deinstallation mit Datenlöschungs-Option
Shopware 6.6 & 6.7 kompatibel, PHP 8.2+