# ⚡ WP Swift Contact - SOFORT STARTEN

## 📦 Was du bekommen hast

- ✅ **wp-swift-contact-v1.0.3-FINAL.zip** ← Einfach in WordPress hochladen!
- ✅ Plugin-Ordner mit allen Dateien
- ✅ README.md mit vollständiger Dokumentation
- ✅ Übersetzungsdateien (DE, FR, ES, EN)

---

## 🚀 Installation (5 Minuten)

### 1. Plugin hochladen
WordPress Admin → **Plugins** → **Installieren** → **Plugin hochladen**
→ ZIP auswählen: `wp-swift-contact-v1.0.3-FINAL.zip`

### 2. Aktivieren
Plugin aktivieren

### 3. reCAPTCHA v3 Keys erstellen
https://www.google.com/recaptcha/admin/create
- **Type:** reCAPTCHA v3 (nicht v2!)
- **Domain:** deine-domain.de

### 4. Plugin konfigurieren
Einstellungen → **WP Swift Contact**
- Site Key eintragen
- Secret Key eintragen  
- Empfänger E-Mail

### 5. Shortcode einfügen
Auf Kontaktseite: `[swiftcontact]`

**Fertig!** 🎉

---

## ⚠️ WICHTIG: CSP-Problem lösen (falls Formular nicht lädt)

### Problem
Du siehst nur den Button, aber keine Eingabefelder? → CSP blockiert reCAPTCHA!

### ✅ Lösung für nginx (empfohlen)

Öffne deine **nginx-Konfiguration** und füge hinzu:

```nginx
# Für Staging (v3.4kfilmliste.de) UND Live (4kfilmliste.de)
add_header Content-Security-Policy "
    default-src 'self';
    script-src 'self' 'unsafe-inline' https://www.google.com https://www.gstatic.com;
    frame-src 'self' https://www.google.com;
    style-src 'self' 'unsafe-inline';
    font-src 'self' data:;
" always;
```

**Minimal (nur reCAPTCHA):**
```nginx
add_header Content-Security-Policy "
    script-src 'self' 'unsafe-inline' https://www.google.com https://www.gstatic.com;
    frame-src 'self' https://www.google.com;
" always;
```

**Nach Änderung:**
```bash
sudo nginx -t
sudo systemctl reload nginx
```

### ✅ Lösung für Apache

In `.htaccess`:
```apache
<IfModule mod_headers.c>
    Header set Content-Security-Policy "script-src 'self' 'unsafe-inline' https://www.google.com https://www.gstatic.com; frame-src 'self' https://www.google.com;"
</IfModule>
```

### Test
1. Staging: https://v3.4kfilmliste.de/kontakt/
2. Öffne Browser-Konsole (F12)
3. Keine CSP-Fehler mehr? ✓ Funktioniert!

---

## 📧 Brevo installieren (SEHR empfohlen!)

### Warum Brevo?

**Standard-PHP-Mail landet oft im Spam!** Brevo garantiert professionelle Zustellung.

- ✅ 300 E-Mails/Tag kostenlos
- ✅ 99%+ Zustellrate (API/SMTP-Infrastruktur)
- ✅ Keine Blacklists
- ✅ Echtzeitstatistiken

### Installation

1. **WordPress Plugin:** https://wordpress.org/plugins/mailin/
2. **Brevo Account:** https://www.brevo.com/ (kostenlos)
3. **API-Key eintragen:** Brevo Plugin → Einstellungen
4. **Fertig!** E-Mails werden automatisch über Brevo versendet

**Keine Extra-Konfiguration nötig!** WP Swift Contact nutzt `wp_mail()` automatisch.

---

## 🌍 Mehrsprachigkeit

Plugin ist bereits übersetzt für:
- 🇩🇪 Deutsch
- 🇬🇧 Englisch  
- 🇫🇷 Französisch
- 🇪🇸 Spanisch

**Sprache ändern:**
WordPress → Einstellungen → Allgemein → Sprache der Website

---

## 📝 Shortcodes

Alle funktionieren identisch:

```
[swiftcontact]
[swift_contact]
[kontaktformular]  ← Legacy für Umstieg
```

---

## 🎯 Was wurde verbessert?

### vs. vorherige Version:

1. ✅ **Name:** "WP Swift Contact" (nicht "leichtes Kontaktformular")
2. ✅ **Brevo Marketing:** Prominent platziert ÜBER den Einstellungen
3. ✅ **Mehrsprachigkeit:** DE, FR, ES, EN
4. ✅ **CSP-Hinweise:** Klare Lösungen im Admin
5. ✅ **Rendering-Fix:** Formular lädt jetzt korrekt
6. ✅ **Secret Key Toggle:** 👁️ Symbol zum Ein-/Ausblenden

---

## 🆘 Schnelle Problemlösung

### "Formular wird nicht angezeigt"
→ CSP-Problem! Siehe Abschnitt oben

### "E-Mails kommen nicht an"
→ Installiere Brevo Plugin (siehe oben)

### "reCAPTCHA funktioniert nicht"
→ Stelle sicher: **v3** (nicht v2!)

### "Fehlermeldung in Console"
→ Browser-Konsole (F12) öffnen, Screenshot machen, uns kontaktieren

---

## 📞 Support

**Website & Kontakt:** https://proleads.online

---

## ✅ Checkliste

- [ ] Plugin hochgeladen und aktiviert
- [ ] reCAPTCHA v3 Keys erstellt und eingetragen
- [ ] Empfänger E-Mail konfiguriert
- [ ] CSP-Einstellungen angepasst (falls nötig)
- [ ] Brevo Plugin installiert (empfohlen)
- [ ] Shortcode auf Kontaktseite: `[swiftcontact]`
- [ ] Test-Nachricht gesendet
- [ ] Test-E-Mail empfangen ✓

---

## 🎁 Brevo Affiliate

**Sobald du deinen Affiliate Link hast:**

1. Öffne: `/wp-content/plugins/wp-swift-contact/admin/settings-page.php`
2. Zeile 10: `$brevo_link = 'https://www.brevo.com/?tap_a=DEINE_ID';`
3. Ersetze `YOUR_AFFILIATE_ID`
4. Speichern

---

**Los geht's! Viel Erfolg! 🚀**

Bei Fragen: https://proleads.online
