WordPress Plugin Installation and Configuration

The EnaCast for WordPress plugin allows you to integrate your radio station’s content directly into your WordPress website. Programs, podcasts, news, broadcast schedule, events and more, all connected to the EnaCast API.

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• A radio station configured in EnaCast (you will need your radio’s codename)

Installation

1. Download the EnaCast plugin for WordPress
2. In the WordPress dashboard, go to Plugins > Add New > Upload Plugin
3. Select the .zip file and click Install Now
4. Once installed, click Activate Plugin

Configuration

After activating the plugin, go to Settings > EnaCast to configure the API connection.

Configuration Fields

Field	Description	Example
Radio codename	Your radio station’s unique identifier in EnaCast	myradio
Cache time (TTL)	Seconds that API responses are cached (default 300)	300

ℹ️ Note: the API URL automatically points to enacast.com. No configuration is required.

Test the Connection

Click the Test Connection button to verify that WordPress can communicate with the EnaCast API. If the connection is successful, you will see a confirmation message.

Quick Start: Creating the Pages

The plugin works through shortcodes that you can insert into any WordPress page or post. Below we explain how to create the main pages for your radio station.

Programs Page

1. Create a new page in WordPress (e.g. title: “Programs”)
2. Add the shortcode [enacast_programs]
3. Publish the page

This page will display the list of your station’s programs with search filters, a toggle to filter by on-air programs, and pagination.

Program Detail Page

1. Create another page (e.g. title: “Program”)
2. Add the shortcode [enacast_program]
3. Publish the page
4. Go to Settings > EnaCast and set the program detail page by selecting the page you just created

ℹ️ Note: the detail page receives the ?program=codename parameter automatically from the programs list.

Podcasts Page

1. Create a new page (e.g. “Podcasts”)
2. Add the shortcode [enacast_podcasts]
3. Publish the page

This will display all episodes with search, programme filter, and pagination.

Podcast Detail Page

1. Create another page (e.g. “Episode”)
2. Add the shortcode [enacast_podcast]
3. Configure the podcast detail page in Settings > EnaCast

News Page

1. Create a new page (e.g. “News”)
2. Add the shortcode [enacast_news]
3. Publish the page

News Article Detail Page

1. Create another page (e.g. “Article”)
2. Add the shortcode [enacast_news_article]
3. Configure the news article detail page in Settings > EnaCast

Schedule Page

1. Create a new page (e.g. “Schedule”)
2. Add the shortcode [enacast_schedule]
3. Publish the page

Displays the weekly broadcast schedule with week-by-week navigation.

Events Page

1. Create a new page (e.g. “Events”)
2. Add the shortcode [enacast_agenda]
3. Publish the page

Now Playing

You can add the shortcode [enacast_now_playing] to any page, sidebar or widget to show which program is currently being broadcast.

Page Settings

The list pages and detail pages link to each other automatically. For this to work correctly, you must configure the page settings in Settings > EnaCast:

Detail pages (detail views link from list cards):

• Program detail page: the page containing [enacast_program]
• Podcast detail page: the page containing [enacast_podcast]
• News article detail page: the page containing [enacast_news_article]

List pages (detail views link back to lists):

• News list page: the page containing [enacast_news] — enables “Back to news” link on articles
• Podcasts list page: the page containing [enacast_podcasts] — enables “See all episodes” link on programs

Other pages:

• Schedule page: the page containing [enacast_schedule] — enables schedule links from the now playing widget

Subscribe Buttons

Each program’s detail page displays subscribe buttons for podcast apps: RSS, Apple Podcasts, Overcast, Pocket Casts, and Castro.

You can enable or disable each platform individually in Settings > EnaCast, under the Subscribe Buttons section. All buttons are enabled by default.

Gutenberg Blocks

All shortcodes are also available as Gutenberg blocks. Search for “EnaCast” in the block inserter to find them. The blocks offer a live preview within the editor.

Cache

The plugin caches API responses using WordPress transients. By default, the cache lasts 5 minutes (300 seconds). You can change this value in Settings > EnaCast.

To clear the cache manually, click Clear Cache on the settings page or save the settings (the cache is automatically cleared on save).