Pandora Feeds for WordPress

Download

The current version 0.5.0.3 can be downloaded here:
zip archive at wordpress.org.

The plugin’s sourcecode is available via subversion repository

Requirements

All you need:

• WordPress 2.1
• An account at Pandora

Installation and Setup

Complete these steps to install the plugin:

1. Download the archive and extract the files
2. Copy the file pandorafeeds.php into your plugin-directory: www.yourblog.com/wp-content/plugins/
3. Go to the plugin-section of your blog’s admin-area, scroll down to Pandora Feeds for WordPress Plugin and press activate.
4. Now go to the Options section and klick on ‘Pandora Feeds’
5. Insert your Pandora-account name into the input-field. You register at Pandora with your E-Mail-address. Your account-name is the local-part of the address. For example, if you have registered with john.doe@example.com, you should enter john.doe into the textfield.
6. Congratulations, you’re done! Now you can adapt your theme.

What is my account-name?

To find out, open your pandora-player and view your profile:

When you click on View your Profile, a new browser-window or -tab will open. Take a look at the new URL:

The part of the URL right from people/ is your account-name (jan.weinschenker in this example).

Adapt your Theme

The plugin provides three tags that can be used inside WordPress-themes. They are further explained in the following subsections. It is not needed to place these tags inside the WordPress Loop.

The tags will deliver lists of xHTML-1.1-listitems (<li> … </li>). That should make it easy to insert them into a static page for example.

Display Stations

<?php pandorafeeds_display_user_stations(NUMBER_OF_ITEMS); ?>

This tag creates a list of your stations. It should be enclosed inside an <ul>-tag.

The parameter NUMBER_OF_ITEMS will be the maximium number of stations to be displayed. For example …

<ul>
<?php pandorafeeds_display_user_stations(15); ?>
</ul>

… would display the 15 most recent of your Pandora-stations. If you only have 8 stations, the list will only consist of these 8 stations. If you want all of your stations to be displayed, set the parameter to -1:

<ul>
<?php pandorafeeds_display_user_stations(-1); ?>
</ul>

Each listitem represents one of your pandora-stations and will look like this:

<li class="pandorafeeds-stations">
<a href="%URL_TO_STATION%" class="pandorafeeds-stations" title="%STATION_NAME%">
%STATION_NAME%
</a>
</li>


• %URL_TO_STATION% will be the URL pointing to your station at pandora
• %STATION_NAME% will be the name of you station

Notice the CSS-class ‘pandorafeeds-stations’. You can use it to adapt the look of the listitem to your theme.

Display Bookmarked Songs

<?php pandorafeeds_display_bookmarked_songs(NUMBER_OF_ITEMS, SHOW_COVER); ?>

This tag creates a list of your bookmarked songs. It should be enclosed inside an <ul>-tag.

The parameter NUMBER_OF_ITEMS will be the maximium number of songs to be displayed. You can set it to -1 to display all of your favorites. The parameter SHOW_COVER lets you decide, if images of the CD-covers should be displayed. For example …

<ul>
<?php pandorafeeds_display_bookmarked_songs(15, true);?>
</ul>

Will show the 15 most recent bookmarked songs together with their CD-cover.

<ul>
<?php pandorafeeds_display_bookmarked_songs(15, false); ?>
</ul>

Will show the same list, but with no CD-covers.

Each listitem represents one of your pandora-stations and will look like this:

<li class="pandorafeeds-favorites">
<img src="%URL_TO_COVER%" class="pandorafeeds-favorites" title="%TITLE% - %ARTIST%" alt="%TITLE% - %ARTIST%" />
<a href="%URL_TO_SONG_AT_PANDORA%" class="pandorafeeds-favorites" title="%SOME_DESCRIPTION%">
%TITLE%
</a> by %ARTIST%
</li>


• %URL_TO_COVER% will be the URL pointing to the image of the cover at Pandora.
• %TITLE% will be the title of the song.
• %ARTIST% will be the name of the artist.
• %URL_TO_SONG_AT_PANDORA% will be the URL pointing to more information about the song.
• %SOME_DESCRIPTION% will be a short description of the song.

Notice the CSS-class ‘pandorafeeds-favorites’. You can use it to adapt the look of the listitem to your theme.

Display Bookmarked Artists

<?php pandorafeeds_display_bookmarked_artists(NUMBER_OF_ITEMS); ?>

This tag creates a list of your bookmarked artists. It should be enclosed inside an <ul>-tag.

The parameter NUMBER_OF_ITEMS will be the maximium number of artists to be displayed. For example …

<ul>
<?php pandorafeeds_display_bookmarked_artists(15); ?>
</ul>

… would display the 15 most recent of your bookmarked artists. If you only have 8 artists, the list will only consist of these 8 artists. If you want all of your artists to be displayed, set the parameter to -1:

<ul>
<?php pandorafeeds_display_bookmarked_artists(-1); ?>
</ul>

Each listitem represents one of your pbookmarked artists and will look like this:

<li class="pandorafeeds-favoriteartists">
<a href="%URL_TO_ARTIST_AT_PANDORA%" class="pandorafeeds-favoriteartists" title="%ARTIST%">
%ARTIST%
</a></li>

• %URL_TO_ARTIST_AT_PANDORA% will be the URL pointing to more information about the artist
• %ARTIST% will be the name of the artist.

Using Stylesheets

You can use CSS to design the look of the lists. The following code shows the relevant style-classes, which you can adapt to your theme.