=== DIRSCHL Google Reviews ===
Contributors: dirschl
Tags: google reviews, reviews widget, rating badge, shortcode, places api
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.0.14
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Free Google Reviews badge and shortcode with Places API data, caching, path exclusions, and responsive WordPress output.

== Description ==

DIRSCHL Google Reviews is free and open-source software for WordPress. There is no DIRSCHL license key, paid feature gate, account, or included usage quota.

Google-Bewertungen als Floating-Badge oder Text-Shortcode sichtbar machen – mit eigenem Places-API-Key und lokalem Cache.

= Features =

* Floating-Badge mit Durchschnitt, Bewertungsanzahl, Sternen und Links zum Lesen oder Bewerten
* Shortcode [dirschl_google_reviews] für Seiten, Beiträge, Footer und Landingpages
* konfigurierbare Cache-Dauer, gespeicherte Fallback-Daten und Localhost-Modus
* Pfad-Ausschlüsse, eigene Farben, Linktexte und Hub-CSS-Variablen
* serverseitiger Abruf über Google Places API; keine einzelnen Rezensionstexte im Frontend

= Typical use cases =

* lokale Unternehmen
* Agentur-Websites
* Dienstleister
* Kontakt- und Vertrauensbereiche

= Search and compatibility =

Google Reviews WordPress Plugin kostenlos · free Google reviews widget · Google rating badge shortcode

Der Shortcode funktioniert im Gutenberg-Shortcode-Block sowie in Divi, Elementor und anderen Buildern, die WordPress-Shortcodes ausführen.

== Installation ==

1. Upload the plugin ZIP through **Plugins → Add New → Upload Plugin**, or install it with the free DIRSCHL Hub.
2. Activate **DIRSCHL Google Reviews**. No DIRSCHL license is required.
3. Plugin installieren und unter Einstellungen → Google Reviews öffnen.
4. Google Places API aktivieren, eingeschränkten API-Key und Place ID speichern.
5. Verbindung testen und Badge aktivieren oder [dirschl_google_reviews] einfügen.

== Quick Start ==

`[dirschl_google_reviews]`

== Frequently Asked Questions ==

= Does it display individual review texts? =

No. It displays the business name, aggregate rating, rating count, stars, and configured links.

= Can I hide the floating badge on selected pages? =

Yes. Add path prefixes to the exclusion list. The content shortcode remains independent.

= Is the Google API free? =

The plugin is free. Google API usage is governed and billed by Google under your own account.

= Is the plugin really free and open source? =

Yes. The plugin code is licensed under GPL-2.0-or-later. You may use, inspect, modify, and redistribute it under a compatible license. It is not dual-licensed under MIT.

= Does free mean that every external service is free? =

No. Live-Daten werden serverseitig über die Google Places API geladen. Google kann ein Abrechnungskonto verlangen und Gebühren berechnen. Der Betreiber muss API-Key, Datenschutzinformation und Einwilligungsbedarf selbst prüfen.

= Does it support Gutenberg, Divi, and Elementor? =

Der Shortcode funktioniert im Gutenberg-Shortcode-Block sowie in Divi, Elementor und anderen Buildern, die WordPress-Shortcodes ausführen.

== Privacy and External Services ==

Live-Daten werden serverseitig über die Google Places API geladen. Google kann ein Abrechnungskonto verlangen und Gebühren berechnen. Der Betreiber muss API-Key, Datenschutzinformation und Einwilligungsbedarf selbst prüfen.

Review your consent setup, privacy notice, retention rules, external provider terms, and regional legal requirements for your specific configuration.

== Developers ==

The source is intentionally editable. Keep WordPress capability checks, nonces, escaping, sanitization, and privacy behavior intact when creating derivatives.

Developed by Johann Dirschl. Want to build WordPress plugins with Cursor AI or Codex, or automate development workflows? See the B2B training at https://www.dirschl.com/academy/cursor-ai-codex-entwicklung/

== Changelog ==

= 2.0.14 =
* Free and open-source positioning, repository-ready documentation, quick start, privacy notes, and developer guidance.
