-

Advanced Settings Guide for the WordPress Plugin

A banner image for the Trinity Audio WordPress plugin advanced settings guide, featuring abstract representations of a LiteSpeed cache gear icon, a third-party theme browser window, and a code bracket, with text reading "ADVANCED SETTINGS GUIDE".

Introduction

Thank you for taking an interest in the Trinity Audio WordPress plugin. In this manual, we’ll walk you through some advanced settings supported by the plugin.  If any questions arise, don’t hesitate to reach out to our team at support@trinityaudio.ai and we’ll make sure to help out.

Topics

In this guide, we're going to cover the following topics:

  • LiteSpeed cache plugin
  • 3rd party themes
  • TTS Player JS Code

LiteSpeed cache plugin

3rd party themes

TTS Player JS Code


LiteSpeed cache plugin: compatibility

First, in your WordPress admin dashboard, hover over the LiteSpeed Cache plugin in the left sidebar, and select "Page Optimization" from the submenu that opens:

A screenshot of the WordPress sidebar menu showing the LiteSpeed Cache menu. A red box highlights "LiteSpeed Cache" and an orange arrow points to the "Page Optimization" submenu option.

In the new dashboard, click on the "Tuning" tab:

A screenshot of the LiteSpeed Cache settings header. A red box and arrow highlight the "[8] Tuning" tab.

Add the following exclusions to the JS Excludes field:

  • trinity-player.js
  • trinity
A close-up screenshot of the "Tuning Settings" in WordPress, showing the "JS Excludes" text box with "trinity-player.js" and "trinity" typed on separate lines.

trinity-player.js

trinity

After you paste them into the corresponding field, don't forget to save your changes:

A screenshot of the LiteSpeed Cache settings header. A red box and arrow highlight the "[8] Tuning" tab.

3rd party themes

This section is written for clients using 3rd party themes on Wordpress which are causing the TTS player not to load.

Pleaser read the following notes before making any changes based on the instructions of this section:

  1. Don't use this settings unless you are sure. If there is any doubt, always consult with oursupport.
  2. If it doesn't help with your theme,sign up to our dashboardtoget a JS snippetthat supports all themes, pages and more.

Don't use this settings unless you are sure. If there is any doubt, always consult with our support.

If it doesn't help with your theme, sign up to our dashboard to get a JS snippet that supports all themes, pages and more.

If order to activate the TTS player with your 3rd party theme, follow these steps:

  • Start by going to your WordPress admin dashboard. Look on the left side and find the Trinity Audio plugin. Click on it, and then choose "Trinity Audio" from the options that appear.

A screenshot of the WordPress admin sidebar. A red box highlights "Trinity Audio," and a red arrow points to the "Trinity Audio" submenu item.
  • Scroll down the page until you reach the bottom. You'll see a section called "Advanced settings.
  • In this section, you'll find a checkbox. Please make sure to check the box, just like the example shows.
A screenshot of the "Advanced Settings" section of the Trinity Audio plugin. A red arrow points to a checked "Enable" box next to the setting "Render player with 3rd party theme posts, e.g. Divi, Bespoke, etc."

Scroll down the page until you reach the bottom. You'll see a section called "Advanced settings.

In this section, you'll find a checkbox. Please make sure to check the box, just like the example shows.

  • Once you've checked the box, remember to save the changes you've made:
A screenshot of the Trinity Audio plugin settings page. A red box and red arrow highlight the bright pink "SAVE CHANGES" button on the right side of the screen.

Adding TTS Player JS Code to your WordPress Site

  • Create a player in theTrinity Audio dashboard. For more information, please visit theplayer implementation guide.
  • Copy the player code from the Trinity Audio dashboard.

Create a player in the Trinity Audio dashboard. For more information, please visit the player implementation guide.

Copy the player code from the Trinity Audio dashboard.

Now, let's get visual! Check out these screenshots in your WordPess admin panel:
  • Step 1:Hit that "Insert" button up in the top left corner of your post:
A screenshot showing the WordPress block search bar with "html" typed in. A yellow arrow points  plus icon adding "Custom HTML" block.
  • Step 2: Search for 'html' in the search bar:
A screenshot showing the WordPress block search bar with "html" typed in. A yellow arrow points to the search result for the "Custom HTML" block.
  • Step 3: moving HTML panel by the arrow button to the right place before your first paragraph and adding the code snippet:
A screenshot of the WordPress block editor showing a "Custom HTML" block. A yellow box highlights the "Move Up" arrow, and the text field contains the placeholder "insert your code here..."


Remember to save your changes. Once you've added the Player Code to your post, let us know so our team can ensure the implementation is correct and the text is read accurately. After this final step, we'll activate the Player for you.

Note: For successful JS integration, disable the Trinity Audio WP plugin on posts where you've inserted the Code snippet.

Summing things up

In case you have any further questions, please visit our FAQ page in WordPress and on our website. In addition, please don’t hesitate to reach out to us directly via support@trinityaudio.ai, we would be happy to hear from you (pun intended).

Happy listening from all of us at Trinity Audio!

FAQ

What should I do if my Trinity Audio player isn't loading on my custom WordPress theme?

Third-party themes can sometimes conflict with the default plugin settings. To fix this, navigate to the Trinity Audio plugin settings in your dashboard and scroll to the bottom. Locate the "Advanced settings" section and check the box to enable compatibility mode. If the player still doesn't appear, it is recommended to use the JS snippet available in the Trinity Audio dashboard, which is designed to support all themes and page types.

How do I prevent the LiteSpeed Cache plugin from breaking the audio player?

Performance plugins like LiteSpeed often compress or delay JavaScript, which can interfere with the player. To prevent this:

  1. Go to LiteSpeed Cache > Page Optimization > Tuning.
  2. Locate the JS Excludes field.
  3. Add trinity-player.js and trinity to the list.
  4. Save changes to ensure these files are ignored by the optimization engine.

Can I manually add the audio player to a specific post using code?

Yes. You can bypass the plugin by inserting a custom HTML block into your post. Copy your unique player code from the Trinity Audio dashboard, then in the WordPress editor, add a Custom HTML block above your first paragraph and paste the snippet.

Note: If you use this manual method, you must disable the Trinity Audio WordPress plugin for that specific post to avoid having duplicate players or script conflicts.

Ready to Monetize Your Audio?

Discover how TrinityAudio can unlock new revenue streams for your content.

Get a Demo