=== Willro Reviews ===
Contributors: sitgram
Tags: video reviews, customer reviews, review plugin wordpress, woocommerce reviews, customer feedback, review for discount, review plugin, review reminder
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
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.

In today’s competitive e-commerce landscape, buyers look for social proof before they buy. Willro helps you showcase authentic customer feedback right on your website using a shortcode, an Elementor widget, or a Gutenberg block.

= WooCommerce Compatibility =

You can embed Willro Reviews anywhere on your site — including WooCommerce pages — by placing the `[willro_reviews]` shortcode where you want the reviews section to appear.

> **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 use this on WooCommerce product pages? =

Yes. Add the `[willro_reviews]` shortcode to your WooCommerce product template, product description, or any section where shortcodes are supported to display your Willro reviews.

= Can customers record video reviews directly from mobile devices? =

Yes. Customers can record or upload video reviews through the Willro platform using a smartphone or desktop browser. This plugin displays those Willro text/image/video reviews on your WordPress site.

= 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.1.0 =
* Updated: Plugin title for clearer WooCommerce + video reviews positioning
* Updated: Plugin readme tags, description, and FAQ content
* Fixed: Plugin Directory banner/icon sizes for consistent display

= 1.0.7 =
* Fixed: Filter AJAX failing for logged-out users on some sites (Invalid request)

= 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.1.0 =
Updates plugin listing text and fixes Plugin Directory banner/icon display.

= 1.0.7 =
Fixes filter not working for logged-out users.

= 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.
