=== Delo Voice Record ===
Contributors: delowarhossen57
Tags: speech to text, voice widgets, voice search, voice recorder, voice dictation, audio recording
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

High-performance speech-to-text dictation & audio recording plugin for WordPress. Enables AI-ready voice search, audio messages, and form inputs.

== Description ==

**Delo Voice Record** is a professional, lightweight, and SEO-optimized WordPress plugin designed to bring real-time **Speech-to-Text (STT)** dictation and **Voice Audio Recording** uploads to your website.

Empower your visitors to perform **voice search**, record voice notes, dictate form entries, or attach uploaded voice recordings directly inside form fields — boosting user engagement, accessibility (a11y), and form conversion rates.

Whether you run an e-commerce store with WooCommerce voice search, a blog, a support desk, or custom forms built with Contact Form 7, Elementor, or Gravity Forms, **Delo Voice Record** seamlessly integrates floating or inline microphone controls with zero coding required.

### 🚀 Why Choose Delo Voice Record?

* **Instant Voice Search & Dictation**: Convert spoken words into typed text in real time with high accuracy using native Web Speech API technology.
* **Voice Audio File Uploads**: Allow users to record audio clips directly in their browser and save downloadable `.webm` or `.m4a` files to your WordPress Media storage.
* **Universal Form Integration**: Automatically attaches microphone buttons to CF7, Elementor Forms, WooCommerce Search, comments, and custom HTML inputs via simple CSS selectors (`.voice-text`, `.speech-input`, `.voice-record-url`) or element IDs (`#search-input`).
* **5 Modern Design Theme Presets**: Choose from 5 stunning visual widget presets (Glassmorphic, Cyber Neon, Compact Pill, Royal Sunset, and Nordic Clean Minimal).
* **Interactive Waveform Preview**: Features a live canvas audio waveform visualizer, countdown timer, editable transcript preview box, and one-click save button.
* **Smart 5-Second Silence Detection**: Automatically pauses microphone capture when the user stops speaking.
* **Global Language Support**: Supports over 120+ international languages and regional accents (English, Spanish, French, German, Japanese, Chinese, Arabic, Portuguese, and more).
* **Analytics & Usage Dashboard**: Track daily recording sessions, average duration, accuracy rates, server storage usage gauges, and top languages used.
* **No External API Key Needed**: Uses browser-native Web Speech and WebRTC MediaRecorder APIs — 100% free with unlimited voice requests.
* **Developer & Performance Focused**: Ultra-fast lightweight JS footprint (under 35KB), WordPress Coding Standards compliant, and 100% translation ready with the `'delo-voice-record'` textdomain.

### 🎯 Popular Use Cases

* 🛒 **WooCommerce Voice Search**: Let shoppers speak product names instead of typing.
* 💬 **Voice Feedback & Reviews**: Capture authentic audio messages from customers.
* 📝 **Accessibility & Dictation**: Assist users with visual or motor impairments to fill out lengthy forms effortlessly.
* 🎧 **Support Ticket Audio Notes**: Allow clients to describe issues using quick voice recordings.
* 🔍 **Site-Wide Search**: Add sleek microphone search buttons to your navigation header or hero search bars.

== Installation ==

1. Upload the `delo-voice-record` plugin directory to your `/wp-content/plugins/` folder, or install via the WordPress **Plugins -> Add New** screen.
2. Activate **Delo Voice Record** from your Plugins menu.
3. Go to **Delo Voice Records** in your WordPress Admin Sidebar to customize visual styles, manage recordings, and configure auto-attach form rules.

== Shortcodes ==

Display standalone voice recording widgets or input-attached microphone buttons anywhere on your pages, posts, sidebars, or page builders using shortcodes:

* `[delovore_voice_record]` &mdash; Embeds the default standalone voice recorder widget.
* `[delovore_voice_record style="2"]` &mdash; Overrides visual preset (1: Glassmorphic, 2: Cyber Neon, 3: Compact Pill, 4: Royal Sunset, 5: Nordic Minimal).
* `[delovore_voice_record target="#search-input"]` &mdash; Automatically populates transcribed voice text into the element `#search-input`.
* `[delovore_voice_record id="1" style="4"]` &mdash; Loads saved widget configuration #1 with Royal Sunset styling.

== Frequently Asked Questions ==

= Is an SSL Certificate (HTTPS) required for voice recording? =
Yes! Web browsers require a Secure Context (**HTTPS**) or `localhost` to grant microphone permissions for Web Speech and WebRTC Audio Capture APIs.

= Does Delo Voice Record require a third-party paid API key? =
No! The plugin utilizes native browser Web Speech API and MediaRecorder standards, requiring zero monthly subscriptions or third-party API keys.

= Which web browsers support speech-to-text dictation? =
Speech recognition is supported natively in Google Chrome, Microsoft Edge, Opera, Safari (iOS & macOS), and Android WebViews. Unsupported browsers display a clean fallback input notice.

= Where are recorded audio files saved? =
Audio recordings are uploaded securely into your WordPress uploads directory (`/wp-content/uploads/delovore-recordings/`) and logged under **Delo Voice Records -> Recordings**.

= Can audio files be automatically deleted upon reset? =
Yes! Enabling **Delete Server File on Reset** under **Form Integration** automatically purges the audio file from your server when a user clicks the reset (✕) button.

= Is the plugin translation ready? =
Yes! All text strings use WordPress localization functions (`__`, `esc_html__`, `esc_attr__`) with the `'delo-voice-record'` text domain.

== Screenshots ==

1. Analytics Dashboard - Real-time recording metrics, daily session charts, speech accuracy rates, storage gauge meters, and top languages used.
2. Voice Recording Widgets - Manage shortcodes, inline vs floating placement, preset styles, and active widget status.
3. Add New Widget & Shortcode Generator - Create custom voice input widgets with live preview and target input selectors.
4. Saved Voice Recordings Management - HTML5 audio playback player, transcript viewer, audio file downloads, and AJAX record deletion.
5. Form Integration Control - Configure automatic microphone button attachment for Gravity Forms, Contact Form 7, WPForms, WooCommerce search, and custom CSS classes or IDs.
6. 6 Modern Theme Design Presets - Glassmorphic Card, Cyber Neon Console, Compact Pill, Royal Sunset, Nordic Clean Minimal, and Cyber Purple Search.
7. Documentation & Quick Help Guide - Comprehensive shortcode reference guide, theme preset style guide, and troubleshooting FAQs.

== Changelog ==

= 1.0.0 =
* Initial Release of Delo Voice Record.
* Feature: Type A (Speech to Text) and Type B (Voice Audio File URL) form integration.
* Feature: 5 modern CSS design presets (Glassmorphic, Cyber Neon, Compact Pill, Royal Sunset, Nordic Minimal).
* Feature: Live audio waveform visualizer, 5-second silence auto-stop engine, and interactive preview card.
* Feature: Analytics Dashboard with Chart.js visualization, language metrics, and storage gauge meters.
* Feature: HTML5 `<audio>` player table, pagination selector (5, 10, 25, 50), download links, and AJAX deletion.
* Security & WPCS: Fully updated with `wp_unslash()`, prepared SQL statements, `wp_upload_bits()`, `wp_delete_file()`, and `'delo-voice-record'` textdomain localization.
