=== Reco For Woocommerce ===
Contributors: recotrust
Donate link: https://www.reco.se
Tags: woocommerce, reviews, ratings, product reviews, ecommerce
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync WooCommerce orders with external product review service Reco.se and display high-quality rating widgets across your shop.

== Description ==

Reco For Woocommerce integrates Reco.se’s powerful review and rating infrastructure directly into your WooCommerce store.

**Features:**
- Automatically sync orders to Reco's review system
- Add product rating widgets to listings and single product pages
- Show full review lists and rating distribution charts
- Shortcodes for flexible placement anywhere
- Customize widget placement, style, and star color
- Supports localized customer invites (Swedish or English)

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/reco-for-woocommerce/`, or install via the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to **Settings → Reco For Woocommerce** to configure your API Key, store ID, and appearance options.

== Requires Plugins ==

Woocommerce

== External services ==

This plugin communicates with a single external service: Reco.se Product Review API (`https://api.reco.se/`).

What the service is and what it’s used for:
- Reco.se is an external product‑review platform. The plugin uses Reco’s API to:
  - Create review invites based on your WooCommerce orders.
  - Retrieve product ratings, rating distributions, and reviews for display in your store.
  - Optionally push store branding (color and logo) for consistent styling in Reco‑hosted experiences.

What data is sent and when:
- Order / invite creation and updates
  - When: Whenever order status changes; invites are created for orders that reach the WooCommerce status `completed`.
  - Data (examples; actual values depend on the order and your settings):
    - Order: `transactionId`, `orderNr`, `status`, `total`, `currency`, `dateCreated`, `dateModified`, `customerId` (billing email), `lang`, `storeId`, `billing` (first name, last name, company, email, phone, postcode, country)
    - Line items: `id`/`productId`, `sku`, `name`, `quantity`, `total`, `price`, `brand` (from meta or manual setting), `image`, `gtin` (if configured), `productUrl`, variation `attributes`
  - Note: This includes customer PII (name, email, phone, postcode, company if provided) and purchase details.

- Ratings/reviews retrieval (read‑only)
  - When: When storefront widgets or shortcodes request product ratings, distributions, or review lists. Responses are cached in WordPress transients for ~5 minutes.
  - Data sent: Identifiers (store and product) plus pagination parameters. No customer PII is sent in these read‑only fetches.

- Review moderation (visibility)
  - When: If you change a review’s visibility via the plugin.
  - Data: `{ "visible": true|false }`

- Store appearance/settings push (optional)
  - When: On relevant setting updates.
  - Data: `{ "brandColor": "#RRGGBB", "logoUrl": "https://…" }`

Links to the service’s terms and privacy:
- Reco website: https://www.reco.se/
- API base: https://api.reco.se/
- Terms of Service and Privacy Policy: Please refer to the legal links in the footer of https://www.reco.se/ for the most current URLs.

== Frequently Asked Questions ==

= Where do I get my API credentials? =
From your Reco representative.

= Does this plugin replace WooCommerce's default review system? =
Yes. When enabled, Reco For Woocommerce overrides the default Reviews tab with its own content from Reco.

== Required Plugins ==

Woocommerce

= Can I use shortcodes outside WooCommerce product pages? =
Yes, you can use them in posts, pages, widgets, and templates.

== Shortcodes ==

| Shortcode | Description |
| --------- | ----------- |
| `[reco-rating]` | Default stars-only widget |
| `[reco-rating style="stars-rating"]` | Stars + numeric rating |
| `[reco-rating style="stars-rating-count"]` | Stars + rating + count |
| `[reco-rating style="stars-rating-count-text"]` | Stars + rating + count + summary text |
| `[reco-rating-small]` | Compact inline star widget |
| `[reco-rating-distribution]` | Rating distribution chart |
| `[reco-reviews-list]` | Full review list |
| `[reco-reviews-tab]` | Full tab override (used automatically) |

== Screenshots ==

1. Appearance settings panel for rating widgets.
2. Ratings in the product grid.
3. Review tab override with full Reco reviews.

== Changelog ==

= 1.0.8 - 2026-09-08 =
* Fixed a fatal error during checkout when an order item carried non-string meta data (e.g. from product customizer plugins such as Lumise). Such values are now skipped instead of crashing.
* Order sync errors are now caught and logged so they can never abort a customer's checkout.

= 1.0.7 - 2026-06-10 =
* Changed default value for Product Grouping Method to "Use Parent ID with fallback to Product ID" so simple products are captured by default.

= 1.0.6 - 2026-04-15 =
* Fixed a bug where disabling recommended product reviews also disabled native product reviews.

= 1.0.5 =
* Introduced functionality to push historical order data to Reco.

= 1.0.4 =
* Upping release version.

= 1.0.3 =
* Bugfix - handle non string values when sending payload to API.

= 1.0.2 =
* Changed default value for Product Grouping Method to "Always Use Product ID".

= 1.0.1 =
* Add button “Test Connection” to verify api credentials
* Make store image url optional

= 1.0.0 =
* Initial release with core sync and display functionality.

== Upgrade Notice ==

= 1.0.4 =
* Upping release version.

= 1.0.3 =
* Minor Bugfixes.

= 1.0.2 =
* Changed default value for Product Grouping Method to "Always Use Product ID".

= 1.0.1 =
* Add button “Test Connection” to verify api credentials.
* Make store image url optional.

= 1.0.0 =
Initial release.

== License ==

This plugin is licensed under the GPLv2 or later. See https://www.gnu.org/licenses/gpl-2.0.html.