=== Cosmo AI FAQ Generator ===
Contributors: cguerra
Tags: faq generator, faq schema, faq seo, faq gutenberg, faq woocommerce
Requires at least: 5.8
Tested up to: 7.1.2
Stable tag: 1.3.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Auto-generate SEO-optimized FAQs for any post or page using artificial intelligence. Free: 4 generations/day, up to 5 questions.

== Description ==

**Cosmo AI FAQ Generator FREE** automatically generates SEO-optimized FAQ sections for your WordPress posts, pages, and custom post types using artificial intelligence.

With a single click from the post editor — both Gutenberg (block editor) and Classic Editor — the plugin sends the post content to an AI engine and returns a ready-to-publish list of relevant questions and answers.

= Key Features =

* **AI-powered generation** — produces relevant Q&A pairs from the existing post content
* **Gutenberg sidebar panel** — native block editor integration, no page reload required
* **Classic Editor metabox** — works with the traditional editor too
* **JSON-LD Schema Markup** — outputs FAQPage structured data in `<head>` for Google Rich Snippets
* **Microdata** — every FAQ item also carries `itemscope`/`itemprop` markup
* **Auto-append** — optionally injects the FAQ section automatically after the post content
* **Two display styles** — Accordion (click to expand) or Flat (always visible)
* **All post types** — works on posts, pages, WooCommerce products, and any public post type with an editor
* **Multilingual** — generate FAQs in Italian, English, French, or German

= Free tier limits =

To keep the service sustainable and prevent abuse, the free tier applies a daily rate limit:

* 4 generations per day per site (only successful generations count)
* Up to 5 questions per generation

= Upgrade to Pro =

[Cosmo AI FAQ Generator PRO](https://wpfaq.it) removes all limits and adds:

* Unlimited daily generations
* Up to 10 questions per generation
* Batch generation across existing articles
* Additional display styles
* Priority support
* Shortcode included to place FAQs anywhere

== Screenshots ==

1. Meta box in editor
2. FAQ analytics
3. Bulk generator
4. Plugin settings (part 1)
5. Plugin settings (part 2)

== Installation ==

= Automatic installation =

1. Go to **Plugins > Add New** in your WordPress dashboard
2. Search for **Cosmo AI FAQ Generator**
3. Click **Install Now**, then **Activate**

= Manual installation =

1. Download the plugin zip file
2. Go to **Plugins > Add New > Upload Plugin**
3. Upload the zip and click **Install Now**
4. Click **Activate Plugin**

= After activation =

Go to **Settings > Cosmo AI FAQ Generator** to configure the display style, default language, and whether to auto-append FAQs to post content.

== Frequently Asked Questions ==

= How does the AI generation work? =

The plugin sends the title and text content of your post to the Cosmo AI FAQ Generator API, which uses an AI model to generate relevant questions and answers. The generated FAQs are returned to the editor for your review before saving.

= Does the free version really limit to 4 generations per day? =

Yes. This is a rate limit to keep the shared AI service sustainable and prevent abuse, not a feature restriction — only successful generations count against the limit, and it resets every day.

= Does it work with WooCommerce products? =

Yes. The plugin registers on all public post types that support the editor, including WooCommerce products (`product`).

= How do I display FAQs on the frontend? =

FAQs are displayed automatically after post content. The PRO version also provides a shortcode to place FAQs anywhere in your content.

= Does it output Schema Markup for Google? =

Yes. When enabled in settings (default: on), the plugin outputs a `FAQPage` JSON-LD block in `<head>` and also adds microdata attributes (`itemscope`, `itemprop`) to the HTML, enabling FAQ Rich Snippets in Google Search results.

= Can I edit the generated FAQs before saving? =

Yes. After generation, each question and answer is editable directly in the panel. You can also remove individual items before saving.

= In which languages can FAQs be generated? =

Italian, English, French, and German. The language can be selected per-generation in the editor panel.

= Does it work with the Classic Editor plugin? =

Yes. When the Classic Editor plugin is active, the plugin falls back to a standard metabox below the post content.

== External services ==

This plugin connects to the **Cosmo AI FAQ Generator API** to generate FAQ content using artificial intelligence. This service is operated by CosmoCode.

= What data is sent and when =

When you click **Generate FAQ** in the post editor, the plugin sends the following data to the API endpoint `https://wpfaq.it/api/relay-server-gen-wpfaq-it/generate-free.php`:

* Your site URL
* The post title and post content (plain text, HTML stripped)
* The post ID
* The requested number of questions (max 5 for the free tier)
* The selected language
* A timestamp and an HMAC-SHA256 signature (used to authenticate the request)

No personal data about visitors or end users is ever transmitted. Data is only sent when an admin explicitly clicks the "Generate FAQ" button.

= Service provider =

The API is provided by **CosmoCode** (https://cosmocode.it).

* [Privacy Policy](https://wpfaq.it/privacy.html)

== Changelog ==

= 1.3.3 =

Bug Fixes, edit readme.txt, added screenshots.
