FAIR

Federated and Independent Repositories

Reco For Woocommerce

Plugin Banner

Reco For Woocommerce

by recotrust

Download
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)

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.

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)

License

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

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

1.0.10 – 2026-10-24

  • The rating distribution and the first page of reviews are now rendered with the product page, so they appear without extra requests. “Show more” still loads further reviews on demand.
  • Products without reviews no longer show empty stars with “0.0 (0)”.
  • Rating widgets added to the page later, such as in the mini cart, are now rendered too.
  • Review text and reviewer names are now escaped before display.

1.0.9 – 2026-10-23

  • Rating widgets in product listings are now rendered with the page instead of making one request per product, which greatly reduces server load on category pages.
  • Fixed rating and review caching, which was bypassed on every request.
  • After a failed request to Reco, rating fetches pause for a minute so an outage cannot slow down listing pages.
  • Review pagination is now cached per page.
  • Orders are synced to Reco in the background instead of during each order save.
  • Removed verbose debug logging of product meta during order sync.
  • The reviews tab count now uses the configured product grouping.

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.
Back to top