Set up the WordPress plugin
Learn how to set up the BeyondWordsWordPress plugin.
This guide explains how to set up the BeyondWords for WordPress plugin. Once complete, posts and pages from your chosen categories will be made listenable automatically (your content will be imported to your project, converted into audio, and then embedded via a customizable player).
The BeyondWords plugin works with pages, posts, and custom post types that have 'custom-fields' in the 'supports' array. See this WordPress resource for guidance.
- 1.
- 2.
- 3.Go to the 'Content' section then select 'WordPress' under 'Connect your CMS' (already created audio? You will need to navigate to 'Settings (Integration)' instead)
- 4.Keep the API credentials (Project ID and API key) on hand for later
Optional:
- Change default voices: You can change the default voice for titles and body content in integration settings or 'Settings (General)'. This will also affect the TTS Editor.
- Customize the audio player: The plugin uses the Small Player by default. If you would rather use the Medium Player, you can use the beyondwords_js_player_params filter. You can customize both players in 'Settings (Player)'.
- Add custom text-to-speech rules: You can add aliases in 'Settings (Aliases)' or request more complex rules from our team.
- 1.Log into your WP Admin dashboard
- 2.From the left-hand menu, select 'Plugins' then 'Add New'
- 3.Search for 'BeyondWords', select the plugin, then select 'Install and activate'
- 4.Once installed, select the 'Manage Plugins' button — you will be redirected to the 'Installed Plugins' page
- 5.Select 'Settings' in the BeyondWords plugin (at this stage, we also recommend enabling auto-updates — this will ensure you don't miss any improvements to the plugin)
- 6.Follow the instructions provided to authenticate your account and determine your settings — if your custom post type is not appearing, please add 'custom-fields' in the 'supports' array (see this WordPress resource for guidance)
- 7.Select 'Save Settings'
The BeyondWords for WordPress plugin should now be installed, activated, and enabled. For posts and pages in eligible categories, audio will be processed automatically. This uses characters, and processing typically takes a couple of minutes.
To request audio for posts that are created programatically (for example, with
wp_insert_post
), set the custom field speechkit_generate_audio
with the value of 1
.This will send the post content to the BeyondWords API for processing immediately after the post is created in WordPress.
If you are using the
wp_insert_post function
, $fire_after_hooks
will be set to true
by default. This is a requirement — if you set this parameter to false
, audio generation will fail.BeyondWords will convert your WordPress title and body content into audio using the default voice set for each.
If you would like excerpts to be included in audio versions, you can use the 'Process excerpts' setting in the plugin settings. Excerpts will be prepended to your body content, meaning that they will be read aloud after the title and in the default voice chosen for body content.
Yes, if you are using the Block Editor you can disable audio processing for any paragraph. Click anywhere in the paragraph you'd like to exclude then:
- Select the speaker icon in the block toolbar ('Disable audio processing') so that the sound waves are removed from the icon, OR
- Switch the toggle in the BeyondWords section of the block sidebar so that it says 'Audio processing disabled'
You can also place elements within
<figcaption>
or <aside>
HTML tags, or the following classes, to prevent them from being processed into audio:- .callout
- .definition
- .divduo
- .pullquote
- .float-out--left
- .float-out--right
- .float-out--right--top
BeyondWords will not automatically convert pre-existing WordPress posts or pages into audio. However, you can generate audio for old posts or pages by using 'Bulk actions' or updating a post with 'Generate audio' checked.
The WordPress plugin uses the Small Player by default. This is a streamlined audio player specially designed for on-page narration, and it can be customized in the 'Settings (Player)' section of your project dashboard.
If you would rather use the Medium Player, you can use the speechkit_js_player_params filter. This can also be customized in 'Settings (Player)'.
By default, our WordPress plugin prepends the player before the first part of
the_content()
, which you should find in your PHP templates. This means it should appear directly above your body content.The player will be automatically embedded into pages with processed and published audio. It will not be rendered on pages where an audio version is unavailable.
Last modified 5mo ago