=== Readivo – Text to Speech Audio Player ===
Contributors: honzanovacek
Tags: audio, audio player, tts, text to speech, accessibility
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Convert WordPress posts and pages into audio using a text-to-speech player. Let visitors listen to your articles with the Readivo audio player.

== Description ==

Readivo Audio Player allows you to add an audio version of your WordPress posts and pages using the Readivo text-to-speech embed script.

The plugin provides a simple integration with minimal configuration:

• Insert the player manually using the shortcode **[readivo]**
• Automatically insert the player at the top or bottom of selected post types
• Control visibility per post using a dedicated editor metabox
• Configure global player attributes such as **site ID**, **voice**, and **player ID**

The player is rendered dynamically on the frontend and does not permanently modify stored post content in the database.

Audio is generated and delivered by the Readivo service. Depending on your Readivo configuration, the player can use page metadata or extracted article content to generate spoken audio.

Full documentation: [https://readivo.app/docs](https://readivo.app/docs)
Readivo.app homepage: [https://readivo.app](https://readivo.app)
Readivo account: [https://app.readivo.app/register](https://app.readivo.app/register)

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/ or install it through the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to Settings -> Readivo and set your **Site ID**.
4. (Optional) Configure auto-insert, position, post types, and other settings.

== Usage ==

Manual insertion:
- Add **[readivo]** to the content where you want the player.

Automatic insertion:
- Enable "Automatically insert a player into each article" in Settings -> Readivo.
- Choose position (top/bottom) and post types.

Per-post control:
- Use the "Readivo" metabox in the editor (Automatically / Show player / Hide player).

== Frequently Asked Questions ==

= Do I need a Site ID? =
Yes. The plugin requires a Readivo **Site ID** to render the player.

= Does the plugin modify my post content in the database? =
No. The player element is inserted only when rendering the post on the frontend. The stored post content is not permanently modified.

= What data does Readivo receive? =
The player uses an external Readivo embed script and player endpoint. Depending on your Readivo administration settings, Readivo may receive page metadata (such as title and URL) and optionally the extracted article text for audio generation.

== External services ==

This plugin loads an external JavaScript embed script from:
https://cdn.readivo.app/dist/v1/embed.min.js

The script renders the Readivo audio player and loads the player endpoint:
https://cdn.readivo.app/player/<siteId>

What the service is used for:
Readivo converts article text into audio and provides an audio player that can play the generated audio on the website.

What data is sent:
When audio generation is triggered, the following data may be sent to the Readivo API:
- page title
- page URL
- a stable custom identifier (post ID based identifier)
- optionally extracted article text for audio generation

When data is sent:
No data is sent to the Readivo API when the page loads.
Data is sent only when a visitor starts audio playback and the audio for the article needs to be generated.

Service provider: [https://readivo.app](https://readivo.app)
Terms of service: [https://readivo.app/legal/terms](https://readivo.app/legal/terms)
Privacy policy: [https://readivo.app/legal/privacy](https://readivo.app/legal/privacy)

== Features ==

• Convert articles to audio using text-to-speech
• Lightweight frontend player
• Manual insertion using shortcode **[readivo]**
• Automatic insertion into posts and pages
• Per-post visibility control via editor metabox
• Does not modify stored post content
• Works with standard WordPress themes

== Screenshots ==

1. Readivo Settings page.
2. Readivo metabox in post editor.
3. Player output on the frontend.

== Changelog ==

= 1.0.2 =
- Updated JS loader for improved performance

= 1.0.1 =
- Improve plugin name for discoverability
- Improved settings labels and consistency with Readivo dashboard
- Added documentation links

= 1.0.0 =
- Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.