=== VoxAI - AI Audio & Summary for Posts ===
Contributors: caioferreiradev
Tags: ai, audio, summary, openai, text-to-speech
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add AI-generated audio narration and a smart summary to your WordPress posts — powered by OpenAI. One click, no recording needed.

== Description ==

**VoxAI - AI Audio & Summary for Posts** transforms your content into a richer, more accessible experience. With a single click, your posts get a professional audio narration and an AI-written summary — no recording equipment, no manual editing.

Readers stay longer. Bounce rates drop. Your content becomes accessible to audiences who prefer to listen.

= ✨ Key Features =

**AI Summary Generator**
Uses OpenAI GPT-4o Mini to read your article and write a concise, accurate summary. The summary appears in a collapsible panel inside your post — clean, discreet, and on-brand.

**Text-to-Speech Audio Player**
Converts your full article into natural-sounding audio using OpenAI's TTS engine. Six high-quality voices available (Alloy, Echo, Fable, Onyx, Nova, Shimmer). The MP3 is saved to your server — no recurring API call for playback.

**Reading Time Estimator**
Automatically calculates and displays the estimated reading time for every post. Configurable and translatable.

**Smart Positioning**
Choose to inject the AI Reader widget before the content, after the content, or disable injection entirely and use the shortcodes manually.

**Shortcodes for Full Control**
- `[voxaiau_summary]` — Displays the AI Summary panel.
- `[voxaiau_tts]` — Displays the AI Audio player.

= 🔧 Zero configuration required to start =
Paste your OpenAI API key in **Settings → AI Audio & Summary**, choose which post types to activate it on, and you're done. The widget renders automatically.

= 🌐 Languages =
- English (default)
- Português do Brasil (pt_BR) — fully translated

= 🔒 Privacy & External Services =
This plugin sends post content to the OpenAI API **only when you explicitly request** a summary or audio generation. No data is sent automatically without user action.

This plugin uses the OpenAI API. By using this plugin, you agree to:
- [OpenAI Terms of Service](https://openai.com/policies/terms-of-use)
- [OpenAI Privacy Policy](https://openai.com/policies/privacy-policy)

No data is stored on our servers. The generated MP3 is saved locally on your WordPress install.

== Installation ==

= Automatic Installation (Recommended) =
1. Go to **Plugins → Add New** in your WordPress dashboard.
2. Search for **VoxAI - AI Audio & Summary**.
3. Click **Install Now**, then **Activate**.
4. Go to **Settings → AI Audio & Summary** and paste your OpenAI API key.

= Manual Installation =
1. Download the plugin zip file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Upload the zip, click **Install Now**, then **Activate**.
4. Go to **Settings → AI Audio & Summary** and paste your OpenAI API key.

= Getting your OpenAI API Key =
1. Create an account at [platform.openai.com](https://platform.openai.com).
2. Navigate to **API Keys** and click **Create new secret key**.
3. Copy the key and paste it in **Settings → AI Audio & Summary**.

== Frequently Asked Questions ==

= Do I need an OpenAI account? =
Yes. This plugin uses the OpenAI API to generate summaries and audio. You need an OpenAI account with a valid API key and available credits.

= Does it send my content to OpenAI automatically? =
No — content is only sent to OpenAI when requested via the "Generate Summary" or "Generate Audio" buttons inside the post editor, or when a user views a post without a cached summary.

= How much does it cost to use? =
The plugin itself is free. You pay OpenAI directly for API usage. A typical article summary (GPT-4o Mini) costs less than $0.001 USD. A full audio narration (1000 words, tts-1 model) costs approximately $0.02–$0.04 USD.

= Is the audio file stored on my server? =
Yes. Once generated, the MP3 file is saved securely on your own WordPress server inside the uploads directory. Playback never calls the OpenAI API again.

= Does it work with Gutenberg and Classic Editor? =
Yes. VoxAI has full support for both the Classic Editor (metabox) and the Gutenberg block editor (sidebar panels).

== Screenshots ==

1. **Frontend Widget** — The AI Audio & Summary widget inside a post.
2. **Gutenberg Sidebar** — The plugin sidebar panels in the Gutenberg editor with real-time status feedback.
3. **Classic Editor Metabox** — The metabox in the Classic Editor showing the summary and voice selector.
4. **Settings Page — General & Summary** — Configuration for API keys, models, and positioning.
5. **Settings Page — Audio (TTS)** — Voice selector and quality settings.

== Changelog ==

= 1.0.0 — April 2026 =
* 🎉 Initial public release.
* AI Summary generation via OpenAI GPT-4o Mini.
* Text-to-Speech audio player via OpenAI TTS API (6 voices).
* Reading time estimator with localization support.
* Full Gutenberg sidebar panel support.
* Classic Editor metabox support.
* Configurable widget position (before content / after content / shortcode only).
* Shortcodes: `[voxai_reader]`, `[voxai_summary]`, `[voxai_audio]`.
* AJAX-based generation with real-time status polling.
* Per-post estimated API cost display.
* PT-BR (Portuguese Brazil) full translation included.
* GPL-2.0+ license compliance.
* PHP 7.4+ and WordPress 6.0+ compatibility check.

== Upgrade Notice ==

= 1.0.0 =
Initial public release. Install and configure your OpenAI API key to get started.
