help-service/content/troubleshooting.md

id, title, icon, description, section, tags, related, order

id	title	icon	description	section	tags	related	order
troubleshooting	Fehlerbehebung	wrench-adjustable	Loesungen fuer haeufige Probleme	Tipps & Tricks	Probleme Fehler FAQ Hilfe Support	schnellstart best-practices emails	65

Fehlerbehebung

Loesungen fuer die haeufigsten Probleme mit dem Kurs-Booking Plugin.

---

E-Mail Probleme

E-Mails kommen nicht an

Symptom: Buchungsbestaetigungen werden nicht zugestellt.

Loesungen:

1. Spam-Ordner pruefen

   • E-Mails landen oft im Spam

2. Absender-E-Mail pruefen

   • Muss zur Domain passen
   • noreply@ihre-domain.de statt Gmail

3. SMTP Plugin installieren

   • WordPress Standard-Mail ist unzuverlaessig
   • Empfohlen: WP Mail SMTP, FluentSMTP

4. E-Mail-Log pruefen

   • Plugins wie "WP Mail Log" zeigen, ob E-Mails versendet wurden

E-Mails ohne Formatierung

Symptom: HTML wird als Text angezeigt.

Loesung:

• Pruefen Sie die E-Mail-Vorlagen unter Einstellungen > E-Mail Vorlagen
• Nutzen Sie Inline-Styles (siehe E-Mail Vorlagen)

---

Buchungsformular Probleme

Formular wird nicht angezeigt

Symptom: "Jetzt buchen" Button fehlt oder Modal oeffnet sich nicht.

Loesungen:

1. JavaScript-Fehler pruefen

   • Browser-Konsole oeffnen (F12)
   • Nach roten Fehlermeldungen suchen

2. Theme-Konflikte

   • Temporaer auf Standard-Theme wechseln
   • Testen, ob Formular erscheint

3. Plugin-Konflikte

   • Alle anderen Plugins deaktivieren
   • Einzeln wieder aktivieren

4. Cache leeren

   • Browser-Cache
   • WordPress Cache (wenn Caching-Plugin aktiv)
   • CDN Cache (Cloudflare etc.)

Pflichtfeld-Fehler trotz Eingabe

Symptom: "Pflichtfeld fehlt" obwohl ausgefuellt.

Loesungen:

1. Autofill-Problem

   • Browser-Autofill kann Probleme verursachen
   • Manuell in Feld klicken und Eingabe bestaetigen

2. JavaScript-Validierung

   • Feld muss "blur" Event ausloesen
   • Einmal aus dem Feld klicken

3. Feld-Name-Konflikt

   • Pruefen Sie, ob Feldnamen eindeutig sind

Buchung bleibt "Ausstehend"

Symptom: Status wechselt nicht zu "Bestaetigt".

Loesungen:

1. Bestaetigungslink geklickt?

   • E-Mail pruefen und Link anklicken

2. Token abgelaufen

   • Standard: 48 Stunden gueltig
   • Neue Buchung erforderlich

3. Manuell bestaetigen

   • Admin > Buchungen > Buchung oeffnen
   • Status auf "Bestaetigt" setzen

---

Preis-Probleme

Preis wird als 0 angezeigt

Symptom: Kurs zeigt keinen Preis.

Loesungen:

1. Preis eingetragen?

   • Kurs bearbeiten > Preis-Feld pruefen

2. Preisvarianten pruefen

   • Mindestens eine Variante muss aktiv sein
   • Preis darf nicht leer sein

3. Waehrung gesetzt?

   • Einstellungen > Preise > Waehrung

MwSt wird nicht berechnet

Symptom: Preise ohne Steuer.

Loesungen:

1. Kleinunternehmer-Regelung aktiv?

   • Einstellungen > Preise > Kleinunternehmer
   • Wenn "Ja": Keine MwSt-Berechnung

2. MwSt-Satz pruefen

   • Muss groesser als 0 sein

---

sevDesk Probleme

Rechnung wird nicht erstellt

Symptom: Keine automatische Rechnung nach Buchung.

Loesungen:

1. API-Token pruefen

   • Einstellungen > sevDesk > Token
   • Token in sevDesk neu generieren

2. Auto-Rechnung aktiviert?

   • Einstellungen > sevDesk > Automatisch erstellen

3. sevDesk-Log pruefen

   • Buchung oeffnen > sevDesk-Status

4. Kontakt-Problem

   • Kunde muss in sevDesk angelegt sein
   • E-Mail-Adresse muss uebereinstimmen

Falscher Kontakt zugeordnet

Symptom: Rechnung geht an falschen Kunden.

Loesung:

• sevDesk sucht nach E-Mail-Adresse
• Bei Duplikaten wird erster Treffer verwendet
• Kontakte in sevDesk bereinigen

---

Performance-Probleme

Seite laedt langsam

Symptom: Kurs-Seiten brauchen lange zum Laden.

Loesungen:

1. Caching aktivieren

   • WP Rocket, W3 Total Cache, etc.

2. Bilder optimieren

   • Kurs-Bilder komprimieren
   • WebP-Format nutzen

3. Datenbank optimieren

   • Alte Buchungen archivieren
   • Transients bereinigen

Admin-Bereich langsam

Symptom: Buchungsliste laedt langsam.

Loesungen:

1. Weniger Eintraege anzeigen

   • Ansicht anpassen > 20 statt 50 pro Seite

2. Filter nutzen

   • Nach Status oder Datum filtern

---

Anzeige-Probleme

Kurs-Cards nicht sichtbar

Symptom: Shortcode [kurs_cards] zeigt nichts.

Loesungen:

1. Kurse vorhanden und veroeffentlicht?

   • Mindestens ein Kurs muss publiziert sein

2. Datum in der Zukunft?

   • Vergangene Kurse werden nicht angezeigt

3. Shortcode-Parameter pruefen

   • [kurs_cards limit="12"]

Styling passt nicht zum Theme

Symptom: Farben/Fonts stimmen nicht.

Loesungen:

1. CSS-Variablen anpassen

   • Theme Customizer > Zusaetzliches CSS

   :root {
       --kb-primary: #ihre-farbe;
   }
   

2. Theme-Kompatibilitaet

   • Kadence, Astra, GeneratePress getestet
   • Bei anderen Themes ggf. Anpassungen noetig

---

Allgemeine Tipps

Debug-Modus aktivieren

Fuer detaillierte Fehlermeldungen in wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

Fehler-Log: /wp-content/debug.log

Browser-Cache leeren

Browser	Tastenkombination
Chrome	Ctrl+Shift+Delete
Firefox	Ctrl+Shift+Delete
Safari	Cmd+Option+E

Plugin aktualisieren

1. Backup erstellen
2. Plugin deaktivieren
3. Neue Version hochladen
4. Aktivieren

---

Noch Probleme?

Wenn keine Loesung hilft:

1. Fehler dokumentieren

   • Screenshot des Problems
   • Browser-Konsole (F12) Screenshot
   • PHP-Fehlerlog

2. Support kontaktieren

   • Mit allen Informationen melden

---

Siehe auch

• Schnellstart
• Best Practices
• E-Mail System