How can we help?

Add custom text before or after every audio file PRO: add a spoken intro or outro, such as a sponsor message or sign-off, to all generated audio. Fix audio generation errors What each audio generation error means, from OpenAI quota and API key problems to timeouts, missing PHP extensions and file errors… Hooks, filters and code examples Developer reference for the plugin's filters, actions and helper functions, with code examples for content and player changes. Plugin overview What the plugin does, how audio is generated with OpenAI, and where to find each part of the plugin in WordPress. Settings page overview A quick reference to every tab and option on the AI Text-to-Speech settings page, with defaults. Store audio files in Dropbox PRO: create a Dropbox app, connect it to the plugin and save new audio files to Dropbox instead of your server. Customise the audio content for a single post PRO: add text before and after one post's audio, or replace the spoken content entirely, from the post editor. Install and set up the plugin Install the plugin, create an OpenAI API key, add it to the settings page and generate your first audio file. Store keys in wp-config.php Define the OpenAI API key and Dropbox app credentials as wp-config.php constants, and a known limitation in version 3.2.0. The audio player isn’t showing on a post Troubleshoot a missing, duplicated or silent audio player: page type, caching, theme compatibility and file access. What is included in the audio How the plugin turns post content into spoken text: the title intro, and what is removed or rewritten before generation. Display the audio player on posts Where the audio player appears, how to move it with the [ai_tts_player] shortcode, and how to change the AI disclosure label. Fix how words are pronounced PRO: use the Custom Pronunciations settings or the [tts say] shortcode to control how names, acronyms and jargon are spoken. Generate audio for a post Use the AI TTS box in the post editor to generate, replace, upload, copy or delete the audio file for a post. Options and post meta reference Developer reference to the options, post meta keys, file paths and AJAX actions the plugin stores or registers, and how to remove… The AI TTS box is missing from the post editor Find or restore the AI TTS box in the post editor when it's hidden, disabled for a post type or role, or asking for an API key. Audio skips content or reads things wrongly Fix audio that skips content, reads links or captions, mispronounces words, ignores shortcodes or has uneven pauses. Generate audio from any text on the Generator page Create and download standalone MP3 files from any text on the AI TTS Generator admin page, without creating a post. How audio generation works Technical walkthrough of how text is prepared, split into chunks, sent to OpenAI and saved as a single MP3 file. Limit the plugin to post types and user roles Choose which post types show the AI TTS box and which user roles are allowed to generate or delete audio. Shortcodes reference Every shortcode the plugin supports: [ai_tts_player], [tts say], [tts ignore] and [voice], with examples and rules. Free and PRO features compared A side-by-side list of what the free plugin includes and which features need a PRO licence. Manage files on the TTS Files page Browse, play, download, search and bulk delete every generated audio file from the TTS Files admin page. Statistics aren’t recording Why listening statistics show zero or low numbers, including page caching, expired security tokens and delayed scripts. Use more than one voice in a post PRO: switch between voices within one audio file using the [voice] shortcode, for quotes, interviews and dialogue. Frequently asked questions Answers to common questions about OpenAI costs, bulk generation, AI disclosure, privacy, uninstalling and support. Generate audio automatically when a post is published PRO: turn on auto-generation so audio is created as soon as you publish a post in the block editor, and what it doesn't cover. View the API request logs Check the last 50 OpenAI requests the plugin made, with characters, estimated cost and response codes, plus the error log. Voices, voice models and supported languages The 13 available voices, the difference between the GPT-4o mini TTS and TTS-1 models, costs and supported languages. Customise the audio player PRO: set the player's accent and background colours, height and default playback speed, and which browsers support them. Voice styles and custom instructions Change the tone of generated audio with voice style presets and your own voice instructions on the GPT-4o mini TTS model. Track listening statistics PRO: see views, plays and listening time for your audio players on the Statistics page and in the post editor.