fmTuner

fmTuner pulls track information from your Last.fm account, including recent tracks, loved tracks, and top tracks. Using built-in options and simple tags, you can fully customize how tracks appear on your site.

Features

• Choose between recent, loved, and top tracks
• Limit how many tracks are shown
• Adjust how often tracks get pulled from Last.fm
• Customize track appearance using HTML and placeholders

Requirements

• A Last.fm account to which you “scrobble” (publish) music details
• WordPress 2.7 or newer
• PHP 5 or newer

Troubleshooting

Why are no tracks displayed?

1. Make sure fmTuner is installed and activated by visiting your Manage Plugins page in the WordPress administration area.
2. Ensure your Last.fm username is set in the fmTuner Settings page, as well as any other necessary options (e.g. Recent Tracks instead of Loved Tracks if you have no Loved Tracks).
3. Confirm that <?php if(function_exists('fmtuner')) { fmtuner(); } ?> exists somewhere in your current WordPress theme.
4. Listen to some music, and perhaps mark some tracks as Loved, to make sure you have available music to show.
5. Finally, try setting a placeholder image address in the fmTuner Settings page, which will be used when tracks have no artwork address.

Why does the number of tracks displayed not match my setting?

Occasionally, you may find that the number of displayed tracks does not match the number you set in the fmTuner Settings page. This is most often attributed to the [::image::] fmTuner tag. Because fmTuner cannot know in advance which tracks don’t have images, it will skip ones without artwork. Alternatively, you can provide a placeholder image address in the fmTuner Settings page which will be used when Last.fm does not provide artwork. Using this, your number of displayed tracks should stay constant.

Why do I get PHP errors?

fmTuner needs certain PHP functions to talk to Last.fm and handle responses, and while it takes precautions to avoid blatant errors, it’s possible your server doesn’t meet the necessary requirements.

1. Ensure your server is running PHP 5 or later. If using a hosted environment, your provider may be able to do this for you.
2. fmTuner needs to communicate with Last.fm. Set allow_url_fopen=”On” in your php.ini file, or confirm that the cURL extension is installed. fmTuner will try one method of fetching track listings, and automatically fall back to the other if needed.

Removal

Sorry to see you go! Here’s how to remove fmTuner:

1. Deactivate the plugin through the ‘Plugins’ menu in WordPress.
2. Delete the fmtuner directory from your wp-content/plugins/ directory.

Be sure to get in touch if there’s a particular feature you think would make fmTuner better!