CaRP: Caching RSS Parser - Documentation

Podcast

Podcast is a plugin bundled with CaRP Evolution 4.0.8 and higher. It works with the 1 Pixel Out Audio Player to display a Flash-powered audio player for each MP3 in a podcast feed.

Example Podcast Feed

Buzz Out Loud (MP3)

Buzz Out Loud Ep. 1299: Apple iPod announcement shuffles the buttons (Podcast)
1 Sep 2010 at 3:06pm

Steve Jobs revealed today three new iPods, including a Shuffle with buttons, a Nano that can double as a wristwatch (we think) and a razor-sharp iPod Touch. Also: Sony and Amazon have media news of their own, and Zuckerberg wants his privacy.

Buzz Out Loud Ep. 1298: Forking tired of Android forks (Podcast)
31 Aug 2010 at 1:58pm

On today's show, Google does us a solid in the ham-filtering department, we wonder whether Paul Allen might have waited too long to sue the Internet, or whether this is just the beginning, and we speculate whether seven inches is, in fact, the perfect size after all. Plus, Internet vigilantes on the loose! --Molly

Buzz Out Loud Ep. 1297: Facebook wants to own your face (Podcast)
30 Aug 2010 at 1:38pm

We're back from our BOL summer vacation, only to find that Paul Allen is trying to patent-troll the Internet out of existence, Netflix seems to have finally put BlockBuster out of existence, and Foursquare ain't going down without a fight. Oh, and Donald Bell gives us his predictions for Apple's Sept. 1 event. --Molly

FLASHBACK! Buzz Out Loud 1262: Apple raises the bars (podcast)
27 Aug 2010 at 2:41am

You say Flashback, I say Unicorn of Rock! Go!

There's a fix coming for the iPhone 4's antenna problems: Apple will make the signal strength meter go higher, no matter what. Seriously? Yes. Also, Steve Jobs did not say, "It's just a phone," Microsoft doesn't care which way you insert your batteries, and there is no space dust on Hayabusa.

Installation:

To install Podcast:

If "podcast.php" is not already found in your "plugins" folder, upload it to that folder.
Download the 1 Pixel Out Audio Player.
If you have a WordPress blog, you may wish to install it in your WordPress plugins directory.
Otherwise, upload just audio-player.js and player.swf to your webserver. You can put them anywhere as long as they're web-accessible and both files are in the same folder.

Use:

To tell CaRP Evolution to use Podcast:

Enter the following command into your webpage after "require_once '/path/to/carp.php';":
CarpLoadPlugin('podcast.php');
Tell the plugin where audio-player.js and player.swf are located by adding a line of code like this:
$podcastcarpconf['player-path']='/blog/wp-content/plugins/audio-player/';
- The path should end with "/".
- If the files are not on the same server as the page where you're displaying the podcast, enter the full URL of the folder. Otherwise, you can enter just the path as in the example above.
By default, the plugin adds a "<br />" (line break) tag after the podcast player. If you wish to change that, or add something before the podcast player, use CaRP's "bipodcast" and "aipodcast" settings to specify what to display. Be sure to set those settings after loading the plugin.
If desired, use the settings below to customize your podcast players.

Important Notes:

This plugin is compatible only with CarpShow and CarpCacheShow, not with CarpFilter, CarpCacheFilter, CarpGroupFilter, CarpAggregate, and CarpInterleave. If you wish to use it to sort aggregated feeds, create a script that outputs the aggregated feed in RSS 2.0 format using the RSS 2.0 theme, and then use this plugin with CarpShow or CarpCacheShow to display the output of that script.
The 1 Pixel Out Audio Player (and thus this plugin) is compatible only with MP3 audio files.
The 1 Pixel Out Audio Player (and thus this plugin) is compatible only with files with sample rates of 11.025kHz, 22.050kHz and 44.100kHz. Files with other sample rates will play incorrectly.

Configuration:

The Sort plugin has the following settings, which are members of the array $sortcarpconf. In most cases, you'll use the functions listed above to control these settings:

player-path: The path to the 1 Pixel Out Audio Player as shown above.
check-for-mp3: If set to 1 (the default), the plugin tries to verify that the audio file is an MP3 by checking for "mp3" (not case sensitive) in the filename. If "mp3" does not appear in the filename, no audio player will be displayed. If set to 0, it will create an audio player for any audio enclosure, whether the filename contains "mp3" or not.
bg: The background color of your page in the place where the audio player will be displayed. Specify this an all colors as six digit hexidecimal values (0 - 9 and A - F).
player-settings: This is an array of colors for each part of the audio player as shown here:

Set these settings like this:
$podcastcarpconf['player-settings']['leftbg']='0033CC';
- bg: The background of the player when it's open
- leftbg: The background of the left side of the player
- lefticon: The icon on the left side
- rightbg: The background of the right side when the mouse isn't over it
- rightbghover: The background of the right side when the mouse is over it
- righticon: The icon on the right side when the mouse isn't over it
- righticonhover: The icon on the right side when the mouse is over it
- text: The text inside the player
- slider: The slider "thumb" in the player
- track: The inside of the part of the track that has been loaded but not played
- border: The border of the track
- loader: The inside of the part of the track that has been played

Example Code:

<?php
require_once '/YOUR/PATH/TO/carp/carp.php';
CarpLoadPlugin('podcast.php');
$podcastcarpconf['player-path']='/blog/wp-content/plugins/audio-player/';
$podcastcarpconf['bg']='FFFFFF'; // White page background
$podcastcarpconf['player-settings']['bg']='FFFFCC'; // Yellow player background
$podcastcarpconf['player-settings']['track']='006633'; // Dark green track
CarpCacheShow('http://example.com/podcast.rss');
?>