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 Podcast 1186: Free chickens for all
17 Mar 2010 at 12:49pm

If 3D is the chicken and the Avatar DVD is the egg, somehow we should all get free chickens or 3D is DOA. Or something like that. We've all still got a bit of a BBQ hangover from our time in Austin, but at least Rafe's here to make a little sense. Oh, wait, he came up with the 3D chicken thing. Anyway, Facebook rules the Web, IE 9 may or may not embrace actual standards, and Droid users are getting 2.1, finally. We're home.

Buzz Out Loud Podcast 1185: I can haz peace?
15 Mar 2010 at 3:02pm

Veronica Belmont and Ben Huh join us on stage to talk about the brewing war between Apple and Google, pay walls on the web... and we also wage tiny cute little wars on each other as well.

Buzz Out Loud Podcast 1184: Warning: BOL may result in loss of toe
14 Mar 2010 at 2:51pm

Today's BOL happened before a live studio audience at SXSW in Austin, TX. Cali Lewis and Nicole Lee joined us on stage to discuss the state of SXSW Interactive, the on-going Google/China kerfuffle, and pharmaceutical companies' struggles to fit the risks of drugs into a Twitter-friendly 140 characters. Also, Cali Lewis nearly loses a toe.... um, sorry?

Buzz Out Loud Podcast 1183: War and peace on the Internet
11 Mar 2010 at 1:09pm

Patent wars reignite, the Internet is nominated for a Nobel Peace Prize, and multitasking may be coming to the iPhone. It's an epic sort of show today. Also, PS3 gets in the game with a motion-controller, and employees like us knowingly violate IT policies like crazy people.

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');
?>