Initial commit - Help Service for Coolify
This commit is contained in:
296
content/troubleshooting.md
Normal file
296
content/troubleshooting.md
Normal file
@@ -0,0 +1,296 @@
|
||||
---
|
||||
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)
|
||||
Reference in New Issue
Block a user