Plastic Tunes

Description

Plastic Tunes is a “now-playing” plugin that allows your blog to display informations about the music you play in your media player, and most importantly, to insert them into your database. Artists, titles, albums and pretty much any information included in your digital music files goes into your database for real-time or later use, ready to be displayed on your sidebar, on a dedicated page or wherever you want.
The concept of this plugin, and quite a few lines of code were originally taken from version 0.1 of the muTunes plugin, made by Ken Smith — although Plastic Tunes grew a lot since then.

Screenshots

Installation

1. Installation of WordPress plugin:

   • FTP the “plastic_tunes” folder to your wp-content/plugins directory.
   • Activate the plugin
   • Customize the options page (help is included on that page)
   • Load the widget: if your installation is compatible, you can use the widget function to load the infos on the sidebar. Just remember to customize its options by adding a user_id in its otpions. Without it the widget won’t work and most likely will cause a ugly error. The title of the widget instead is optional, and if entered will override the sidebar title as (and if) indicated on the plastic tunes option page. Be aware that leaving the widget title empty also overrides the tags before and after the widget element, such as <h2> or *. In that scenario you are in fact expected to provide them with the ‘title’ and the ‘closing element’ fields on the plastic tune option page.
   • If you can’t or won’t use the widget function, add the following piece of code to your sidebar: <?php plastic_sidebar($user_id); ?>, where $user_id is the number reported in the list in the options page.
   • Add the following piece of code to the template you will use for the entire list of music items: <?php plastic_table($user_id); ?> (see instruction on how to use templates on the WordPress codex website.)

2. Installation and setup of media players plugins:

   • consult the included “readme.htm”.

Reviews

Contributors & Developers

Changelog

• 1.4 Compatible with WordPress 2.5, and minor fixes and redesign.
• 1.3 Plastic Tunes can now be used with the Now Playing plugin for Winamp. For compatibility reasons, AMIP users who update must slightly modify their insert settings. More details below. This version also fixes few potential bugs.
• 1.2 Minor fix due to a bug of the widget functionality, where the widget form would not report the values correctly. Now fixed.
• 1.1 A management page has been included in the admin area. This is still in a early stage, but allows you to browse all the music items you added so far, delete single records and purge the entire list of music items.
  Also added an option to skip duplicates when listing all the entries in your list page (this does not apply to the just mentioned management page in the admin area). For duplicates it is meant the same music piece played more than one time and appearing in more locations within the list. With this option on, songs that occur more than once will be inserted in the database just as well, but will not appear in the list.
• 1.0b Just a mistake in the title of the plugin on the WP plugins page, where it said ‘(next)Plastic Tunes’. Sorry about it, it was a testing leftover. Now it correctly says ‘Plastic Tunes’.
• 1.0 For sake of logic, efficiency and security, I made few changes in the way the plugin understands what goes on with the player. The callbacks events are slightly different now. You’ll have to take care of these changes in your AMIP configurator (see ‘How to install the Media Player plugin’ section below). This is important since previously in the instructions I had also forgot to indicate the ‘duration’ variable that is crucial for certain functions of the plugin.
  On a technical side, there’s now a new option in the options table of your wordpress DB, called plastic_tunes_player_state, and a obsolete one, that won’t be used anymore, plastic_tunes_togglesidebar(note that a plugin like CleanOptions can help you in removing obsolete entries from your wordpress options).
  Reflecting these changes, there are now in the code new comments and explanations, and also a very useful example on how it is possible to customize the title of the sidebar element according to the state of the player. Look for it in the ‘Edit the title of your sidebar code here’ in the file ‘plastic_functions.php’.
• 0.99 Corrected the relationship between the sidebar option and the widget. Now when the widget options has no title, it is not only assumed that the title is taken care of in the option page: also the default ‘before’ and ‘after’ tags of the widget are not displayed, and are thus expected to be taken care of in the option page too. They should be considered for in the ‘title’ and ‘closing elements’ fields. This is done to avoid redundancy of tags and allow for more customization. The less expert user is not affected by this as long as a title is entered in the widgted options.
• 0.98 Plastic Tunes is now widget compatible. For those who run WordPress 2.2.x or the Widgets plugin with compatible themes, it means it’s a lot easier now to show off your listening preferences on the sidebar. Read below for more detailed informations, “how to install” section.
• 0.97 Two apostrophes slipped in a SQL query. It broke the insert of the data. Sorry for being such a messy programmer. Hopefully is now all OK.
• 0.96 Corrected the time span calculation, now it works properly. Also added a checkbox I forgot in the option page. Never to sing the victory, they say in my falling country.
• 0.95 Flood protection is now working. Also I realized that the “Play & Change” callback from the media player wasn’t properly working (it caused duplicate entries after stopping and restarting the player). The event to use is now “Change” only. Also I changed the “year” field to accept more than 4 chars, in case of entries like “1998-2003” and similar. This version is quite a good one, I think (or better, I hope).
• 0.94 temporarily removed flood protection. I don’t seem to be able to make it work properly. Also I forgot to make the variable %duration% available in the option panel, and the example of customized code for the sidebar was wrong. Both corrected.
• 0.93 fixed the flood control function and few other bugs.
• 0.90 first public release. I worked a lot before to release this beta, so I just invented a version number I thought proper. Possibly this one is a little optimistic, but hey, it’s too late to change it. I never understood the general logic of application numbering anyway.