=== APlug Bewertungscenter ===
Contributors: aplug
Tags: reviews, ratings, moderation, directory, booking
Requires at least: 6.4
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Verifizierte Bewertungen mit Moderation, Buchungsprüfung, Anbieterantworten und klar gekennzeichnetem Fremdimport.

== Description ==

APlug Bewertungscenter verwaltet Bewertungen und Erfahrungsberichte für Branchenregister, Buchungsangebote, Anbieterprofile und Kundenbereiche.

Hauptfunktionen:

* E-Mail-Verifizierung mit zeitlich begrenztem Bestätigungslink;
* standardmäßig zwingender Buchungsnachweis über einen dokumentierten Adapter;
* Gesamtsterne und frei benennbare Einzelkriterien;
* Moderation, Ablehnung und Archivierung;
* Missbrauchsmeldungen mit eigenem Bearbeitungsstatus;
* Antworten des Anbieters mit optionaler Antwortmoderation;
* öffentliche REST-Zusammenfassungen und strukturierte JSON-LD-Daten;
* Standard- und erweiterte Premiumdarstellung ohne Veränderung von Score oder Moderation;
* CSV-Import externer Bewertungen nur mit sichtbarer Quellenkennzeichnung;
* WordPress-Datenschutzexport und Anonymisierung;
* eigenständiger Betrieb und dokumentierte APlug-Schnittstellen.

Das Plugin ruft keine externe Bewertungsplattform ab. Es enthält keine Telemetrie, keine Werbung und keine fremd gehosteten Bibliotheken.

== Installation ==

1. Plugin-ZIP unter „Plugins > Installieren > Plugin hochladen“ auswählen.
2. Plugin aktivieren.
3. Unter „APlug Bewertungen > Einstellungen“ Moderation, E-Mail- und Buchungsmodus prüfen. Neue Installationen verlangen standardmäßig eine bestätigte Buchung.
4. Einen Shortcode auf der gewünschten Seite einfügen.
5. Bei zwingender Buchungsprüfung den dokumentierten Filter-Adapter verbinden.

Beispiel:

`[aplug_bewertungen subject_type="provider" subject_id="123" form="1"]`

== Frequently Asked Questions ==

= Kann das Plugin nur echte Buchungen bewerten lassen? =

Ja. Im Pflichtmodus akzeptiert es nur Einreichungen, deren Buchungsreferenz ein angebundenes Buchungssystem über `aplug_review_booking_verify` bestätigt. Fehlt der Adapter, wird die Einreichung kontrolliert abgewiesen und WordPress bleibt stabil.

= Werden externe Bewertungen automatisch abgerufen? =

Nein. Externe Bewertungen können nur durch einen berechtigten Administrator aus einer CSV-Datei importiert werden. Quelle und externe Referenz sind Pflichtfelder. Die Quelle wird im Frontend immer angezeigt.

= Beeinflusst die Premiumdarstellung die Bewertung? =

Nein. Premium verändert ausschließlich die Darstellung. Durchschnitt, Reihenfolge, Moderation und Veröffentlichungsstatus bleiben unverändert.

= Garantiert JSON-LD Sterne in Suchergebnissen? =

Nein. Das Plugin gibt strukturierte Daten aus, garantiert aber keine Rich Results. Der Betreiber muss Inhaltstyp, sichtbare Inhalte und die jeweils geltenden Suchmaschinenrichtlinien prüfen.

= Welche personenbezogenen Daten werden gespeichert? =

Bei eigenen Einreichungen werden Anzeigename, nicht öffentliche E-Mail-Adresse, Bewertungsinhalt, Verifizierungsstatus und gegebenenfalls ein Hash der Buchungsreferenz gespeichert. WordPress-Datenschutzexport und Anonymisierung werden unterstützt.

= Werden Daten bei Deinstallation gelöscht? =

Standardmäßig nicht. Die vollständige Löschung muss zuvor ausdrücklich in den Einstellungen aktiviert werden.

== Screenshots ==

1. Übersicht mit Veröffentlichungen, offenen Verifizierungen, Moderationen und Meldungen.
2. Moderationsansicht mit Quelle, Prüfstatus, Einzelkriterien und Anbieterantwort.
3. Einstellungen für E-Mail-Verifizierung, Buchungsnachweis und strukturierte Daten.
4. Frontend-Ausgabe mit Bewertungsübersicht, Kriterien und Missbrauchsmeldung.
5. Vorschau eines eindeutig gekennzeichneten externen CSV-Imports.

== Privacy ==

Das Plugin verarbeitet Bewertungs- und Moderationsdaten auf der eigenen WordPress-Installation. Bestätigungs-E-Mails werden über `wp_mail()` versendet. Es lädt keine externen Skripte, Schriftarten oder Bewertungsdienste. Externe Quelllinks werden erst durch einen bewussten Klick des Besuchers geöffnet.

== Changelog ==

= 1.0.1 =
* Neue Installationen verlangen standardmäßig eine bestätigte echte Buchung.
* Doppelte Bewertungen derselben Buchung werden erkannt.
* Externe Importe werden zunächst zur Moderation gespeichert.
* Strukturierte Daten berechnen bei ausgeschlossenen Fremdbewertungen auch den Aggregatwert ausschließlich aus eigenen Bewertungen.
* Einzelkriterien werden in Listen gebündelt geladen; E-Mail-Suchwerte werden per Site-HMAC pseudonymisiert.
* Datenbankindex, Dokumentation und Einreichungsunterlagen aktualisiert.
* Öffentliche REST- und APlug-Listenausgaben auf datensparsame Bewertungsobjekte begrenzt.
* Moderations-JavaScript übersetzbar gemacht und Ereigniskatalog vervollständigt.

= 1.0.0 =
* Erster eigenständig installierbarer Prototyp.
* E-Mail-Verifizierung, Buchungsadapter, Moderation und Missbrauchsmeldungen.
* Anbieterantworten, Einzelkriterien, REST-API und strukturierte Daten.
* Gekennzeichneter CSV-Import externer Bewertungen.
* APlug-Modulmanifest, Datenschutzwerkzeuge und vollständige Dokumentation.

== Upgrade Notice ==

= 1.0.1 =
Sicherheits- und Konsistenzupdate. Bei Pflichtbuchungen muss ein Buchungsadapter verbunden sein.

= 1.0.0 =
Erste Version. Vor produktivem Einsatz Buchungsadapter, Mailversand und Moderationsregeln prüfen.
