---
id: troubleshooting
title: Fehlerbehebung
icon: wrench-adjustable
description: Loesungen fuer haeufige Probleme
section: Tipps & Tricks
tags: [Probleme, Fehler, FAQ, Hilfe, Support]
related: [schnellstart, best-practices, emails]
order: 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](/topic/email_templates))

---

## 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

   ```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`:

```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](/topic/schnellstart)
- [Best Practices](/topic/best-practices)
- [E-Mail System](/topic/emails)