=== SpecCompare for WooCommerce ===
Contributors: rensike
Tags: woocommerce, product comparison, compare, spec table, attributes
Requires at least: 6.1
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
WC requires at least: 7.0
Stable tag: 0.1.2
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Zero-config product comparison and spec tables for WooCommerce, built from your existing product attributes.

== Description ==

Turn a WooCommerce category — or any list of product IDs — into a clean, responsive comparison table, without configuring a single column.

SpecCompare reads the attributes you already have on your products, builds the union of every attribute across the selected products, and renders one row per spec and one column per product. Rows where the products actually differ can be highlighted with a single click, so shoppers see the decision-relevant differences instead of a wall of identical values.

**What you get**

* Shortcode and Gutenberg block: `[speccompare_table category="laptops"]` or `[speccompare_table ids="123,124,125"]`
* Automatic columns: price, SKU, stock and rating, plus every product attribute
* One-click "highlight differences" toggle, with a configurable default
* Product thumbnail, title link and add-to-cart button in each column
* Mobile-responsive, themeable (default / modern)
* No configuration required, and no limits on the number of tables or products

**Free vs Pro**

Everything above is in this free version, unrestricted — no table limits, no product limits, no feature locked behind a trial. SpecCompare Pro is a separate, optional upgrade that adds AI-selected comparison rows: instead of listing every attribute, it picks the specs that actually differentiate the products in the table (bring your own OpenAI-compatible API key). You never need Pro to use the free plugin.

**External services**

This plugin uses the Freemius service to offer that optional upgrade, to activate licences, and to deliver updates to paying customers. On activation Freemius asks for your permission before sending anything; if you decline, no data leaves your site and the plugin keeps working. When you opt in, it sends your site URL, WordPress and PHP versions and the administrator email so licences and update notices can be delivered. See the Freemius [terms](https://freemius.com/terms/) and [privacy policy](https://freemius.com/privacy/). The free plugin makes no other outbound requests.

== Installation ==

1. Upload the `speccompare` folder to `/wp-content/plugins/`, or install the zip via Plugins → Add New.
2. Activate the plugin. WooCommerce must be installed and active.
3. Add a table to any page with the `[speccompare_table]` shortcode or the "SpecCompare Table" block.

== Frequently Asked Questions ==

= Do I have to configure which specs to compare? =

No. The table is built from the product attributes already stored on the selected products, so it works immediately after activation.

= Which products end up in the table? =

Either the IDs you list (`ids="123,124,125"`) or the products in a category (`category="laptops"`, optionally with `limit`, `orderby` and `order`).

= What are the shortcode options? =

`ids`, `category`, `limit`, `orderby`, `order`, `highlight`, `theme`.

= Why do some rows look empty? =

A cell is empty when that product does not define the attribute. The table shows the union of all attributes, so a product missing one simply has a blank cell for it.

== Screenshots ==

1. The comparison table on the front end, with rows where the products differ highlighted.
2. The same table with the "Highlight differences" toggle switched off.
3. On small screens each product stacks under its spec label.

== Changelog ==

= 0.1.2 =
* Added the Freemius SDK to the free version, so an optional Pro upgrade and licence activation are reachable from the plugin itself.
* Documented the external service and the free/Pro split in the readme.
* Bundled the plugin icon used by the account screens.

= 0.1.1 =
* Renamed internal prefixes and text domain to match the plugin slug.
* Escaped all markup returned by the shortcode and block render callback.
* Declared WooCommerce as a required plugin via the `Requires Plugins` header.

= 0.1.0 =
* Initial release: automatic comparison tables from product attributes, shortcode and block, difference highlighting, settings.
