=== ReviewSolicitors Widgets ===
Contributors: reviewsolicitors
Tags: reviews, testimonials, widget, solicitors, law firm
Requires at least: 6.0
Tested up to: 7.1
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 ReviewSolicitors reviews on your website. Choose a widget, style it and switch it on or off without copying any code.

== Description ==

* Pick any ReviewSolicitors widget from a gallery and style it with a live preview.
* Create as many versions of a widget as you need, for example one per office or area of law.
* Switch each widget on or off with one click.
* Show a widget on every page, on the home page, on chosen pages, or only where you place it.
* Place widgets with the "ReviewSolicitors widget" block, a shortcode, or Appearance › Widgets.
* Widgets created in your ReviewSolicitors dashboard appear in WordPress too, and changes go both ways.

Your website keeps showing your widgets even if ReviewSolicitors cannot be reached while you edit.

The plugin needs a ReviewSolicitors API token, which firms with an active Premium membership can create in their dashboard under API Settings. Custom colours need the Widget Theming add-on.

== External services ==

This plugin relies on ReviewSolicitors (https://www.reviewsolicitors.co.uk), the review platform your firm's widgets and reviews come from. It cannot work without it.

* **ReviewSolicitors API, from your WordPress site.** When you connect, open the widget list, create, edit, preview, switch or delete a widget, and twice a day in the background, the plugin sends your API token and the widget settings you choose to https://www.reviewsolicitors.co.uk/api/v2/widgets. It receives your firm's widgets and the widget previews. No visitor data is sent.
* **ReviewSolicitors embed script, from your visitors' browsers.** On pages that show a widget, visitors' browsers load the embed script (https://www.reviewsolicitors.co.uk/widget/rs.js) and the widget content from ReviewSolicitors, exactly as with the copy-and-paste widget code. ReviewSolicitors receives the visitor's IP address, browser details and the address of the page, and records that the widget was shown.

ReviewSolicitors terms and conditions: https://www.reviewsolicitors.co.uk/terms
ReviewSolicitors privacy policy: https://www.reviewsolicitors.co.uk/privacy-policy

== Installation ==

1. Upload the plugin from Plugins › Add New › Upload Plugin and activate it.
2. Sign in to your ReviewSolicitors dashboard, open API Settings and generate a token. Under "What is this token for?" choose WordPress plugin, so the token can only manage your widgets.
3. In WordPress, open ReviewSolicitors › Connection, paste the token and select Connect.
4. Open ReviewSolicitors › Widgets and select Add widget.

== Frequently Asked Questions ==

= How do I place a widget inside a page? =

Add the "ReviewSolicitors widget" block and pick the widget, or paste its shortcode, for example `[reviewsolicitors_widget code="AbC123"]`. You can copy the shortcode from the widget list.

= Can I show the same widget on several pages? =

Yes. Either choose "Chosen pages" under "Where it shows", or place the block or shortcode on each page.

= Can I show two widgets of the same type on one page? =

Not yet. The ReviewSolicitors embed script shows one widget of each type per page, so place different types together (for example a Badge and a Carousel) rather than two Badges.

= What happens when I disconnect? =

Widgets stop showing on your website until you connect again. Your widgets and their settings stay in your ReviewSolicitors account.

= Which data does the plugin send? =

Only the widget settings you choose, sent to ReviewSolicitors with your API token. Visitors' browsers load the widget from ReviewSolicitors, as they do with the copy-and-paste code.

== Screenshots ==

1. Choose a widget from the gallery: star ratings, showcase reviews, badges, individual professionals and review highlights.
2. Style a widget with a live preview, on desktop or mobile.
3. Choose where each widget shows: only where you place it, on every page, on the home page or on chosen pages.
4. All your widgets at a glance: switch each one on or off and see which pages show it.
5. Place a widget with the "ReviewSolicitors widget" block, and change it without leaving the editor.
6. A Badge on the home page, with the Side widget showing on every page.
7. The Full page widget on a client reviews page.
8. Connect your website with an API token from your ReviewSolicitors dashboard.

== Changelog ==

= 1.0.0 =
* First release.
