=== Fivenson Reviews Widget for Google Business ===
Contributors: fivensonstudiosinc
Tags: google reviews, reviews widget, business reviews, testimonials, customer reviews
Requires at least: 5.6
Tested up to: 7.1
Stable tag: 1.1.6
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display verified Google Business reviews with responsive touch carousels, customizable grid layouts, and Schema star rating snippets.

== Description ==

Fivenson Reviews Widget for Google Business allows you to display authentic customer reviews from your Google Business Profile on any WordPress site. Reviews are supplied by a JSON feed you maintain or specify; the plugin renders and formats the feed with responsive touch sliders, carousels, and grid layouts.

Created by Chris Narine-Fivenson at [Fivenson Studios](https://fivensonstudios.com).

Designed for performance, reliability, and visitor trust:
* **Interactive Carousel & Slider:** Smooth auto-scrolling card slider with touch finger swipe, mouse grab-and-drag, and circular navigation buttons.
* **Sort by Newest 1st:** Chronological ordering ensures your newest, freshest customer reviews are displayed prominently.
* **Responsive Grid & List Feed:** Complete reviews feed with high-impact rating summary badge, "Write a review" call to action, and "Load More" pagination.
* **SEO Rich Snippets (Schema.org):** Built-in LocalBusiness AggregateRating structured data injection for organic Google star snippets.
* **Secure Client Architecture:** Zero client-side API key exposure. Front-end DOM rendering uses safe text node creation and sanitized attributes.
* **Star Filtering:** Easily filter out low ratings (e.g. show only 3, 4, or 5-star reviews).
* **Lightweight & Fast:** Pure vanilla JS and scoped CSS with zero bulky dependencies.
* **Visual Shortcode Generator:** Built-in copy-and-paste tool for Elementor, Gutenberg, and classic editors.

== Installation ==

1. Upload the `fivenson-business-reviews-for-google` folder to your `/wp-content/plugins/` directory, or install directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **Settings > Fivenson Reviews** to enter your Google Place ID and customize your preferences.
4. Place the shortcode `[fivenson_reviews layout="slider" sort="newest" min_rating="3"]` anywhere on your site.

== Frequently Asked Questions ==

= How do I find my Google Place ID? =
You can find your Place ID using Google's Place ID Finder tool or entering your business name in the plugin settings.

= Can I hide reviews under 3 stars? =
Yes, you can set the `min_rating` attribute or configure it in the admin settings. Reviews below your threshold are filtered out.

= Can visitors swipe with their fingers on mobile? =
Yes! The carousel supports full touch swipe on mobile and mouse grab-and-drag on desktop.

= Does this expose my Google Cloud API keys? =
No. The plugin is built with a zero-credential client architecture to prevent quota theft and key abuse.

= Does this plugin inject Google SEO Schema? =
Yes. Enabling the SEO & Schema setting outputs Schema.org AggregateRating markup into the page header for Google search rich snippets.

= How are reviews synchronized? =
Reviews are supplied by a JSON feed URL you configure under Settings > Fivenson Reviews (or an endpoint you maintain). The plugin renders the feed with responsive sliders, touch gestures, and star filtering without exposing Google API credentials in client-side code.

= Where can I get support or request features? =
For support or inquiries, contact info@fivensonstudios.com or visit https://fivensonstudios.com.

== Changelog ==

= 1.1.6 =
* Privacy & Data Protection: Replaced bundled client reviews with generic anonymized sample data.
* Configuration Defaults: Cleared all client-specific defaults for Place ID, business name, and review URLs.
* Schema & SEO Compliance: AggregateRating structured data is now dynamically derived from validated feed data; omitted when unsubstantiated to comply with Google search guidelines.
* Schema Default: Disabled schema output by default to prevent conflicts with dedicated SEO plugins.
* Compatibility: Added backward-compatibility alias for the [trust_reviews] shortcode.

= 1.1.5 =
* Renamed plugin display name to "Fivenson Reviews Widget for Google Business" per WordPress.org reviewer recommendation.
* Synchronized all internationalization gettext functions to text domain "fivenson-business-reviews-for-google".
* Standardized all prefixes to "fivenson_reviews" (minimum 4+ characters) across defines, options, and shortcodes.
* Removed legacy shortcodes and 3-letter constants.

= 1.1.0 =
* Added chronological sorting with "Newest first" as default.
* Added touch swipe on mobile and mouse grab-and-drag on desktop with inertia snap.
* Added comprehensive 5-tab WordPress admin settings suite.
* Added Schema.org LocalBusiness AggregateRating JSON-LD integration for SEO rich snippets.
* Added interactive Shortcode Generator tool in admin settings.
* Added brand accent color customizer.
* Added uninstall.php cleanup script for official WordPress.org repository compliance.

= 1.0.0 =
* Initial public release with slider, list, star filtering, and secure rendering.
