=== Pan-Google-Beurteilungen ===
Contributors: pan4
Tags: google reviews, bewertungen, google bewertungen, reviews, testimonials
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.0
Stable tag: 1.9.23
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Google-Bewertungen im hellen Karten-Stil auf der Website zeigen: voll funktionsfähig mit der Google API, datensparsam, ohne Profilbilder. Kostenlos.

== Description ==

Pan-Google-Beurteilungen bindet Google-Bewertungen per Block, Shortcode, Widget oder Elementor ein, im hellen Karten-Stil (weiße Karten, gelbe Sterne) oder schlicht mit eigenen Farben. Voll funktionsfähig mit der Google Places API.

* Drei Quellen: Google Places API (offiziell, voll funktionsfähig), manuelle Pflege (Einfügen aus Google Maps, CSV-Import) oder eine Testfunktion ohne API-Key
* Reihenfolge (neueste, älteste, beste, schlechteste, Zufall), Filter (Alter, Suchbegriff), optional gleitender Slider
* Sammelspeicher: neue Bewertungen werden ergänzt, nichts wird überschrieben (max. 300 pro Standort)
* Jede Bewertung einzeln ein- oder ausblendbar, Filter nach Sternen
* Layouts: Karten, Liste, Slider, Masonry, Badge, schwebendes Badge; responsiv
* Datensparsam: keine Profilbilder, Namen gekürzt („Anna K.“), kleine Datenbank
* Keine Verbindung des Besucher-Browsers zu Google (kein Tracking durch dieses Plugin)
* Mehrere Standorte, Generator mit Live-Vorschau, Sicherungen, Export/Import
* Abruf per WP-Cron und/oder externem Cron, Intervall täglich, wöchentlich oder monatlich
* Datenschutz-Textvorschlag im Admin (Entwurf, keine Rechtsberatung)

= Wichtiger Hinweis zur Testfunktion ohne API-Key =

Der Abruf ohne API-Key liest die öffentliche Google-Maps-Seite aus (nur nach ausdrücklicher Freigabe in den Einstellungen; der Kompatibilitätsmodus ist ebenfalls standardmäßig aus). Das ist von Google nicht vorgesehen und widerspricht den Google-Nutzungsbedingungen. Sie ist standardmäßig ausgeschaltet und muss unter „Testfunktion freigeben“ bewusst freigegeben werden. Die Funktion kann jederzeit ausfallen, liefert nur die 5 von Google angezeigten Bewertungen, ein Nachladen älterer lehnt Google für Server ab und wird auf eigene Verantwortung genutzt. Die Google Places API ist der offizielle Weg (siehe Hinweis zu den Richtlinien unten), daneben gibt es den manuellen Modus. Nach 3 Fehlern in Folge pausiert der automatische Abruf 7 Tage.

Dieses Plugin steht in keiner Verbindung zu Google LLC. „Google“ und „Google Maps“ sind Marken von Google LLC.

== Externe Dienste ==

* **Google Places API** (nur wenn Quelle „API“ gewählt): Der Server sendet API-Key und Place-ID an places.googleapis.com. Hinweis: Die Places-API-Richtlinien (https://developers.google.com/maps/documentation/places/web-service/policies) schränken das Zwischenspeichern von Inhalten ein und verlangen bei Bewertungen eine Autorenangabe (Bild, Name, Profil-Link). Dieses Plugin speichert Bewertungen und zeigt bewusst keine Profilbilder und -Links. Prüfe vor dem Einsatz, ob das für dich passt. Dienst: Google Ireland Ltd. — Nutzungsbedingungen: https://cloud.google.com/terms — Datenschutz: https://policies.google.com/privacy
* **Google Maps-Seite** (nur Testfunktion ohne API-Key, nur nach ausdrücklicher Freigabe): Der Server ruft www.google.com/maps?cid=… ab und liest daraus Firmendaten und Bewertungen.
* **Links zu Google/pan4.de:** Klickt ein Besucher auf „Alle Bewertungen ansehen“, „Jetzt bewerten“ oder den kleinen Hinweis-Link zu pan4.de, öffnet sich ein neues Fenster. Der kleine Hinweis-Link zu pan4.de ist fester Bestandteil des kostenlosen Plugins.

Die Abrufe erfolgen ausschließlich vom Server der Website, nie vom Browser der Besucher.

== Installation ==

1. Plugin hochladen und aktivieren (Menü „Pan4“ → „Pan-Google-Beurteilungen“).
2. Quelle wählen und Daten eintragen (API-Key + Place-ID, CID oder manuell).
3. „Plugin aktivieren“ einschalten, „Jetzt abrufen“ drücken.
4. Block „Google-Beurteilungen“ oder Shortcode `[pan_beurteilungen]` einfügen (Generator im Admin).

== Frequently Asked Questions ==

= Brauche ich einen API-Key? =
Nein, aber nur die Places API ist die offizielle und stabile Quelle. Alternativ: manuell pflegen.

= Warum sehe ich nur 5 Bewertungen? =
Google liefert pro Abruf nur die 5 „hilfreichsten“ Bewertungen (nicht die neuesten), mit der API wie ohne. Das gilt auch für andere Plugins. Gesamtnote und Anzahl werden bei jedem Abruf aktuell geholt. Neue Bewertungen kommen dazu, sobald Google sie in die Auswahl aufnimmt; der Bestand wächst. Ältere ergänzt du im Tab „Manuelle Bewertungen“ per „Aus Google einfügen“. Sie werden zu den abgerufenen dazugemischt.

= Warum kann ein anderes Plugin mehr Bewertungen holen? =
Solche Plugins fragen die Bewertungen über eigene Server des Anbieters ab (oft mit Kontingent oder Bezahlversion). Dieses Plugin holt direkt von Google und kommt deshalb nicht über die Auswahl von Google hinaus.

= Werden Profilbilder geladen? =
Nein. Es gibt nur Initialen-Kreise.

= Was ist der kleine Link zu pan4.de? =
Ein Hinweis auf den Anbieter („Kostenloses Google Bewertungs Plugin von Pan4.de“). Er ist fester Bestandteil des kostenlosen Plugins und nicht abschaltbar.

== Changelog ==

= 1.9.23 =
* Der Hinweis-Link unter dem Widget führt jetzt auf die Plugin-Seite https://pan4.de/pan-google-beurteilungen/.

= 1.9.22 =
* Der kleine Hinweis-Link zu pan4.de unter dem Widget ist jetzt fester Bestandteil und nicht mehr abschaltbar.

= 1.9.21 =
* Das Google-Symbol und „powered by Google“ wurden entfernt; als Quellenangabe bleibt der Text „Bewertungen von Google“.

= 1.9.20 =
* Rechtlich vorsichtiger: Die Testfunktion „Ohne API-Key“ ist standardmäßig aus und muss in den Einstellungen ausdrücklich freigegeben werden; ohne Freigabe wird keine Anfrage an die Google-Maps-Seite gesendet. Der Kompatibilitätsmodus ist standardmäßig aus.

= 1.9.19 =
* Hilfe und Beschreibung: Erfahrungen aus der Praxis (voll funktionsfähig mit der Google API, Grenze von 5 Bewertungen, Ergänzen per Einfügen, Testfunktion ohne API-Key).

= 1.9.18 =
* Neu: „Aus Google einfügen“ – in Google Maps kopierte Bewertungen werden erkannt (Name, Sterne, Datum, Text) und übernommen.
* Manuelle Bewertungen werden jetzt auch bei den Quellen „Ohne API-Key“ und „Google Places API“ zu den abgerufenen dazugemischt (Dubletten nur einmal).

= 1.9.17 =
* Das Nachladen weiterer Bewertungen wurde wieder entfernt: Google lehnt die Listenabfrage ab (HTTP 403). Ältere Bewertungen über „Manuelle Bewertungen“ ergänzen.

= 1.9.16 =
* Google-Stil: Feinschliff für kleine Bildschirme (Handy).

= 1.9.15 =
* Neu: Reihenfolge (neueste, älteste, beste, schlechteste, Zufall), Filter „nicht älter als N Monate“ und Suchbegriff, optionaler langsamer Slider-Lauf (stoppt bei Hover/Touch). Auch im Shortcode: order, max_age, keyword, slider_speed.

= 1.9.14 =
* Neu: Weitere Bewertungen nachladen (Quelle „Ohne API-Key“, Testfunktion): automatisch höchstens 10 pro Tag, per Button höchstens 30 pro Tag. Seitenweise, Fortsetzung am nächsten Tag.

= 1.9.13 =
* Neu: Google-Stil für die Bewertungen (weiße Karten, farbige Initialen, gelbe Sterne, blauer Bewerten-Button). Einstellung „Stil“, im Shortcode design="google" oder design="standard".
* Kompatibilitätsmodus ist beim Abruf ohne API-Key jetzt standardmäßig an (abschaltbar).

= 1.9.12 =
* Fix: Das Speichern der Einstellungen löschte die CID (Quelle „Ohne API-Key“); neues Feld „CID“ in den Einstellungen
* Export/Import enthält jetzt auch Standorte und Cron-Einstellungen (ohne geheimen Token)
* Alle Einstellungsfelder per Rundlauf-Test auf korrektes Speichern geprüft

= 1.9.11 =
* Abruf ohne API-Key: Ortsdaten werden über den vorgeladenen Ort-Abruf der Maps-Seite gelesen (neues Google-Seitenformat)
* Diagnose: Variante I (preview/place), Variante H korrigiert

= 1.9.10 =
* Diagnose: Auszug aus der Google-Seite und Test der Bewertungsliste (Variante H)

= 1.9.9 =
* Diagnose zeigt jetzt, wie weit die Auswertung der Google-Seite kommt, samt Bericht zum Kopieren

= 1.9.8 =
* Menü: gemeinsamer Pan4-Menüpunkt (Pan4_Admin_Menu), kein doppeltes „Pan4“ mehr
* Hilfe: Hinweis auf Google-Einwilligungsseite bei Abruf ohne API-Key
* Neu: optionaler Kompatibilitätsmodus für den Abruf ohne API-Key (standardmäßig aus)
* Neu: Diagnose im Tab „Status & Log“ (testet mehrere Abruf-Varianten bei Google, auch mit fremder CID)

= 1.9.7 =
* Neuer Tab „Hilfe“: Schritt-für-Schritt-Anleitung (Google-Maps-Link, API-Key, Place-ID, manuell, Einbinden, Probleme)
* API-Key-Hinweis korrigiert: Einschränkung auf Server-IP statt Domain

= 1.9.6 =
* Hinweis zu den Places-API-Richtlinien (Speichern, Autorenangabe)

= 1.9.5 =
* Automatischer Abruf ohne API-Key pausiert nach 3 Fehlern in Folge für 7 Tage
* readme.txt, Hinweise zur Testfunktion

= 1.9.0 =
* Tab „Abruf & Cron“: WP-Cron und/oder externer Cron per geheimer Adresse, Intervall täglich/wöchentlich/monatlich
* Gemeinsames Pan4-Fehlerprotokoll

= 1.8.0 =
* Umbenennung in Pan-Google-Beurteilungen, schnellere Auslieferung ohne Wartezeit auf Google
