Maria Ratings: Umfassendes Installations- und Nutzerhandbuch

Meistern Sie Maria Ratings mit diesem umfassenden Installations- und Benutzerhandbuch, das von der Grundeinrichtung bis zum Spamschutz alles abdeckt.

1. Systemanforderungen

• PHP: Version 8.0 oder höher.
• Erweiterungen: json und mbstring sind erforderlich. Wenn Sie MySQL/MariaDB für die Speicherung wählen, ist auch mysqli erforderlich.
• CAPTCHA (Pro): Zur Nutzung von Cloudflare Turnstile oder Google reCAPTCHA v3 ist ausgehendes HTTPS erforderlich (die curl Erweiterung wird bevorzugt; ansonsten muss allow_url_fopen in der php.ini auf On stehen).
• E-Mails (Pro): Ausgehende SMTP- oder PHP mail() Fähigkeiten sind für Double Opt-in und Admin-Benachrichtigungen erforderlich.

2. Installationsanleitung

Schritt 1: Hochladen der Dateien

Extrahieren Sie das heruntergeladene Archiv und laden Sie den gesamten Ordner über FTP, SFTP oder den Dateimanager Ihres Hostings auf Ihren Webserver hoch.

Schritt 2: Ausführen des Installers

Rufen Sie die Installationsdatei in Ihrem Webbrowser auf (zum Beispiel: https://ihrewebsite.de/maria-ratings/install.php). Der visuelle Installer führt Sie durch die Erstellung Ihres Administratorkontos.

Schritt 3: Auswahl des Speichermediums

Während der Installation müssen Sie auswählen, wie Ihre Bewertungsdaten gespeichert werden sollen:

• JSON-Dateispeicherung: Die einfachste Option. Erfordert keine Konfiguration und eignet sich hervorragend für kleine Websites. Stellen Sie sicher, dass Ihr storage/ Ordner Schreibrechte hat.
• MySQL/MariaDB: Dringend empfohlen für Produktionsumgebungen, Medien-Uploads und Websites mit hohem Traffic. Sie müssen Datenbank-Host, Name, Benutzer, Passwort und Tabellenpräfix angeben.

Sobald die Installation abgeschlossen ist, können Sie sich über /admin/ in Ihr Admin-Panel einloggen.

3. Upgrade von Free auf Pro

Wenn Sie von Maria Ratings Free auf Pro upgraden, gehen Ihre bestehenden Bewertungen nicht verloren:

1. Laden Sie die Pro-Dateien hoch und überschreiben Sie Ihre bestehende Free-Installation.
2. Wichtig für JSON-Nutzer: Stellen Sie sicher, dass Sie Ihr bestehendes storage/ Verzeichnis nicht überschreiben, da es Ihre Live-Daten enthält.
3. Wenn Sie MySQL/MariaDB nutzen, führen Sie einfach den Pro-Installer aus und verbinden sich mit exakt denselben Datenbankdaten. Ihre Daten werden automatisch erkannt.

4. Einbetten des Bewertungs-Widgets

Um das Bewertungs-Widget auf Ihrer Website anzuzeigen, platzieren Sie das folgende HTML-Snippet genau dort, wo die Bewertungen erscheinen sollen:

<div data-maria-ratings data-product-key="ihr-produkt-id"></div>
<script src="https://ihrewebsite.de/maria-ratings/embed.js" defer></script>

Hinweis: Ändern Sie ihr-produkt-id in eine eindeutige Kennung für das jeweilige Produkt oder die Seite. Dies stellt sicher, dass Bewertungen für verschiedene Artikel auf Ihrer Website getrennt gehalten werden.

5. Admin-Dashboard & Moderation

Loggen Sie sich in Ihr Admin-Dashboard (/admin/index.php) ein, um Ihre Bewertungen zu verwalten. Von hier aus können Sie:

• Bewertungen moderieren: Ausstehende Bewertungen genehmigen, ablehnen oder löschen.
• Kunden antworten (Pro): Öffentliche Inhaberantworten direkt unter Kundenbewertungen posten.
• Daten exportieren: Eine CSV-Datei aller Ihrer Bewertungen herunterladen.
• Einstellungen konfigurieren: Ratenbegrenzungen, blockierte Wörter, erforderliche Formularfelder und zulässige Ursprünge (Allowed Origins) anpassen.

6. Detaillierte Einstellungsanleitung

Das Admin-Panel ist in mehrere Konfigurations-Tabs unterteilt. Hier ist eine detaillierte Aufschlüsselung:

Allgemeine Einstellungen

• Bewertungen automatisch genehmigen: Wählen Sie, ob Bewertungen sofort veröffentlicht oder zur manuellen Moderation zurückgehalten werden. Sie können auch nur 4- und 5-Sterne-Bewertungen automatisch genehmigen lassen.
• Bewertungen pro Seite: Steuern Sie, wie viele Bewertungen initial geladen werden.
• Sortierreihenfolge: Legen Sie die Standardsortierung fest (Neueste, Älteste, Höchste, Niedrigste Bewertung).
• Theme: Wechseln Sie zwischen den Widget-Themes (z.B. Classic oder Dark Mode).
• Erlaubte Ursprünge: Eine kritische Sicherheitseinstellung. Geben Sie die genauen Domains (z.B. https://ihrewebsite.de) an, auf denen Ihr Widget eingebettet ist.

Formularfelder & Nachrichten

• Sichtbarkeit & Anforderungen: Übernehmen Sie die volle Kontrolle über die Felder Name, E-Mail und Website. Legen Sie fest, ob sie im Formular angezeigt werden, verpflichtend sind und ob sie öffentlich sichtbar sind.
• Benutzerdefinierte Texte & Übersetzungen: Passen Sie den Text für Schaltflächen, Etiketten und Erfolgsmeldungen an, um das Widget in Ihre lokale Sprache zu übersetzen.

Spam & Sicherheit (Free & Pro)

• IP-Ratenbegrenzung: Beschränken Sie, wie viele Bewertungen von derselben IP-Adresse in einem bestimmten Zeitraum eingereicht werden können.
• Eine Bewertung pro E-Mail: Verhindern Sie, dass Benutzer mehrere Bewertungen für dasselbe Produkt mit derselben E-Mail-Adresse einreichen.
• Blockierte Wörter: Erstellen Sie eine durch Kommas getrennte Liste verbotener Wörter. Bewertungen mit diesen Wörtern werden automatisch blockiert.

Pro-Funktionen & Integrationen

Wenn Sie Maria Ratings Pro nutzen, haben Sie Zugriff auf spezielle Premium-Konfigurationen:

• Medien-Uploads: Aktivieren Sie Foto- und Video-Uploads. Legen Sie die maximale Dateianzahl und Dateigröße (in MB) fest, um Speicherplatz zu sparen.
• Multikriterien-Bewertungen: Definieren Sie benutzerdefinierte Metriken (z.B. Qualität, Wert) und lassen Sie Kunden jede einzeln bewerten.
• Rich-Text-Editor: Ein wunderschöner WYSIWYG-Editor, der Benutzern formatierten Text, Fett- und Kursivdruck ermöglicht.
• Hilfreich-Abstimmung: Lassen Sie Besucher darüber abstimmen, ob eine Bewertung hilfreich war.
• Verifizierte Abzeichen: Zeigen Sie ein offizielles "Verifiziert"-Häkchen für Bewerter an, die die E-Mail-Verifizierung abgeschlossen haben.
• SEO Schema (JSON-LD): Fügen Sie strukturierte Daten in Ihre Webseiten ein, damit Google Sternebewertungen direkt in den Suchergebnissen anzeigt.
• CAPTCHA Konfiguration: Wählen Sie Google reCAPTCHA v3 oder Cloudflare Turnstile, um Bots geräuschlos zu blockieren.
• SMTP E-Mail-Einstellungen: Geben Sie Ihre SMTP-Anmeldeinformationen ein, um E-Mails zuverlässig zu versenden.
• Admin-Benachrichtigungen: Senden Sie automatisch eine E-Mail-Warnung an Ihren Posteingang, sobald eine neue Bewertung eingereicht wird.
• E-Mail-Verifizierung (Double Opt-in): Um gefälschte Bewertungen zu verhindern, können Sie Benutzer zwingen, ihre E-Mail-Adresse über einen automatisierten Link zu bestätigen, bevor die Bewertung zur Moderation freigegeben wird.

7. Sicherheits-Best-Practices

Bevor Sie Ihr Bewertungssystem der Öffentlichkeit zugänglich machen, stellen Sie bitte sicher, dass die folgenden Sicherheitsmaßnahmen getroffen wurden:

• Erlaubte Ursprünge: Definieren Sie explizit die erlaubten Domainnamen. Verwenden Sie den Platzhalter * nicht in einer Produktionsumgebung.
• Schützen Sie den JSON-Speicher: Wenn Sie JSON verwenden, müssen Sie den direkten Webzugriff auf das storage/ Verzeichnis blockieren. Apache-Benutzer sind standardmäßig durch die mitgelieferte .htaccess geschützt. Wenn Sie Nginx oder IIS verwenden, müssen Sie Ihre Serverregeln konfigurieren, um den Zugriff explizit zu verweigern.