=== VoiceDropper ===
Tags: audio, text to speech, accessibility, player, auto mode
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

VoiceDropper is an AI-powered audio publishing platform for transforming written content into natural-sounding audio.

== Description ==

VoiceDropper connects your WordPress site to a VoiceDropper project.

After entering your project client key, use VoiceDropper HTML tags inside a WordPress Custom HTML block to embed a published speech or enable Auto Mode for an element on the page.

Published speech:

`<voicedropper data-speech="YOUR_SPEECH_ID"></voicedropper>`

Auto Mode:

`<voicedropper data-mode="auto" data-content-target="#article"></voicedropper>`

A VoiceDropper account and project client key are required. Create an account at [voicedropper.felixg.io](https://voicedropper.felixg.io/).

== External services ==

This plugin connects to the VoiceDropper service to load the audio player and generate or retrieve audio requested through the configured VoiceDropper project.

When the client key is configured, the plugin loads a JavaScript library from `https://voicedropper.felixg.io/plugin/{CLIENT_KEY}` in the public website header. The library may send the page URL, configured content target, text content, speech ID, and technical request information to VoiceDropper as required to provide the audio service.

This service is provided by VoiceDropper:

* [Terms of service](https://voicedropper.felixg.io/docs/legal/terms)
* [Privacy policy](https://voicedropper.felixg.io/docs/legal/privacy)

== Privacy ==

VoiceDropper does not send data to the external service until a site administrator configures a project client key.

After configuration, the VoiceDropper embed library is loaded on public pages. Depending on the HTML tags placed on a page, the service may process the page URL, selected text content, speech ID, configured content target, and technical request information to provide audio playback or Auto Mode.

Site administrators should review the VoiceDropper privacy policy and update their website privacy notice as appropriate.

== Installation ==

1. Upload the `voicedropper` folder to `/wp-content/plugins/`, or install the ZIP from the WordPress Plugins screen.
2. Activate VoiceDropper.
3. Open the new VoiceDropper menu in WordPress.
4. Paste the client key from your VoiceDropper project and save.
5. After setup, copy a VoiceDropper tag from the installation screen into a WordPress Custom HTML block.

To update the connected project later, use the Change button beside the connected client key.

== Screenshots ==

1. Preview and customize the VoiceDropper audio player.
2. Choose natural-sounding AI voices for your content.
3. Monitor plays, listeners, and audio engagement with built-in analytics.
4. Automatically transform selected website content into audio with Auto Mode.

== Frequently Asked Questions ==

= Where do I find my client key? =

Sign in to VoiceDropper, open your project, and copy its client key from the installation flow.

= How do I embed a published speech? =

Use `<voicedropper data-speech="YOUR_SPEECH_ID"></voicedropper>`, replacing `YOUR_SPEECH_ID` with the published speech ID.

= How do I use Auto Mode? =

Use `<voicedropper data-mode="auto" data-content-target="#article"></voicedropper>`, replacing `#article` with the CSS selector of the content VoiceDropper should read.

= Does the plugin load VoiceDropper on every page? =

Yes. After a client key is configured, the VoiceDropper embed library is loaded in the header of every public page so that players and Auto Mode can work anywhere on the site.

== Changelog ==

= 1.0.0 =

* Initial release.
* Added project client key settings.
* Added speech and Auto Mode HTML integration examples.
