=== WPVoicer - AI Text to Speech ===
Contributors: wpvoicer
Tags: text-to-speech, tts, audio, accessibility, voice, ai
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 8.0
Stable tag: 2.4.50
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Transform your WordPress posts into high-quality audio with AI-powered text-to-speech. Requires a free WPVoicer.com account.

== Description ==

WPVoicer automatically converts your WordPress posts into natural-sounding audio files using advanced AI text-to-speech technology. Make your content accessible to a wider audience and improve user engagement with professional audio narration.

**Important: This plugin requires a free account on [WPVoicer.com](https://wpvoicer.com) to function. The plugin connects to WPVoicer's cloud AI servers to generate audio files.**

= Key Features =

* **One-Click Audio Generation**: Convert any post into high-quality audio instantly
* **Natural AI Voices**: Multiple voices that sound human and natural
* **Custom Voice Cloning**: Upload your own voice sample for personalized narration
* **Multiple Languages**: Support for Italian, English, and more
* **Page Builder Integration**: Works seamlessly with Elementor, Bricks, and Breakdance
* **Shortcode Support**: Embed audio players anywhere with `[wpvoicer_audio]`
* **Audio Library**: Manage all your generated audio files in one place
* **Play Count Analytics**: Track how many times your audio content is played

= How It Works =

1. Install and activate the plugin
2. Register a free account on WPVoicer.com (directly from the plugin)
3. Edit any post and click "Generate Audio" in the WPVoicer metabox
4. Audio is generated in the cloud and downloaded to your Media Library
5. Use shortcodes or page builders to display the audio player

= Pricing =

* **Free Tier**: 30-day free trial with included generation minutes
* **Premium Plans**: Additional minutes available for purchase on [WPVoicer.com](https://wpvoicer.com)

The plugin itself is completely free. Included trial minutes and paid packages are managed on WPVoicer.com.

== Third Party Services ==

This plugin connects to the **WPVoicer.com** external service to generate audio files. The connection is required for the plugin to function.

= What Data Is Sent =

When you generate audio, the following data is sent to WPVoicer.com servers:

* Post title and content (the text to be converted to speech)
* Your site URL (for account association)
* Selected voice settings (language, speed, pitch, etc.)
* Custom voice sample (if you upload one for voice cloning)

= Service Links =

* **Service Website**: [https://wpvoicer.com](https://wpvoicer.com)
* **Terms of Service**: [https://wpvoicer.com/terms](https://wpvoicer.com/terms)
* **Privacy Policy**: [https://wpvoicer.com/privacy](https://wpvoicer.com/privacy)

= Data Processing =

* Audio generation is processed on WPVoicer's cloud servers
* Generated audio files are transferred back to your WordPress site
* Text content is processed only for audio generation and not stored permanently
* All data transfers occur over HTTPS encrypted connections

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/wpvoicer/` directory, or install the plugin through the WordPress plugins screen
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to **WPVoicer → Connection** in your admin menu
4. Register a new account or login with existing credentials
5. Go to **WPVoicer → Voice Settings** to configure your preferred voice
6. Edit any post and use the WPVoicer metabox to generate audio

== Frequently Asked Questions ==

= Do I need an account to use WPVoicer? =

Yes, a free WPVoicer.com account is required. The account is used to:
- Track your audio generation usage
- Associate generated audio with your site
- Provide access to your voice settings and audio library

Registration is free and takes less than 30 seconds.

= Is the plugin free? =

Yes, the plugin is completely free. WPVoicer.com offers a free trial with included minutes, and additional minutes can be purchased if needed.

= Does this work with Gutenberg and page builders? =

Yes, WPVoicer works with:
- Classic Editor
- Gutenberg Block Editor
- Elementor (with dynamic tags)
- Bricks Builder (with dynamic data)
- Breakdance (with dynamic data)

= What languages are supported? =

WPVoicer currently supports:
- Italian
- English

More languages are being added regularly.

= Can I use my own voice? =

Yes! You can upload a voice sample (WAV or MP3, up to 5MB) and WPVoicer will clone it for use in your audio generation.

= How do I display the audio player? =

Use the shortcode `[wpvoicer_audio]` in your post content, or use the dynamic tags/data features in your page builder.

= Where is my audio stored? =

Generated audio files are downloaded to your WordPress Media Library and stored on your server. You have full control over your audio files.

= Is my content secure? =

Yes. All data is transmitted over HTTPS. Your post content is only used for audio generation and is not stored permanently on WPVoicer servers.

== Screenshots ==

1. WPVoicer metabox in post editor - Generate audio with one click
2. Connection page - Register or login to your WPVoicer account
3. Voice settings - Configure voice parameters and select from multiple voices
4. Custom voice upload - Clone your own voice for personalized narration
5. Audio library - Manage all generated audio files with play counts

== Changelog ==

= 2.4.50 =
* Improved the self-hosted updater integration so the plugin details modal remains available after updating to the latest version.
* Aligned the updater plugin slug with the public WPVoicer slug used by WordPress plugin details screens.

= 2.4.49 =
* Added clearer registration feedback when an account cannot be created from temporary, staging, local, or disposable WordPress environments.
* Added support contact guidance for legitimate cases that require manual approval.
* Improved onboarding and connection handling for registration error codes returned by WPVoicer.com.

= 2.4.48 =
* Updated release metadata and synchronized the packaged readme information.

= 2.4.47 =
* Unified success and error feedback across Connection, Voice Settings, Audio Library, and Intro/Outro screens.
* Added dismissible notices with consistent WPVoicer styling.

= 2.4.46 =
* Updated the WordPress admin menu icon with a cleaner waveform-style WPVoicer mark.
* Improved icon color consistency in the WordPress admin sidebar.

= 2.4.45 =
* Improved the plugin navigation layout inside WordPress admin.
* Moved dashboard access closer to the main WPVoicer navigation.
* Refined spacing in the plugin header area.

= 2.4.44 =
* Normalized button colors and accent styles across the plugin admin screens.
* Improved visual consistency with the current WPVoicer interface.

= 2.4.43 =
* Improved WPVoicer admin menu icon color and active-state behavior.

= 2.4.42 =
* Improved Audio Library width, table layout, and responsive behavior.
* Refined Audio Library controls, spacing, and action buttons.

= 2.4.41 =
* Improved audio play-count tracking reliability.
* Fixed tracking when multiple WPVoicer players are present on the same page.
* Prevented admin previews from increasing public play counts.

= 2.4.40 =
* Updated filenames for newly generated MP3 files to use the `wpvoicer-{post-slug}-{post_id}.mp3` format.
* Existing generated audio files are not renamed or modified.

= 2.4.39 =
* Improved Elementor, Bricks, and Breakdance integration documentation and naming.
* Confirmed local WordPress attachments as the source of truth for page builder integrations.

= 2.4.38 =
* Improved text-length limit messaging.
* Added clearer upgrade guidance for longer generation limits with the Voice Cloning add-on.

= 2.4.37 =
* Improved the Voice Settings limits card.
* Replaced technical entitlement labels with clearer customer-facing wording.

= 2.4.36 =
* Improved custom voice availability checks based on account entitlements.
* Kept custom voice controls gated behind the correct Voice Cloning add-on status.

= 2.4.35 =
* Improved upgrade links for connected users.
* Clarified that minute packages and the Voice Cloning add-on are separate purchases.

= 2.4.34 =
* Added the WordPress site URL to the Connection screen account details.
* Improved the connected account overview layout.

= 2.4.33 =
* Improved completed-job handling after generated audio is downloaded into the WordPress Media Library.
* Improved cleanup flow for temporary remote audio files after local download confirmation.

= 2.4.32 =
* Improved Connection screen layout for connected accounts.
* Separated connected and disconnected states more clearly.

= 2.4.31 =
* Improved disconnected-state handling across plugin tabs.
* Added clearer empty-state guidance for unavailable features.

= 2.4.30 =
* Redesigned the Connection screen for account usage, limits, and site information.
* Improved responsive behavior on smaller WordPress admin viewports.

= 2.4.29 =
* Improved Intro/Outro screen layout consistency.
* Refined form spacing and page alignment.

= 2.4.28 =
* Improved the Audio Library header, search area, and empty states.
* Improved mobile behavior for Audio Library controls and actions.

= 2.4.27 =
* Added pagination to the Audio Library table.
* Improved performance on sites with many generated audio files.

= 2.4.26 =
* Added Audio Library search by post title.
* Improved audio count handling when search filters are active.

= 2.4.25 =
* Added a persistent account limits card in Voice Settings.
* Improved Voice Cloning add-on upgrade messaging.
* Improved text-length upgrade guidance for base users.

= 2.4.24 =
* Fixed onboarding logo rendering across wizard steps.

= 2.4.22 =
* Fixed account purchase history to show the configured free-tier minutes.

= 2.4.21 =
* Fixed onboarding completion redirect.
* Improved onboarding step positioning inside the modal.

= 2.4.20 =
* Improved onboarding navigation and completion behavior.

= 2.4.19 =
* Fixed onboarding visibility after disconnect events.
* Improved reset behavior on test sites.

= 2.4.18 =
* Refined onboarding wizard visuals for a more consistent setup experience.

= 2.4.17 =
* Fixed onboarding reset behavior.
* Improved new-account initialization consistency.

= 2.4.8 =
* Added more resilient long-job processing.
* Improved audio duration estimation.
* Improved connection handling and Audio Library mobile behavior.

= 2.4.7 =
* Refined Audio Library layout and responsive behavior.
* Improved playback UX across mobile browsers.

= 2.4.6 =
* Improved API connection workflow and error messaging.
* Hardened token and session handling.

= 2.4.5 =
* Improved audio generation queue handling.
* Improved retry behavior for transient remote errors.

= 2.4.4 =
* Improved long-text chunk processing stability.
* Improved post content parsing edge-case handling.

= 2.4.3 =
* Maintenance and compatibility improvements.

= 2.4.2 =
* Added stronger capability checks to plugin handlers.
* Added authorization checks to AJAX endpoints.
* Improved overall security posture.

= 2.4.1 =
* Added audio duration estimation before generation.
* Improved speaker selection.

= 2.4.0 =
* Added new speaker selection with preview audio.
* Added multi-engine support.
* Added advanced voice style controls.
* Improved chunking for long articles.

= 2.3.0 =
* Added redesigned admin UI.
* Added Intro/Outro text settings.
* Improved navigation between settings pages.

= 2.2.0 =
* Added play count tracking for audio files.
* Added rate limiting for API endpoints.
* Added security improvements.

= 2.1.0 =
* Added Breakdance page builder support.
* Improved Elementor and Bricks integrations.

= 2.0.0 =
* Complete plugin rewrite with improved architecture.
* Added custom voice cloning support.
* Added Elementor, Bricks, and Breakdance integrations.
* Added Audio Library management.
* Added enhanced voice parameter controls.

= 1.0.0 =
* Initial release.
* Basic text-to-speech functionality.
* Italian language support.

== Upgrade Notice ==

= 2.4.50 =
Fixes plugin details visibility after self-hosted updates.

= 2.4.49 =
Improves registration feedback for sites that are not eligible for free account creation.

= 2.4.48 =
Updates release metadata and packaged readme information.

= 2.4.47 =
Improves feedback notices across the plugin admin screens.

= 2.4.42 =
Improves Audio Library layout, search, pagination, and generated-audio management.

= 2.4.37 =
Improves account limit visibility and Voice Cloning add-on messaging.

= 2.4.30 =
Improves the Connection screen for account, usage, and site information.

= 2.4.27 =
Adds Audio Library pagination for sites with many generated audio files.

= 2.4.26 =
Adds Audio Library search by post title.

= 2.4.25 =
Adds the account limits card and improves Voice Cloning add-on guidance.

= 2.4.8 =
Recommended update for stability, connection handling, and Audio Library improvements.

= 2.4.2 =
Security update. All users should upgrade.

= 2.4.0 =
Adds speaker previews, multi-engine support, and improved long-article handling.

= 2.0.0 =
Major plugin rewrite with new audio library, custom voice, and page builder integrations.
