fbpx

Documentation: Plugin Options

← Back to Documentation Index

Plugin Settings are stored in an array under the radio_station key in the WordPress options table.

Below is a list of plugin options available via the Plugin Settings Screen.

Plugin Setting Value Filters

Note for custom flexibility, all Plugin Settings can also be filtered programmatically via their respective option key. Use add_filter to add a filter to radio_station_{settings_key}, then check your desired conditions to modify the value before returning it. eg:

add_filter( 'radio_station_station_phone', 'my_custom_station_phone' ); function my_custom_station_phone( $number ) { $current_hour = (int) date( 'G', time() ); if ( $current_hour > 20 ) {$number = '(123) 456 7890';} return $number; }

The above example will change the display of the Station Phone number after 8pm (server time).

General

Broadcast

Streaming URL

Default: None. Key: streaming_format Enter the Streaming URL for your Radio Station. This will be discoverable via Data Feeds and used by default by the Radio Player.

Stream Format

Default: AAC/M4A. Key: streaming_format Select the format for your stream. This will be discoverable via Data Feeds and used by default by the Radio Player.

Fallback URL

Default: None. Key: fallback_url Enter the fallback Streaming URL for your Radio Station. This will be discoverable via Data Feeds and used by default by the Radio Player.

Streaming URL

Default: OGG. Key: fallback_format Select the format for your fallback stream. This will be discoverable via Data Feeds and used by default by the Radio Player.

Main Broadcast Language

Default: WordPress Language. Key: radio_language Select the main language used on your Radio Station.

Station

Station Title

Default: none. Key: station_title

Station Image

Default: none. Key: station_image

Location Timezone

Default: WordPress Timezone. Key: timezone_location Select your Broadcast Location for Radio Timezone display.

Clock Time Format

Default: 12 Hour Format. Key: clock_time_format Default Time Format for display output. Can be overridden in each shortcode or widget.

Station Phone

Default: none. Key: station_phone Default Phone Number to use for requests etc.

Shows Phone

Default: On. Key: shows_phone Use the Station Phone Number on Shows which do not have a phone number specified.

Station Email

Default: none. Key: station_email Default Email Address to use for requests etc.

Shows Email

Default: On. Key: shows_email Use the Station Email Address on Shows which do not have an email address specified.

Feeds

Enable Data Routes

Default: On. Key: enable_data_routes Enables Station Data Routes via WordPress REST API.

Enable Data Feeds

Default: On. Key: enable_data_feeds Enable Station Data Feeds via WordPress Feed links.

Ping Netmix Directory

Default: On. Key: ping_netmix_directory

Clear Transients

Default: Off. Key: clear_transients

[Pro] Transient Caching

Default: On. transient_caching Use Transient Caching to improve Schedule calculation performance.

[Pro] Show Shift Feeds

Default: On. Key: show_shift_feeds Convert RSS Feeds for a single Show to a Show shift feed, allowing a visitor to subscribe to a Show feed to be notified of Show shifts.

Player

Pages

Master Schedule

Master Schedule Page

Default: None. Key: schedule_page Select the Page you are displaying the Master Schedule on.

Automatic Schedule Display

Default: On. Key: schedule_auto Replaces selected page content with Master Schedule.
Alternatively customize with the shortcode: [master-schedule] See Master Schedule Shortcode for more info.

Schedule View Default

Default: Table. Key: schedule_view View type to use for automatic display on Master Schedule Page.

Radio Clock

Default: On. Key: schedule_clock Whether to enable the display of the Radio/User Times clock on the automatic Master Schedule Page.

[Pro] Schedule View Switcher

Default: On. Key: schedule_switcher Enable View Switching on the automatic Master Schedule Page.

[Pro] Available Views

Default: table, tabs. Key: schedule_views Which Views to enable for switching on the automatic Master Schedule Page.

Show Pages

Show Info Blocks Position

Default: Left. Key: show_block_position Where to position Show info blocks relative to Show Page content.

Show Content Layout

Default: Tabbed. Key: show_section_layout How to display extra sections below Show description. In content tabs or standard layout down the page.

Show Content Header Image

Default: Off. Key: show_header_image If your chosen template does not display the Featured Image, enable this and use the Content Header Image box on the Show edit screen instead.

Show Posts Per Page

Default: 10. Key: show_posts_per_page Linked Show Posts per page on the Show Page tab/display.

Show Playlists per Page

Default: 10. Key: show_playlists_per_page Playlists per page on the Show Page tab/display.

[Pro] Show Episodes per Page

Default: 10. Key: show_episodes_per_page Number of Show Episodes per page on the Show page tab/display.

Archives

Show Archives Page

Default: None. Key: show_archive_page Select the Page for displaying the Show archive list.

Show Archives Automatic Display

Default: On. Key: show_archive_auto Replaces selected page content with default Show Archive.
Alternatively customize display using the shortcode: [shows-archive] See Show Archives Shortcode for more info.

Override Archives Page

Default: None. Key: override_archive_page Select the Page for displaying the Override archive list.

Override Archives Automatic Display

Default: On. Key: override_archive_auto Replaces selected page content with default Override Archive.
Alternatively customize display using the shortcode: [overrides-archive] See Show Archives Shortcode for more info.

Playlist Archives Page

Default: None. Key: playlist_archive_page Select the Page for displaying the Playlist archive list.

Playlist Archives Automatic Display

Default: On. Key: playlist_archive_auto Replaces selected page content with default Playlist Archive.
Alternatively customize display using the shortcode: [playlists-archive] See Playlist Archives Shortcode for more info.

Genre Archives Page

Default: None. Key: genre_archive_page Select the Page for displaying the Genre archive list.

Genre Archives Automatic Display

Default: On. Key: genre_archive_auto Replaces selected page content with default Genre Archive.
Alternatively customize display using the shortcode: [genres-archive] See Genre Archives Shortcode for more info.

Templates

Since 2.3.0, the way that Templates are implemented has changed. See Templates for more info.

Single Templates

Show Template

Default: page.php. Key: show_template Which template to use for displaying Show and Override content.

Combines Show Template Method

Default: Off. Key: show_template_combined For advanced usage. Use both a custom template AND content filtering for a Show. (Not compatible with Legacy templates.)

Playlist Template

Default: page.php. Key: playlist_template Which template to use for displaying Playlist content.

Combined Playlist Template Method

Default: Off. Key: playlist_template_combined For advanced usage. Use both a custom template AND content filtering for a Playlist. (Not compatible with Legacy templates.)

Widgets

AJAX Loading

Default: On. Key: ajax_widgets Whether to load Widget contents via AJAX by default. This prevents stale cached displays of Current/Upcoming Shows etc. Note this can be changed on a per widget basis.

[Pro] Dynamic Reloading

Default: On. Key: dynamic_reload Whether to reload Widgets automatically on change of Current Show. Can also be set on a per widget basis.

Roles

Since 2.3.0, a new Show Editor role has been added with Publish and Edit capabilities for all Radio Station Post Types. You can assign this Role to any user to give them full Station Schedule updating permissions without giving them a WordPress administrator role. See [Roles](https://radiostation.pro/docs/Roles/#show-editor-role] for more info.

Permissions

Add to Author Role Capabilities

Default: On. Key: add_author_capabilities Allow users with the WordPress Author role to publish and edit their own Shows and Playlists.

Add to Editor Role Capabilities

Default: On. Key: add_editor_capabilities Allow users with the WordPress Editor role to edit all Radio Station post types.

Role Editing

[Pro] Role Editor Interface

Allows you to assign any of the Radio Station plugin Roles directly to any user. For more information see Roles Documentation

← Back to Documentation Index