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).
- 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
- 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'
To request audio for posts that are created programatically (for example, with
wp_insert_post), set the custom field
speechkit_generate_audiowith the value of
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
$fire_after_hookswill be set to
trueby 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
<aside>HTML tags, or the following classes, to prevent them from being processed into audio:
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.