mirror of
https://git.hexahost.dev/smueller/HexaHost-Frontend.git
synced 2026-06-02 09:18:43 +00:00
Aktualisierung der Kontaktseite: Ersetzung von Live Chat durch Discord-Support, Anpassung des Kontaktformulars mit Honeypot-Feld für Bot-Schutz und Verbesserung der Formularvalidierung. Hinzufügung von CSS-Stilen für neue Abschnitte und Optimierung der responsiven Darstellung.
This commit is contained in:
199
public/README-EMAIL-SETUP.md
Normal file
199
public/README-EMAIL-SETUP.md
Normal file
@@ -0,0 +1,199 @@
|
||||
# HexaHost.de E-Mail-System Setup
|
||||
|
||||
## 📧 Kontaktformular E-Mail-Versand
|
||||
|
||||
Dieses System ermöglicht den E-Mail-Versand über das Kontaktformular mit SMTP-Integration und umfassendem Spam-Schutz.
|
||||
|
||||
## 🚀 Installation
|
||||
|
||||
### 1. SMTP-Konfiguration
|
||||
|
||||
Öffnen Sie die Datei `config.php` und tragen Sie Ihre SMTP-Daten ein:
|
||||
|
||||
```php
|
||||
$smtp_config = [
|
||||
'smtp_host' => 'smtp.gmail.com', // Ihr SMTP-Server
|
||||
'smtp_port' => 587, // Port (587 für TLS, 465 für SSL)
|
||||
'smtp_username' => 'info@hexahost.de', // Ihr SMTP-Benutzername
|
||||
'smtp_password' => 'IHR_PASSWORT', // Ihr SMTP-Passwort
|
||||
'smtp_encryption' => 'tls', // 'tls' oder 'ssl'
|
||||
'from_email' => 'info@hexahost.de', // Absender-E-Mail
|
||||
'to_email' => 'info@hexahost.de', // Empfänger-E-Mail
|
||||
];
|
||||
```
|
||||
|
||||
### 2. E-Mail-Provider Beispiele
|
||||
|
||||
#### Gmail
|
||||
```php
|
||||
'smtp_host' => 'smtp.gmail.com',
|
||||
'smtp_port' => 587,
|
||||
'smtp_encryption' => 'tls',
|
||||
```
|
||||
**Hinweis:** Aktivieren Sie "Weniger sichere Apps" oder verwenden Sie App-Passwörter.
|
||||
|
||||
#### Outlook/Hotmail
|
||||
```php
|
||||
'smtp_host' => 'smtp-mail.outlook.com',
|
||||
'smtp_port' => 587,
|
||||
'smtp_encryption' => 'tls',
|
||||
```
|
||||
|
||||
#### GMX
|
||||
```php
|
||||
'smtp_host' => 'mail.gmx.net',
|
||||
'smtp_port' => 587,
|
||||
'smtp_encryption' => 'tls',
|
||||
```
|
||||
|
||||
#### Web.de
|
||||
```php
|
||||
'smtp_host' => 'smtp.web.de',
|
||||
'smtp_port' => 587,
|
||||
'smtp_encryption' => 'tls',
|
||||
```
|
||||
|
||||
#### Eigener Mail-Server
|
||||
```php
|
||||
'smtp_host' => 'mail.ihre-domain.de',
|
||||
'smtp_port' => 587, // oder 465 für SSL
|
||||
'smtp_encryption' => 'tls', // oder 'ssl'
|
||||
```
|
||||
|
||||
## 🔒 Sicherheitsfeatures
|
||||
|
||||
### Anti-Spam Schutz
|
||||
- **Rate Limiting**: Max. 5 Anfragen pro Stunde pro IP
|
||||
- **Honeypot**: Verstecktes Feld für Bot-Schutz
|
||||
- **Input-Validierung**: Sanitization aller Eingaben
|
||||
- **E-Mail-Validierung**: Format-Prüfung
|
||||
|
||||
### E-Mail-Headers für Spam-Schutz
|
||||
```php
|
||||
X-Mailer: HexaHost Contact Form
|
||||
X-Priority: 3
|
||||
X-MSMail-Priority: Normal
|
||||
Importance: Normal
|
||||
X-Report-Abuse: Please report abuse here: abuse@hexahost.de
|
||||
```
|
||||
|
||||
## 📧 E-Mail-Template
|
||||
|
||||
### HTML-E-Mail
|
||||
- Responsive Design
|
||||
- HexaHost Branding
|
||||
- Strukturierte Darstellung aller Formulardaten
|
||||
- IP-Adresse und Zeitstempel für Tracking
|
||||
|
||||
### Text-Version
|
||||
- Fallback für E-Mail-Clients ohne HTML-Support
|
||||
- Alle wichtigen Informationen enthalten
|
||||
|
||||
## 🛠️ DNS-Konfiguration für Spam-Schutz
|
||||
|
||||
### SPF Record (TXT Record)
|
||||
```
|
||||
v=spf1 include:_spf.hexahost.de ~all
|
||||
```
|
||||
|
||||
### DMARC Record (TXT Record)
|
||||
```
|
||||
v=DMARC1; p=quarantine; rua=mailto:dmarc@hexahost.de
|
||||
```
|
||||
|
||||
### DKIM
|
||||
- Wird über Ihren Mail-Server konfiguriert
|
||||
- Erhöht die Zustellbarkeit erheblich
|
||||
|
||||
## 🔧 Debugging
|
||||
|
||||
### Debug-Modus aktivieren
|
||||
```php
|
||||
$debug_config = [
|
||||
'debug_mode' => true,
|
||||
'log_errors' => true,
|
||||
'log_file' => 'contact_form_errors.log',
|
||||
];
|
||||
```
|
||||
|
||||
### Log-Datei prüfen
|
||||
```bash
|
||||
tail -f contact_form_errors.log
|
||||
```
|
||||
|
||||
## 📋 Dateistruktur
|
||||
|
||||
```
|
||||
public/
|
||||
├── contact-handler.php # E-Mail-Verarbeitung
|
||||
├── config.php # SMTP-Konfiguration
|
||||
├── contact.html # Kontaktformular
|
||||
├── assets/
|
||||
│ ├── css/
|
||||
│ │ └── style.css # Styling
|
||||
│ └── js/
|
||||
│ └── contact.js # Frontend-Logic
|
||||
└── README-EMAIL-SETUP.md # Diese Anleitung
|
||||
```
|
||||
|
||||
## 🧪 Testing
|
||||
|
||||
### 1. Konfiguration testen
|
||||
```bash
|
||||
php -f config.php
|
||||
```
|
||||
|
||||
### 2. E-Mail-Versand testen
|
||||
1. Öffnen Sie `contact.html`
|
||||
2. Füllen Sie das Formular aus
|
||||
3. Senden Sie eine Test-Nachricht
|
||||
4. Prüfen Sie Ihr E-Mail-Postfach
|
||||
|
||||
### 3. Fehlerbehebung
|
||||
- Prüfen Sie die Browser-Konsole (F12)
|
||||
- Prüfen Sie die PHP-Fehler-Logs
|
||||
- Aktivieren Sie den Debug-Modus
|
||||
|
||||
## 🔧 Erweiterte Konfiguration
|
||||
|
||||
### PHPMailer Integration
|
||||
Falls PHPMailer verfügbar ist, wird es automatisch verwendet:
|
||||
|
||||
```bash
|
||||
composer require phpmailer/phpmailer
|
||||
```
|
||||
|
||||
### Fallback
|
||||
Falls PHPMailer nicht verfügbar ist, wird die native PHP `mail()` Funktion verwendet.
|
||||
|
||||
## 📊 Monitoring
|
||||
|
||||
### Erfolgreiche E-Mails
|
||||
- Empfangen Sie strukturierte HTML-E-Mails
|
||||
- Alle Formulardaten werden übersichtlich dargestellt
|
||||
- IP-Adresse und Zeitstempel für Tracking
|
||||
|
||||
### Fehlerbehandlung
|
||||
- Detaillierte Fehlermeldungen im Log
|
||||
- Benutzerfreundliche Frontend-Meldungen
|
||||
- Rate-Limiting-Schutz
|
||||
|
||||
## 🚨 Wichtige Hinweise
|
||||
|
||||
1. **Sicherheit**: Ändern Sie die Standard-Konfiguration
|
||||
2. **Passwörter**: Verwenden Sie sichere SMTP-Passwörter
|
||||
3. **SSL/TLS**: Verwenden Sie immer verschlüsselte Verbindungen
|
||||
4. **DNS**: Konfigurieren Sie SPF, DMARC und DKIM
|
||||
5. **Backups**: Sichern Sie die Konfigurationsdateien
|
||||
|
||||
## 📞 Support
|
||||
|
||||
Bei Problemen:
|
||||
1. Prüfen Sie die Log-Dateien
|
||||
2. Aktivieren Sie den Debug-Modus
|
||||
3. Testen Sie die SMTP-Verbindung
|
||||
4. Kontaktieren Sie Ihren Hosting-Provider
|
||||
|
||||
---
|
||||
|
||||
**© 2024 HexaHost.de - Alle Rechte vorbehalten**
|
||||
Reference in New Issue
Block a user