=== Mivídeo Reviews SEO Writer ===
Contributors: mivideo
Tags: product reviews, affiliate, seo, artificial intelligence, schema
Requires at least: 7.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create product comparison articles from up to three public product URLs using the native WordPress AI Client.

== Description ==

Mivídeo Reviews SEO Writer Lite helps WordPress publishers create product comparison articles from public product pages.

The plugin combines local data extraction, native WordPress AI assistance, editorial comparison content, product cards, affiliate links, FAQ content and complementary structured data.

The Lite version supports up to three product URLs per article. Additional URLs are ignored before extraction.

No direct OpenAI key or provider-specific API key is stored by the plugin. AI connections are managed by WordPress under Settings > Connectors.

= Main features =

* Sequential extraction from up to three product URLs.
* Local reading of JSON-LD, Open Graph and public HTML data.
* Hybrid extraction fallback through the native WordPress AI Client.
* Support for full and short Amazon links with controlled redirects.
* Product extraction from Amazon, Mercado Livre and other public product pages.
* Product title, brand, description, image, price, rating and feature normalization when available.
* AI-assisted article title suggestion when the title field is left empty.
* Product comparison articles generated in Brazilian Portuguese.
* Editorial product cards and affiliate buttons.
* Complementary ItemList, Product, Offer, AggregateRating and FAQPage schema when valid data is available.
* Rank Math focus keyword, title and description integration.
* Configurable site context, writing style, author note, cache and request delay.

= Lite version limitations =

The Lite version includes the complete hybrid extraction engine and article generation workflow, with the following limits:

* Maximum of three product URLs per article.
* No Intent Finder SEO integration.
* Suggested prices are not displayed inside product cards.
* Card colors use the built-in Lite palette and cannot be customized.
* The generic master prompt is protected and cannot be edited.
* AI generation of a custom master prompt is available only in the PRO version.

The PRO version removes these limits and adds advanced integrations and customization options.

= Native WordPress AI Client =

The plugin requires WordPress 7.0 or newer and uses the native WordPress AI Client.

To configure AI access:

1. Open Settings > Connectors in WordPress.
2. Configure a compatible text generation provider.
3. Authorize the connection for Mivídeo Reviews SEO Writer Lite.
4. Return to the plugin and confirm that the native AI status is available.

The plugin does not call a specific AI provider directly and does not store its own provider API key.

= Product extraction =

The extraction engine first looks for reliable local data in the product page, including JSON-LD, Open Graph and store-specific HTML elements.

When local data is incomplete, the plugin can use the native WordPress AI Client as a fallback. Local values are preserved and AI results are used only to complete missing fields.

For Amazon products, full product page URLs generally provide more stable extraction than short links.

= Article structure =

Generated content follows a controlled editorial structure in Brazilian Portuguese:

* Introduction without a heading.
* Quick summary.
* Product selection criteria.
* Detailed product cards inserted by the plugin.
* Recommendations by user need.
* FAQ section.

The plugin avoids generating Article or BlogPosting schema. Those entities remain the responsibility of the active SEO plugin or theme.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install the ZIP file from Plugins > Add New > Upload Plugin.
2. Activate Mivídeo Reviews SEO Writer Lite.
3. Open Settings > Connectors and authorize a compatible AI connection.
4. Open Reviews SEO Writer > Settings and configure the site context and writing style.
5. Enter a focus keyword, an optional article title and up to three product URLs.
6. Extract the products, review the data and generate the article.

== Frequently Asked Questions ==

= Does the plugin require an OpenAI API key? =

No. It uses the native WordPress AI Client. Provider credentials are managed by WordPress under Settings > Connectors.

= How many products can I compare in the Lite version? =

Up to three product URLs per article. If more URLs are entered, only the first three are processed.

= Is the generated content in English? =

No. The plugin interface and generated article content are provided in Brazilian Portuguese. This readme is written in English to follow the WordPress.org plugin directory standard.

= Can I customize the product card colors? =

The Lite version uses a fixed built-in palette. Card color customization is available in the PRO version.

= Can I edit or generate the master prompt? =

The Lite version uses a protected generic master prompt. Editing the master prompt and generating a custom prompt with AI are PRO features.

= Does the Lite version integrate with Intent Finder SEO? =

No. Saved-idea integration is available in the PRO version.

= Does the plugin create Article or BlogPosting schema? =

No. It adds only complementary product comparison entities. The primary article schema should be handled by the active SEO plugin or theme.

= Will installing the PRO version create a second plugin? =

No. The Lite and PRO packages use the same public folder and main plugin file. Installing the PRO version over Lite replaces it without creating duplicate dashboard menus.

== Screenshots ==

1. Article configuration and product URL extraction.
2. Extracted product preview and article generation.
3. Lite settings with fixed card appearance and protected master prompt.
4. Native WordPress AI Client connection status.

== Changelog ==

= 1.0.2 =

* Matched the readme plugin name with the plugin header.
* Added the required translator comment for the Lite URL limit.
* Removed manual translation loading for WordPress.org distribution.
* Replaced direct debug logging with extension hooks.

= 1.0.1 =

* Removed the Lite label from the plugin name shown on the Plugins screen.
* Added a white external-link icon to the upgrade buttons.

= 1.0.0 =

* Initial Lite release based on the stable hybrid extraction engine.
* Supports up to three product URLs per article.
* Uses the native WordPress AI Client without direct provider keys.
* Includes fixed card styling and a protected generic master prompt.
* Generates comparison articles and complementary product schema in Brazilian Portuguese.
