This guide explains how to connect your Ghost site to BeyondWords using the BeyondWords x Ghost integration.
This allows you to automatically create and embed audio versions of your posts.
Log into your Ghost admin dashboard
From the left-hand menu, select 'Integrations'
Select 'Add custom integration'
Enter the name 'BeyondWords' then select 'Create'
Keep the admin API key and API URL on hand for later
Sign into your BeyondWords account (don't have one? Create your free account)
Go to the 'Content' section of your project dashboard (don't have one? Create a project)
Already created audio? You will need to navigate to 'Settings (Integration)' instead.
Select 'Ghost' under 'Connect your CMS'
Copy and paste the admin API key and API URL from Ghost into the corresponding fields, then select 'Test' — you should get a 'Success' message
Copy the audio player script for use in the next stage
Select 'Save changes'
- Go to 'Settings' in your Ghost admin
- Select 'Code injection'
Paste the audio player script into a new line in 'Site Footer' then select 'Save'
Please note: While the audio player script is inserted into the Site Footer section, the Small Player will be embedded below the header, at the top of your audio-enabled posts. If you would like to change this default position, you can edit your
post.hbstemplate and add an empty div with the class ‘speechkit-container’ where you would like to see the player.
The BeyondWords x Ghost integration should now be installed, activated, and enabled. BeyondWords will automatically create audio versions of new posts, with each conversion using characters. Once processed (this should take just a few minutes), the audio version will be automatically embedded into the source page via the Small Player.
You can customize the Small Player in the 'Distribution (Player)' section of your project dashboard.
How to disable automatic publishing
If you wish to review your audio before it is published, you will need to enable 'Pending review'.
Will my old posts be converted into audio?
BeyondWords will not automatically convert pre-existing Ghost posts into audio. However, you can trigger audio processing by updating an old post.
What happens when I update a post?
If you update the text in an audio-enabled post via Ghost, BeyondWords will automatically reprocess the audio. Once available, the new version will be streamed in the Player. Reprocessing usually takes just a few minutes and will not use any additional characters.
If you update the text in an old page or post that does not currently have audio, this will trigger audio processing. This will use characters and the Player will be embedded like normal.
If you wish to edit the audio script without editing your Ghost post, see our instructions on editing audio.
Can I customize the Player's appearance?
Yes, you can customize the Small Player used by the Ghost integration.
Can I remove the Player from specific posts?
Yes, you can remove the automatically embedded Player from specific Ghost posts by disabling the corresponding audio. However, please note that this will affect all distributions of this audio.
Will the integration slow down my website?
Can I share my audio versions elsewhere?
Yes, there are many other ways to distribute audio versions of your Ghost posts.
All of your audio versions will be available in the 'Content (Audios)' section of your project dashboard, where you can:
Updated about 1 month ago