# Faymax Smart FAQ Pro fuer JTL Shop 5

Version: 1.3.0

## Beschreibung

Faymax Smart FAQ Pro fuer JTL Shop 5 ist ein kostenloses FAQ und SEO Schema Plugin fuer JTL Shop Betreiber. Das Plugin ermoeglicht die Verwaltung von FAQ Eintraegen im Shop Backend, die regelbasierte Ausgabe auf passenden Seiten, die Platzierung ueber den OnPage Composer und die optionale Ausgabe von FAQPage JSON LD.

Das Plugin eignet sich fuer Kategorien, Landingpages, Servicebereiche, Produktberatung, Supportseiten und SEO Inhalte.

## Wichtige Funktionen

- FAQ Verwaltung im Backend
- aktive und inaktive FAQ Eintraege
- FAQ Eintraege duplizieren
- URL Regeln: global, exakt, beginnt mit, enthaelt, Regex
- Prioritaeten und sichtbares Limit
- URL Test im Backend
- Debug Kommentar im Quelltext
- Accordion Verhalten: alle geschlossen, erste Frage offen, alle offen, nur eine offen
- sichere HTML Antworten mit erlaubten Basis Tags
- automatische Absatzformatierung
- Platzhalter in CTA, Fragen und Antworten
- Kontakt CTA mit dynamischen Links
- Design Einstellungen fuer Farben, Abstaende, Rundung und Schatten
- Ausgabe vor Footer, im Footer, am Seitenende oder ueber Platzhalter
- OPC Portlet fuer den JTL OnPage Composer
- FAQPage Schema global steuerbar
- FAQPage Schema pro Eintrag aktivierbar
- globales Schema Limit
- updatefester Speicher in mediafiles/faymax_smart_faq/faq_data.json
- Faymax Support Tab mit Kontaktlinks

## OPC Portlet

Das Plugin liefert ein eigenes OnPage Composer Portlet mit dem Namen Faymax Smart FAQ aus. Damit kann der FAQ Block per OPC an einer beliebigen Stelle platziert werden.

Portlet Optionen:

- Headline ueberschreiben
- Gruppenfilter
- Limit Override
- Kontakt CTA anzeigen oder ausblenden
- FAQPage Schema ausgeben oder deaktivieren
- URL Regeln ignorieren und alle aktiven FAQ Eintraege nutzen

Wenn der FAQ Block per OPC Portlet platziert wird, bleibt die Ausgabe an der im OnPage Composer gesetzten Position.

## Platzhalter

Folgende Platzhalter koennen in CTA Feldern, Fragen und Antworten verwendet werden:

- {url}
- {seite}
- {path}
- {pfad}
- {url_encoded}
- {seite_encoded}
- {path_encoded}
- {pfad_encoded}
- {headline}
- {shopname}
- {shop}

Beispiel fuer eine WhatsApp CTA URL:

https://wa.me/49123456789?text=Hallo%2C%20ich%20habe%20eine%20Frage%20zu%20{url_encoded}

## Platzhalter im OnPage Composer

Alternativ zum OPC Portlet kann ein HTML Element mit einem der folgenden Marker genutzt werden:

<!-- FAYMAX_SMART_FAQ -->

oder

[faymax_smart_faq]

Die globale Einstellung Ausgabe muss dann auf Platzhalter stehen.

## Installation

1. ZIP Datei im JTL Shop Backend hochladen
2. Plugin installieren und aktivieren
3. Smart FAQ Manager oeffnen
4. FAQ Eintraege anlegen
5. Bei Bedarf OPC Portlet im OnPage Composer platzieren
6. Shop Cache und Template Cache leeren
7. Frontend pruefen

## Update

Die FAQ Daten werden updatefest unter mediafiles/faymax_smart_faq/faq_data.json gespeichert. Vor groesseren Updates sollte diese Datei trotzdem gesichert werden.

## Testhinweise

- Zuerst einen globalen FAQ Eintrag anlegen
- Danach die gewuenschte URL Regel testen
- Im Backend den URL Test nutzen
- Bei OPC Nutzung testweise URL Regeln ignorieren aktivieren
- Seitenquelltext auf application/ld+json pruefen, wenn FAQPage Schema aktiv ist
- Nach Aenderungen Shop Cache und Template Cache leeren

## Hinweise zu strukturierten Daten

FAQPage JSON LD sollte nur fuer Fragen ausgegeben werden, die sichtbar auf der Seite stehen. Die Nutzung strukturierter Daten ersetzt keine SEO fachliche oder rechtliche Pruefung.

## Support

Faymax Consulting unterstuetzt bei JTL Shop, JTL Wawi, SEO, Plugin Entwicklung, Migrationen, Marktplatzanbindungen und individuellen Anpassungen.

Website: https://faymax-consulting.de
E Mail: info@faymax-consulting.de
