RadioDJ tutorials

RadioDJ WordPress plugin

This is a WordPress plugin for displaying currently playing songs, requests and statistics on a WordPress site. It can connect any WordPress site to RadioDJ database.

Latest version of RadioDJ WordPress plugin can be download here.

There is a dedicated thread on RadioDJ forums, if you need assistance or get stuck. Remote database configuration has been described in this forums thread.

Setup instructions

Short version:

  1. Install plugin by uploading the files to your server or using Plugins → Add New screen in your WordPress dashboard.
  2. Open RadioDJ plugin options screen and enter database connection details.
  3. Add shortcodes on pages or posts.

Database settings

This is the most importan part of RadioDJ plugin setup. Database conection details are used to connect to RadioDJ database.

Plugin database settings
Database settings section

Description of entry fields

RadioDJ Server: IP address or hostname of RadioDJ database server.

Note that is a loopback address and it always points back to computer itself. If RadioDJ database is not running on the same computer as your web server, you have to use the IP addres or hostname of that computer and not localhost or

Username: Database connection username. You may use same user credentials as RadioDJ but it is advised to create a new MySQL database user with restricted privileges.

Password: Database connection password.

Database name: Name of database, also called scheme name.

Verify database settings button: Allows to test provided connection details before saving options.

Offline message: This message is displayed in place of shortcodes if RadioDJ database is unreachable.

Now Playing Options

Now Playing Options section
Now Playing Options section

Description of entry fields

Upcoming Items Number of ucoming tracks to tisplay in now playing view. Checkbox allows to enable display of artist and title of upcoming tracks. If unchecked, only artist names are displayed.

AJAX refresh Enable refreshing of currently playing information from RadioDJ database every 10 seconds without reloading page.

Shuffle Upcoming Display upcoming tracks in random order. May be required to make it harder to rip streamed music.

History Items How many previously played tracks to display in history list.

Top Tracks and Albums Display Options

Top Tracks and Albums Display Options section
Top Tracks and Albums Display Options section

Description of entry fields

Top Tracks Items: Number of tracks to display in top tracks lists.

Top Albums Items: Number of tracks to display in top albums lists.

Days To Build The Top: Number of days used to calculate top positions.

Requests Options

Requests Options section
Requests Options section

Description of entry fields

Items per Page: Number of tracks to display on one request list page

Minimum Track Repeat: Time span during which same track can't be requested repeatedly.

Minimum Artist Repeat: Time span during which tracks by same artist can't be requested repeatedly.

Daily Request Limit: Number of allowed requests for one IP address per day.


RadioDJ WordPress plugin provides following shortcodes:

  • Now Playing [now-playing]
  • Top Played Tracks [top-tracks]
  • Top Played Albums [top-albums]
  • Top Played Artists [top-artists]
  • Request Section [track-requests]
  • Top Requests [top-requested]

What are shortcodes?

A short description of shortcodes:

A shortcode is a WordPress-specific code that lets you do nifty things with very little effort. Shortcodes can embed files or create objects that would normally require lots of complicated, ugly code in just one line. Shortcode = shortcut. documentation

©  JWL  2013 | 2018    Back to top