Leírás
Sangar Studio ReadFlow is a premium, high-fidelity WordPress plugin designed to elevate the user reading and auditory experience on your website. It calculates the reading time of your posts based on custom speed parameters and inserts a gorgeous, glassmorphic player widget that lets users listen to posts.
By integrating directly with OpenAI’s state-of-the-art TTS models, Sangar Studio ReadFlow converts your blog content into natural, fluid, human-like voice recordings. It handles OpenAI’s character limitations gracefully by dividing long essays into sentence-aware blocks and stitching the audio binaries together seamlessly.
To protect your budget and increase speed, Sangar Studio ReadFlow features a robust local caching system. It generates the voice file only once per post and caches it directly inside your server’s uploads directory. Every subsequent listener loads the audio instantly in a custom-designed web player.
If no API Key is provided, or if the API suffers a network failure, the plugin automatically falls back to the Web Speech API SpeechSynthesis, providing free, zero-config native voice synthesis directly inside the reader’s browser.
Key Features
- Accurate Reading Time Indicator: Computes reading times based on custom Words Per Minute (WPM) settings.
- Premium Custom HTML5 Player: Ditch the default browser audio bar. Features stylized play/pause buttons, loading spinners, sound-wave animations, and draggable seek sliders.
- OpenAI TTS Integration: Access six natural voices (Alloy, Echo, Fable, Onyx, Nova, Shimmer) with standard
tts-1or high-definitiontts-1-hdqualities. - Unlimited Text Length Chunking: Sentence-intelligent text-splitting bypasses API size caps for infinite post narration.
- Smart Local Caching: Saves generated MP3s locally. Zero repetitive API billing overhead for repeat readers.
- Auto Pre-Generation: Optional setting pre-renders post narration in the background as soon as you hit „Publish”.
- Sleek Administration Panel: Manage credentials, customize accent colors, adjust reading formulas, check cache sizes, test voices with live playback, and flush files with one click.
- Zero-Config Web Speech Fallback: Universal native voice narration fallback if AI models are disabled or run out of quota.
- Adjustable Playback Velocity: Speed options (
0.8x,1.0x,1.2x,1.5x,2.0x) for listeners on the go. - Direct MP3 Download Link: Give readers the option to take post narrations with them.
Privacy & Third-Party Service Disclosure
This plugin integrates with and sends requests to a third-party service: OpenAI API (specifically the Text-to-Speech service).
- What is sent: Only the plain text content of your published posts is transmitted to OpenAI’s servers to synthesize the voice.
- What is NOT sent: No reader IP addresses, personal data, browser details, or cookies are sent to OpenAI.
- Data Processing & Storage: The audio generation is executed server-side. The compiled MP3 is saved locally on your self-hosted WordPress site inside
/wp-content/uploads/sangar-studio-readflow/. No external CDN or tracking tags are embedded in the reader’s browser. - OpenAI Terms: For more details on data retention policies, please check the OpenAI Privacy Policy: https://openai.com/policies/privacy-policy
Telepítés
- Upload the
sangar-studio-readflowfolder to the/wp-content/plugins/directory, or upload the ZIP file via Plugins > Add New > Upload Plugin. - Activate the plugin through the Plugins screen in WordPress.
- Navigate to Settings > ReadFlow 🎙️ in your admin dashboard.
- (Optional) Toggle „Activar Voz por IA”, input your OpenAI API Key, and select your default voice and model.
- Customize visual configurations (accent colors, positioning, reading speeds) and click Guardar Configuración.
GYIK
-
Is an OpenAI API Key required?
-
No. If you leave „Voz por IA” disabled or do not provide an API Key, the plugin operates in fallback mode, using the reader’s local web browser engine (
window.speechSynthesis) to synthesize voice completely free and instantly. -
Where are the generated audio files saved?
-
Files are saved inside the
/wp-content/uploads/sangar-studio-readflow/directory as static MP3 files. They are automatically named according to post IDs (e.g.post-42.mp3). -
How is cache invalidated when I edit a post?
-
The plugin listens to post updates. Saving, editing, or trashing a post automatically deletes its corresponding cached MP3 so that the fresh content is compiled on the next listener’s play click.
-
Does the text chunking support very long articles?
-
Yes! Sangar Studio ReadFlow breaks articles into smart, semantic chunks of approximately 3,500 characters, avoiding breaking mid-word or mid-sentence. It submits each chunk sequentially and compiles the resulting binaries into a unified audio stream, bypassing OpenAI’s 4,096 character limit easily.
-
How can I place the widget manually?
-
Select „Insertar manualmente” in the settings, and insert the shortcode
[sangar-studio-readflow]anywhere in your post text, or call it programmatically in your theme files:(The legacy shortcode
[readio]is also fully supported for backward compatibility).
Vélemények
Nincsenek értékelések erről a bővítményről.
Közreműködők és fejlesztők
“Sangar Studio ReadFlow” egy nyílt forráskódú szoftver. A bővítményhez a következő személyek járultak hozzá:
Közreműködők“Sangar Studio ReadFlow” fordítása a saját nyelvünkre.
Érdekeltek vagyunk a fejlesztésben?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Változási napló
1.2.1
- Fixed Text Domain Mismatch errors for proper i18n compatibility.
1.2.0
- Added full WordPress 7.0 compatibility.
- Integrated natively with the WordPress 7.0 Abilities API (safely supported on WP 6.9+), exposing post audio narration generation and retrieval as standard system abilities.
- Ready for the WordPress 7.0 Native AI Client and Model Context Protocol (MCP) tool-calling support.
- Fully verified compatibility with PHP 8.3 and PHP 8.4 recommended guidelines for WordPress 7.0.
1.1.1
- Fixed all WordPress Plugin Check tool errors and warnings.
- Replaced strip_tags with wp_strip_all_tags for better compliance.
- Added missing translators comments to translatable strings.
- Scoped uninstall variables and migrated to WP_Filesystem API in uninstall.php.
- Cleaned up deprecated load_plugin_textdomain call.
1.1.0
- Added OpenAI TTS integration with 6 beautiful natural voices.
- Added smart, sentence-aware chunking for infinite-length blog post compilation.
- Added server-level binary caching (
wp-content/uploads/sangar-studio-readflow/). - Added automatic background audio compilation on post publish.
- Added custom HTML5 player visual overlay with progress tracking, visual equalizer animations, speed adjustment dropdown, and direct MP3 downloads.
- Added Live API Connection tester in administration dashboard.
- Fully refactored classes, prefixing, variables, and options names to be 100% compliant with WordPress.org submission requirements.
1.0.0
- Initial structure. Basic reading time calculations and raw browser SpeechSynthesis triggers.
