=== AddonLogic Read-Aloud Button ===
Contributors: snehalpancholi
Tags: accessibility, text to speech, read aloud, a11y, tts
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a text-to-speech play/pause/stop toolbar to post content using the browser's built-in SpeechSynthesis API. No API key required.

== Description ==

Read-Aloud Button adds a lightweight listen/pause/stop toolbar to any post or custom post type, using the browser's native `SpeechSynthesis` API — no external service, no API key, no privacy concerns.

**Features:**
* Play, pause/resume, and stop controls
* Uses the browser's built-in speech engine — works offline, no API cost
* Configurable speech rate, pitch, and volume
* Configurable content selector so only the article text is read (not menus or sidebars)
* Auto-insert before or after content, or use `[read_aloud]` shortcode for manual placement
* Graceful degradation: shows a notice if the browser does not support SpeechSynthesis
* ARIA `aria-pressed` states on play/pause button
* Supports any public post type
* Zero jQuery dependency

== Installation ==

1. Upload the `read-aloud-button` folder to `/wp-content/plugins/`.
2. Activate via **Plugins → Installed Plugins**.
3. Go to **Settings → Read Aloud** to configure post types, position, and speech parameters.

== Shortcodes ==

`[read_aloud]`

| Attribute  | Default          | Description                                    |
|------------|------------------|------------------------------------------------|
| selector   | *(from settings)*| CSS selector of element to read                |

== Frequently Asked Questions ==

= Which browsers support SpeechSynthesis? =
All modern browsers: Chrome, Edge, Firefox, Safari, and mobile browsers. The plugin shows a graceful notice on unsupported browsers.

= Does this send my content to any server? =
No. All text-to-speech processing happens locally in the visitor's browser using the built-in OS speech engine.

= Can I change the voice? =
Voice selection is handled by the visitor's OS and browser. The plugin uses the browser's default voice. Voice selection controls could be added via custom JavaScript using the `speechSynthesis.getVoices()` API.

== Changelog ==

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Read-aloud toolbar displayed before post content.
2. Settings page showing post type, rate, pitch, and volume options.
