Use the WordPress plugin
Learn how to use the BeyondWords for WordPress plugin.
After you have set up the BeyondWords for WordPress plugin, you can publish new posts and pages like usual. Those in your chosen categories will be made listenable automatically. (If you have enabled 'Pending review', you will need to publish them first.)
For all other usages, please see the instructions below.
Whether or not audio is requested for a post depends on the status of the 'Generate audio' checkbox in the sidebar at the time of publishing.
The default setting for the checkbox depends on the page/post type and category, and can be determined in plugin settings (Settings > BeyondWords > 'Generate audio' settings > Preselect 'Generate audio').
You can disable audio processing for any paragraph via the WordPress Block Editor. 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
The customizable audio player will render before the first part of
the_content()
by default. This means it should appear directly above your body content.If you wish to change the location of the player, you can do so via your WordPress Editor:
- 1.Open the relevant post or page in your WordPress Editor
- 2.There are two options, depending on whether you use the WordPress Classic Editor or Block Editor:
In the Classic Editor, select where you would like to place the player, then select 'Insert BeyondWords Player' button — a player placeholder will appear, which can be deleted or moved
In the Block Editor, press the '+' icon then select the BeyondWords block — a player placeholder will appear, which can be deleted or moved
3. Select 'Publish' or 'Update' and the player will appear in the new location on your live post or page
Please note that the player will only appear if the audio is processed is pubished.
To trigger audio processing for a post:
- 1.Open the post in WordPress
- 2.Check 'Generate audio' in the BeyondWords section of the post sidebar
- 3.Select 'Update'
If audio was previously created for the post but has since been deleted, you will need to:
- 1.Remove the old BeyondWords data from the post:
- 1.Open the relevant post using the Block Editor
- 2.Open the Inspect section of the BeyondWords sidebar
- 3.Scroll to the bottom and select 'Remove'
- 4.Select 'Update' to finalize the removal
- 2.Create the replacement audio:
- 1.Update the post with 'Generate audio' checked
You can request audio for one or more existing posts using 'Bulk actions':
- 1.Open the relevant posts overview page in your WordPress admin ('Posts', 'Pages', or a custom post type)
- 2.Use the checkboxes to select the posts you would like to request audio for (you may need to change your 'View mode' in 'Screen Options' first)
- 3.Choose 'Generate audio' from the 'Bulk actions' dropdown then select 'Apply'
You should receive a success message stating that audio has been requested. If audio already exists for any posts, these will be skipped. Once processed, the audio will be embedded automatically.
You can manually embed any audio into your WordPress post using our Small or Medium Player UI. You will need to add the iFrame code to your post via the HTML editor or a 'Custom HTML' block.
By default, if you update the title or body text in an audio-enabled post, BeyondWords will automatically reprocess the audio to match. Processing usually takes just a few minutes and will only use additional characters if you add paragraphs or change voices.
By default, BeyondWords will automatically reprocess audio to match any updates to your text. If you wish to disable this automatic reprocessing:
- 1.Go to the 'Content (Audios)' section of your project dashboard
- 2.Hover on the audio you would like to disable CMS updates for
- 3.Select '⋮' to open the submenu, then select 'Disable CMS updates'
If you wish to edit an audio without updating the corresponding post, you can do so using the TTS Editor. You can edit the wording, change voices at a title and paragraph level, and insert your own audio clips.
During this process, we recommend that you disable CMS updates to avoid the risk of accidentally overwriting your changes.
If you unpublish an audio, it will not be available for distribution. This means that the player will not appear on your WordPress post.
This is the best method if you want to keep your audio available for other distributions or hide it from your post temporarily. If CMS updates are enabled, the audio will be automatically updated like usual.
- 1.Open the post in WordPress
- 2.Open the BeyondWords sidebar
- 3.Uncheck 'Display player'
- 4.Select 'Update' to save your changes
You can reinstate the player at any time. Just update the post with 'Display player' checked.
If you delete an audio from your BeyondWords dashboard, the player will no longer appear on the corresponding post.
To create replacement audio, you will need to:
- 1.Remove the old BeyondWords data from the post:
- 1.Open the relevant post using the Block Editor
- 2.Open the Inspect section of the BeyondWords sidebar
- 3.Scroll to the bottom and select 'Remove'
- 4.Select 'Update' to finalize the removal
- 2.Create the replacement audio:
- 1.Update the post with 'Generate audio' checked
If you delete an audio-enabled post in WordPress, the corresponding audio will still be available in your BeyondWords dashboard. You can delete it if you wish.
Last modified 6mo ago