=== Truewidgets — Google Reviews ===
Contributors: truewidgets
Tags: reviews, google reviews, testimonials, rating, widget
Requires at least: 5.8
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show your Google reviews, honest rating and trust wall anywhere on your site — with a block or a shortcode. No code required.

== Description ==

Truewidgets turns your Google reviews into a beautiful, fast, self-contained widget you can drop anywhere on your WordPress site.

* **Block or shortcode** — add the “Truewidgets Reviews” block, or use `[truewidgets]`.
* **Six layouts** — carousel, grid, masonry, list, badge and floating.
* **Honest rating** — the widget shows a real, count-weighted average across your sources, never an inflated number.
* **Fast & isolated** — the widget renders in a closed Shadow DOM, so your theme’s CSS can’t break it and its CSS can’t leak into your site.
* **Loads only where used** — the script is enqueued on pages that actually contain a widget, so the rest of your site stays light.

You’ll need a Truewidgets account to get a Widget ID. Create one at https://truewidgets.com.

== Installation ==

1. Upload the `truewidgets` folder to `/wp-content/plugins/`, or install the ZIP via Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Go to **Settings → Truewidgets** and paste your **Widget ID** (from your Truewidgets dashboard).
4. Add the **Truewidgets Reviews** block to any page, or use the `[truewidgets]` shortcode.

== Usage ==

**Block:** search for “Truewidgets Reviews”, then set the Widget ID and layout in the sidebar.

**Shortcode:**
`[truewidgets]` — uses your default Widget ID and dashboard layout.
`[truewidgets id="your-widget-id" layout="grid"]` — override per placement.
`[truewidgets id="your-widget-id" min_height="450"]` — reserve vertical space while it loads.

**Theme template:**
`<?php if ( function_exists( 'truewidgets_widget' ) ) truewidgets_widget( 'your-widget-id', 'carousel' ); ?>`

Layouts: `carousel`, `grid`, `masonry`, `list`, `badge`, `floating`. Leave the layout blank to use whatever you set in the dashboard.

== Frequently Asked Questions ==

= Do I need a Truewidgets account? =
Yes — the plugin displays a widget you configure in your Truewidgets dashboard. Grab your Widget ID there.

= Where do I set my Widget ID? =
Settings → Truewidgets sets a site-wide default. Individual blocks and shortcodes can override it.

= Will it slow down my site? =
No. The widget script is loaded asynchronously and only on pages that actually contain a widget.

== Changelog ==

= 1.0.0 =
* Initial release: block, shortcode, template tag, and settings screen.
