- Sie haben noch keine Artikel in Ihrem Warenkorb.
Eigene Hilfetexte ist das Gambio-Modul, mit dem Kunden per Klick auf einen Hilfe-Button erfahren, was ein Auswahlfeld bedeutet. Der Button erscheint an Varianten, Zusatzoptionen und GX-Customizer-Elementen und öffnet ein Infofenster mit Ihrem Text. Sie pflegen die Texte im Admin pro Element und Sprache, mit Formatierung und Links.
Hilfetexte direkt am Auswahlfeld: Zusatzoptionen, Varianten und GX Customizer erklären
Eigene Hilfetexte ist das Gambio-Modul, mit dem Kunden per Klick auf einen Hilfe-Button erfahren, was eine Zusatzoption, eine Variante oder ein GX-Customizer-Element bedeutet. Kunden zögern, wenn sie ein Auswahlfeld nicht verstehen. Deshalb setzt das Modul neben das Element einen kleinen Button. Er öffnet ein Infofenster mit einem Text, den Sie pro Element und Sprache im Admin pflegen. Programmierkenntnisse brauchen Sie dafür nicht.
Auf einen Blick
| Was es ist | Ein Gambio-Modul der WinHelp GmbH. Der Modulname im Admin lautet „Eigene Hilfetexte“. Es setzt einen Hilfe-Button mit Infofenster an Auswahlfelder der Produktseite. |
|---|---|
| Für wen | Für Shopbetreiber mit erklärungsbedürftigen Varianten, Zusatzoptionen oder GX-Customizer-Feldern. |
| So funktioniert es | Sie pflegen den Hilfetext im Admin pro Element und Sprache. Auf der Produktseite öffnet der Button ein Infofenster (Popover) mit dem Text. |
| Elementarten | Varianten, Zusatzoptionen und GX-Customizer-Elemente. |
| Einschränkungen | Nur auf Produktseiten. Bei Varianten nur in der Darstellung als Auswahlliste. Mit dem Modul „ProductOptionsPerPostcode“ erscheinen die Buttons der Zusatzoptionen nicht. |
| Voraussetzung | Gambio GX5 (PHP 8.2). |
| Gambio-Versionen | Gambio GX5 und Gambio GX26, jeweils mit PHP 8.2 oder höher. |
| Hersteller und Support | WinHelp GmbH, Rheinstetten, support@winhelp.eu |
Für wen ist Eigene Hilfetexte gedacht?
- Das passt gut zu: Shops, deren Varianten, Zusatzoptionen oder GX-Customizer-Felder eine Erklärung brauchen, etwa bei kurzen Bezeichnungen, die ohne Zusatz missverständlich sind.
- Dafür ist es nicht gedacht: Erklärungen außerhalb von Produktseiten, und Shops, in denen das Modul „ProductOptionsPerPostcode“ die Zusatzoptionen darstellt. Dort erscheinen die Hilfe-Buttons nicht.
Ohne Modul oder mit Eigene Hilfetexte?
| Ohne Modul | Mit Eigene Hilfetexte | |
|---|---|---|
| Erklärung zum Auswahlfeld | Im Namen des Elements oder im Artikeltext. | Per Klick im Infofenster direkt am Auswahlfeld. |
| Formatierung | Wie im Namen oder Artikeltext. | Fett, Listen und Links im Hilfetext. |
| Sprachen | Je nach Name bzw. Artikeltext. | Ein Hilfetext pro Element und Sprache. |
| Aus- und einschalten | Text ändern oder löschen. | Schalter „Aktiv / Inaktiv“ je Hilfetext. |
Ihre Vorteile
Erklärung genau dort, wo die Frage entsteht. Der Hilfe-Button sitzt direkt an der Bezeichnung bzw. am Auswahlfeld. Ein Klick öffnet ein Infofenster, ein Klick an eine andere Stelle schließt es.
Drei Elementarten. Das Modul unterstützt Varianten, Zusatzoptionen (Auswahlliste, Radiobuttons, Bild, Text, Textbox) und GX-Customizer-Elemente.
Formatierte Texte. Im Texteditor (CKEditor) setzen Sie Fett, Listen und Links zu weiterführenden Seiten.
Mehrsprachig. Es gibt einen Reiter pro Shopsprache. Jeder Hilfetext gilt für die Sprache, in der Sie ihn anlegen.
Einfache Pflege. Eine Übersicht listet alle Elemente Ihres Shops, auch solche ohne Hilfetext. Die Spalten „Name“ und „Hilfe“ lassen sich sortieren.
Ein- und ausschalten. Mit dem Schalter „Aktiv / Inaktiv“ blenden Sie einen Hilfetext aus, ohne ihn zu löschen.
Anpassbares Aussehen. Button-Klassen und Symbol ändern Sie pro Hilfetext. Leere Felder setzen beim Speichern die Standardwerte.
Der Button lässt sich per Tab-Taste bedienen und ist für Screenreader beschriftet.
Alle Texte des Moduls können Sie je Sprache unter „Texte anpassen“ ändern.
So richten Sie Hilfetexte ein
1 Entpacken Sie die ZIP-Datei und laden Sie die Ordner per FTP vollständig in das Basisverzeichnis des Shops hoch. Dabei überschreiben Sie keine Dateien des Gambio-Shops.
2 Leeren Sie im Admin unter „Toolbox → Cache“ nacheinander den Cache für Modulinformationen, den Cache für Texte und den Cache für die Seitenausgabe.
3 Öffnen Sie im Modul-Center den Eintrag „WinHelp® - Eigene Hilfetexte“ und klicken Sie auf „Installieren“.
4 Öffnen Sie im Admin „WinHelp® Module → Eigene Hilfetexte“. Wählen Sie den Reiter der Sprache und die Art des Elements (Varianten, Zusatzoptionen, GX Customizer).
5 Klicken Sie in der Zeile des Elements auf den grünen Stift, geben Sie den Hilfetext ein und speichern Sie. Button-Klassen und Symbol können Sie auf Wunsch ändern.
6 Leeren Sie bei Bedarf unter „Toolbox → Cache“ den Cache für die Seitenausgabe, damit der Button auch auf bereits zwischengespeicherten Produktseiten erscheint.
Auf der Produktseite erscheint der Button, sobald für das Element in der aktuellen Shopsprache ein aktiver Hilfetext existiert. Für alle anderen Elemente bleibt die Darstellung unverändert.
Technische Daten
- Gambio-Versionen: GX5 und GX26, jeweils mit PHP 8.2 oder höher. GX26 unterstützt auch PHP 8.0 und 8.1, das Modul braucht aber PHP 8.2.
- Die Hilfe-Buttons erscheinen nur auf Produktseiten und nur, solange das Modul im Modul-Center installiert ist.
- Vorlagen für alle Themes („Shop/Themes/All“) liefert das Modul mit. Dateien des Gambio-Shops überschreibt es nicht.
- Standard für Button-Klassen: btn btn-link btn-sm. Standard für das Symbol: fa fa-question-circle.
- Die Hilfetexte liest das Modul pro Seitenaufruf nur einmal aus der Datenbank.
- Die Verwaltung finden Sie im Admin unter „WinHelp® Module → Eigene Hilfetexte“.
- Installation, Update und Deinstallation laufen über das Gambio-Modul-Center. Beim Deinstallieren werden die modulabhängigen Datenbanktabellen entfernt.
- Stand dieser Beschreibung: Oktober 2026.
Gut zu wissen
- Ist das Modul „ProductOptionsPerPostcode“ vorhanden, überlässt Eigene Hilfetexte ihm die Darstellung der Zusatzoptionen, weil beide dieselben Vorlagen ersetzen. Die Hilfe-Buttons der Zusatzoptionen erscheinen dann nicht. Varianten und GX-Customizer-Elemente sind nicht betroffen.
- Haben Sie in einem eigenen Theme die Vorlagen für Optionen („modifier_group_type_…“) oder Varianten-Auswahllisten („product_info_property_template_dropdowns“) selbst angepasst, kann der Button dort fehlen. Der Support hilft Ihnen weiter.
- Bei Varianten erscheint der Button nur in der Darstellung als Auswahlliste. Beim GX Customizer fügt das Modul ihn per JavaScript ein und setzt ihn nach jeder Aktualisierung des Gestalters erneut.
- Das Löschen eines Hilfetextes geht sofort und lässt sich nicht rückgängig machen. Zum vorübergehenden Ausblenden dient der Status „Inaktiv“.
- Die Hilfetexte werden als HTML ausgegeben. Pflegen Sie sie nur selbst oder durch vertrauenswürdige Personen.
Häufige Fragen
Wie kann ich in Gambio einen Hilfetext an eine Zusatzoption hängen?
Mit dem Modul Eigene Hilfetexte. Sie wählen im Admin unter „WinHelp® Module → Eigene Hilfetexte“ die Sprache und „Zusatzoptionen“, klicken in der Zeile der Option auf den Stift und geben den Text ein. Auf der Produktseite erscheint danach neben der Bezeichnung ein Hilfe-Button.
Funktioniert das auch bei Varianten und im GX Customizer?
Ja. Das Modul unterstützt Varianten (Eigenschaften), Zusatzoptionen (Attribute) und Elemente des GX Customizers. Bei Varianten sitzt der Button nur in der Darstellung als Auswahlliste.
Wie erkläre ich Kunden eine Eigenschaft oder ein Auswahlfeld, ohne den Namen zu verlängern?
Legen Sie für das Element einen Hilfetext an. Der Name bleibt kurz, und die Erklärung öffnet sich erst auf Klick in einem Infofenster, formatiert mit Fett, Listen oder Links.
Kann ich Hilfetexte in mehreren Sprachen anlegen?
Ja. Die Seite hat einen Reiter pro installierter Shopsprache. Jeder Hilfetext gilt nur für die Sprache, in der Sie ihn angelegt haben.
Kann ich das Aussehen des Hilfe-Buttons ändern?
Ja. Sie können Button-Klassen (Standard: btn btn-link btn-sm) und Symbol (Standard: fa fa-question-circle) pro Hilfetext anpassen, zum Beispiel auf „btn btn-info btn-sm“ für einen blauen Button.
Kann ich einen Hilfetext vorübergehend ausblenden?
Ja. Mit dem Schalter „Aktiv / Inaktiv“ blenden Sie einen Hilfetext aus, ohne ihn zu löschen. Nur aktive Hilfetexte erscheinen im Shop.
Ist der Hilfe-Button barrierefrei?
Sie erreichen den Button per Tab-Taste, und er ist für Screenreader beschriftet („Hilfe zu: Name des Elements“). Die Beschriftung können Sie unter „Texte anpassen“ ändern.
Warum erscheint der Button bei Zusatzoptionen nicht?
Meistens liegt es am Modul „ProductOptionsPerPostcode“. Ist es im Shop vorhanden, übernimmt es die Darstellung der Zusatzoptionen. Weitere Ursachen sind ein fehlender aktiver Hilfetext in der aktuellen Sprache, eine zwischengespeicherte Seite oder ein eigenes Theme mit angepassten Options-Vorlagen.
Wird der Hilfetext sofort gelöscht, wenn ich auf den Papierkorb klicke?
Ja. Das Löschen fragt nicht nach und lässt sich nicht rückgängig machen. Wollen Sie einen Text nur vorübergehend ausblenden, stellen Sie den Status auf „Inaktiv“.
Kann ich HTML in den Hilfetext schreiben?
Ja, der Texteditor (CKEditor) erzeugt formatierten Text mit Fett, Listen und Links. Die Texte werden als HTML ausgegeben. Pflegen Sie sie deshalb nur selbst oder durch vertrauenswürdige Personen.
Läuft das Modul unter Gambio GX26?
Ja. Das Modul ist für Gambio GX5 und für Gambio GX26 vorgesehen. Es braucht PHP 8.2 oder höher. GX26 unterstützt zwar auch PHP 8.0 und 8.1, damit läuft das Modul aber nicht.
Verwandte Module
- Preis auf Anfrage mit Formular: Preisanfrage-Formular, das auch GX-Customizer-Angaben übernimmt.
Support
Bei Fragen zur Einrichtung oder Nutzung schreiben Sie uns an support@winhelp.eu. Die Kundendokumentation mit Installation, Einrichtung und Textanpassung liegt dem Modul bei.