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

Floating Google Reviews badge and text shortcode for WordPress.

== Description ==

DIRSCHL Google Reviews shows your Google Business rating in two ways:

1. **Floating widget** (bottom-left on every page) – compact badge with average rating, stars, and optional links (open on click or hover).
2. **Shortcode** – plain text block for pages and posts, ideal for landing pages and contact sections.

Product page and downloads: https://dirschl.com/wordpress/plugins/dirschl-google-reviews/

= Features =

* Google Places API (Place Details) with configurable cache duration
* Floating badge: position, colors, custom CSS, path exclusions
* Open links area via **click** (with close button) or **hover**
* Shortcodes: `[dirschl_google_reviews]` and legacy `[google_bewertungen]`
* Shortcode output (text layout):
  * Business name
  * Ø rating (e.g. Ø 5.0 von 5 Sternen)
  * Review count (e.g. Basierend auf 9 Google-Bewertungen)
  * Star display
  * Links: read | write (labels configurable)
* Settings: API key, Place ID, colors, notice text, link labels, localhost mode (no API calls)
* Connection test in WordPress admin
* Automatic updates via dirschl.com update server (Update URI)
* Migration from the former „Google Bewertungen Widget“ plugin

= Shortcode example =

Place in any page or post:

`[dirschl_google_reviews]`

Rendered output (example):

DIRSCHL.com GmbH Fotograf, Webseiten und SEO
Ø 5.0 von 5 Sternen
Basierend auf 9 Google-Bewertungen
★ ★ ★ ★ ★
lesen | bewerten

= Floating widget =

Enable under **Settings → DIRSCHL Google Reviews → Floating-Widget aktivieren**.
The widget appears fixed at the bottom-left of the viewport (customizable via CSS).
On dirschl.com you can see a live example on most pages (plugin documentation pages exclude the widget intentionally).

== Installation ==

= Manual install =

1. Download the latest ZIP from https://dirschl.com/wordpress/plugins/dirschl-google-reviews/
2. In WordPress: **Plugins → Add New → Upload Plugin** – select the ZIP
3. Activate **DIRSCHL Google Reviews**
4. Go to **Settings → DIRSCHL Google Reviews**
5. Enter **Google API Key** and **Place ID**
6. Enable **Places API** in Google Cloud Console for your project
7. Click **Verbindung testen** (connection test)
8. Enable the floating widget and/or add `[dirschl_google_reviews]` to a page

= Google Cloud setup =

1. Create or select a project in Google Cloud Console
2. Enable **Places API**
3. Create an API key (restrict to your domain and Places API)
4. Find your **Place ID** via Place ID Finder or Google Maps Platform tools

= Updates =

After the first install from dirschl.com, WordPress can install updates automatically
(**Dashboard → Updates** or the plugins list), as long as the update server provides
a new `info.json` and ZIP for each release.

== Frequently Asked Questions ==

= Does the plugin work without a Google API key? =

On localhost, enable **Localhost (keine API-Zugriffe)** to use cached/stored data only.
On production you need a valid API key and Place ID for live data.

= Can I hide the floating widget on specific pages? =

Yes. Under **Pfade ausschließen** enter one path per line (e.g. `/shop` or `/games`).

= Click or hover for the floating links? =

Under **Öffnen mit** choose either **Klick** (with × to close) or **Hover** – not both.

= Custom styling? =

Use **Eigenes CSS** in the plugin settings. Default CSS includes border-radius, link colors, and hover underline.

== Screenshots ==

1. Floating widget (bottom-left)
2. Shortcode text block in page content
3. Settings page

== Changelog ==

= 2.0.7 =
* Text shortcode layout (name, rating lines, stars, lesen | bewerten)
* Product documentation, install guide, release ZIP workflow
* Expanded readme.txt

= 2.0.6 =
* Open mode: click OR hover (exclusive)
* Close button only in click mode
* Custom CSS editor with defaults
* Unified card UI (no separate popover)

= 2.0.5 =
* Custom CSS field in settings
* Spacing and link hover fixes

= 2.0.0 =
* Rebrand to DIRSCHL Google Reviews
* Update server, migration from Google Bewertungen Widget
* Legacy shortcode `[google_bewertungen]` retained

== Upgrade Notice ==

= 2.0.7 =
Improved shortcode text layout and documentation. Recommended update.
