=== GR Review - Reviews Widget for Google ===
Contributors: besthelptool
Donate link: https://besthelptool.com/
Tags: google reviews, reviews widget, google business reviews, testimonials, customer reviews
Requires at least: 5.6
Tested up to: 7.1
Stable tag: 1.0.2
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Embed responsive customer reviews and Google ratings on your WordPress site in Carousel, Masonry Grid, List, Floating Badge, or Compact Pill formats.

== Description ==

**GR Review** is an ultra-fast, zero-dependency WordPress plugin that showcases your verified customer ratings and Google business testimonials anywhere on your site.

No complex Google Cloud Console credentials or Google API keys required! Display verified customer social proof instantly using simple shortcodes, classic widgets, or the WordPress block editor.

[Online Generator & Live Demos](https://besthelptool.com/) | [Explore More Free Business Tools](https://besthelptool.com/)

### Key Features

* **5 Beautiful Layout Styles**:
  * **Interactive Carousel Slider**: Smooth horizontal touch-friendly review slider with navigation dots and arrows.
  * **Masonry Grid**: Clean multi-column review wall that dynamically adapts to desktop, tablet, and mobile.
  * **Review List**: Clean vertical testimonial feed ideal for dedicated review or case study pages.
  * **Sticky Floating Badge**: Discreet bottom corner pill that slides open an elegant review drawer upon click.
  * **Compact Pill Badge**: High-density header/footer badge displaying your aggregate 4.9★ rating and customer avatars.
* **Sub-10ms Lightweight Footprint**: Zero jQuery dependency on frontend, pure vanilla JavaScript under 12KB with zero render-blocking scripts.
* **Direct "Write a Review" CTA**: Optional high-converting button linking directly to your Google Maps review submission dialog.
* **Rating Filter**: Filter reviews to display only 4+ or 5-star ratings.
* **Custom Theming**: Light and dark mode support with customizable accent colors, star colors, and border radii.
* **Shortcode & Gutenberg Support**: Works with `[grreview_google_reviews]` shortcode, classic widgets, and modern block editor.
* **Page Builder Friendly**: 100% compatible with Elementor, Divi, Beaver Builder, Oxygen, Bricks, and Gutenberg.

== External Services ==

This plugin relies on external services to fetch and display Google Business reviews:

1. **BestHelpTool GR Review Cloud API**
* **Service**: BestHelpTool GR Review API (https://besthelptool.site/grreview/)
* **Purpose**: Fetches public Google Business review data (ratings, review text, author names, avatars, review dates) and widget layout configuration for the specified widget preset or ID.
* **Data transmitted**: When a page containing the widget is viewed, the visitor's browser makes an HTTPS GET request to `https://besthelptool.site/grreview/api.php?action=get_widget&id=<widget_id>`. Only the widget preset identifier is transmitted. No personal data, IP tracking, cookies, or user credentials are sent or stored.
* **Terms of Service**: [Terms and Conditions](https://besthelptool.site/terms-and-conditions/)
* **Privacy Policy**: [Privacy Policy](https://besthelptool.site/privacy-policy-2/)

2. **Google Maps / Places Service**
* **Service**: Google Maps (https://maps.google.com)
* **Purpose**: Provides optional direct links for visitors to view your official business profile on Google Maps and submit verified reviews via the "Write a review" CTA button.
* **Data transmitted**: User interaction only. When a user clicks the business name or "Write a review" button, they are redirected via standard HTTPS link to the business's public Google Maps URL.
* **Terms of Service**: [Google Terms of Service](https://policies.google.com/terms)
* **Privacy Policy**: [Google Privacy Policy](https://policies.google.com/privacy)

== Installation ==

### Automatic Installation via WordPress Admin:
1. Log in to your WordPress dashboard.
2. Go to **Plugins &rarr; Add New**.
3. Search for `GR Review - Reviews Widget for Google` or click **Upload Plugin** and select the `gr-review-reviews-widget-for-google.zip` file.
4. Click **Install Now** and then **Activate**.

### Manual Installation via FTP:
1. Download `gr-review-reviews-widget-for-google.zip` and extract the files.
2. Upload the `gr-review-reviews-widget-for-google` folder to the `/wp-content/plugins/` directory.
3. Activate the plugin through the **Plugins** menu in WordPress.

### How to Display Reviews:
* **Using Shortcode**: Insert `[grreview_google_reviews id="preset_dental"]` into any page, post, or text widget.
* **Using Custom Configuration**: Configure your display at `wp-admin &rarr; Google Reviews` and copy the generated shortcode.
* **Using Widget**: Navigate to **Appearance &rarr; Widgets**, find the **Google Reviews (GR Review)** widget and place it in your sidebar or footer.

== Frequently Asked Questions ==

= Do I need a Google Cloud API key? =
No. You do not need a Google Cloud account, billing setup, or API key. The widget loads your listing details or customized verified reviews automatically.

= Which layouts are available? =
You can choose between Carousel Slider, Masonry Grid, Vertical List, Floating Corner Badge, and Compact Header Pill.

= Will this plugin slow down my WordPress site? =
No! The client script is under 12KB, loads asynchronously, and has zero external dependencies, keeping your Google Core Web Vitals green.

= Does it work with Elementor or Divi? =
Yes. Add a Shortcode or HTML block in Elementor, Divi, or your preferred page builder and insert `[grreview_google_reviews]`.

= Are there any hidden limits or locked features? =
No. This plugin is 100% free, fully functional, and contains no locked features, quotas, or forced attribution watermarks.

== Screenshots ==

1. Carousel Slider Layout with Google star ratings and customer testimonials.
2. Responsive Masonry Grid review wall layout.
3. Sticky Floating Corner Badge with expandable reviews drawer.
4. WordPress Admin Studio Builder and shortcode generator.

== Changelog ==

= 1.0.2 =
* Added built-in rich demo reviews for BrightSmile Dental Studio, Artisan Bakery & Cafe, and Summit Legal Partners presets.
* Fixed admin live widget interactive preview rendering without external network latency.
* Updated all external documentation and generator links to besthelptool.com.

= 1.0.1 =
* WordPress.org Plugin Directory review compliance release.
* Added comprehensive "External Services" disclosure in readme for BestHelpTool API and Google Maps.
* Removed all license key checks, trialware mechanisms, and watermark locks; all features are 100% free and fully functional.
* Standardized all declarations, hooks, script handles, and options with the unique `grreview_` prefix.
* Removed directory banner and icon assets from the plugin zip package (moved to repository assets).
* Removed redundant `load_plugin_textdomain()` call (handled automatically by WordPress.org since 4.6).
* Reduced readme tags list to exactly 5 tags.

= 1.0.0 =
* Initial public release.
* 5 responsive layout options (Carousel, Grid, List, Floating, Badge).
* Shortcode `[grreview_google_reviews]` with customizable layout attributes.
* Classic sidebar widget support and Gutenberg block support.

== Upgrade Notice ==

= 1.0.2 =
* Built-in demo reviews and instant live preview improvements.
