WordPress Plugin – Radio Station


Description

Radio Station is a plugin to run a radio station’s website. It’s functionality is based on Drupal 6’s Station plugin, reworked for use in WordPress. The plugin includes the ability to associate users with “shows” (schedulable blocks of time that contain a description, and other meta information), and generate playlists associated with those shows. The plugin contains a widget to display the currently on-air DJ with a link to the DJ’s show and current playlist. A schedule of all shows can also be generated.


Downloads

WordPress Repo: http://wordpress.org/extend/plugins/radio-station/

Direct Downloads:

Version 2.1.3 – 12/8/2015

[accordions]
[accordion title=”Older Versions”]
Version 2.1.2 – 10/5/2015
Version 2.1.1 – 2/16/2015
Version 2.1 – 2/12/2015
Version 2.0.16 – 9/16/14
Version 2.0.15 – 9/9/14
Version 2.0.14 – 9/4/14
Version 2.0.13 – 7/24/14
Version 2.0.12 – 7/3/14 – *Bug fix
Version 2.0.11 – 6/30/14
Version 2.0.10 – 6/5/2014
Version 2.0.9 – 6/4/2014
Version 2.0.8 – 5/14/2014
Version 2.0.6 – 3/13/2014
Version 2.0.5 – 3/11/2013 – *Bug Fix
Version 2.0.4 – 3/4/2014 – *Bug Fix
Version 2.0.3 – 2/10/2014
Version 2.0.2 – 12/9/2013 – *Bug fix
Version 2.0.1 – 11/27/2013- *Bug fix
Version 2.0.0 – 11/26/2013
Version 1.6.2 – 11/20/2013
Version 1.6.1 – 11/12/2013 – *Bug fix
Version 1.6.0 – 11/11/2013
Version 1.5.4 – 10/15/2013
Version 1.5.3 – 10/2/2013
Version 1.5.2 – 9/27/2013
Version 1.5.1 – 9/26/2013
Version 1.5.0 – 9/25/2013
Version 1.4.6 – 9/19/2013
Version 1.4.5 – 8/23/2013
Version 1.4.4 – 8/19/2013
Version 1.4.3 – 8/14/2013
Version 1.4.2 – 8/6/2013
Version 1.4.1 – 8/5/2013
Version 1.4.0 – 8/5/2013
Version 1.3.9 – 8/01/2013
Version 1.3.8 – 6/27/2013
Version 1.3.7 – 6/24/2013
Version 1.3.6 – 5/29/2013
Version 1.3.5 – 5/13/2013
Version 1.3.4 – 4/17/2013
Version 1.3.3 – 4/11/2013
Version 1.3.2 – 4/5/2013
Version 1.3.1 – 3/19/2013
Version 1.3 – 2/25/2013
[/accordion]
[/accordions]


Contributors: kionae
Donate link: http://www.nlb-creations.com/donate
Tags: dj, music, playlist, radio, scheduling
Requires at least: 3.3.1
Tested up to: 4.3.1
Stable tag: trunk


Installation

  1. Upload plugin .zip file to the /wp-content/plugins/ directory and unzip.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Give any users who need access to the plugin the role of “DJ”. Only DJ and administrator roles have administrative access.
  4. Create shows and set up shifts.
  5. Add playlists to your shows.

Tutorials


Frequently Asked Questions

[accordions]
[accordion title=”I’m seeing 404 Not Found errors when I click on the link for a show!”]
Try re-saving your site’s permalink settings. WordPress sometimes gets confused with a custom post type is added.
[/accordion]
[accordion title=”My Shows don’t have a place to add a featured image. Is the plugin broken?”]
No. This is usually a theme issue.

It may be that you don’t have post thumbnails enabled in your theme, or the theme you’re using enables them only for specific post types. Check your theme’s
functions.php file and see if there is a line that looks like this:

add_theme_support( 'post-thumbnails' );

If not, you’ll need to add that line in to enable featured images. You may also see something like this:

add_theme_support( 'post-thumbnails', array( 'post', 'page' ) );

If that’s the case, your theme is enabling featured images selectively, and you can turn them on for Shows by adding “show” to the array, like this:

add_theme_support( 'post-thumbnails', array( 'post', 'page', 'show' ) );
[/accordion]
[accordion title=”How do I schedule a show?”]
Simply create a new show. You will be able to aside it to any timeslot you wish on the edit page.
[/accordion]
[accordion title=”What if I have a special event?”]
If you have a one-off event that you need to show up in the On-Air or Coming Up Next widgets, you can create a Schedule Override by clicking the Schedule Override tab
in the Dashboard menu. This will allow you to set aside a block of time on a specific date, and will display the title you give it in the widgets. Please note that
this will only override the widgets and their corresponding shortcodes. If you are using the weekly master schedule shortcode on a page, its output will not be altered.
[/accordion]
[accordion title=”How do I display a full schedule of my station’s shows?”]
Use the shortcode [master-schedule] on any page. This will generate a table containing your show details.

The following attributes are available for the shortcode:
‘list’ => If set to a value of ‘list’, the schedule will display in list format rather than table or div format. Valid values are ‘list’, ‘divs’, ‘table’.  Default value is ‘table’.
‘time’ => The time format you with to use.  Valid values are 12 and 24.  Default is 12.
‘show_link’ => Display the title of the show as a link to its profile page.  Valid values are 0 for hide, 1 for show.  Default is 1.
‘display_show_time’ => Display start and end times of each show after the title in the grid.  Valid values are 0 for hide, 1 for show.  Default is 1.
‘show_image’ => If set to a value of 1, the show’s avatar will be displayed.  Default value is 0.
‘show_djs’ => If set to a value of 1, the names of the show’s DJs will be displayed.  Default value is 0.
‘divheight’ => Set the height, in pixels, of the individual divs in the ‘divs’ layout.  Default is 45.
‘single_day’ => Display schedule for only a single day of the week.  Only works if you are using the ‘list’ format.  Valid values are sunday, monday, tuesday, wednesday, thursday, friday, saturday.

For example, if you wish to use 24-hour time format, use [master-schedule time="24"].    If you want to only show Sunday’s schedule, use [master-schedule list="list" single_day="sunday"].
[/accordion]
[accordion title=”How do I get the last song played to show up?”]
You’ll find a widget for just that purpose under the Widgets tab. You can also use the shortcode [now-playing] in your page/post, or use do_shortcode('[now-playing]'); in your template files.

The following attributes are available for the shortcode:
‘title’ => The title you would like to appear over the now playing block
‘artist’ => Display artist name. Valid values are 0 for hide, 1 for show. Default is 1.
‘song’ => Display song name. Valid values are 0 for hide, 1 for show. Default is 1.
‘album’ => Display album name. Valid values are 0 for hide, 1 for show. Default is 0.
‘label’ => Display label name. Valid values are 0 for hide, 1 for show. Default is 0.
‘comments’ => Display DJ comments. Valid values are 0 for hide, 1 for show. Default is 0.

Example:

[now-playing title="Current Song" artist="1" song="1" album="1" label="1" comments="0"]

[/accordion]
[accordion title=”What about displaying the current DJ on air?”]
You’ll find a widget for just that purpose under the Widgets tab. You can also use the shortcode [dj-widget] in your page/post, or you can use

do_shortcode('[dj-widget]');

in your template files.

The following attributes are available for the shortcode:
‘title’ => The title you would like to appear over the on-air block
‘display_djs’ => Display the names of the DJs on the show.  Valid values are 0 for hide names, 1 for show names.  Default is 0.
‘show_avatar’ => Display a show’s thumbnail. Valid values are 0 for hide avatar, 1 for show avatar. Default is 0.
‘show_link’ => Display a link to a show’s page. Valid values are 0 for hide link, 1 for show link. Default is 0.
‘default_name’ => The text you would like to display when no show is schedule for the current time.
‘time’ => The time format used for displaying schedules. Valid values are 12 and 24. Default is 12.
‘show_sched’ => Display the show’s schedules. Valid values are 0 for hide schedule, 1 for show schedule. Default is 1.
‘show_playlist’ => Display a link to the show’s current playlist. Valid values are 0 for hide link, 1 for show link. Default is 1.
‘show_all_sched’ => Displays all schedules for a show if it airs on multiple days. Valid values are 0 for current schedule, 1 for all schedules. Default is 0.

Example:

[dj-widget title="Now On-Air" display_dj="1" show_avatar="1" show_link="1" default_name="RadioBot" time="12" schow_sched="1" show_playlist="1" show_all_sched="0"]

[/accordion]
[accordion title=”Can I display upcoming shows, too?”]
You’ll find a widget for just that purpose under the Widgets tab. You can also use the shortcode [dj-coming-up-widget] in your page/post, or you can use

echo do_shortcode('[dj-coming-up-widget]');

in your template files.

The following attributes are available for the shortcode:
‘title’ => The title you would like to appear over the on-air block
‘display_djs’ => Display the names of the DJs on the show.  Valid values are 0 for hide names, 1 for show names.  Default is 0.
‘show_avatar’ => Display a show’s thumbnail. Valid values are 0 for hide avatar, 1 for show avatar. Default is 0.
‘show_link’ => Display a link to a show’s page. Valid values are 0 for hide link, 1 for show link. Default is 0.
‘limit’ => The number of upcoming shows to display. Default is 1.
‘time’ => The time format used for displaying schedules. Valid values are 12 and 24. Default is 12.
‘show_sched’ => Display the show’s schedules. Valid values are 0 for hide schedule, 1 for show schedule. Default is 1.

Example:

[dj-widget title="Coming Up On-Air" display_dj="1" show_avatar="1" show_link="1" limit="3" time="12" schow_sched="1"]

Can I change how show pages are laid out/displayed?

Yes. Copy the radio-station/templates/single-show.php file into your theme directory, and alter as you wish. This template, and all of the other templates in this plugin, are based on the TwentyEleven theme. If you’re using a different theme, you may have to rework them to reflect your theme’s layout.
[/accordion]
[accordion title=”What about playlist pages?”]
Same deal as the previous question. Grab the radio-station/templates/single-playlist.php file, copy it to your theme directory, and go to town.
[/accordion]
[accordion title=”And playlist archive pages?”]
Same as above. Grab the radio-station/templates/archive-playlist.php file, copy it to your theme directory, and go to town.
[/accordion]
[accordion title=”And the program schedule, too?”]
Because of the complexity of outputting the data, you can’t directly alter the template, but you can copy the radio-station/templates/program-schedule.css file into your theme directory and change the CSS rules for the page.
[/accordion]
[accordion title=”What if I want to style the DJ on air sidebar widget?”]
Copy the radio-station/templates/djonair.css file to your theme directory.
[/accordion]
[accordion title=”How do I get an archive page that lists ALL of the playlists instead of just the archives of individual shows?”]
First, grab the radio-station/templates/playlist-archive-template.php file, and copy it to your active theme directory. Then, create a Page in wordpress to hold the playlist archive. Under Page Attributes, set the template to Playlist Archive. Please note: If you don’t copy the template file to your theme first, the option to select it will not appear.
[/accordion]
[accordion title=”Can show pages link to an archive of related blog posts?”]
Yes, in much the same way as the full playlist archive described above. First, grab the radio-station/templates/show-blog-archive-template.php file, and copy it to your active theme directory. Then, create a Page in wordpress to hold the blog archive. Under Page Attributes, set the template to Show Blog Archive.
[/accordion]
[accordion title=”How can I list all of my shows?”]
Use the shortcode [list-shows] in your page/posts or use do_shortcode(['list-shows']); in your template files. This will output an unordered list element containing the titles of and links to all shows marked as “Active”.
[/accordion]
[accordion title=”I need users other than just the Administrator and DJ roles to have access to the Shows and Playlists post types. How do I do that?”]
Since I’m stongly opposed to reinventing the wheel, I recommend Justin Tadlock’s excellent “Members” plugin for that purpose. You can find it on WordPress.org, here: http://wordpress.org/extend/plugins/members/

Add the following capabilities to any role you want to give access to Shows and Playlist:

edit_shows
edit_published_shows
edit_others_shows
read_shows
edit_playlists
edit_published_playlists
read_playlists
publish_playlists
read
upload_files
edit_posts
edit_published_posts
publish_posts

If you want the new role to be able to create or approve new shows, you should also give them the following capabilities:

publish_shows
edit_others_shows
[/accordion]
[accordion title=”How do I change the DJ’s avatar in the sidebar widget?”]
The avatar is whatever image is assigned as the DJ/Show’s featured image. All you have to do is set a new featured image.
[/accordion]
[accordion title=”Why don’t any users show up in the DJs list on the Show edit page?”]
You did remember to assign the DJ role to the users you want to be DJs, right?
[/accordion]
[accordion title=”My DJs can’t edit a show page. What do I do?”]
The only DJs that can edit a show are the ones listed as being ON that show in the DJs select menu. This is to prevent DJs from editing other DJs shows without permission.
[/accordion]
[accordion title=”How can I export a list of songs played on a given date?”]
Under the Playlists menu in the dashboard is an Export link. Simply specify the a date range, and a text file will be generated for you.
[/accordion]
[accordion title=”Can my DJ’s have customized user profile pages in addition to Show pages?”]
Yes. These pages are the same as any other author page (edit or create the author.php template file in your theme directory). A sample can be found in the radio-station/templates/author.php file. Like the other theme templates included with this plugin, this file is based on the TwentyEleven theme.
[/accordion]
[accordion title=”I don’t want to use Gravatar for my DJ’s image on their user profile page.”]
Then you’ll need to install a plugin that lets you add a different image to your DJ’s user account and edit your author.php theme file accordingly. That’s a little out of the scope of this plugin. I recommend Cimy User Extra Fields: http://wordpress.org/extend/plugins/cimy-user-extra-fields/
[/accordion]
[accordion title=”What languages other than English is the plugin available in?”]
Right now:

Albanian (sq_AL)
French (fr_FR)
German (de_DE)
Italian (it_IT)
Russion (ru_RU)
Serbian (sr_RS)
Spanish (es_ES)
Catalan (ca)

[/accordion]
[accordion title=”Can you translate the plugin into my language?”]
My foreign language skills are rather lacking. I managed a Spanish translation, sheerly due to the fact that I still remember at least some of what I learned in high school Spanish class. But I’ve included the .pot file in the /languages directory. If you want to give it a shot, be my guest. If you send me your finished translation, I’d love to include it.
[/accordion]
[/accordions]


Changelog

[accordions]
[accordion title=”Older Revisions”]

1.0

  • Initial release

1.1

  • Fixed playlist edit screen so that queued songs fall to the bottom of the list to maintain play order
  • Reduced the size of the content field in the playlist post type
  • Some minor formatting changes to default templates
  • Added genre highlighter to the master programming schedule page
  • Added a second Update button on the bottom of the playlist edit page for convinience.
  • Added sample template for DJ user pages
  • Fixed a bug in the master schedule shortcode that messed up the table for shows that are more than two hours in duration
  • Fixed a bug in the master schedule shortcode to accomodate shows that run from late night into the following morning.
  • Added new field to associate blog posts with shows

1.2

  • Fixed thumbnail bug in sidebar widgets
  • Added new widget to display upcoming shows
  • Added pagination options for playlists and show blogs

1.3

  • Fixed some minor compatibility issues with WordPress 3.5
  • Fixed Shows icon in Dashboard

1.3.1

  • Fixed a major bug in the master schedule output

1.3.2

  • Fixed a bug in the DJ-on-air widget
  • Fixed show select list for show blog posts

1.3.3

  • Added the ability to assign any user with the edit_shows capability as a DJ, to accommodate custom and edited roles.

1.3.4

  • By request, added as 24-hour time format option to the master schedule and sidebar widgets.

1.3.5

  • Fixed a time display bug in the DJ On-Air sidebar widget
  • Fixed a display bug on the master schedule with overnight shows

1.3.6

  • Fixed issue with shows that run overnight not showing up correctly in the sidebar widgets

1.3.7

  • Fixed a scheduling bug in the upcoming shows widget
  • By popular request, switched the order of artist and song in the now playing widget

1.3.8

  • Changes to fix the incorrect list of available shows on the Add Playlist page
  • Removing Add Show links from admin menu for DJs, since they don’t have permission to use them anyway.

1.3.9

  • Fixed a bug that was preventing sites using a non-default table prefix from seeing the list of DJs on the add/edit show pages

1.4.0

  • Compatibility fix for WordPress 3.6

1.4.1

  • Fixed issue with templates copied to the theme directory not overriding the defaults correctly
  • Fixed incorrectly implemented wp_enqueue_styles()
  • Removed deprecated escape_attribute() function from the plugin widgets
  • Fixed some areas of the code that were generating PHP notices

1.4.2

  • Fixed a bug in the CSS file override from theme directory

1.4.3

  • Master schedule shortcode now displays indiviual shows in both 24 and 12 hour time
  • Fixed some areas of the code that were generating PHP notices in WordPress 3.6
  • Added example of how to display show schedule to single-show.php template
  • Added more options to the plugin’s widgets
  • Added new options to the master-schedule shortcode

1.4.4

  • Compatibility fix for WordPress 3.6 – fixed problem with giving alternative roles DJ capabilities
  • Fixed some areas of the code that were generating PHP notices in WordPress 3.6

1.4.5

  • Fixed master-schedule shortcode bug that was preventing display of 12 hour time

1.4.6

  • Fixed a bug with shows that start at midnight not displaying in the on-air sidebar widget.
  • Switched DJ/Show avatars in the widgets to use the featured image of the show instead of gravatar.
  • Updated show template to get rid of a PHP warning that appeared if the show had no schedules.
  • Fixed some other areas of the code that were generating PHP notices in WordPress 3.6
  • Added CSS classes to master program schedule output so CSS rules can be applied to specific shows
  • Added new attribute to the list-shows shortcode to allow only specified genres to be displayed

1.5.0

  • Plugin modified to allow for internationalization.
  • Spanish translation added.

1.5.1

  • Fixed some localization bugs
  • Added French translation (a big thank you to Dan over at BuddyPress France – http://bp-fr.net/)

1.5.2

  • Fixed some localization bugs
  • Added Albanian translation (sq_AL) (thank you to Lorenc!)

1.5.3

  • Added Serbian translation (sr_RS) (thank you to Miodarag Zivkovic!)

1.5.4

  • Fixed some PHP notices that were being generated when there were no playlist entries in the system.

1.6.0

  • Added the ability to override the weekly schedule to allow one-off events to be scheduled
  • Added a list format option to the master schedule shortcode
  • Added Italian translation (it_IT) (thank you to Cristofaro Giuseppe!)

1.6.1

  • Bug fix: Some of the code added in the previous update uses the array_replace() function that is only available in PHP 5.3+. Added a fallback for older PHP versions.

1.6.2

  • Minor PHP warning fixes

2.0.0

  • Major code reorganization for better future development
  • PHP warning fix
  • Enabled option to add comments on Shows and Playlists
  • Added option to show either single or multiple schedules in the On Air widget

2.0.1

  • Bug fix: Fixed PHP error in Playlist save function that was triggered during preview
  • Bug fix: Fixed PHP notice in playlist template file
  • Bug fix: Fixed PHP error in dj-widget shortcode

2.0.2

  • Bug fix: Scheduling issue with overnight shows fixed

2.0.3

  • Compatibility fix: Fixed a jquery conflict in the backend that was occurring in certain themes

2.0.4

  • Master Schedule bug for shows that start at midnight and end before the hour is up fixed.

2.0.5

  • Fixed an issue with some shows displaying in 24 hour time on master schedule grid even though 12-hour time is specified
  • Fixed a bug in the On-Air widget that was preventing shows spanning two day from displaying
  • Added code to enable theme support for post-thumbnails on the “show” post-type so users don’t have to add it to their theme’s functions.php file anymore.

2.0.6

  • Master Schedule now displays days starting with the start_of_week option set in the WordPress General Settings panel.
  • Fixed issue with shows that have been unplublished still showing up on the master schedule.
  • Fixed missing am/pm text on shows that run overnight on the master schedule.
  • Fixed an issue with shows that run overnight not spanning the correct number of hours on the second day on the master schedule.
  • Fixed problem in Upcoming DJ Widget that wasn’t displaying the correct upcoming shift.

2.0.7

  • Fixed scheduling bug in shortcode function

2.0.8

  • Fixed the display of schedules for upcoming shows in the widget and shortcode.
  • Fixed a bug in the dj_get_next function that was causing it to ignore the beginning of the next week at the end of the current week.

2.0.9

  • Fixed broken upcoming show shortcode.
  • Added ability to display DJ names along with the show title in the widgets.

2.0.10

  • Fixed role/capability conflict with WP User Avatar plugin.
  • Added the missing leading zero to 24-hour time format on the master schedule.
  • Fixed dj_get_current function so that it no longer returns shows that have been moved to the trash.
  • Fixed dj_get_next function so that it no longer ignores the “Active” checkbox on a show.
  • Added some CSS ids and classes to the master program schedule list format to make it more useful.

2.0.11

  • Russian translation added (Thank you to Alexander Esin for the file!)

2.0.12

  • Fixed a bug in the master schedule shortcode

2.0.13

  • Added the ability to display show avatars on the program grid.
  • Added the ability to display show description in the now on-air widget and short code.

2.0.14

  • Fixed issue on the master schedule where genres containing more than one work wouldn’t highlight when clicked
  • Added ability to display DJ names on the master schedule.
  • Fixed bug in the Upcoming widget.  Override Schedule no longer display as upcoming when they are on-air.
  • Verified compatibility with WordPress 4.0

2.0.15

  • German translation added (Thank you to Ian Hook for the file!)

2.0.16

  • Minor revisions to German translation.
  • Fixed a bug that was resetting custom-sert role capabilities for the DJ role.

2.1

  • General code cleanup, 4.1 compatibility testing, and changes for better efficiency.
  • Bug fix – Fixed issue with early morning shows spanning entire column in the programming grid shortcode
  • New Feature – Master programming grid can now be displayed in div format, as well as the original table and list formats.

[/accordion]
[/accordions]

2.1.1

  • Bug fix – Fixed day of the week language translation issue in master schedule shortcode
  • Bug fix – Added some error checking in the sidebar widgets
  • New Feature – Added ability to give schedule overrides a featured image
  • New Feature – Added built-in help page

2.1.2

  • Compatibility fix for WordPress 4.3.x – Updated the widgets to use PHP5 constructors instead of the deprecated PHP4 constructors.
  • Catalan translation added (Thank you to Victor Riera for the file!)

2.1.3

  • Added method for displaying schedule for only a single day (see readme section for the master-schedule shortcode for details).
Liked it? Take a second to support Netmix.com on Patreon!
Become a patron at Patreon!

528 comments

  1. Monica says:

    Great plugin!
    But I can’t understand how to edit the template page to fit with my template. Which part I have to modify in my template?

    • If you look at the radio-station/templates/single-show.php file, there are HTML comment lines that read “custom show output : This portion can be edited or inserted into your own theme files” and “/custom show output”.

      Everything between those two lines is specific to the plugin. Everything outside of those lines is specific to the theme.

      Probably the easiest way to modify it is to make a copy of your theme’s single.php and rename it single-show.php. Then take the code from between the two comment lines in the plugin’s single-show.php file and use it to replace whatever happens to be in the content area of you theme’s version of the template file.

  2. Monica says:

    Great plugin!
    But I can’t understand how to edit the template page to fit with my template. Which part I have to modify in my template?

    • If you look at the radio-station/templates/single-show.php file, there are HTML comment lines that read “custom show output : This portion can be edited or inserted into your own theme files” and “/custom show output”.

      Everything between those two lines is specific to the plugin. Everything outside of those lines is specific to the theme.

      Probably the easiest way to modify it is to make a copy of your theme’s single.php and rename it single-show.php. Then take the code from between the two comment lines in the plugin’s single-show.php file and use it to replace whatever happens to be in the content area of you theme’s version of the template file.

  3. byron says:

    hello
    again like every one else great job. i searched a little for this kind of solution and it seems your are a world wide first choice.

    my issue may be something i could find somewhere else, but you know your work better.
    my question is :
    i have a page with all djs avatars and i would like to link theme to the show or shows they host.
    for now it links to there posts by this function in my template
    get_author_posts_url($q->ID);

    thanks by advance

  4. byron says:

    hello
    again like every one else great job. i searched a little for this kind of solution and it seems your are a world wide first choice.

    my issue may be something i could find somewhere else, but you know your work better.
    my question is :
    i have a page with all djs avatars and i would like to link theme to the show or shows they host.
    for now it links to there posts by this function in my template
    get_author_posts_url($q->ID);

    thanks by advance

  5. byron says:

    hello great work

    is there a way to have like this kind of function
    ID);?>
    but for displaying shows users host.

  6. byron says:

    hello great work

    is there a way to have like this kind of function
    ID);?>
    but for displaying shows users host.

  7. byron says:

    very very sorry i was wrong i meant
    get_author_posts_url($q->ID);

    a function that would link to users shows they host
    instead of post they have published.

    thanks by advance

    • At the moment, no. The closest thing available in the current version of the plugin would be the [list-shows] shortcode. It displays a list of all shows, and a link to their page, but does not display the djs assigned to those shows.

  8. byron says:

    very very sorry i was wrong i meant
    get_author_posts_url($q->ID);

    a function that would link to users shows they host
    instead of post they have published.

    thanks by advance

    • At the moment, no. The closest thing available in the current version of the plugin would be the [list-shows] shortcode. It displays a list of all shows, and a link to their page, but does not display the djs assigned to those shows.

  9. Francesco says:

    Ciao Nikki and everybody here,
    I was wondering if there is a way to have a different hours distribution during day scheduling… I mean: it would be helpful to have night shows listed in their “previous” days.
    EG: If I have a show that starts at 01.00 of Tuesday, I would like to see it listed in Monday’s Schedule, after 23.59…

    Actually I would have all the show listed in the same day until a fixed (even better settable) hour or til the show flagged as “last of the day”….

    I don’t know if I have explained it well with my poor English (Sorry)

  10. Francesco says:

    Ciao Nikki and everybody here,
    I was wondering if there is a way to have a different hours distribution during day scheduling… I mean: it would be helpful to have night shows listed in their “previous” days.
    EG: If I have a show that starts at 01.00 of Tuesday, I would like to see it listed in Monday’s Schedule, after 23.59…

    Actually I would have all the show listed in the same day until a fixed (even better settable) hour or til the show flagged as “last of the day”….

    I don’t know if I have explained it well with my poor English (Sorry)

  11. Dee says:

    Hello Nikki I was wondering do you have a video out on this plugin? when I click on the dj show I get an error 404 and also do you have an example of what the plug in should look like or a page of someone that is using this plugin just as a example because I am kind of confused.

    • I don’t have a video, no. To fix the 404 error, try resaving your site’s permalink settings. WordPress sometimes doesn’t recognize the url when a new post type is added by a plugin, for some reason.

  12. Dee says:

    Hello Nikki I was wondering do you have a video out on this plugin? when I click on the dj show I get an error 404 and also do you have an example of what the plug in should look like or a page of someone that is using this plugin just as a example because I am kind of confused.

    • I don’t have a video, no. To fix the 404 error, try resaving your site’s permalink settings. WordPress sometimes doesn’t recognize the url when a new post type is added by a plugin, for some reason.

  13. Paul says:

    Hi Nikki, Thanks again for adding the one-off event feature. I may be the only one using it for my station but thanks again! A couple of things though, I noticed when I schedule a one-off event it displays correctly in the coming-up-next widget until the event is on the air, then it is shown in the on-the-air widget, but it also is still displayed in the coming-up-next widget. Any chance to have the coming-up-next widget display the next show after the one-off event? Also, could you add a featured image option to the one-off event section? Thanks again for this wonderful plugin!

  14. Paul says:

    Hi Nikki, Thanks again for adding the one-off event feature. I may be the only one using it for my station but thanks again! A couple of things though, I noticed when I schedule a one-off event it displays correctly in the coming-up-next widget until the event is on the air, then it is shown in the on-the-air widget, but it also is still displayed in the coming-up-next widget. Any chance to have the coming-up-next widget display the next show after the one-off event? Also, could you add a featured image option to the one-off event section? Thanks again for this wonderful plugin!

  15. Hi. I’d like to use this plugin on the revamped Website I am building for WETD 90.7 FM. I wanted to move the site from Drupal to WordPress and thought this plugin might be a good fit for the site. However, I have one technical question: how can I import playlists automatically from a site like RadioActivity.fm or even a file on a server? Our station DJs log all of the music played on their shows to RadioActivity.fm, which completes our record keeping requirements for the FCC, and I am wondering if these logs can just be imported into your plugin as playlists for the shows to which they pertain. Is this possible? I am well-versed in PHP and MySQL and don’t mind doing a bit of hacking/coding to get this to work if it is possible. Thanks!

    • It would certainly be possible… playlists are just WordPress posts with a post_type of “playlist” and some metadata fields in the postmeta table. You could insert them into the database the same way you could insert any other WordPress post.

      includes/post_types.php is where all the plugin handles data entry for playlists… I would start there, and use that as a reference.

      • Hi Nikki,

        Thanks for your reply. Looking further at the playlists functionality in your Radio Station plugin, I think I’m a little confused about them. Let’s say I am running a radio station with three DJs and an automation system that plays when none of these DJs are on the air. All three DJs log their music to RadioActivity.fm, and so does the automation system (auto DJ). Now, let’s also say that on my station’s Web site I want to display a “daily master playlist” containing the currently playing song as well as the songs played in the last 24 hours. Would the playlists functionality of your plugin accomplish this, assuming I was able to pull in the song info from RadioActivity and add it to the database using your playlists format? What if one or more DJs were on the air in the last 24 hours, along with of course the automation system? Would this require separate playlists for each DJ’s show as well as a playlist for the automation system, and if so how would they be combined into one master playlist?

        I guess I’m just looking for a way to let Website visitors view a master playlist of everything played within the last 24 hours, and allow them to select a date range as well, e g. last week, last two weeks. It would be nice if each individual show could have its own playlist, but these playlists would of course only be filled with songs the DJs played on their particular show.

        Is there a way I can associate a show with a playlist rather than associating a playlist with a show? For example, right now, from what I can see from my exploration of your plugin, it seems I have to first create a show, then create a playlist and select the show to which that playlist belongs. But is there a way I can just create a show and have a playlist automatically attach itself to the show, or be a part of the show? That way I know I have the same number of playlists as I do shows, there are no rogue playlists, and everything is attached.

        Finally, I looked at includes/post_types.php and was a bit confused by it. While I’ve been learning PHP for a few years now there is still a lot I can learn. I’m OK with pulling in song title, artist, album, etc. from RadioActivity and also pulling in the ID from RadioActivity of the show this information belongs to, but how would I go about matching that ID to the ID of the corresponding “show” in your plugin, and then populating the attached playlist of the show with the information pulled from RadioActivity?

        Thank you so much for answering my questions and I’m sorry if this was a long post. I really like your plugin and hope I can extend its functionality by integrating it directly with RadioActivity.fm.

        • I think, if it were me doing it, I would start by simply make the automated system it’s own “show” on the site, in order to save playlists that were used while it was on the air.

          Each DJ or show would have its own set of playlists (because that is how the plugin determines who played what)… but playlists are just metadata, so they’re fairly easy to manipulate via PHP. My plugin doesn’t use a running playlist (where shows would just keep adding songs to the first playlist they create… though I suppose there’s really nothing stopping someone from doing that). Each time a show is broadcast, it is expected that a new playlist will be created for that specific airing.

          So that in mine, any time you create a new playlist, you need to associate it with a show. I think my workflow would be something like…

          1) Check that the show exists in the database.

          2) If the show doesn’t exist, automatically create it.

          3) Get the value of the show’s ID field. This would either be available from the database match in step 1, or would be the ID that was just created in step 2.

          4) Create the new playlist. Get the value of the playlist’s ID field.

          5) Add the songs to the playlist (these live in the post_metadata table).

          6) Create the association between the show and the playlist in the post_metadata table where the post_id is the playlist’s ID field, the meta_key is “playlist_show_id” and the meta_value is the show’s ID field.

          Really, all you’re doing is writing code that creates WordPress posts (with a specific post_type) and post metadata with specific meta_keys that my plugin knows to look for.

          As for a master playlist… that’s not something I’ve coded for the front end, but in the backend, there is a playlist export function (station_admin_export() in the radio-station.php file). I think it would do pretty much what you’re asking… you’d just need to create a similar function that’s available in the front end and format the output for web display rather than file output.

          • Hi Nikki,

            So essentially you are saying that every time a show airs the DJ needs to create a new playlist for it? This makes sense, I suppose, and could easily be automated through the use of RadioActivity. Given what you said in your comments, I’m thinking the following workflow might be the best way to go:

            1. DJ creates his/her show in the plugin in WordPress. Let’s say this show airs once a week, Wednesdays at 9 AM.
            2. During the show, DJ manually logs music played to RadioActivity (or configures his broadcasting software for automatic logging).
            3. Not sure if RadioActivity supports this, but if it does, at this point I would have it alert a script on the WordPress side that the DJ’s show has begun airing.
            4. Script grabs show ID/name/etc. from RadioActivity and looks up associated “show” in WP plugin.
            5. Script creates new playlist and then polls RadioActivity every few minutes for new music logs, at which time it imports the songs into the playlist.
            6. Rinse and repeat for each “show” in the plugin that matches a detected show in RadioActivity.

            What are your thoughts on this?

            My overarching goal is that I don’t want DJs to have to log their songs twice in order to get a playlist to be visible on the Website. They already go to RadioActivity.fm, and we are already integrating RadioActivity into WordPress but I saw the “playlists” functionality in your plugin and thought this would be a great way to automatically create playlists based on RadioActivity logs. That way, the DJ starts their show, logs to RadioActivity, someone goes to the Website and sees this DJ on the air, they click link to playlist, and the playlist is right there, based on RadioActivity data but associated with the “show” from the plugin.

            What do you think?

            Can we perhaps chat off-site about this so as not to fill up this comments section? I’d really like to get this integration working if at all possible and make use of the playlists function in your plugin. My e-mail is the same as the one given when posting this comment.

            Thanks!

          • I think your workflow would work. It’s vaguely similar to something I did way back for a site (long before the Radio Station plugin existed) that accepted song info via a url and inserted them into a database. If you think that code might be helpful to you, the plugin was called Playlist217.

            http://nlb-creations.com/2011/05/13/wordpress-plugin-playlist217/

            You can hit me up via email, if you like. Might be easier than going back and forth in the comments. nblight (at) nlb-creations.com

  16. Hi. I’d like to use this plugin on the revamped Website I am building for WETD 90.7 FM. I wanted to move the site from Drupal to WordPress and thought this plugin might be a good fit for the site. However, I have one technical question: how can I import playlists automatically from a site like RadioActivity.fm or even a file on a server? Our station DJs log all of the music played on their shows to RadioActivity.fm, which completes our record keeping requirements for the FCC, and I am wondering if these logs can just be imported into your plugin as playlists for the shows to which they pertain. Is this possible? I am well-versed in PHP and MySQL and don’t mind doing a bit of hacking/coding to get this to work if it is possible. Thanks!

    • It would certainly be possible… playlists are just WordPress posts with a post_type of “playlist” and some metadata fields in the postmeta table. You could insert them into the database the same way you could insert any other WordPress post.

      includes/post_types.php is where all the plugin handles data entry for playlists… I would start there, and use that as a reference.

      • Hi Nikki,

        Thanks for your reply. Looking further at the playlists functionality in your Radio Station plugin, I think I’m a little confused about them. Let’s say I am running a radio station with three DJs and an automation system that plays when none of these DJs are on the air. All three DJs log their music to RadioActivity.fm, and so does the automation system (auto DJ). Now, let’s also say that on my station’s Web site I want to display a “daily master playlist” containing the currently playing song as well as the songs played in the last 24 hours. Would the playlists functionality of your plugin accomplish this, assuming I was able to pull in the song info from RadioActivity and add it to the database using your playlists format? What if one or more DJs were on the air in the last 24 hours, along with of course the automation system? Would this require separate playlists for each DJ’s show as well as a playlist for the automation system, and if so how would they be combined into one master playlist?

        I guess I’m just looking for a way to let Website visitors view a master playlist of everything played within the last 24 hours, and allow them to select a date range as well, e g. last week, last two weeks. It would be nice if each individual show could have its own playlist, but these playlists would of course only be filled with songs the DJs played on their particular show.

        Is there a way I can associate a show with a playlist rather than associating a playlist with a show? For example, right now, from what I can see from my exploration of your plugin, it seems I have to first create a show, then create a playlist and select the show to which that playlist belongs. But is there a way I can just create a show and have a playlist automatically attach itself to the show, or be a part of the show? That way I know I have the same number of playlists as I do shows, there are no rogue playlists, and everything is attached.

        Finally, I looked at includes/post_types.php and was a bit confused by it. While I’ve been learning PHP for a few years now there is still a lot I can learn. I’m OK with pulling in song title, artist, album, etc. from RadioActivity and also pulling in the ID from RadioActivity of the show this information belongs to, but how would I go about matching that ID to the ID of the corresponding “show” in your plugin, and then populating the attached playlist of the show with the information pulled from RadioActivity?

        Thank you so much for answering my questions and I’m sorry if this was a long post. I really like your plugin and hope I can extend its functionality by integrating it directly with RadioActivity.fm.

        • I think, if it were me doing it, I would start by simply make the automated system it’s own “show” on the site, in order to save playlists that were used while it was on the air.

          Each DJ or show would have its own set of playlists (because that is how the plugin determines who played what)… but playlists are just metadata, so they’re fairly easy to manipulate via PHP. My plugin doesn’t use a running playlist (where shows would just keep adding songs to the first playlist they create… though I suppose there’s really nothing stopping someone from doing that). Each time a show is broadcast, it is expected that a new playlist will be created for that specific airing.

          So that in mine, any time you create a new playlist, you need to associate it with a show. I think my workflow would be something like…

          1) Check that the show exists in the database.

          2) If the show doesn’t exist, automatically create it.

          3) Get the value of the show’s ID field. This would either be available from the database match in step 1, or would be the ID that was just created in step 2.

          4) Create the new playlist. Get the value of the playlist’s ID field.

          5) Add the songs to the playlist (these live in the post_metadata table).

          6) Create the association between the show and the playlist in the post_metadata table where the post_id is the playlist’s ID field, the meta_key is “playlist_show_id” and the meta_value is the show’s ID field.

          Really, all you’re doing is writing code that creates WordPress posts (with a specific post_type) and post metadata with specific meta_keys that my plugin knows to look for.

          As for a master playlist… that’s not something I’ve coded for the front end, but in the backend, there is a playlist export function (station_admin_export() in the radio-station.php file). I think it would do pretty much what you’re asking… you’d just need to create a similar function that’s available in the front end and format the output for web display rather than file output.

          • Hi Nikki,

            So essentially you are saying that every time a show airs the DJ needs to create a new playlist for it? This makes sense, I suppose, and could easily be automated through the use of RadioActivity. Given what you said in your comments, I’m thinking the following workflow might be the best way to go:

            1. DJ creates his/her show in the plugin in WordPress. Let’s say this show airs once a week, Wednesdays at 9 AM.
            2. During the show, DJ manually logs music played to RadioActivity (or configures his broadcasting software for automatic logging).
            3. Not sure if RadioActivity supports this, but if it does, at this point I would have it alert a script on the WordPress side that the DJ’s show has begun airing.
            4. Script grabs show ID/name/etc. from RadioActivity and looks up associated “show” in WP plugin.
            5. Script creates new playlist and then polls RadioActivity every few minutes for new music logs, at which time it imports the songs into the playlist.
            6. Rinse and repeat for each “show” in the plugin that matches a detected show in RadioActivity.

            What are your thoughts on this?

            My overarching goal is that I don’t want DJs to have to log their songs twice in order to get a playlist to be visible on the Website. They already go to RadioActivity.fm, and we are already integrating RadioActivity into WordPress but I saw the “playlists” functionality in your plugin and thought this would be a great way to automatically create playlists based on RadioActivity logs. That way, the DJ starts their show, logs to RadioActivity, someone goes to the Website and sees this DJ on the air, they click link to playlist, and the playlist is right there, based on RadioActivity data but associated with the “show” from the plugin.

            What do you think?

            Can we perhaps chat off-site about this so as not to fill up this comments section? I’d really like to get this integration working if at all possible and make use of the playlists function in your plugin. My e-mail is the same as the one given when posting this comment.

            Thanks!

          • I think your workflow would work. It’s vaguely similar to something I did way back for a site (long before the Radio Station plugin existed) that accepted song info via a url and inserted them into a database. If you think that code might be helpful to you, the plugin was called Playlist217.

            http://nlb-creations.com/2011/05/13/wordpress-plugin-playlist217/

            You can hit me up via email, if you like. Might be easier than going back and forth in the comments. nblight (at) nlb-creations.com

  17. Ward says:

    Hi Nikki,
    I am trying to get the plugin working on my WordPress.org site but the show pages are not showing. Because my site is set up in a special way (WordPress URL and site URL are not the same) it keeps redirecting itself back and forth between the 2 url’s thus getting in an endless loop.
    Do you have any idea on how to fix this without changing the site’s setup.

    • I would start by re-saving your site’s permalink settings (just go to the settings page and click save), to make sure WordPress recognizes that shows have their own url format.

      If that doesn’t fix it, I’m not entirely sure what to do. I’ve never had a wordpress site set up in the way you’re describing.

      • Ward says:

        Thanks for the response. It’s a strange set up I know (at least that’s not my fault 😉 )
        Resaving didn’t help. The strange thing is that using the ?post_type=show&p=number does work while /show/slug doesn’t.
        Since the strange set up is the cause (i suppose) I’ll go try talk with the hosting provider and the person who installed it…

        But i also have it running on a personal WP so I do know it’s a good plugin 😉

  18. Ward says:

    Hi Nikki,
    I am trying to get the plugin working on my WordPress.org site but the show pages are not showing. Because my site is set up in a special way (WordPress URL and site URL are not the same) it keeps redirecting itself back and forth between the 2 url’s thus getting in an endless loop.
    Do you have any idea on how to fix this without changing the site’s setup.

    • I would start by re-saving your site’s permalink settings (just go to the settings page and click save), to make sure WordPress recognizes that shows have their own url format.

      If that doesn’t fix it, I’m not entirely sure what to do. I’ve never had a wordpress site set up in the way you’re describing.

      • Ward says:

        Thanks for the response. It’s a strange set up I know (at least that’s not my fault 😉 )
        Resaving didn’t help. The strange thing is that using the ?post_type=show&p=number does work while /show/slug doesn’t.
        Since the strange set up is the cause (i suppose) I’ll go try talk with the hosting provider and the person who installed it…

        But i also have it running on a personal WP so I do know it’s a good plugin 😉

  19. Dan says:

    Hello, on the website I use your plugin, and I have a question, how can I get rid off “Playlists” view and “Blog Posts” view?

  20. Dan says:

    Hello, on the website I use your plugin, and I have a question, how can I get rid off “Playlists” view and “Blog Posts” view?

  21. paul says:

    Hi Nikki

    I’m still working on our new radio station site – I’ll send a link once it’s up and running – but I have one more question for you.

    We would like the Master Schedule to have the DJ’s name on it, under the show title and above the time. I have found the right place in master_schedule.php to add this (around line 392) but I can’t figure out the right php code. Copying it from the widget_djonair.php file doesn’t seem to do it – but I’m a complete n00b when it comes to PHP, so I’m probably just not grabbing the right bits!!

    Any chance you could please solve this one for me..?

    Love your work!!
    Cheers
    Paul

  22. paul says:

    Hi Nikki

    I’m still working on our new radio station site – I’ll send a link once it’s up and running – but I have one more question for you.

    We would like the Master Schedule to have the DJ’s name on it, under the show title and above the time. I have found the right place in master_schedule.php to add this (around line 392) but I can’t figure out the right php code. Copying it from the widget_djonair.php file doesn’t seem to do it – but I’m a complete n00b when it comes to PHP, so I’m probably just not grabbing the right bits!!

    Any chance you could please solve this one for me..?

    Love your work!!
    Cheers
    Paul

  23. Andy says:

    Hi Nikki,
    My master schedule list has stopped working since I downloaded the latest upgrade. It defaults to the Sunday schedule but won’t switch to the other days.

    Andy

  24. Andy says:

    Hi Nikki,
    My master schedule list has stopped working since I downloaded the latest upgrade. It defaults to the Sunday schedule but won’t switch to the other days.

    Andy

  25. Tom says:

    Hi Nikki

    Just wondering whether you would be able to help me.

    I am probably being very thick (have had a long day!) but I am trying to set up a radio station website. I am using your excellent plug-in, but am just wondering…

    For the theme I have developed, I am just trying to extract the text from the plug-in showing the current “on-air” item. SO I would just need:

    – Presenter’s name
    – Avatar
    – On air time

    Is there a page with FAQs I have missed?

    If you could help at all I would be extremely grateful.

    Best Regards

    Tom

    • Probably the easiest way to accomplish something like that would be to copy the station_shortcode_dj_on_air() function from includes/shortcodes.php (lines 160 to 310) into your theme’s functions.php file, rename it, and modify it to output only the fields you need.

      • Tom says:

        Thanks Nikki. Took a while to pick up the right fields etc, but I have done it!

        Just have a few modifications to do but it is there!

        Thanks so much!

  26. Tom says:

    Hi Nikki

    Just wondering whether you would be able to help me.

    I am probably being very thick (have had a long day!) but I am trying to set up a radio station website. I am using your excellent plug-in, but am just wondering…

    For the theme I have developed, I am just trying to extract the text from the plug-in showing the current “on-air” item. SO I would just need:

    – Presenter’s name
    – Avatar
    – On air time

    Is there a page with FAQs I have missed?

    If you could help at all I would be extremely grateful.

    Best Regards

    Tom

    • Probably the easiest way to accomplish something like that would be to copy the station_shortcode_dj_on_air() function from includes/shortcodes.php (lines 160 to 310) into your theme’s functions.php file, rename it, and modify it to output only the fields you need.

      • Tom says:

        Thanks Nikki. Took a while to pick up the right fields etc, but I have done it!

        Just have a few modifications to do but it is there!

        Thanks so much!

Comments are closed.