=== Willro Reviews ===
Contributors: sitgram
Tags: reviews, ratings, testimonials, video reviews, business reviews
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Show Willro text, image & video reviews with 3 templates, shortcode, and an Elementor widget.

== Description ==

**Willro Reviews** connects your WordPress site to [Willro](https://www.willro.com) — a next-generation review platform where real customers share their experiences through text, images, and videos.

Show your visitors what real customers think, right on your website. Build trust, increase conversions, and let authentic voices grow your business.

> **You need a [Willro](https://www.willro.com) business account to use this plugin.**

---

= ✨ Key Features =

* 📝 **Text, Image & Video Reviews** — Display rich media reviews from your Willro business profile including text, photos, and video reviews.
* 🎨 **3 Beautiful Templates** — Choose from 3 professionally designed display templates. Template 3 is dedicated to video reviews.
* ⭐ **Rating Filter** — Show reviews filtered by star rating (1–5 stars or all).
* 🏆 **Willro Score** — Display your overall Willro business score directly on your review sections.
* 🔃 **Sort Options** — Sort reviews by latest, highest rating, or lowest rating.
* 📦 **Shortcode Support** — Embed reviews anywhere on your site using a simple shortcode.
* 🧩 **Elementor Widget** — Drag and drop reviews directly in Elementor with visual controls.
* ⚡ **Gutenberg Block** — Add reviews in the WordPress block editor with ease.
* 🔒 **Secure API Connection** — All data is fetched securely over HTTPS using your Willro API key.
* 🏷️ **Willro Attribution** — Optionally display the Willro logo/attribution in your review section.
* 🚀 **Lightweight & Fast** — Minimal footprint, built for performance.

---

= 🚀 How It Works =

1. Sign up or log in at [Willro](https://www.willro.com)
2. Get your **API key** from your Willro business dashboard
3. Install and activate this plugin
4. Go to **Willro Reviews → Settings** and enter your API key
5. Click **Test Connection** to verify your key
6. Add `[willro_reviews]` to any page, post, or widget area
7. Or use the **Willro Reviews** widget in Elementor / block in Gutenberg

---

= 📌 Shortcode Usage =

Basic:
`[willro_reviews]`

With options:
`[willro_reviews template="2" limit="10" rating="5" sortType="latest" mediaType="IMAGE"]`

**All Shortcode Parameters:**

| Parameter | Default | Options | Description |
|-----------|---------|---------|-------------|
| `template` | `1` | `1`, `2`, `3` | Display template (Template 3 = video only) |
| `limit` | `10` | `1–50` | Number of reviews to show |
| `page` | `1` | Any number | Page number for pagination |
| `rating` | _(all)_ | `1`, `2`, `3`, `4`, `5` | Filter by star rating |
| `sortType` | _(default)_ | `latest`, `highest`, `lowest` | Sort order |
| `mediaType` | _(all)_ | `IMAGE`, `VIDEO` | Filter by media type |

**Examples:**

Show 5 top-rated image reviews using template 2:
`[willro_reviews template="2" limit="5" rating="5" mediaType="IMAGE"]`

Show latest video reviews using template 3:
`[willro_reviews template="3" sortType="latest"]`

---

= 🌟 About Willro =

Willro is built around one idea: **authenticity**. Unlike traditional review platforms, Willro lets customers express their opinions through text, images, and videos — giving feedback that feels personal, relatable, and trustworthy.

With Willro, businesses don't just collect ratings — they build real connections, earn genuine trust, and grow through honest customer feedback.

👉 Learn more at [www.willro.com](https://www.willro.com)

== External Services ==

This plugin connects to the Willro API (`https://prod.willro.com/api/v1/integration/business-api`) to fetch and display your business reviews and related business information.

**What data is sent and when:**

* When a page with the Willro Reviews shortcode, block, or Elementor widget loads, your server sends a request to the Willro API including your API key (in request headers) and query parameters such as `limit`, `page`, `mediaType`, `rating`, and `sortType`.
* When you click **"Test Connection"** in plugin settings, a request is sent to the Willro API to verify your API key and retrieve your connected business name.
* Review images and videos may be loaded directly by the visitor's browser from media URLs returned by the Willro API.

**Service provider information:**

* Website: [https://www.willro.com](https://www.willro.com)
* Terms of Service: [https://www.willro.com/terms-and-conditions](https://www.willro.com/terms-and-conditions)
* Privacy Policy: [https://www.willro.com/privacy-policy](https://www.willro.com/privacy-policy)

== Installation ==

= ✅ Automatic Installation (Recommended) =

1. Go to your WordPress dashboard
2. Navigate to **Plugins → Add New**
3. Search for **Willro Reviews**
4. Click **Install Now**, then **Activate**

= 📁 Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the ZIP file and click **Install Now**
4. Activate through the **Plugins** menu

= ⚙️ Setup After Activation =

1. Go to **Willro Reviews** in your WordPress admin sidebar
2. Enter your **Willro API key**
3. Click **Save**, then click **Test Connection** to verify
4. Add `[willro_reviews]` to any page or post
5. Or use the Elementor widget / Gutenberg block

== Frequently Asked Questions ==

= Do I need a Willro account? =

Yes. You need a Willro business account to get your API key. Sign up for free at [www.willro.com](https://www.willro.com).

= Where do I find my API key? =

Log in to your Willro business dashboard and navigate to the API/Integration section to generate your API key.

= Is this plugin free? =

Yes, the plugin is completely free. Your Willro subscription plan may determine the number of reviews accessible via the API.

= How many templates are available? =

There are **3 templates**:

* **All Reviews**
* **Reviews with Rating**
* **Video Reviews** (automatically filters for video content)

= Does it work with Elementor? =

Yes! The plugin includes a dedicated **Elementor widget**. In Elementor, search for "Willro Reviews" in the widget panel and drag it onto your page.

= Does it work with the Gutenberg block editor? =

Yes! A **Gutenberg block** is included. In the block editor, search for "Willro Reviews" to add the block to any page or post.

= Can I show only video reviews? =

Yes! Use template 3, which automatically displays video reviews:
`[willro_reviews template="3"]`

Or set `mediaType="VIDEO"` in any template:
`[willro_reviews mediaType="VIDEO"]`

= Can I filter by star rating? =

Yes. Use the `rating` parameter in the shortcode:
`[willro_reviews rating="5"]` — shows only 5-star reviews.

= How many reviews can I display at once? =

You can display between 1 and 50 reviews per instance using the `limit` parameter.

= Is my API key stored securely? =

Yes. Your API key is stored securely in the WordPress database using the standard WordPress options API and is only transmitted to the Willro API over HTTPS.

= Can I show the Willro attribution/logo? =

Yes. In the plugin settings, enable the **"Show attribution"** option to display the Willro logo in your review section.

= What is the Willro Score? =

The Willro Score is your overall business rating score from the Willro platform. It is now displayed directly in all review templates so visitors can instantly see your business reputation.

== Screenshots ==

1. All Reviews
2. Reviews with Rating
3. Video Reviews
4. Plugin settings page — API key and connection test
5. Elementor widget settings

== Changelog ==

= 1.0.6 =
* Fixed: Elementor review stars hover color (SVG class sanitization)
* Fixed: Prevent JS error when SVG background element missing

= 1.0.5 =
* Improved: Elementor SVG arrow icon fill color customization
* Improved: Media reviews now display a shorter preview (30 characters) for better layout consistency
* Minor UI improvements

= 1.0.4 =
* Update adds verified author badges
* Improved performance
* Minor UI improvements

= 1.0.1 =
* Fixed: Elementor widget template loading issue
* Added: Willro Score now visible in all review templates

= 1.0.0 =
* Initial release
* Shortcode `[willro_reviews]` with full parameter support
* Elementor widget with visual controls
* Gutenberg block support
* 3 display templates (text/image/video)
* Rating filter (1–5 stars)
* Sort by latest, highest, or lowest rating
* Media type filter (image/video/all)
* Secure Willro API integration
* Test Connection feature in settings
* Optional Willro attribution display

== Upgrade Notice ==

= 1.0.6 =
Fixes Elementor hover star color not working.

= 1.0.4 =
Elementor svg icon width fix

= 1.0.3 =
This update adds verified author badges, improves review card layout when media is present, and renames template options for clarity. Upgrade recommended.

= 1.0.2 =
This update fixes Elementor template loading issues and adds Willro Score visibility across all review templates. Upgrade recommended.

= 1.0.1 =
This update fixes Elementor template loading issues and adds Willro Score visibility across all review templates. Upgrade recommended.

= 1.0.0 =
Initial release of Willro Reviews. Install and connect your Willro account to get started.
