=== EU Warranty Ready ===
Contributors: ajescudero
Tags: woocommerce, warranty, eu, ecommerce, legal guarantee
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.6.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add the official EU legal guarantee notice and eligible EU GARAN durability labels to WooCommerce products, checkout, and customer emails.

== Description ==

EU Warranty Ready integrates the official EU harmonised legal guarantee notice into WooCommerce, with automatic support for all 24 official EU languages.

The free plugin adds the official notice to WooCommerce product pages, classic checkout, Checkout Blocks, and customer order emails. Its readiness view explains whether the legal notice and optional GARAN setup are ready, incomplete, not eligible, or outside the safe artwork fit. It automatically selects the appropriate language from the current product or variation translation, the visitor's active WPML or Polylang language, or the WordPress locale, with a safe English fallback. It also supports product-specific EU GARAN commercial durability labels for eligible producer guarantees and manual placement through a shortcode. Everything runs locally inside WordPress: no external account, no SaaS dependency, and no customer data is transmitted.

Built for WooCommerce stores and agencies that want a lightweight, predictable way to add official EU warranty information without introducing another consumer platform or external service.

= Features in the free plugin =

* Official EU harmonised legal guarantee notice on WooCommerce product pages.
* Clear readiness status for the legal notice and each product's optional GARAN setup.
* Server-rendered integration before Place Order in classic checkout and Checkout Blocks.
* Live legal notice and eligible GARAN information in customer HTML and plain-text emails; administrative emails are excluded.
* Manual `[eu_warranty_ready]` shortcode with `content="all|notice|garan"` and an optional `product_id`.
* Independent control of automatic product-page placement; disabling it does not disable the shortcode.
* All 24 official EU languages.
* Automatic language selection from the translated product or variation, the active WPML/Polylang visitor language when available, or the WordPress locale, with English fallback.
* Manual language override when needed.
* Optional custom link text.
* Click-to-open notice with a direct link to the corresponding [Your Europe guarantee information](https://europa.eu/youreurope/citizens/consumers/shopping/guarantees/index_en.htm).
* Product-specific EU GARAN commercial durability labels.
* Eligibility assistant for new GARAN configurations.
* Official nested GARAN label with full-label expansion on first interaction.
* Producer/brand, model identifier, and duration fields.
* Conservative artwork-fit validation for newly edited GARAN producer/model values.
* Runs entirely inside WordPress.
* No external SaaS account.
* No customer-data transmission by the plugin.

The GARAN eligibility assistant is a factual configuration aid. It does not determine legal compliance and is not legal advice. Store owners remain responsible for confirming that the producer guarantee and their use of the label meet the applicable requirements.

EU Warranty Ready is an independent WooCommerce plugin and is not affiliated with or endorsed by the European Union or the European Commission.

== Installation ==

1. Install and activate WooCommerce.
2. Install and activate EU Warranty Ready.
3. Open WooCommerce > EU Warranty Ready.
4. Leave the notice language on Automatic to follow the translated product, visitor language, or WordPress locale, or select one of the 24 supported EU languages.
5. Open a WooCommerce product page and use the legal guarantee link to view the official notice.
6. For an eligible product, open Product data > General and complete the EU GARAN eligibility assistant and product fields.
7. For manual placement, add `[eu_warranty_ready]`, optionally using `content="notice"`, `content="garan"`, or `product_id="123"`. Without a product context or ID, the shortcode shows the legal notice and omits GARAN.

== Frequently Asked Questions ==

= Does this plugin make my store legally compliant? =

No. The plugin helps display the official EU harmonised legal guarantee notice and eligible EU GARAN label in the supported WooCommerce location. It does not provide or guarantee legal compliance and is not legal advice.

= Does the plugin alter the official EU artwork? =

The bundled legal-guarantee notice SVG files are redistributed unmodified. For EU GARAN, the plugin uses the official label templates and fills only the designated editable duration, producer name (Brand/Trademark field), and model fields.

= Which languages are included? =

The official notice artwork is included for all 24 official EU languages: Bulgarian, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Irish, Italian, Latvian, Lithuanian, Maltese, Polish, Portuguese, Romanian, Slovak, Slovenian, Spanish, and Swedish.

= When should I enable EU GARAN? =

Use EU GARAN only for an eligible commercial durability guarantee offered by the producer at no additional cost, covering the entire good, and lasting more than two years. The plugin asks for explicit confirmations and supporting product information before a new GARAN configuration can be enabled.

= Does the plugin send customer data to another service? =

No. The plugin runs inside WordPress and does not transmit customer data to an external SaaS service. When a visitor follows an official information link, their browser opens the corresponding European Commission or Your Europe page.

= Does the plugin store warranty snapshots with orders? =

No. Version 1.4 displays live information from the current product or variation. It does not write warranty snapshots, hashes, or historical evidence to order metadata.

== Screenshots ==

1. Configure EU guarantee notices, multilingual resolution, and automatic product-page placement.
2. Validate product information and enable an eligible GARAN durability guarantee with clear readiness feedback.
3. Show official EU legal guarantee rights and eligible GARAN information directly on product pages.
4. Include official legal guarantee information and GARAN details in customer order emails.
5. Identify missing GARAN information before publishing a product or displaying the label.

== Third Party Content ==

The official EU harmonised legal guarantee notice and EU GARAN label artwork are published by the European Commission, Directorate-General for Justice and Consumers.

Source: [European Commission — Practical guidelines and official EU notice and label files](https://commission.europa.eu/publications/practical-guidelines-and-high-resolution-vector-files-eu-notice-and-label-product-guarantees_en)

European Commission legal notice: [Legal notice](https://commission.europa.eu/legal-notice_en)

Unless otherwise indicated by the source, EU-owned content on the Commission website is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). The legal-guarantee notice SVG files are redistributed unmodified. The GARAN templates preserve the fixed official artwork and are populated only in the designated editable fields. See `assets/notices/ATTRIBUTION.txt` and `assets/garan/ATTRIBUTION.txt` inside the plugin for details.

== Changelog ==

= 1.6.0 =
* Added native WooCommerce Products-list readiness visibility with contextual Fix, View product, and Review variations actions.
* Kept the Catalogue Readiness screen and introduced shared, readable readiness status styling across admin surfaces.
* Corrected GARAN readiness fixtures and removed duplicated healthy Ready indicators from the product panel.
* Preserved native product search and pagination with no full-catalogue scan or persistent readiness index.

= 1.5.0 =
* Added non-blocking onboarding and first-run guidance to the catalogue readiness overview.
* Added readiness filters, exact configuration reasons, and a coverage summary for supported surfaces.
* Added a contextual Pro discovery path after usable readiness information.
* Added a neutral optional support and review prompt, plus responsive and accessibility presentation polish.

= 1.4.0 =
* Added a clearer settings and product-readiness experience for legal notice, language fallback, and GARAN configuration states.
* Added automatic WPML and Polylang product, variation, and visitor-language resolution with a safe English fallback.
* Added live server-rendered warranty output to classic checkout, Checkout Blocks, and customer HTML/plain-text emails.
* Added manual placement with `[eu_warranty_ready]`, including content selection and optional `product_id`.
* Added deduplication across repeated cart items and automatic suppression when the companion Pro plugin is active.
* Strengthened GARAN eligibility and artwork-fit guards for valid, incomplete, non-fitting, and not-eligible configurations.

= 1.2.0 =
* Added conservative artwork-fit protection so newly edited GARAN producer/model values are not silently rendered in a truncated form.
* Kept the Free product-page feature set intact and compatible with Pro metadata.
* Added release artifact boundary validation to protect the Free/Pro packaging separation.

= 1.1.0 =
* Added product-specific EU GARAN commercial durability labels to the free plugin.
* Added a factual GARAN eligibility assistant for new configurations.
* Added official nested label display with full-label expansion.
* Preserved compatibility with the existing Pro metadata keys.
* Added storefront strings for English, Spanish, German, French, Italian, and Dutch.

= 1.0.0 =
* Initial WordPress.org release.
* Product-page legal guarantee notice.
* 24 official EU notice languages.
* Automatic and manual language selection.

== Upgrade Notice ==

= 1.6.0 =
Adds native Products-list readiness guidance and consistent status styling while preserving the Catalogue Readiness screen and native WooCommerce navigation.

= 1.5.0 =
Adds first-run guidance, a catalogue readiness overview with filters and exact reasons, coverage context, a factual Pro discovery path, and neutral support/review prompts. Existing configuration remains unchanged.

= 1.4.0 =
Adds readiness guidance, multilingual fallback, live checkout and customer-email output, manual shortcode placement, and stronger GARAN fit protection. Existing product settings remain in place.
