=== Vocalect Audio Input ===
Contributors: hrs2015
Tags: voice input, speech-to-text, dictation, forms voice input, contact form 7 voice
Requires at least: 5.6
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add voice-to-text input to WordPress forms. Visitors click a mic icon and speak to dictate text using the browser Web Speech API.

== Description ==

**Vocalect Audio Input** is a secure, lightweight, and incredibly smart WordPress plugin that implements hands-free voice dictation inside any input form field on your website. Powered by the native high-fidelity HTML5 Web Speech API (`SpeechRecognition`), it allows users to fill out search boxes, contact forms, booking inputs, or checkout comment fields simply by speaking.

This plugin is crafted specifically for creators, agencies, and businesses looking to reduce form friction, boost mobile conversions, and maximize web accessibility.

= Key Features =

* **One-Click Voice Dictation** -- An elegant microphone icon is dynamically overlaid on targeted text fields, textareas, and search boxes. Users simply click to start speaking.
* **Browser-Native Speech Recognition** -- Uses the built-in Web Speech API. No external API keys, no subscriptions, no data sent to third-party servers.
* **Smart Cursor-Aware Insertion** -- Text is inserted exactly where the user's cursor is positioned. Supports Append and Replace modes.
* **Continuous Dictation Mode** -- Keeps listening through silent pauses until explicitly stopped by the user.
* **Multi-Language Support** -- Supports over 40 language locales including English, Spanish, French, German, Arabic, Persian, Chinese, Japanese, Korean, Hindi, and many more.
* **Voice Punctuation Commands** -- Speak punctuation naturally (e.g. "period", "comma", "question mark") in English, Persian, Arabic, French, and German.
* **Discard / Apply Workflow** -- Spoken text appears in a preview overlay card. Users choose to apply or discard the transcription before it enters the form field.
* **Universal Form Compatibility** -- Works out-of-the-box with Contact Form 7, WPForms, Gravity Forms, Fluent Forms, Elementor Forms, WooCommerce checkout, and standard WordPress forms.
* **Highly Configurable** -- Control button position, icon style, vertical alignment, text insertion mode, page targeting, and field exclusion rules.
* **Mobile Friendly** -- Optional mobile support toggle for touch devices.
* **Accessibility Ready** -- Includes ARIA attributes (`role="status"`, `aria-live="polite"`, keyboard navigation with Escape/Enter support, focus-visible outlines, and high-contrast mode support).
* **Lightweight & Secure** -- No external HTTP requests, no tracking, no analytics, no bundled third-party libraries. All output is properly escaped. All input is sanitized.

= How It Works =

1. Install and activate the plugin.
2. Navigate to **Settings > Vocalect Audio Input** to configure your preferences.
3. The microphone icon will automatically appear on targeted input fields across your site.
4. Visitors click the icon, speak naturally, and the transcribed text appears in a preview card.
5. They click the checkmark to apply the text to the form field, or the X to discard.

= Form Builder Compatibility =

Vocalect Audio Input has been tested and works with:

* Contact Form 7
* WPForms
* Gravity Forms
* Fluent Forms
* Elementor Forms
* WooCommerce checkout fields
* Default WordPress search and comment forms
* Any standard HTML `<input>` or `<textarea>` element

= Privacy & Security =

This plugin does **not** collect, store, or transmit any personal data. The Web Speech API is handled entirely by the user's own browser. No server-side processing occurs. No external API calls are made. For more details, please refer to our [Privacy Policy](https://projects.hamidrezasepehr.com/vocalect/privacy-policy.html).

== Installation ==

1. Upload the `vocalect-audio-input` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Navigate to **Settings > Vocalect Audio Input** to configure your preferences.
4. The microphone icon will automatically appear on targeted input fields across your site.

== Frequently Asked Questions ==

= Does this plugin require an API key? =

No. The plugin uses the browser's built-in Web Speech API, which is completely free and requires no API key or external account.

= Which browsers are supported? =

The Web Speech API is supported in Google Chrome, Microsoft Edge, Safari (macOS/iOS), and Chromium-based browsers. Firefox has limited support.

= Does this work on mobile devices? =

Yes, but it depends on the browser. Safari on iOS and Chrome on Android both support the Web Speech API. You can enable or disable mobile support in the plugin settings.

= Can I restrict voice input to specific pages or forms? =

Yes. The **Form Targeting** tab in the settings allows you to whitelist specific page/post IDs, form IDs, CSS selectors, and exclude fields by CSS class.

= Does this send data to external servers? =

No. All speech recognition is handled locally by the user's browser through the native Web Speech API. No data is sent to any external server by this plugin.

= Is this plugin translation-ready? =

Yes. The plugin is fully internationalized using the `vocalect-audio-input` text domain. A `.pot` template file is included in the `/languages` directory.

== Screenshots ==

1. The microphone icon overlay on a standard text input field.
2. The voice dictation preview card showing transcribed text before applying.
3. The plugin settings page with General Options tab.
4. The Appearance settings tab with button position and style options.
5. The Form Targeting settings for page and field-level control.
6. The Language selection dropdown with 40+ supported locales.

== Changelog ==

= 1.0.0 =
* Initial release of Vocalect Audio Input.
* Browser-native Web Speech API voice-to-text integration.
* Microphone overlay on standard inputs and textareas.
* Continuous dictation mode with discard/apply preview workflow.
* Smart cursor-aware, append, and replace text insertion modes.
* Multi-language support with 40+ locales.
* Voice punctuation commands in English, Persian, Arabic, French, and German.
* Form builder compatibility with Contact Form 7, WPForms, Gravity Forms, Fluent Forms, Elementor Forms, and WooCommerce.
* Configurable button position, icon style, and vertical alignment settings.
* Page, form, and field-level targeting and exclusion controls.
* Mobile support toggle.
* Accessibility features including ARIA attributes, keyboard navigation, and high-contrast mode.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
