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