WordPress Plugin – DJ On-Air Widget

Description

The DJ On-Air Widget adds a “Dj Shifts” field to user profiles that allows them to be scheduled for on-air shifts on an hourly basis and provides a sidebar widget that displays any user(s) scheduled for the current hour.

---

Download

Version 0.2.6 – 11/25/2011 ** bug fix**
Version 0.2.5 – 11/23/2011
Version 0.2.4 – 10/31/2011
Version 0.2.3 – 10/26/2011
Version 0.2.2 – 10/17/2011
Version 0.2.1 – 10/5/2011 **bug fix**
Version 0.2 – 9/19/2011
Version 0.1 – 9/2/2011

---

Screenshots

---

Contributors: kionae
Tags: dj, music, radio, scheduling
Donate link: http://nlb-creations.com/donate/
Requires at least: 3.2.0
Tested up to: 3.2.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. Under Settings > DJ On-Air, set your shift length and role access for the plugin.
4. When editing users, you will now find a “DJ shifts” field at the bottom of the form. Use this to set up your on-air schedule for any user.
5. Add the DJ On-Air widget to your site’s sidebar and set it’s options.

---

Frequently Asked Questions

Can I display a full schedule of my DJs?

Yes, as of version 0.2.5. Use the shortcode [dj-schedule] in any page or post. The name of the default DJ can be set on the plugin’s options page under settings, and styles for the schedule output can be changed in dj-on-air-wdiget/styles/djonair.css.

Can I change the length of a shift?

As of version 0.2.3, yes. Under Settings > DJ On-Air, you can select hour, half-hour, or 15 minute shifts.

How do I use the widget in my template or individual posts?

The widget can be embedded into posts usings the following shortcode:


[dj-widget title="Current DJ On-Air" show_avatar="1" show_link="1" default_name="Some DJ"]


title = The title that will appear above the name(s) of the current DJ(s) – (optional)
show_avatar = Whether or not to display avatars, 1 for yes, 0 for no (optional – default is 0)
show_link = Whether or not to link to profile page, 1 for yes, 0 for no (optional – default is 0)
default_name = The name or text to display if no DJ is currently scheduled

To use it in a template file include the following PHP code:

echo do_shortcode('[dj-widget title="Current DJ On-Air" show_avatar="1" show_link="1" default_name="Some DJ"]');
or

$args = array("title" => "Current DJ On-Air", "show_avatar" => 1, "show_link" => 1, "default_name" => "Some DJ");
echo dj_show_widget($args);


Can I set it so that only certain roles can add schedules to user accounts? I don’t want Subscribers to start adding themselves to the widget.

Yes, as of version 0.2. The options page is under the Settings tab.

I don’t like the way the sidebar widget is styled. Can I change it?

Yes. Just edit the /dj-on-air/styles/djonair.css file and change whatever you want.

How do I change the DJ’s avatar?

It’s the same avatar that’s assigned to the user’s account…. so you would need to change their Gravatar.

Can I have more than one DJ on air during the same hour?

Yes. If two users are scheduled for the same hour on the same day, they will both show up in the widget.

---

Changelog

0.2.6

• Bug fix in the dj-schedule shortcode function.

0.2.5

• Added shortcode to output a full schedule on any page or post.

0.2.4

• Fixed a conflict DJ On-Air Widget had another plugin
• Fixed the admin menu in WordPress 3.3

0.2.3

• Added the ability to change the length of shifts

0.2.2

• Added shortcode so that the widget can be used outside of the sidebar
• Schedules are now based on the timezone set in WordPress rather than servertime

0.2.1

• Fixed a bug that was causing problems with schedules before 10am

0.2

• Added the ability to limit addition/removal of DJ schedules by role.

0.1

• Initial release

---

Upgrade Notice

0.2.6

Bug fix in the dj-schedule shortcode function.

0.2.5

Added shortcode to output a full schedule on any page or post.

0.2.4

Fixed a conflict DJ On-Air Widget had another plugin
Fixed the admin menu in WordPress 3.3

0.2.3

Added the ability to change the length of shifts

0.2.2

Added shortcode so that the widget can be used outside of the sidebar
Schedules are now based on the timezone set in WordPress rather than servertime

0.2.1

Fixed a bug that was causing problems with schedules before 10am

0.1

Initial release

Tags: plugin, portfolio work, wordpress